Aplikace, kterou postavil jeden člověk pomocí AI nástroje, funguje. To je hotová věc. Otázka, která přijde později, zní jinak: může v ní pokračovat někdo jiný?
Rozdíl mezi těmito dvěma stavy se nazývá přenositelnost a je to nejpodceňovanější položka celého vibe codingu. Nezpůsobí incident ani pokutu. Způsobí, že každá další změna stojí násobek toho, co by měla.
Tento text je seznamem toho, co musí být hotové, aby předání dopadlo dobře.
Kdy se to řeší
- Autor odchází z firmy nebo mění roli.
- Aplikace přerostla to, co jeden člověk zvládne udržovat vedle své práce.
- Aplikace má přejít z omezeného používání do plného provozu.
- Firma se rozhodla aplikaci dál rozvíjet a hledá dodavatele.
- Kupující nebo investor se ptá, co přesně přebírá.
Ve všech pěti případech platí totéž: čím dřív, tím levněji. Předání se dělá nejlépe v době, kdy je autor ještě dostupný a ochotný.
Sedm věcí, které musí existovat
1. Zdrojový kód mimo platformu
Kód exportovaný z nástroje, ve kterém vznikl, musí být uložený ve verzovacím systému, ke kterému má přístup firma, ne jednotlivec.
Bez tohoto bodu nemá smysl řešit zbylých šest. Pokud aplikaci nelze dostat z platformy ven, není co předávat a jedinou cestou dál je přepis.
2. Popis toho, co aplikace dělá
Tři odstavce prózy stačí. Kdo aplikaci používá, co v ní dělá a co se stane, když se zastaví. Tento dokument je pro nového člověka cennější než jakýkoliv technický popis, protože bez něj nedokáže odhadnout, které části jsou důležité.
3. Popis dat
Jaké údaje aplikace ukládá, jak jsou uspořádané a co s čím souvisí. U aplikací postavených pomocí AI bývá datová struktura to jediné, co se nedá z kódu rychle odvodit, protože vznikala postupně a nese v sobě rozhodnutí z různých fází.
4. Seznam všech služeb a účtů
Hosting, databáze, doména, platební brána, e-mailová služba, AI služby, úložiště a analytika. U každé položky uveďte, kdo je vlastníkem účtu, kdo platí, kolik to stojí a co se stane, když platba nepřijde.
Tento seznam je zároveň podkladem pro smlouvy se zpracovateli osobních údajů, takže se hodí dvakrát.
5. Přístupy vedené na firmu
Ne na osobní e-mail ani na sdílenou schránku bez správce. Firemní účty se správcovským přístupem, ke kterým lze kdykoliv přidat člověka nebo mu přístup odebrat.
Pokud tento bod není splněný, předání se nekoná. Pouze se vše přesune na jiného jednotlivce.
6. Prostředí, ve kterém se dá pracovat
Nový člověk musí být schopen aplikaci spustit u sebe, zkoušet změny a nasadit je, aniž by při každé úpravě zasahoval do ostrého provozu. To znamená oddělené testovací prostředí a popsaný postup nasazení.
Tento bod chybí v drtivé většině aplikací postavených pomocí AI a bývá to první věc, kterou nový tým musí udělat, než vůbec začne pracovat.
7. Seznam provizorních řešení
Každá aplikace má místa, o kterých autor ví, že jsou udělaná narychlo. Napsat je na papír zabere půl hodiny a ušetří novému člověku týdny.
Tento bod se nikdy nezískává z kódu. Získává se výhradně rozhovorem s autorem, a to dřív, než odejde.
Předávací rozhovor
Vyhraďte si dvě hodiny, přizvěte autora i přebírajícího a rozhovor nahrajte. Položte autorovi tyto otázky:
- Co se rozbije nejčastěji a proč?
- Které části se bojíš měnit?
- Co jsi udělal narychlo a chtěl ses k tomu vrátit?
- Co dělá někdo ručně, protože to aplikace neumí?
- Kde je nejvíc dat a kde nejrychleji přibývají?
- Co bys udělal jinak, kdybys to stavěl znovu?
- Existuje něco, co víš jenom ty?
Otázka číslo šest bývá nejužitečnější z celého předání. Autor v odpovědi zpravidla přesně popíše to, co bude přebírající řešit první tři měsíce.
Kontrola stavu před předáním
Předání a kontrola stavu jsou dvě různé věci a dělají se v tomto pořadí.
Předání zajistí, že aplikaci máte a někdo v ní může pokračovat. Kontrola vám řekne, v jakém je stavu. Bez ní nový tým začne tím, že tři týdny zjišťuje, co zdědil, a to zaplatíte v hodinách.
Podklad, ve kterém je popsaný stav aplikace, seznam nálezů a doporučené pořadí oprav, zkracuje nástup nového týmu o týdny a zároveň slouží jako výchozí bod pro dohodu o tom, co se bude dělat.
Když předání nedává smysl
Jsou situace, kdy je předání dražší než začít znovu. Poznáte je podle těchto znaků:
- Kód nelze dostat z platformy ven.
- Datová struktura je natolik neuspořádaná, že se v ní nedá spolehlivě orientovat.
- Odhad na uvedení do udržovatelného stavu se blíží ceně nového řešení.
- Aplikace má růst řádově a základ na to není stavěný.
V takovém případě má pořád smysl zachovat data a popis toho, co aplikace dělá. To je hodnota, která zůstává, i když kód nezůstane.