Pochopení legacy kódu s pomocí AI

Kód, který nikdo nepsal (ale všichni na něm závisí)

V každé firmě existuje ten jeden repozitář. Možná je to interní nástroj napsán v PHP 5, který běží na serveru pod stolem. Možná je to Java monolith z roku 2012 s třemi stovkami tříd a nulovými testy. Možná je to Python skript, který spálí noční importy dat a nikdo neví, co přesně dělá. Všichni na něm závisí. Nikdo mu nerozumí. A nikdo se na něj nechce dívat.

Tradičně máte dvě možnosti: strávit týdny čtením každého řádku, nebo napsat nový systém od nuly (a zjistit, že ten starý dělal věci, o kterých jste nevěděli). AI otevírá třetí cestu: systematické pochopení existujícího kódu za zlomek času.

Extrakce architektury: od chaosu k diagramu

Začněte tím, že AI nakrmíte adresářovou strukturou projektu a klíčovými soubory. Nechtějte po něm hned detailní analýzu každé funkce — začněte shora. 'Jaké vrstvy tento projekt má? Kde je vstupní bod? Jaké externí služby volá?' AI dokáže z adresářové struktury, importů a konfiguračních souborů odvodit architekturu, kterou byste ručně skládali celý den.

Praktický postup: použijte příkaz tree nebo ls -R pro získání adresářové struktury. Přidejte soubory jako package.json, pom.xml nebo requirements.txt. Nechte AI vygenerovat Mermaid diagram hlavních komponent a jejich vztahů. Za pět minut máte mapu, která by jinak vyžadovala půl dne reverse engineeringu.

Mapování závislostí: co na čem závisí

Legacy kód má často skryté závislosti, které nenačete v žádném konfiguračním souboru. Hardcoded URL adresy, implicitní očekávání prostředí, časové zóny nastavené hluboko v kódu. AI dokáže prohledat kód a identifikovat tyto skryté vazby. Zadejte: 'Najdi všechny externí závislosti — API volání, databázová připojení, souborové operace, environment proměnné.'

Zvlášť důležité je pochopit datové toky. Odkud data přicházejí? Jak se transformují? Kam odcházejí? Nechte AI vytvořit datový flow diagram — často odkryje věci, které by vám trvaly dny ručního trasování. Například skrytý side effect, kdy funkce pro výpočet ceny zároveň zapisuje do logovací tabulky.

Business logika: pochopení pravidel ukrytých v kódu

Nejcennější část legacy kódu nejsou technické detaily — je to business logika. Pravidla, která se postupně nabalovala přes roky v podobě if-else větví, speciálních případů a hotfixů. AI dokáže tyto pravidla extrahovat a přeformulovat do čitelné podoby. Zadejte: 'Extrahuj všechna business pravidla z této třídy. Pro každé pravidlo uveď: co kontroluje, jaký je výsledek a jaké výjimky existují.'

Pozor na hallucinations. AI může business logiku špatně interpretovat, zvlášť u implicitních pravidel. Vždy si ověřte, že extrahovaná pravidla odpovídají reálnému chování — například spuštěním stávajícího kódu s testovacími daty. AI vám pomůže pochopit, co kód pravděpodobně dělá. Potvrdit to musíte vy.

Dokumentační výstup: základ pro další kroky

Výstupem této fáze by měl být dokument, který pokrývá čtyři oblasti: architektonický přehled (vrstvy, komponenty, komunikace), mapa závislostí (externí služby, databáze, API), seznam business pravidel (extrahovaných z kódu) a seznam rizik (co je křehké, co nemá testy, co je hardcoded). Tento dokument je váš základ pro všechno další — refaktoring, testy i modernizaci.