Keď jeden PROJECT_MEMORY.md nestačí: ako si vytvoriť spoločný pohľad naprieč AI projektmi

Ako som z jednotlivých projektových pamätí vytvorila spoločný rozhodovací pohľad a prečo oddeľujem kontrolu zdrojov od AI interpretácie.

Keď som začala držať kontext priamo pri jednotlivých projektoch, návraty k práci boli jednoduchšie. Codex alebo Claude Code si vedeli prečítať aktuálny stav, rozhodnutia a otvorené otázky. Pri každej novej session som už nemusela vysvetľovať celý priebeh od začiatku.

Pri viacerých projektoch však zostávala ďalšia vrstva práce.

Ráno som stále potrebovala otvoriť jeden projekt za druhým a zisťovať, čo sa od poslednej kontroly pohlo, čo zostalo otvorené, kde chýba rozhodnutie a ktorému projektu mám venovať pozornosť.

Projektová pamäť vyriešila pokračovanie vo vnútri jednotlivých projektov. Na orientáciu naprieč nimi som potrebovala spoločný rozhodovací pohľad.

Tak začala vznikať portfóliová vrstva môjho AI Project Memory.

Dve rozdielne úlohy projektovej pamäte

Pri práci s viacerými projektmi mi pomáha rozlišovať dve vrstvy.

Projektová pamäť drží detail konkrétneho projektu. Zachytáva jeho cieľ, aktuálny stav, rozhodnutia, otvorené otázky a ďalší krok.

Portfóliová pamäť tento detail neopakuje. Vyberá z neho iba informácie potrebné na rozhodovanie.

Ak mám päť projektov, ráno nepotrebujem päť dlhých súhrnov. Potrebujem vedieť, ktorý projekt sa zmenil, kde čaká moje rozhodnutie, kde chýba dôkaz a ktoré dve alebo tri veci si zaslúžia pozornosť.

Kedy má spoločná vrstva zmysel

Portfóliovú pamäť by som pridávala až vtedy, keď funguje pamäť jednotlivých projektov.

Ak sú vstupy neaktuálne alebo nejasné, spoločný prehľad túto neistotu iba prenesie vyššie. Výsledok môže vyzerať presvedčivo, ale bude stáť na slabých podkladoch.

Pred vytvorením spoločnej vrstvy by preto malo byť pri každom aktívnom projekte jasné:

• aký je jeho aktuálny stav,
• ktorý ďalší krok je platný,
• aké rozhodnutia už boli urobené,
• čo zostáva otvorené,
• z ktorých súborov alebo dôkazov tieto informácie vychádzajú.

Nové návrhy by zároveň mali zostať odlíšené od potvrdeného stavu. Portfóliový prehľad má vychádzať z toho, čo dnes platí, a otvorene ukázať miesta, kde to potvrdiť nevieme.

Ako vytvoriť prvý PORTFOLIO_MEMORY.md

Na prvý pokus nepotrebujete rannú automatizáciu ani kontrolné skripty. Stačí, že každý projekt obsahuje aktuálny PROJECT_MEMORY.md.

Nad nimi si môžete vytvoriť jeden spoločný výstup:

PORTFOLIO_MEMORY.md

Jeho štruktúra môže vyzerať napríklad takto:

# Portfolio Memory

Review date:
[DATE]

Review window:
[FROM] – [TO]

## Project A

Status:
Updated / Confirmed no change / Needs confirmation

What changed:
...

Current next step:
...

Needs my decision:
...

Missing context or evidence:
...

Source:
[path to PROJECT_MEMORY.md]

## Project B

Status:
...

## Moja pozornosť teraz

1. ...
2. ...
3. ...

## Projekty bez potrebnej akcie

...

Výstup má zostať krátky. Ak potrebujem technický detail, otvorím si konkrétny projekt. Úlohou portfóliového pohľadu je pomôcť mi rozhodnúť sa, kam ísť ďalej.

Prvý prehľad môže vzniknúť manuálne pomocou jedného promptu:

Pracujem na viacerých projektoch.

