| |
| ai:platformy:agenti-a-orchestrace:spec-kit [05.05.2026 07:49] – Přesun článku Spec Kit do AI agentů a orchestrace Petr Nosek | ai:platformy:agenti-a-orchestrace:spec-kit [05.05.2026 09:33] (aktuální) – Doplnění vazby na Tučného dokumentační framework – vysvětlení vztahu a prolinkování Petr Nosek |
|---|
| //Vytvořeno: **5.5.2026** | Aktualizováno: **~~LASTMOD~~**// | //Vytvořeno: **5.5.2026** | Aktualizováno: **~~LASTMOD~~**// |
| |
| [[https://github.com/github/spec-kit|Spec Kit]] je open-source toolkit od GitHubu pro [[https://github.com/github/spec-kit/blob/main/spec-driven.md|Spec-Driven Development]] — vývoj řízený specifikací. V kontextu AI nástrojů slouží hlavně jako strukturovaný proces pro práci s coding agenty: místo jednorázového „vibe codingu“ vede agenta přes specifikaci, technický plán, úkoly a implementaci. Projekt má i [[https://github.github.io/spec-kit/|oficiální dokumentaci]] na GitHub Pages. | [[https://github.com/github/spec-kit|Spec Kit]] je open-source toolkit od GitHubu pro [[https://github.com/github/spec-kit/blob/main/spec-driven.md|Spec-Driven Development]] — vývoj řízený specifikací. V kontextu AI nástrojů slouží hlavně jako strukturovaný proces pro práci s coding agenty: místo jednorázového „vibe codingu" vede agenta přes specifikaci, technický plán, úkoly a implementaci. Projekt má i [[https://github.github.io/spec-kit/|oficiální dokumentaci]] na GitHub Pages. |
| |
| ===== Co Spec Kit řeší ===== | ===== Co Spec Kit řeší ===== |
| |
| V README projektu je zároveň upozornění, že komunitní extensions a presets jsou třetí strany. GitHub a maintainers projektu je nemusí auditovat ani podporovat, takže je potřeba kontrolovat jejich zdrojový kód před instalací. | V README projektu je zároveň upozornění, že komunitní extensions a presets jsou třetí strany. GitHub a maintainers projektu je nemusí auditovat ani podporovat, takže je potřeba kontrolovat jejich zdrojový kód před instalací. |
| | |
| | ===== Kde Spec Kit zapadá do širší dokumentační architektury ===== |
| | |
| | Spec Kit pokrývá TO BE stranu vývoje — vytvoří specifikaci, plán a úkoly pro konkrétní feature nebo epik. Neřeší ale, jak vypadá AS IS dokumentace systému (struktura ''docs/'', dokumentace u kódu, archivace rozhodnutí). |
| | |
| | Tuhle druhou část — celkovou architekturu dokumentace repozitáře — popisuje přístup Ondřeje Tučného prezentovaný na Vibeco Ding Talks: [[ai:platformy:claude-code:strukturace-dokumentace|Strukturace dokumentace pro Claude Code]]. Ten definuje, kde co v repozitáři žije, jak oddělit AS IS od TO BE, jak dokumentaci prohledávat přes MCP nástroj a jak strukturovat úkolovou historii. |
| | |
| | Vztah je tedy: |
| | |
| | * **Tučného framework** = celková architektura — kde věci leží a jaký mají životní cyklus |
| | * **Spec Kit** = konkrétní nástroj pro TO BE část — jak specifikaci, plán a úkoly prakticky vytvářet |
| | |
| | Oba přístupy se doplňují: Spec Kit lze použít uvnitř Tučného frameworku jako implementaci ''tasks/'' strany. |
| |
| ===== Kdy dává smysl ===== | ===== Kdy dává smysl ===== |
| |
| Spec Kit se hodí hlavně tam, kde AI agent nemá jen „něco napsat“, ale má pracovat podle jasně popsaného zadání: | Spec Kit se hodí hlavně tam, kde AI agent nemá jen „něco napsat", ale má pracovat podle jasně popsaného zadání: |
| |
| * greenfield projekt, kde je potřeba nejdřív ujasnit produktové požadavky, | * greenfield projekt, kde je potřeba nejdřív ujasnit produktové požadavky, |
| * [[https://github.com/github/spec-kit/blob/main/docs/upgrade.md|Spec Kit — Upgrade Guide]] | * [[https://github.com/github/spec-kit/blob/main/docs/upgrade.md|Spec Kit — Upgrade Guide]] |
| * [[https://github.com/github/spec-kit/blob/main/LICENSE|Spec Kit — MIT License]] | * [[https://github.com/github/spec-kit/blob/main/LICENSE|Spec Kit — MIT License]] |
| | * [[ai:platformy:claude-code:strukturace-dokumentace|Strukturace dokumentace pro Claude Code]] – Tučného framework pro celkovou dokumentační architekturu repozitáře |
| | |