Claude Code plan mode: kedy tímu stačí?

Claude Code plan mode prinúti Clauda najprv preskúmať kód a navrhnúť plán, až potom niečo upraví. Plán schválite a až vtedy sa začne meniť kód. Pre jedného vývojára v jednej session to často stačí. V tíme nie, lebo plán žije v jednej session na jednom notebooku a nikto iný ho nemôže skontrolovať ani si ho neskôr overiť.

Plan mode preto používame na návrh a plán držíme tam, kde tím pracuje: v GitHub issue, s kritériami prijatia, na ktoré reviewer odpovie áno alebo nie. Skôr než náš agent čokoľvek postaví, kontrola len na čítanie overí predpoklad issue voči kódu.

Ako funguje plan mode v Claude Code?

Plan mode je jeden z režimov oprávnení. Podľa dokumentácie režimov Claude číta súbory, spúšťa príkazy na prieskum a píše plán, ale váš kód neupraví, kým ho neschválite. Postup:

Schválenie prepne session z plan mode a Claude začne upravovať. Plán sa uloží do ~/.claude/plans/, ak nenastavíte plansDirectory.

Aj sprievodca nákladmi od Anthropicu odporúča plan mode pri zložitých úlohách, lebo zlý smer odhalený pred úpravami je lacnejší ako ten, ktorý sa ukáže až po nich.

Kde plan mode v tíme nestačí?

Plan mode odpovedá na otázku „rozumie Claude, čo práve chcem“. Tím potrebuje odpovede na tri ďalšie:

• Kto ešte plán videl? Žije v jednej session. Kolega, ktorý prácu zajtra preberie, ani reviewer pull requestu nikdy neuvidí, na čom ste sa dohodli.
• Platil vôbec predpoklad? Plán stojí na tom, čo vývojár napísal. Ak issue tvrdí „export vynecháva prázdne riadky“ a kód ich už rieši, plán opraví chybu, ktorá neexistuje.
• Ako spoznáme, že je hotovo? Plán vymenúva kroky. Reviewer potrebuje kritériá, ideálne každé dokázané testom.

Nie sú to súperi. Plan mode je dobrý spôsob, ako issue napísať.

Ako plánujeme namiesto toho?

Každá úloha je GitHub issue s typom a povinným výstupom:

Issue hovorí, čo dodať. Kto ho zoberie, človek alebo náš AI agent, doplní chýbajúci výstup alebo kritériá ako vyslovený predpoklad, namiesto tichého hádania.

Ako vyzerá kontrola READY?

Skôr než naša agentová slučka čokoľvek postaví, spustí krok READY. Nie je to plan mode. Je to samostatné volanie len na čítanie s typovanou odpoveďou:

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čí odpoveď do polí: ready, done_when (kritériá, na ktoré reviewer povie áno alebo nie), verify (ako sa každé dokáže), understood, premise a verifiable, ktoré je test alebo human. Keď nepríde platný objekt, počíta sa to ako zlyhanie, nikdy ako predvolená hodnota.

Stavebná session potom dostane tieto kritériá ako zadanie. Beží s --disallowedTools AskUserQuestion ExitPlanMode: plán je v tej chvíli uzavretý, takže agent sa nemôže zastaviť s otázkou ani sa vrátiť do plánovania. Celá slučka od READY po pull request je v článku Harness engineering v praxi.

Čo kontrola predpokladu odhalí a plan mode nie?

Plán urobený v dobrej viere na nepravdivom predpoklade. Prompt pre READY káže modelu overiť každé tvrdenie issue o súčasnom správaní voči repozitáru a citovať file:line. Ak tvrdenie neplatí, odpoveď začína REFUTED: a vymenuje, čo už neplatí a čo stále áno.

Čo nasleduje, závisí od toho, koľko ostalo:

• Nič na práci. Issue sa vráti človeku s dôkazmi a návrhom zavrieť ho.
• Časť je vyvrátená. Slučka navrhne na issue opravený rozsah a čaká, kým človek odpíše OK, až potom stavia.
• Overiť to vie len človek. Keď je verifiable nastavené na human, agent pred začiatkom povie, čo sa musí niekto pozrieť.

Presne túto medzeru kontrola predpokladu zatvára. Plánovanie je lacné. Drahé je naplánovať nesprávnu vec, a to vyzerá presne ako pokrok, kým nepríde review.

Kedy plan mode stačí?

Veľmi často. Podľa tohto rozhodnete, či má plán opustiť session:

Plan mode sedí na krátke lokálne zmeny, pri ktorých ste jediný čitateľ. Všetko ostatné si zaslúži plán, ktorý prečíta tím. Ako sa z písanej špecifikácie stane dohoda medzi ľuďmi a agentmi, je v článku Spec-driven development s AI agentmi.

Chcete plány, ktoré prežijú session?

Dohody v issues, kontroly READY aj agentovú slučku nastavujeme priamo v repozitároch tímu v službe AI-native SDLC pre vývojové tímy. AI dnes píše všetok náš kód a za výsledok ručí senior. Od roku 2023 sme dodali 15+ produkčných projektov.

Ozveme sa do dvoch pracovných dní a spolu vyberieme, čo vyriešime ako prvé.

Ak sa chcete najprv porozprávať, dohodnite si meeting na 15 minút s Filipom.

Kto vo vašom tíme by dnes našiel včerajší plán?

Časté otázky

Čo je plan mode v Claude Code?

Režim oprávnení, v ktorom Claude číta súbory a spúšťa prieskumné príkazy a potom navrhne plán bez úpravy vášho kódu. Úpravy ostávajú zablokované, kým plán neschválite.

Ako zapnúť plan mode v Claude Code?

Stlačte Shift+Tab, kým sa naň neprepnete, napíšte /plan pred jeden prompt alebo spustite session cez claude --permission-mode plan.

Dá sa plán upraviť, skôr než Claude začne?

Áno. Ctrl+G otvorí navrhnutý plán vo vašom editore, alebo zvoľte pokračovanie v plánovaní a povedzte Claudovi, čo zmeniť.

Kam Claude Code ukladá plány?

Predvolene do ~/.claude/plans/, prípadne do priečinka z nastavenia plansDirectory. V oboch prípadoch je to jeden počítač, preto tímový plán patrí aj do issue.

Je plan mode to isté ako spec-driven development?

Nie. Plan mode je funkcia jednej session. Spec-driven development drží plán ako zapísaný dokument, ktorý reviewuje celý tím a ktorý vedia overiť kontroly. Plan mode na to môže pripraviť prvý návrh.