Projekt, ktorý si pamätá sám
- Pre koho: pre každého, kto robí na viacerých veciach naraz, odkladá ich a vracia sa k nim, alebo raz bude svoju prácu odovzdávať niekomu inému. Programátorov, ale aj tých, čo programovať nepotrebujú.
- Čo si odnesieš: päť princípov, ako zapisovať prácu, aby sa na nič nezabudlo, a jednoduchý začiatok bez akéhokoľvek špeciálneho nástroja.
Poznáš to. Otvoríš projekt, ktorý pol roka ležal v šuplíku, a nevieš, prečo si ho vtedy odložil. Nefungovalo niečo? Došla chuť? Čakal si na niečo? A čo z toho, čo je rozrobené, je hotové a čo len vyzerá hotovo?
Pri programovaní je to rovnaké ako pri rekonštrukcii bytu alebo pri papieroch na úrade. Najdrahšie nie je to, čo sa stratilo, ale to, čo si treba znova zisťovať.
Mne sa to stávalo často. Robím po večeroch na mnohých projektoch naraz a zámerne medzi nimi striedam, lebo ma to baví a čistí mi to hlavu. Lenže každý návrat stál hodinu skladania toho, kde som skončil. Tak som si postavil systém, ktorý si to pamätá za mňa.
Ako to vzniklo: projekt, pri ktorom musí byť všetko doložené
Prvý impulz neprišiel z lenivosti, ale z jedného náročného koníčka. Pri jednom projekte som si dal prísne pravidlo: všetko napíšem sám od nuly a do cudzieho kódu nenahliadnem ani „len na chvíľku“. Takému postupu sa hovorí clean room, čistá miestnosť.
Taký sľub má zmysel len vtedy, keď sa dá aj dokázať. Pri každom vzorci teda musí byť zapísané, odkiaľ pochádza, či z odbornej publikácie, normy, alebo z vlastného výpočtu. Pri každom rozhodnutí prečo. A keď sa niečo nečisté predsa stane, zapíše sa to otvorene do zoznamu incidentov a opraví, nič sa nezametá pod koberec.
Zistil som, že takýto poctivý záznam pomáha oveľa viac než len pri jednom projekte. Odpovedá na otázky, ktoré si o rok položím pri čomkoľvek: odkiaľ to je, prečo je to takto a čo sme skúšali predtým.
Kto to číta
Pôvodne som písal hlavne pre seba. Časom sa ukázalo, že ten istý záznam má troch čitateľov:
- ja o pol roka, keď si na nič nespomínam;
- človek, ktorý po mne prevezme prácu alebo mi s ňou pomôže, a nemá čas čítať celú históriu;
- AI pomocník, s ktorým dnes časť práce robím. Ten má rovnaký problém ako nový kolega: každý deň začína od nuly a vie len to, čo mu niekto povie alebo čo si niekde prečíta.
Dobrý záznam slúži všetkým trom naraz. Keď je zrozumiteľný pre človeka, ktorý projekt nikdy nevidel, je zrozumiteľný aj pre mňa o rok.
1. Zapisuj hneď, nie „potom“
Prvé pravidlo znelo jednoducho: priebežne si zapisuj, čo robíš. V praxi to nefungovalo.
Pri krátkej úlohe sa to dodržalo. Pri dlhej práci, keď človek rieši problém naplno, sa zapisovanie vytrácalo, a platilo to pre mňa aj pre AI. Keď som to v júli prvýkrát poriadne skontroloval, za jeden deň chýbalo 10 zo 16 záznamov.
Poučenie: pravidlo, ktoré je krokom navyše, sa pri plnom sústredení vynechá ako prvé. Zápis musí byť súčasť práce. Úloha nie je hotová, kým nie je zapísaná.
2. Jedno miesto pravdy
Najprv som skúšal zapisovať na dve miesta naraz, pre istotu. Bola to chyba, len dvojnásobná: dva kroky navyše a k tomu otázka, ktoré miesto má pravdu, keď sa rozídu.
Pomohol až opačný prístup. Zapisuje sa na jedno jediné miesto a všetko ostatné sa z neho vytvára samo. Postavil som si na to malú vlastnú appku a pomenoval ju Mímir, podľa studne múdrosti zo severskej mytológie. Je v nej denník, poznámky k projektom a zoznam nedokončených vecí. Čitateľné zálohy v obyčajných súboroch z nej vznikajú automaticky.
A je to aj môj poznámkový blok. Keď ma niečo napadne, či v práci, cestou, alebo večer pred spaním, otvorím ho aj na mobile a zapíšem nápad priamo k projektu, ktorého sa týka. Nie na papierik, ktorý sa stratí, ani do všeobecnej poznámky, ktorú o mesiac nikto nenájde. Keď sa k projektu vrátim, nápad tam čaká spolu so všetkým ostatným.
Či sa zapisuje, sa dá overiť jednou otázkou: kedy sa naposledy niečo zapísalo?
3. Zapisuj to, čo nie je nikde inde
Najväčšia chyba je zapisovať všetko. Záznam sa zahltí, podstatné sa v ňom nenájde a prestaneš ho čítať.
Zapisuj to, čo sa nedá zistiť inak:
- rozhodnutia aj s dôvodom: „takto nie, lebo minule to spadlo pri výpadku prúdu“;
- slepé uličky: čo sme skúšali a prečo to nevyšlo, aby to o rok nikto neskúšal znova;
- prečo sa niečo odložilo: nefungovalo, čakalo sa na niečo, alebo jednoducho nebola chuť. Aj to je poctivá a užitočná informácia;
- dohody: čo sa smie spraviť bez opýtania a čo nie;
- otvorené veci: čo sme našli, ale ešte nevyriešili.
Nezapisuj to, čo vidno v samotnej práci. Pri programovaní je to kód a jeho história, pri rekonštrukcii hotová stena.
Pri rozhodovaní pomáha jedna otázka: bude to dôležité aj o pol roka a nedá sa to zistiť inak? Ak áno, zapíš to.
4. Pamäť má vrstvy
Časom sa ukázalo, že pamäť nie je jeden zošit, ale niekoľko vrstiev a každá má inú úlohu:
| Vrstva | Čo v nej je | Ako často sa mení |
|---|---|---|
| Kto som a ako pracujem | zvyky, pravidlá, čo mi vadí, aké mám nástroje | zriedka |
| Pravidlá projektu | ako sa v projekte pracuje, čo sa nesmie, ako sa overuje výsledok | občas |
| Denník a rozhodnutia | čo sa robilo, prečo a čo z toho vyplynulo | každý deň |
| Otvorené veci | nájdené, ale nevyriešené. Nič sa nemaže, len uzatvára | každý deň |
Kto k projektu prichádza, či už ja, kolega alebo AI, prečíta si najprv prvé dve vrstvy a potom posledné záznamy z denníka. Nezačína od nuly, ale tam, kde sa naposledy skončilo.
5. Prepoj záznam s prácou
Malá vec s veľkým účinkom. Programátori ukladajú každú zmenu kódu s krátkym popisom (tzv. commit). Do toho popisu pridávam odkaz na záznam v denníku, kde je napísané prečo. Kód hovorí, čo sa zmenilo, záznam hovorí prečo, a odkaz ich spája. Keď o rok natrafím na zvláštny riadok, jedným klikom vidím, prečo tam je.
To isté sa dá aj mimo programovania: číslo záznamu na faktúre, v názve fotky z rekonštrukcie alebo v e-maile.
Rovnaké pravidlo platí pri odovzdávaní práce. Keď na jednej veci robia dvaja ľudia, alebo človek a AI, prípadne pokračuje niekto na inom počítači, nikto nemusí čítať cudzie rozhovory ani sa vypytovať. Všetci čítajú ten istý záznam.
Čo stále nefunguje dokonale
Aby to neznelo príliš ružovo:
- Zápis sa občas aj tak vynechá, u mňa aj u AI. Preto pravidelná kontrola, nie slepá dôvera.
- Záznamy zastarávajú. Čo platilo v auguste, nemusí platiť v novembri. Keď niečo prestane platiť, opraví sa to. Nenechávam tam dve protichodné pravdy.
- Viac nie je lepšie. Čo sa číta na začiatku, musí byť krátke. Raz som tú časť nafúkol a jej koniec sa prestal čítať, bez akéhokoľvek varovania. Odvtedy je tam len stručný prehľad a podrobnosti sú v samostatných poznámkach.
Čo sa zmenilo
Najväčší rozdiel nie je technický. Keď otvorím projekt, ktorý mesiace ležal, do pár minút viem, kde som skončil, prečo som ho odložil a čo ostalo otvorené. K projektom, ktoré by som kedysi nechal ležať, lebo by to bolo príliš veľa skladania, sa dnes vraciam a dokončujem ich.
A kto mi s niečím pomáha, či človek alebo AI, nemusí začínať otázkou „a ako to tu vlastne funguje?“.
Ako začať, bez akéhokoľvek nástroja
Vlastnú appku nepotrebuješ. Stačí začať takto:
- Jeden súbor alebo zošit na projekt s pravidlami: ako sa v ňom pracuje a čo sa nesmie. Programátori ho dajú do koreňa projektu (napríklad
README.md,CLAUDE.mdaleboAGENTS.md), kde ho nájde človek aj AI. - Denník rozhodnutí. Krátke záznamy s dátumom: čo sme sa rozhodli, prečo, a čo nevyšlo.
- Zoznam otvorených vecí. Nič z neho nemaž, hotové len označ.
- Zápis ako súčasť práce. Nie „keď bude čas“, ale „hotové je až zapísané“. To platí pre teba, kolegu aj AI.
- Raz za čas kontrola. U mňa prvá kontrola ukázala, že chýba viac než polovica záznamov.
V poslednom čase vznikajú aj hotové nástroje, ktoré robia niečo podobné, hlavne pre prácu s AI. Je to dobrý signál, že nejde o výmysel jedného človeka, ale o potrebu každého, kto sa k svojej práci chce vedieť vrátiť. Princípy vyššie platia bez ohľadu na to, či použiješ appku, tabuľku, alebo obyčajný zošit.