Planmodus gebruiken

Deze gids laat zien hoe je een gestructureerd plan uit een agent krijgt voordat hij ook maar een regel code schrijft.

In planmodus doet de agent alleen-lezen onderzoek en levert hij precies één ding op: een getypeerd plan — een afhankelijkheidsgraaf van stappen die je goedkeurt, waarna Control Center hem omzet in echt werk. Gebruik het wanneer je de omvang van een wijziging wilt zien, de stappen uitgesplitst wilt krijgen, of risico’s en afhankelijkheden benoemd wilt hebben voordat er iets wordt aangeraakt.

Een ruimte omzetten naar planmodus

Elk van deze zet de modus van de ruimte om, en de wijziging wordt opgeslagen:

Kies Plan in de modusvervolgkeuzelijst helemaal links in de werkbalk van de composer
Druk op Shift+Tab
Stuur /plan. Een kaal /plan zet de modus alleen scherp; /plan <request> zet hem scherp en stuurt de rest als je bericht

/plan reist nooit als tekst mee — het commando zet de opgeslagen modus, en dat is de autoriteit die het toolaanbod, de modusvoorinstelling en de prompt allemaal lezen. De modus geldt dus voor deze beurt en elke beurt daarna, totdat je hem terugzet.

De modus wordt op de ruimte opgeslagen, dus dezelfde agent kan hier in planmodus zitten en elders in agentmodus.

Wat de agent oplevert

Hij doet alleen-lezen onderzoek — geheugen, de code-index, bestanden
Hij roept submit_plan één keer aan, met een goal plus nodes; elke node draagt een stabiele key, een title, een description en de nodesleutels waarvan hij dependsOn (dat is juist wat onafhankelijk werk parallel laat lopen)
Hij stopt

De tool valideert de graaf — dubbele sleutels, losse afhankelijkheden, cycli — en geeft overtredingen terug die de agent moet oplossen, in plaats van een kapot plan te accepteren.

Het plan verschijnt in het gesprek als een compacte rij met het doel, de status en het aantal stappen. Plan Studio — de afhankelijkheidsgraaf, de inspecteur per node en de kostenschatting — opent als een tab naast het gesprek: druk op Openen in de rij, of wacht gewoon, want een plan dat binnen 30 seconden binnenkomt terwijl je naar het gesprek kijkt, opent zijn tab vanzelf.

Wanneer het verzoek dubbelzinnig is, kan een plan-agent pauzeren en je met de tool ask_user tot drie blokkerende vragen stellen. Die tekent een formulier in het gesprek — opties of vrije tekst — en de run blokkeert totdat je antwoordt. De tool zit op leesniveau, dus hij overleeft het alleen-lezen aanbod van de planmodus, en hij is vrijgesteld van de goedkeuringswrapper (een prompt vóór een prompt zou gesloten vallen wanneer er geen goedkeurder is verbonden, waardoor de agent het stellen van de vraag zelf wordt ontzegd).

Hij heeft een ruimte nodig om in te tekenen, dus een one-shot-dispatch zonder gesprek krijgt hem niet. De scope, de doelrepo en de acceptatiecriteria al in je eerste bericht zetten, is nog altijd sneller dan een heen-en-weertje.

Proza is hier geen resultaat. Een run die eindigt zonder submit_plan aan te roepen, plaatst een zichtbare regel “Ended without submitting a plan (no submit_plan call).” in het gesprek en markeert de run als eentje die zijn resultaat heeft gemist. De status van de run blijft bewust completed — dat laat de statusmachines van pipelines en tickets ongemoeid — dus lees de regel, niet de statusbadge.

Het plan goedkeuren

Druk in de rij van het plan in het gesprek op Goedkeuren en uitvoeren. Druk in de goedkeuringsbalk van Plan Studio op Plan goedkeuren (of op Afwijzen ernaast; goedkeuren is uitgeschakeld zolang de graaf een validatiefout heeft).

Daarna:

Control Center compileert het plan tot een orkestratie en materialiseert die — de tickets en de run. Bij deze stap is geen model betrokken; hij is deterministisch
Het plan wordt uitgevoerd als de agent die het heeft geschreven. Of er nog iemand anders bij komt, is aan die agent op het moment van uitvoering — hij kan een stap met delegate_task aan een beter geschikte teamgenoot geven, binnen de delegatiedieptelimiet van de werkruimte
Het doel van het plan wordt het doel van het gesprek en het werk loopt in datzelfde gesprek: elke stap plaatst wat de agent is gevraagd en streamt zijn beurt terug, zodat je het volgt (en een beurt kunt stoppen) waar je al bent
De doelrij in het Algemeen-zijpaneel van het gesprek (onder Taken) toont de voortgang van de run als settled/total en de stopknop; Plan Studio toont de status per node op de graaf en annuleert daar ook

Blijven doorwerken zonder goed te keuren

Als je liever in dit gesprek blijft dan het plan goed te keuren, kan de agent exit_plan_mode aanroepen. Dat is de enige toegestane uitweg: hij opent een duurzame goedkeuringsaanvraag die aan het gesprek is gekoppeld en geeft pending terug — de ruimte blijft in planmodus en de agent mag niet handelen. Zodra de aanvraag is goedgekeurd, zet de volgende exit_plan_mode-aanroep van de agent de ruimte van planmodus naar agentmodus en worden zijn muterende tools ontgrendeld. Bij een afwijzing kan hij een nieuwe aanvraag openen voor een herzien plan.

Om planmodus te verlaten, wissel je de vervolgkeuzelijst van de composer (of Shift+Tab), of keur je het ingediende plan goed. exit_plan_mode opent een duurzame goedkeuring die met de MCP-tool decide_approval wordt beslist. De beveiligingsoverlay voor geblokkeerde toolaanroepen is een andere, in-memory wachtrij en bevat geen plan-uitstapverzoeken.

Planmodus in een pipelinestap

Een pipelinenode messaging.createSpace leest de gespreksmodus uit de extra mode van de nodeconfig — extras['mode']: 'plan'. De sleutel moet exact overeenkomen: elke andere spelling, ook conversationMode of dispatchMode, wordt stil genegeerd en de ruimte valt terug op de standaardwaarde van de body, namelijk reviewmodus, niet chat. Een stap promptAgent voegt zich bij een ruimte die hij niet zelf heeft gemaakt en past de rechten ervan niet aan. De keuzelijst Verzendmodus (allParallel / manager) in de nodeconfiguratie-editor is voor Team dispatch-nodes. Stel de gespreksmodus in met extras['mode'] op een sjabloon dat de ruimte opent, of via de API op de config van die node.