AI a dokumentace: praktický workflow, který konečně funguje

Dokumentace je jako zubař — všichni vědí, že by měli, nikdo nechce. AI to mění. Ne tak, že napíše dokonalé docs za vás, ale tak, že z půldenního úkolu udělá půlhodinový. A výsledek je často lepší, protože AI nepřeskakuje 'zřejmé' detaily, které vy považujete za samozřejmé.

Co AI v dokumentaci umí

AI exceluje v generování prvního draftu — a draft je 80 % práce. Tady je, co jí můžete delegovat s vysokou kvalitou výstupů:

• JSDoc/docstring z kódu — AI přečte funkci a napíše popis, parametry, návratové hodnoty
• README pro modul na základě jeho API a struktury
• Changelog z git historie — AI přečte commity a vygeneruje čitelný changelog
• Architekturní dokumentace z existujícího kódu — flow dat, závislosti, moduly
• Překlad interních docs do jiného jazyka
• API dokumentace z endpointů — request/response formáty, příklady

# Prompt pro generovani dokumentace modulu:

Precti vsechny soubory v src/services/payment/
a napís dokumentaci:

1. Prehled — co modul dela, jednim odstavcem
2. Architektura — jak spolu soubory souviseji
3. API — verejne funkce s parametry a priklady
4. Zavislosti — co modul potrebuje
5. Znama omezeni a tech debt

Format: Markdown, stručně, bez marketingu.

Co AI v dokumentaci neumí

Vysvětlit PROČ. Dokumentace, která říká 'tato funkce dělá X' je k ničemu — to vidím v kódu. Dokumentace, která říká 'tuto funkci jsme vytvořili, protože předchozí přístup Y měl problém Z, a rozhodli jsme se pro toto řešení, protože...' — to AI neví.

AI taky neumí spolehlivě dokumentovat implicitní znalosti týmu: 'Nikdy nemigruj tuto tabulku v pátek.' 'Tento endpoint používá jiný auth flow než všechny ostatní.' 'Tahle proměnná se jmenuje špatně, ale měnit ji by rozbilo 15 externích integrací.' Tohle musí dodat člověk.

Praktický workflow ve třech krocích

Krok 1: AI vygeneruje základ z kódu

Dejte AI přístup k codebase (Claude Code, Cursor) a řekněte jí: 'Napiš dokumentaci pro [modul/funkci/API]. Zahrň přehled, API popis, příklady použití a známá omezení.' AI přečte kód a vygeneruje první draft.

Krok 2: Vy doplníte kontext, důvody a nuance

Projděte draft a doplňte: proč jsme tohle tak udělali, jaké alternativy jsme zvažovali, jaké jsou gotchas, které z kódu nevyplývají. Tohle je ta část, kterou umí jen vy — a díky AI se můžete soustředit jenom na ni.

Krok 3: AI zformátuje a zpřesní

Po vašich úpravách nechte AI finalizovat: 'Zformátuj tento dokument konzistentně. Doplň chybějící příklady. Zkontroluj, že všechny API popisy odpovídají skutečnému kódu.' AI doladí strukturu a chytne nesrovnalosti.

Konkrétní použití, která fungují

CLAUDE.md jako živá dokumentace

CLAUDE.md v rootu projektu slouží jako dokument pro AI agenty — ale taky jako skvělá dokumentace pro nové členy týmu. Obsahuje stack, build příkazy, konvence, důležitá rozhodnutí. A protože ho AI aktivně používá, zůstává aktuální — na rozdíl od wiki, na kterou se všichni vykašlali.

# CLAUDE.md — priklad zive dokumentace

## Stack
Next.js 16, TypeScript, Tailwind, Prisma

## Konvence
- Funkce: camelCase, komponenty: PascalCase
- Testy: vitest, soubory: *.test.ts
- Commit messages: conventional commits

## Dulezite rozhodnuti
- Auth: JWT + httpOnly cookies (ne session)
  Duvod: microservices need stateless auth
- DB: Postgres + Prisma (ne TypeORM)
  Duvod: lepsi type safety, jednodussi migrace

Automatický changelog z git historie

Místo ručního psaní changelogu: 'Přečti git log za poslední 2 týdny a vygeneruj changelog. Seskup změny podle: features, fixes, refactoring. Popiš změny z perspektivy uživatele, ne vývojáře.'

Onboarding guide z existujícího kódu

'Napiš onboarding guide pro nového vývojáře na tomhle projektu. Zahrň: jak nastartovat lokálně, klíčové soubory a moduly, architektura v kostce, kam se podívat jako první.' AI přečte celý projekt a vytvoří guide, který by vám ručně trval půl dne.

Výsledek: dokumentace, která existuje

Existující dokumentace je nekonečně lepší než dokonalá dokumentace, která neexistuje.

AI nesníží bariéru na nulu — stále musíte doplnit kontext a zkontrolovat přesnost. Ale sníží ji natolik, že dokumentace přestane být úkol, který se odkládá 'na příště.' A to mění všechno.