Každý projekt obsahuje súbor PROJECT_MEMORY.md s aktuálnym stavom,
rozhodnutiami, otvorenými otázkami a ďalším krokom.

Prečítaj PROJECT_MEMORY.md v týchto projektoch:

1. [PATH TO PROJECT A]
2. [PATH TO PROJECT B]
3. [PATH TO PROJECT C]

Priprav návrh PORTFOLIO_MEMORY.md.

Pre každý projekt uveď:

1. aktuálny stav,
2. čo sa od poslednej aktualizácie zmenilo,
3. najbližší konkrétny krok,
4. čo potrebuje moje rozhodnutie,
5. či chýba kontext alebo dôkaz,
6. zdroj, z ktorého informácia vychádza.

Použi jeden z troch stavov:

- Updated,
- Confirmed no change,
- Needs confirmation.

Potom vytvor sekciu:

## Moja pozornosť teraz

Vyber maximálne tri položky naprieč projektmi, ktoré si podľa
dostupných podkladov vyžadujú moju pozornosť.

Pri poradí zohľadni:

- zablokovanú ďalšiu prácu,
- chýbajúce rozhodnutie,
- riziko,
- termín,
- dopad na ostatné projekty.

Rozlišuj medzi:

- potvrdeným stavom,
- odporúčaním,
- chýbajúcou informáciou.

Ak niečo nevieš potvrdiť, označ:
TREBA POTVRDIŤ.

Nevymýšľaj chýbajúci kontext.
Neupravuj jednotlivé PROJECT_MEMORY.md.
Najprv mi ukáž návrh.

Pri prvých behoch by som tento proces spúšťala manuálne. Uvidíte, či je spoločný pohľad presný, či niektorý projekt dostáva neprimerane veľa pozornosti a či vstupné Project Memories obsahujú dostatok aktuálneho kontextu.

Ako vyhodnotiť stav každého projektu

Mne sa osvedčili tri jednoduché stavy.

Updated

V projekte vznikla relevantná zmena. Môže ísť o upravený zdrojový súbor, nový výstup, zmenu tasku alebo potvrdené rozhodnutie.

Tento stav by nemal znamenať iba to, že sa v projektovom priečinku zmenil ľubovoľný súbor. Potrebujeme vedieť, že zmena ovplyvňuje samotný projekt alebo jeho ďalší krok.

Confirmed no change

Projekt bol zahrnutý do kontroly a od posledného checkpointu sa v ňom nič relevantné nezmenilo.

Toto označenie je dôležité. Ukazuje rozdiel medzi projektom, ktorý bol skontrolovaný bez zmeny, a projektom, na ktorý sa pri kontrole zabudlo.

Needs confirmation

Stav projektu nevieme spoľahlivo vyhodnotiť.

Môže chýbať aktuálna projektová pamäť, zdroj, prístup alebo dôkaz o tom, čo sa stalo. Takýto stav má zostať viditeľný. Portfóliová vrstva by ho nemala potichu nahradiť odhadom.

Ako overiť, ktoré projekty sa skutočne zmenili

Pri prvej verzii môžete vychádzať z dátumu aktualizácie PROJECT_MEMORY.md. Neskôr sa však ukáže, že samotný čas zmeny nemusí stačiť.

Projekt môže vyzerať ako aktualizovaný, pretože prebehol build, vznikol testovací výstup, zmenil sa pomocný súbor alebo predchádzajúca automatizácia vytvorila vlastný súhrn. Samotná práca sa pritom nemusela posunúť.

Preto som postupne začala používať Git ako vrstvu dôkazov.

Git mi pomáha zistiť, ktoré súbory sa zmenili, od akého checkpointu a čo bolo pred zmenou a po nej. Viem tiež odlíšiť zdrojové súbory od odvodených výstupov, ktoré nemajú ovplyvniť stav projektu.

Model potom nemusí hľadať zmenu v celom projekte. Dostane konkrétne súbory alebo diff, ktorých význam má interpretovať.

Tým vzniká dôležité rozdelenie:

1. jednoduchšia kontrola zistí, kde nastala zmena,
2. AI vyhodnotí, čo táto zmena znamená.

