Tvůj kód je studnice znalostí. A nikdo z ní nečerpá.
Zde je něco, co by mělo znepokojit každého CTO a lead developera: ta nejpokročilejší понимание vašeho podnikání možná existuje nikde jinde než v produkčním kódu.
Nový výzkum od týmu ServiceMatch přináší provokativní myšlenku. Tvrdí, že vyspělé softwarové systémy nejsou jen nástroje, které provozují vaše podnikání — jsou to spustitelné reprezentace všecho, co se organizace naučila o tomto podnikání. Ten problém? Toto vědění se skrývalo na očích, zamčené v repozitářích, které četly jen překladače a (občas) lidé.
Mýtus dokumentace
Všichni jsme to zažili. K novému inženýrovi se dostane hromada Confluence stránek, záznamů o architektonických rozhodnutích a wiki příspěvků. "Tohle tě rychle nastaví," řekne někdo s optimistickou jistotou.
Nebude.
Dokumentace zachycuje to, co někdo považoval za vhodné napsat, v momentě, který mohl být před lety. Postrádá edge cases. Postrádá argumenty, které proběhly na schůzkách a formovaly rozhodnutí. Postrádá business logiku, která se vyvíjela přes tisíce commitů, každý z nich řešil reálný scénář.
Podle Petra Naura (ano, ten Naur, co nám dal Backus-Naur form), programová dokumentace nikdy plně nezachytí "teorii" za systémem. Skutečné pochopení žije v hlavách lidí. Když tito lidé odejdou, odejde s nimi i teorie.
Ale tady to začíná být zajímavé.
AI mění problém čtenářů
Naurův argument se týkal dvou typů čtenářů: překladačů (které kód provádějí bez jeho pochopení) a lidí (kteří ho chápou pomalu a draze). Nemožnost oživení dokumentace předpokládala, že neexistuje žádný jiný typ čtenáře.
Velké jazykové modely jsou třetím typem čtenáře. A jsou překvapivě dobré v rekonstrukci implicitních teorií vložených do kódu.
Systém ServiceMatch poskytuje přesvědčivé důkazy. Jejich CMDB platforma kóduje znalosti o správě podnikové konfigurace, které by naplnily svazky, kdyby byly napsány jako próza. Ale tady je ta věc — už jsou napsané, jen ne prózou. Jsou v kódu.
Vezměte si jejich logiku pro rozpoznávání identit. Místo konzultantova eseje o "tom, jak funguje identita zařízení" mají konfigurační soubor s váhami: sériové číslo (25), hostname (25), asset tag (25), IP adresa (20), MAC adresa (15). Plus práhy spolehlivosti a pravidla pro řešení konfliktů. Každé číslo představuje argument, který někdo vyhrál. Každý typ konfliktu představuje reálný incident, který se někde stal.
Toto není popis politiky. TOTO JE ta politika, běžící každou noc proti skutečným podnikovým prostředím.
Co to znamená pro váš tým
Pro vývojáře a technické lídry má tento výzkum praktické důsledky:
Váš kód je dokumentace, kterou jste neudržovali — a to má své výhody. Na rozdíl od zastaralých wiki stránek je kód běžící v produkci neustále validován. Pokud dokumentace nesouhlasí s kódem, chyba je v dokumentaci.
AI nástroje se zlepšují v extrakci těchto znalostí. Pohybujeme se směrem ke světu, kde by se dalo AI zeptat na "jak řešíme konflikty identit zařízení" a vrátí nejen dokumentaci, ale skutečné zdůvodnění zakódované ve vahách a prahových hodnotách.
Skutečné vědění žije v edge cases. Hlavní toky jsou obvykle dobře zdokumentované. Jsou to speciální případy, výjimky, rohové případy vyřešené za roky, které obsahují ty hluboké institucionální znalosti.
Varovný signál
Je zde nepříjemný důsledek: pokud je vaše business logika jen v kódu a váš kód má špatné testovací pokrytí, nejasné pojmenování nebo chaotickou strukturu, sedíte na hromadě znalostí, které se téměř nedají extrahovat.
Tým ServiceMatch zjistil, že jejich tvrzení — že "repozitář stačí" — se rozpadá předvídatelným způsobem. Naurův tichý zbytek je skutečný. Některé znalosti skutečně žijí jen v hlavách lidí.
Ale silnější zjištění je, že v kódu přežívá víc, než jsme si mysleli možné. Repozitář zachycuje daleko víc teorie než dokumentace kdy mohla — jen jsme potřebovali nový typ čtenáře, abychom to extrahovali.
Co s tím dělat
Pokud jste startup nebo rostoucí technologická společnost, zde je rámec pro přemýšlení:
- Věřte svému kódu víc než dokumentům, když se tyto dva neshodují
- Pište kód, který dokumentuje své zdůvodnění — smysluplné názvy proměnných, jasné funkce, komentáře vysvětlující PROČ, ne jen CO
- Zacházejte s konfigurací jako s institucionální znalostí — ty váhy a prahové hodnoty jsou rozhodnutí hodná uchování
- Začněte prozkoumávat AI nástroje, které umí interrogovat váš codebase jako zdroj znalostí
Kód, který píšete dnes, je zítřejší institucionální znalost. Udělejte z něj něco hodnotného.