Používejte režim plánu

Tenhle návod ukáže, jak z agenta dostat strukturovaný plán, než napíše jakýkoli kód.

V režimu Plan agent zkoumá jen pro čtení a jediným výstupem je typovaný plán: graf závislostí kroků, který schválíš a Control Center ho pak zkompiluje do skutečné práce. Použij ho, když chceš vidět rozsah změny, mít kroky rozložené, nebo mít rizika a závislosti pojmenované, než se na cokoli sáhne.

Přepni prostor do režimu Plan

Každá z těchto možností přepne režim prostoru a změna se uloží:

• Vyber Plan v rozbalovací nabídce režimu úplně vlevo na liště composeru
• Stiskni Shift+Tab
• Pošli /plan. Holé /plan režim jen zapne; /plan <request> ho zapne a zbytek pošle jako tvou zprávu

/plan nikdy neputuje jako text. Nastaví uložený režim a právě podle něj se řídí plocha nástrojů, preset strážce i prompt. Režim proto platí pro tenhle tah i pro každý další, dokud ho nepřepneš zpátky.

Režim je uložený na prostoru, takže stejný agent může být tady v režimu Plan a jinde v režimu agenta.

Co agent doručí

1. Zkoumá jen pro čtení: paměť, index kódu, soubory
2. Zavolá submit_plan jednou, s goal a nodes. Každý uzel nese stabilní key, title, description a klíče uzlů, na kterých dependsOn (právě to nechá nezávislou práci běžet paralelně)
3. Zastaví se

Nástroj graf ověří (duplicitní klíče, visící závislosti, cykly) a vrátí porušení, která má agent opravit, místo aby přijal rozbitý plán.

Plán se objeví v konverzaci jako kompaktní řádek s cílem, jeho stavem a počtem kroků. Plan Studio (graf závislostí, inspektor jednotlivých uzlů a odhad nákladů) se otevře jako záložka vedle konverzace: na řádku stiskni Otevřít, nebo jen počkej. Plán, který dorazí do 30 sekund, zatímco konverzaci sleduješ, si záložku otevře sám.

Záruka jen pro čtení je strukturální a platí jen u vestavěného harnessu

Vlastní harness Control Center sestaví registr nástrojů agenta ze specifikace plochy režimu Plan, takže nástroj na zápis, úpravu nebo příkaz, který by šlo zavolat, prostě neexistuje. Omezení není pokyn v promptu, ze kterého by se model uměl vykroutit.

Adaptér Claude Code takové filtrování nedostane: režim k němu dorazí jako žádost, kterou jeho vlastní runner může a nemusí dodržet, a Control Center z něj vidí jen volání mcp__*. Odznak vynucení vedle rozbalovací nabídky režimu se objeví právě v tomhle případě.

Agent se tě může zeptat na upřesnění

Když je zadání nejednoznačné, agent v režimu Plan se umí zastavit a položit až tři blokující otázky nástrojem ask_user. V konverzaci vykreslí formulář (možnosti, nebo volný text) a běh stojí, dokud neodpovíš. Nástroj je na úrovni čtení, takže ho plocha jen pro čtení v režimu Plan nechá, a je vyňatý z obalu schválení (výzva před výzvou by bez připojeného schvalovatele selhala uzavřeně a agentovi upřela samotné zeptání).

Potřebuje prostor, kam se vykreslí, takže ho one-shot odeslání bez konverzace nedostane. Když rozsah, cílový repozitář a kritéria přijetí napíšeš už do první zprávy, je to pořád rychlejší než kolečko otázek a odpovědí.

Próza tady výstupem není. Běh, který skončí bez volání submit_plan, vloží do konverzace viditelný řádek „Ended without submitting a plan (no submit_plan call).“ a běh označí, že výstup nedodal. Stav běhu schválně zůstane completed. Tím se nesáhne na stavové automaty pipeline ani ticketů, takže čti ten řádek, ne odznak stavu.

Schval plán

Na řádku plánu v konverzaci stiskni Schválit a spustit. Na liště schválení v Plan Studio stiskni Schválit plán (vedle je Odmítnout; schválení je vypnuté, dokud má graf chybu ověření).

Pak:

1. Control Center plán zkompiluje do orchetrace a zmaterializuje ho, tedy tickety a běh. V tomhle kroku se nevolá žádný model. Je deterministický
2. Plán běží jako agent, který ho napsal. Jestli přizve někoho dalšího, rozhodne ten agent až za běhu: krok může přes delegate_task předat vhodnějšímu kolegovi, v rámci stropu hloubky delegace pracovního prostoru
3. Cíl plánu se stane cílem konverzace a práce běží v téže konverzaci: každý krok vloží zadání, které agent dostal, a streamuje jeho tah zpátky, takže ji sleduješ (a tah umíš zastavit) tam, kde už jsi
4. Řádek cíle v postranním panelu Obecné u konverzace (pod Úkoly) nese postup běhu jako settled/total a tlačítko Zastavit. Plan Studio ukazuje na grafu stav jednotlivých uzlů a zrušit jde i odtud

Pokračuj bez schválení

Když chceš v téhle konverzaci zůstat a plán neschvalovat, agent může zavolat exit_plan_mode. Je to jediný povolený odchod: otevře trvalou žádost o schválení navázanou na konverzaci a vrátí pending. Prostor zůstane v režimu Plan a agent nesmí jednat. Jakmile je žádost schválená, další volání exit_plan_mode přepne prostor z režimu Plan do režimu agenta a odemkne mu měnící nástroje. Odmítnutí mu dovolí otevřít novou žádost k upravenému plánu.

Z režimu Plan odejdeš přepnutím rozbalovací nabídky v composeru (nebo Shift+Tab), nebo tím, že schválíš odeslaný plán. exit_plan_mode otevře trvalé schválení, o kterém rozhodne nástroj MCP decide_approval. Překryv guardrailů pro zablokovaná volání nástrojů je jiná fronta, jen v paměti, a žádosti o odchod z režimu Plan nenosí.

Režim Plan v kroku pipeline

Uzel pipeline messaging.createSpace čte režim konverzace z extra mode v konfiguraci uzlu: extras['mode']: 'plan'. Shoda klíče je přesná. Jakékoli jiné znění, včetně conversationMode nebo dispatchMode, se potichu ignoruje a prostor spadne na výchozí hodnotu těla, což je režim review, ne chat. Krok promptAgent vstoupí do prostoru, který nezaložil, a oprávnění mu znovu nenastaví. Výběr Režim dispatch v editoru konfigurace uzlu (allParallel / manager) patří uzlům týmového odeslání. Režim konverzace nastav pomocí extras['mode'] na šabloně, která prostor otevírá, nebo na konfiguraci toho uzlu přes API.

Související návody

• Chatujte s agentem
• Používejte prostory
• Pracujte v Plan Studio
• Spusťte orchestaci

Související koncepty

• Režimy
• Orchestace