Ako oddeliť kontrolu zdrojov od AI interpretácie

Pred zapojením modelu sa dá overiť viacero vecí bez potreby jazykového porozumenia:

• ktoré projekty sú registrované,
• či sú ich zdroje dostupné,
• či sa od posledného checkpointu zmenili,
• či majú aktuálnu projektovú pamäť,
• či už neprebieha iný kontrolný beh.

Až potom AI interpretuje význam zmenených podkladov.

Zjednodušený flow vyzerá takto:

PROJECT A → PROJECT_MEMORY.md ┐
PROJECT B → PROJECT_MEMORY.md ├→ kontrola zdrojov
PROJECT C → PROJECT_MEMORY.md ┘
                                  ↓
                    Updated / No change / Confirm
                                  ↓
                     relevantné súbory a rozhodnutia
                                  ↓
                         AI interpretácia
                                  ↓
                       PORTFOLIO_MEMORY.md

Toto rozdelenie znižuje riziko, že niektorý projekt vypadne z kontroly alebo že model opakovane číta projekty, v ktorých sa nič relevantné nestalo.

Kde používam AI a kde pevné pravidlá

Pri každom kroku mi pomáha otázka:

Potrebuje tento krok pochopiť význam, alebo iba overiť jasnú podmienku?

AI používam najmä na interpretáciu zmenených súborov, spojenie kontextu z viacerých zdrojov, rozlíšenie výsledku a prekážky, prípravu krátkeho súhrnu a návrh priorít.

Pevné pravidlá alebo skripty používam na kontrolu toho, či boli zahrnuté všetky projekty, či projekt existuje, či sa zmenil, či má výstup povinné sekcie a či už neprebieha iný beh.

Model tak dostáva priestor tam, kde potrebujem úsudok. Kód drží konzistentnosť tam, kde je pravidlo jednoznačné.

Prečo prvá verzia spotrebovala priveľa kontextu

Prvá automatizovaná verzia ranného a večerného review vytvárala použiteľný prehľad, ale čítala priveľa.

Model opakovane dostával pracovné pokyny, celý register taskov, staré súhrny, širokú históriu aj projekty, v ktorých sa nič relevantné nezmenilo. Niektoré projekty navyše vyzerali ako aktualizované iba preto, že predchádzajúci beh vytvoril vlastný výstup.

Postupne som preto upravila flow tak, aby sa všetky projekty najprv skontrolovali bez detailnej interpretácie. AI dnes číta iba zmenené alebo nejasné projekty a dostáva konkrétny balík relevantných podkladov. Buildy, pomocné súbory a manažérske výstupy sa z kontroly vylúčia.

Systém zároveň kontroluje, či už neprebieha iný beh. Duplicitný proces tak môže skončiť skôr, než znovu pošle modelu rovnaký kontext.

Najúspornejší AI beh je ten, ktorý sa nemusí spustiť.

Táto veta pre mňa neznamená, že treba AI používať čo najmenej. Znamená, že ju má zmysel zapojiť tam, kde potrebujeme porozumieť významu. Kontrolu existencie súboru alebo času poslednej zmeny zvládne spoľahlivejšie a lacnejšie jednoduchší mechanizmus.

Presnú percentuálnu úsporu zatiaľ neuvádzam. Zmenu architektúry mám overenú, finančný výsledok ešte meriam.

Ktoré zmeny stále potvrdzuje človek

Portfóliová pamäť môže pripraviť kvalitný rozhodovací podklad. Stále však nechcem, aby model bez kontroly menil prioritu, ownera, termín, hlavný stav úlohy alebo potvrdené rozhodnutie.

Rovnako má zostať pod ľudskou kontrolou zlúčenie dvoch taskov, zmena ich významu alebo označenie práce ako dokončenej bez dostatočného dôkazu.

Dôvod je praktický. Ak sa pracovný návrh zmieša s potvrdeným stavom, ďalší AI nástroj môže veľmi efektívne pokračovať nesprávnym smerom.

Systém preto rozdeľujem na tri kroky:

