Aplikácia, ktorú postavil jeden človek pomocou AI nástroja, funguje. To je hotová vec. Otázka, ktorá príde neskôr, znie inak: môže v nej pokračovať niekto iný?
Rozdiel medzi týmito dvoma stavmi sa nazýva prenositeľnosť a je to najpodceňovanejšia položka celého vibe codingu. Nespôsobí incident ani pokutu. Spôsobí, že každá ďalšia zmena stojí násobok toho, čo by mala.
Tento text je zoznamom toho, čo musí byť hotové, aby odovzdanie dopadlo dobre.
Kedy sa to rieši
- Autor odchádza z firmy alebo mení rolu.
- Aplikácia prerástla to, čo jeden človek zvládne udržiavať popri svojej práci.
- Aplikácia má prejsť z obmedzeného používania do plnej prevádzky.
- Firma sa rozhodla aplikáciu ďalej rozvíjať a hľadá dodávateľa.
- Kupujúci alebo investor sa pýta, čo presne preberá.
Vo všetkých piatich prípadoch platí to isté: čím skôr, tým lacnejšie. Odovzdanie sa robí najlepšie v čase, keď je autor ešte dostupný a ochotný.
Sedem vecí, ktoré musia existovať
1. Zdrojový kód mimo platformy
Kód exportovaný z nástroja, v ktorom vznikol, musí byť uložený vo verzovacom systéme, ku ktorému má prístup firma, nie jednotlivec.
Bez tohto bodu nemá zmysel riešiť zvyšných šesť. Ak aplikáciu nemožno dostať z platformy von, nie je čo odovzdávať a jedinou cestou ďalej je prepis.
2. Opis toho, čo aplikácia robí
Tri odseky prózy stačia. Kto aplikáciu používa, čo v nej robí a čo sa stane, keď sa zastaví. Tento dokument je pre nového človeka cennejší než akýkoľvek technický opis, pretože bez neho nedokáže odhadnúť, ktoré časti sú dôležité.
3. Opis dát
Aké údaje aplikácia ukladá, ako sú usporiadané a čo s čím súvisí. Pri aplikáciách postavených pomocou AI býva dátová štruktúra to jediné, čo sa nedá z kódu rýchlo odvodiť, pretože vznikala postupne a nesie v sebe rozhodnutia z rôznych fáz.
4. Zoznam všetkých služieb a účtov
Hosting, databáza, doména, platobná brána, e-mailová služba, AI služby, úložisko a analytika. Pri každej položke uveďte, kto je vlastníkom účtu, kto platí, koľko to stojí a čo sa stane, keď platba nepríde.
Tento zoznam je zároveň podkladom pre zmluvy so sprostredkovateľmi osobných údajov, takže sa hodí dvakrát.
5. Prístupy vedené na firmu
Nie na osobný e-mail ani na zdieľanú schránku bez správcu. Firemné účty so správcovským prístupom, ku ktorým možno kedykoľvek pridať človeka alebo mu prístup odobrať.
Ak tento bod nie je splnený, odovzdanie sa nekoná. Všetko sa iba presunie na iného jednotlivca.
6. Prostredie, v ktorom sa dá pracovať
Nový človek musí byť schopný aplikáciu spustiť u seba, skúšať zmeny a nasadiť ich bez toho, aby pri každej úprave zasahoval do ostrej prevádzky. To znamená oddelené testovacie prostredie a opísaný postup nasadenia.
Tento bod chýba v prevažnej väčšine aplikácií postavených pomocou AI a býva to prvá vec, ktorú nový tím musí urobiť, než vôbec začne pracovať.
7. Zoznam provizórnych riešení
Každá aplikácia má miesta, o ktorých autor vie, že sú urobené narýchlo. Napísať ich na papier zaberie pol hodiny a ušetrí novému človeku týždne.
Tento bod sa nikdy nezískava z kódu. Získava sa výhradne rozhovorom s autorom, a to skôr, než odíde.
Odovzdávací rozhovor
Vyhraďte si dve hodiny, prizvite autora aj preberajúceho a rozhovor nahrajte. Položte autorovi tieto otázky:
- Čo sa pokazí najčastejšie a prečo?
- Ktoré časti sa bojíš meniť?
- Čo si urobil narýchlo a chcel si sa k tomu vrátiť?
- Čo robí niekto ručne, pretože to aplikácia nedokáže?
- Kde je najviac dát a kde najrýchlejšie pribúdajú?
- Čo by si urobil inak, keby si to staval znova?
- Existuje niečo, čo vieš iba ty?
Otázka číslo šesť býva najužitočnejšia z celého odovzdania. Autor v odpovedi spravidla presne opíše to, čo bude preberajúci riešiť prvé tri mesiace.
Kontrola stavu pred odovzdaním
Odovzdanie a kontrola stavu sú dve rôzne veci a robia sa v tomto poradí.
Odovzdanie zaistí, že aplikáciu máte a niekto v nej môže pokračovať. Kontrola vám povie, v akom je stave. Bez nej nový tím začne tým, že tri týždne zisťuje, čo zdedil, a to zaplatíte v hodinách.
Podklad, v ktorom je opísaný stav aplikácie, zoznam nálezov a odporúčané poradie opráv, skracuje nástup nového tímu o týždne a zároveň slúži ako východiskový bod pre dohodu o tom, čo sa bude robiť.
Keď odovzdanie nedáva zmysel
Sú situácie, keď je odovzdanie drahšie než začať odznova. Spoznáte ich podľa týchto znakov:
- Kód nemožno dostať z platformy von.
- Dátová štruktúra je natoľko neusporiadaná, že sa v nej nedá spoľahlivo orientovať.
- Odhad na uvedenie do udržiavateľného stavu sa blíži cene nového riešenia.
- Aplikácia má rásť rádovo a základ na to nie je stavaný.
V takom prípade má stále zmysel zachovať dáta a opis toho, čo aplikácia robí. To je hodnota, ktorá zostáva, aj keď kód nezostane.