Rozdíly

Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.

--- ai:platformy:claude-code:strukturace-dokumentace [05.05.2026 09:32] – Doplnění vazby na Spec Kit – vysvětlení vztahu a prolinkování Petr Nosek
+++ ai:platformy:claude-code:strukturace-dokumentace [05.05.2026 09:38] (aktuální) – Doplnění dvou klíčových principů: PROČ místo CO/JAK, AS IS místo changelogu Petr Nosek
@@ Řádek 4: / Řádek 4: @@
 [[https://www.vibecoding.cz/download/strukturace-dokumentace-pro-claude-code-v2.pdf|Prezentace Ondřeje Tučného]] z akce Vibeco Ding Talks (20. 4. 2026) popisuje systém strukturování dokumentace pro projekty s Claude Code, který škáluje od malých repozitářů až po miliony řádků kódu. Výchozím bodem je [[https://vibecoding.cz|vibecoding.cz]] – konkrétně přístup Patricka Zandla, který funguje do určité velikosti projektu. Tato prezentace řeší, co dělat, když tento přístup přestane stačit.
+===== Co AI agent z dokumentace skutečně potřebuje =====
+Dva principy, které stojí za celým přístupem:
+**Dokumentace pro AI odpovídá na PROČ, ne na CO nebo JAK.**
+CO a JAK jde přečíst přímo z kódu — agent to zvládne sám. Jediné, co z kódu vyčíst nejde, je záměr: proč byl zvolen tento přístup, jaké alternativy byly zamítnuty, co se tímto rozhodnutím vědomě obětovalo. Bez tohoto kontextu agent při každé nové session navrhuje „lepší" řešení, které ale ignoruje důvody, proč věci jsou tak, jak jsou.
+**AS IS místo changelogu.**
+Changelog zaznamenává historii změn — co se dělalo před rokem, před půl rokem. Pro AI agenta je tato historie bezcenná a škodlivá: zbytečně plní kontext a mate model tím, co už dávno neplatí. Místo toho dokumentace popisuje **aktuální stav systému** — jak věci fungují teď. Historie patří do verzovacího systému (git), ne do dokumentace pro agenta.
 ===== Kde plochá struktura přestává stačit =====