1. AI číta a interpretuje podklady.
2. AI navrhuje zmenu alebo prioritu.
3. Človek potvrdzuje, čo bude ďalej platiť.

Nové vstupy zo stretnutí, chatov alebo iných AI nástrojov v mojom sete najprv smerujú do oddeleného priestoru na kontrolu. Do hlavného stavu sa dostanú až po porovnaní s existujúcimi taskami a potvrdení.

Tento intake proces je samostatná vetva systému. Portfóliový pohľad má pracovať predovšetkým s potvrdeným stavom projektov.

Ako používam ranný a večerný pohľad

Spoločná pamäť má pre mňa dve praktické použitia.

Ráno potrebujem vidieť, čo sa od poslednej kontroly pohlo, čo zostalo otvorené, kde chýba rozhodnutie a ktoré maximálne tri priority dávajú zmysel.

Večer chcem zachytiť potvrdené výstupy, nedokončenú prácu, nové otvorené otázky a ďalší krok.

Detail zostáva v konkrétnom projekte. Spoločný pohľad mi má pomôcť rozhodnúť sa, kam ísť ďalej.

Práve tu sa ukazuje rozdiel medzi súhrnom a rozhodovacím pohľadom. Súhrn môže obsahovať všetko, čo sa stalo. Rozhodovací pohľad vyberá iba informácie, ktoré menia moju ďalšiu akciu.

Odporúčané poradie implementácie

1. Overte projektovú pamäť na jednom projekte

Portfóliová vrstva bude iba taká spoľahlivá ako jej vstupy. Najprv si preto overte, že podľa PROJECT_MEMORY.md dokáže iný AI nástroj správne pochopiť projekt a pokračovať.

2. Rozšírte rovnaký princíp na ďalšie aktívne projekty

Jednotlivé projekty nemusia mať identickú technickú štruktúru. Potrebujú však obsahovať rovnaké základné typy informácií: aktuálny stav, rozhodnutia, otvorené otázky, ďalší krok a zdroje.

3. Vytvorte prvý manuálny portfóliový pohľad

Spustite prompt nad dvomi alebo tromi projektmi a skontrolujte, či vám výsledok reálne pomáha rozhodovať sa. Sledujte, či vybrané priority nevychádzajú iba z poslednej zmeny, ale zohľadňujú aj blokery, termíny a potrebné rozhodnutia.

4. Sledujte opakujúce sa kontroly

Počas jedného alebo dvoch týždňov si všímajte, čo stále overujete rovnakým spôsobom. Môže ísť o existenciu súboru, čas poslednej zmeny, pokrytie projektov alebo povinné časti výstupu.

5. Až potom pridávajte skripty a automatizácie

Automatizácia má zmysel tam, kde už rozumiete manuálnemu flow a viete, aký výstup potrebujete. Inak môže iba zrýchliť tvorbu nepresného alebo málo užitočného prehľadu.

Limity spoločnej projektovej pamäte

Portfóliová pamäť mi pomáha s orientáciou, stále však nie je autonómny project manager.

Kontrolný skript môže potvrdiť, že bol projekt zahrnutý. Nedokáže zaručiť, že model správne pochopil význam každej zmeny.

Aj výber troch priorít zostáva odporúčaním. Model nemusí poznať širší obchodný, osobný alebo tímový kontext, ktorý ovplyvňuje moje rozhodnutie.

Ľudské schválenie chráni hlavný stav, zároveň pridáva ďalší krok a môže sa stať úzkym miestom. Pri tímovom alebo produkčnom použití by som preto riešila aj technické oprávnenia: kto môže kontext čítať, kto môže navrhovať zmenu a kto ju môže potvrdiť.

Hodnota AI Project Memory pre mňa nevzniká množstvom uchovaných informácií. Vzniká vo chvíli, keď ráno nemusím otvoriť päť projektov, aby som zistila, kde som na rade ja.

Ak s tým začínate, držala by som jednoduché poradie: najprv spoľahlivá pamäť jedného projektu, potom manuálny spoločný pohľad a až nakoniec automatizácia.