Claude Code plan mode: kdy stačí týmu?

Plan mode v Claude Code donutí Clauda projít kód a navrhnout plán dřív, než cokoli upraví. Plán schválíte a teprve pak začnou úpravy. Pro jednoho vývojáře v jedné session to často stačí. V týmu ne, protože plán žije v jedné session na jednom notebooku a nikdo další ho nemůže zreviewovat ani později zkontrolovat.

Plan mode proto používáme na koncept a plán držíme tam, kde tým pracuje: v GitHub issue, s akceptačními kritérii, na která reviewer odpoví ano, nebo ne. Než náš agent cokoli postaví, kontrola jen pro čtení ověří předpoklad z issue proti kódu.

Jak plan mode v Claude Code funguje?

Plan mode je jeden z režimů oprávnění. Podle dokumentace k režimům Claude čte soubory, spouští shellové příkazy na průzkum a píše plán, ale zdrojový kód neupraví, dokud plán neschválíte. Postup:

Schválením session plan mode opustí a Claude začne upravovat. Soubor s plánem se uloží do ~/.claude/plans/, pokud nenastavíte plansDirectory.

Vlastní průvodce náklady od Anthropicu doporučuje plan mode na složité úkoly, protože špatný směr odhalený před úpravami vyjde levněji než ten odhalený po nich.

Kde plan mode v týmu nestačí?

Plan mode odpovídá na otázku „rozumí teď Claude tomu, co chci“. Tým potřebuje odpovědi na tři další:

• Kdo další plán viděl? Žije v jedné session. Kolega, který práci zítra převezme, ani reviewer pull requestu nikdy neuvidí, na čem jste se dohodli.
• Platil předpoklad? Plán stojí na tom, co vývojář napsal. Když issue tvrdí „export zahazuje prázdné řádky“ a kód je už zvládá, plán opraví chybu, která neexistuje.
• Podle čeho poznáme, že je hotovo? Plán vyjmenuje kroky. Reviewer potřebuje kritéria, ideálně každé doložené testem.

Nejsou to soupeři. Plan mode je dobrý způsob, jak issue napsat.

Jak plánujeme my?

Každý úkol je GitHub issue s typem a povinným výstupem:

Issue říká, co dodat. Kdo ho vezme, člověk nebo náš AI agent, chybějící výstup nebo akceptaci doplní jako vyslovený předpoklad, místo aby potichu hádal.

Jak vypadá kontrola READY?

Než naše agentní smyčka cokoli postaví, spustí krok READY. Není to plan mode. Je to samostatné volání jen pro čtení s typovanou odpovědí:

claude -p "$(cat ready.md; cat issue.md)" \
  --permission-mode default --permission-prompts none \
  --tools "Read,Grep,Glob,WebFetch" \
  --json-schema "$(cat ready.schema.json)" --output-format json --max-turns 40

Schéma vtlačí odpověď do polí: ready, done_when (kritéria, na která reviewer odpoví ano, nebo ne), verify (jak se každé dokáže), understood, premise a verifiable, které je test, nebo human. Když nepřijde platný objekt, počítá se to jako selhání, nikdy jako výchozí hodnota.

Stavební session pak dostane tato kritéria jako zadání. Běží s --disallowedTools AskUserQuestion ExitPlanMode: v té chvíli je plán uzavřený, takže agent se nemůže zastavit a ptát ani se vrátit k plánování. Celá smyčka od READY po pull request je v článku Harness engineering v praxi.

Co kontrola předpokladu zachytí a plan mode ne?

Plán udělaný v dobré víře na nepravdivém předpokladu. Prompt pro READY modelu říká, ať každé tvrzení issue o současném chování ověří proti repozitáři a ocituje file:line. Když tvrzení neplatí, odpověď začíná REFUTED: a vypíše, co už neplatí a co ještě ano.

Co se stane dál, záleží na tom, kolik zbývá:

• Nezbývá nic. Issue jde zpátky člověku s důkazy a návrhem ho zavřít.
• Část je vyvrácená. Smyčka navrhne v issue opravený rozsah a před stavbou čeká, až člověk odpoví OK.
• Ověřit to může jen člověk. Když je verifiable rovno human, agent napíše, na co se musí někdo podívat, než začne.

Přesně tuhle mezeru kontrola předpokladu zavře. Plánování je levné. Drahé je naplánovat špatnou věc a až do review to vypadá úplně jako pokrok.

Kdy plan mode stačí?

Docela často. Tímhle rozhodnete, jestli plán musí opustit session:

Plan mode sedí na krátké, lokální změny, kde jste jediný čtenář. Všechno ostatní si zaslouží plán, který tým přečte. Jak se ze zapsané specifikace stane smlouva mezi lidmi a agenty, je v článku Spec-driven development s AI agenty.

Chcete plány, které přežijí session?

Smlouvy v issues, kontroly READY a agentní smyčku nastavujeme přímo v repozitářích týmu v rámci služby AI-native SDLC pro vývojové týmy. AI dnes píše veškerý náš kód a za výsledek ručí senior. Od roku 2023 jsme dodali 15+ produkčních projektů.

Ozveme se do dvou pracovních dnů a společně vybereme, co vyřešíme jako první.

Pokud si chcete nejdřív promluvit, domluvte si meeting na 15 minut s Filipem.

Kdo ve vašem týmu by dnes našel včerejší plán?

Časté otázky

Co je plan mode v Claude Code?

Režim oprávnění, ve kterém Claude čte soubory a spouští průzkumné příkazy, pak navrhne plán a zdrojový kód neupravuje. Úpravy zůstanou zablokované, dokud plán neschválíte.

Jak zapnout plan mode v Claude Code?

Přepněte se na něj klávesami Shift+Tab, začněte jeden prompt příkazem /plan, nebo spusťte session přes claude --permission-mode plan.

Můžu plán upravit, než Claude začne?

Ano. Ctrl+G otevře navržený plán ve vašem editoru, nebo zvolte, že plánujete dál, a řekněte Claudovi, co změnit.

Kam Claude Code ukládá plány?

Standardně do ~/.claude/plans/, případně do adresáře z nastavení plansDirectory. V obou případech na jeden počítač, a proto týmový plán patří i do issue.

Je plan mode totéž co spec-driven development?

Ne. Plan mode je funkce jedné session. Spec-driven development drží plán jako zapsaný dokument, který reviewuje celý tým a který umí ověřit kontroly. Plan mode na něj umí připravit koncept.