DotMDSpecifikace je první.A čtete ji dřív než kód.
Vývoj řízený specifikací promění zadání v dokumenty dřív, než se stane kódem. Tahle stránka ukazuje cyklus, krátkou šablonu specifikace a kam zapadá vaše revize u Claude Code, Codexu a Cursoru.
macOS 14 nebo novější. Čtení je zdarma; úpravy a revize se platí jednou.
Rychlá odpověď
Při vývoji řízeném specifikací agent napíše specifikaci (co a proč), pak plán (jak), pak úkoly a staví až po revizi každého z nich. Právě revize rozhoduje o úspěchu: špatný požadavek ve specifikaci se stane špatným kódem. V DotMD si přečtete každý dokument, okomentujete přesný úsek a zkontrolujete opravy agenta, než půjde dál.
Cyklus: specifikace, revize, plán, revize, úkoly, stavba
Místo jednoho velkého promptu a hromady kódu projde práce dokumenty, z nichž každý vy zkontrolujete dřív, než se napíše další.
-
Specifikace: co a proč
Co má funkce dělat, pro koho a co dělat nesmí. Zatím žádné názvy souborů ani volba technologií.
-
Plán: jak
Přístup: které části se změní, v jakém pořadí a s jakými riziky. Plán se řídí specifikací.
-
Úkoly: malé kroky
Kontrolní seznam, který agent projde a odškrtává, každý úkol dost malý na kontrolu.
-
Stavba
Teprve teď agent píše kód, podle dokumentů, které jste už přečetli.
Krátká šablona specifikace
Specifikace nemusí být dlouhá. Šest nadpisů stačí na zachycení většiny nedorozumění:
# Feature name
## Goal
## Non-goals
## Users
## Requirements
## Edge cases
## Open questionsNon-goals a Open questions jsou ty, které lidé vynechávají a agenti potřebují nejvíc. Agent, kterému řeknete, co nestavět a co ještě není rozhodnuté, se zeptá místo hádání.
Jak na to v Claude Code, Codexu a Cursoru
Všechny tři umí dokumenty napsat a každý má pro krok plánování plan mode: plan mode v Claude Code, plan mode v Codexu a plan mode v Cursoru.
Aby byla revize automatická, dejte do CLAUDE.md nebo AGENTS.md jedno pravidlo: po napsání specifikace nebo plánu ji pošli přes request_review do DotMD a čekej. Agent se pak po každém dokumentu zastaví a čeká na vaše komentáře nebo schválení, bez spotřeby tokenů. DotMD umí pravidlo přidat za vás: viz CLAUDE.md a AGENTS.md.
Revize, která škáluje
Chat je špatné místo na revizi dokumentu. Specifikaci raději čtete vykreslenou v DotMD, vyberete chybný úsek a stisknete ⌥⌘M. Komentář je svázaný se svými řádky, takže agent přesně ví, co myslíte. Všechny komentáře můžete napsat nejdřív a poslat je naráz.
Když je agent opraví, každá změna je v souboru vidět: starý text červeně, nový zeleně, vedle komentáře, na který odpovídá. Každou Accept nebo Reopen. DotMD také vypíše změny, o které nikdo nežádal. Viz Kontrola změn.
Pro druhý názor nechte nejdřív revidovat jiného agenta. Specifikace napsaná v Claude Code a okomentovaná Codexem k vám dorazí s viditelnými mezerami už označenými a vy rozhodnete, které poznámky autor dostane: Agent kontroluje agenta.
Nástroje pro vývoj řízený specifikací
- Obyčejný Markdown v repozitáři. Složka
docs/specsa šablona výše je kompletní nastavení. - Plan mode. Vlastní způsob každého agenta, jak plánovat dřív, než staví.
- GitHub Spec Kit. Open-source sada nástrojů, která vašemu agentovi dává příkazy pro každý krok a píše za vás
spec.md,plan.mdatasks.md: GitHub Spec Kit.
Ať zvolíte cokoli, dokumenty jsou soubory Markdown a DotMD přečte kterýkoli z nich.
Dotazy k vývoji řízenému specifikací
Je vývoj řízený specifikací to samé co plan mode?
Plan mode je jeho jeden krok: plán před kódem. Vývoj řízený specifikací přidává specifikaci před plán a revizi v každém kroku.
Potřebuji zvláštní nástroj?
Ne. Specifikace jsou soubory Markdown v repozitáři a napsat je umí kterýkoli agent. GitHub Spec Kit přidává hotové příkazy.
Kde specifikace žijí?
V repozitáři, vedle kódu, takže jsou verzované a agent je může znovu přečíst.
Stojí DotMD za tohle něco?
Čtení specifikací je zdarma. Komentáře a revize s agenty potřebují DotMD Reviewer; viz ceník.