Utiliser le mode plan

Ce guide explique comment obtenir d’un agent un plan structuré avant qu’il n’écrive la moindre ligne de code.

En mode plan, l’agent mène ses recherches en lecture seule et son seul livrable est un plan typé : un graphe de dépendances d’étapes que vous approuvez, que Control Center compile ensuite en travail réel. Utilisez-le lorsque vous voulez voir la portée d’une modification, obtenir le détail des étapes, ou faire nommer les risques et les dépendances avant que quoi que ce soit ne soit touché.

Basculer un espace en mode plan

N’importe laquelle de ces actions bascule le mode de l’espace, et le changement est persisté :

Choisissez Plan dans le menu déroulant de mode à l’extrême gauche de la barre d’outils du compositeur
Appuyez sur Maj+Tab
Envoyez /plan. Un /plan seul arme le mode ; /plan <request> l’arme et envoie le reste comme votre message

/plan ne circule jamais comme du texte — il définit le mode stocké, qui est l’autorité que lisent la surface d’outils, le préréglage de garde-fous et le prompt. Le mode tient donc pour ce tour et pour tous les tours suivants, jusqu’à ce que vous le remettiez comme avant.

Le mode est stocké sur l’espace : un même agent peut donc être en mode plan ici et en mode agent ailleurs.

Ce que l’agent produit

Il effectue ses recherches en lecture seule — la mémoire, l’index de code, les fichiers
Il appelle submit_plan une seule fois, avec un goal et des nodes, chacun portant une key stable, un title, une description et les clés des nœuds dont il dependsOn (c’est ce qui permet au travail indépendant de s’exécuter en parallèle)
Il s’arrête

L’outil valide le graphe — clés en double, dépendances orphelines, cycles — et renvoie les violations pour que l’agent les corrige plutôt que d’accepter un plan cassé.

Le plan apparaît dans la conversation sous la forme d’une ligne compacte affichant l’objectif, son statut et le nombre d’étapes. Plan Studio — le graphe de dépendances, l’inspecteur de nœuds et l’estimation de coût — s’ouvre dans un onglet à côté de la conversation : appuyez sur Ouvrir sur la ligne, ou attendez simplement, car un plan qui arrive dans les 30 secondes pendant que vous regardez la conversation ouvre son onglet de lui-même.

Lorsque la demande est ambiguë, un agent en mode plan peut s’interrompre et vous poser jusqu’à trois questions bloquantes avec l’outil ask_user. Il affiche un formulaire dans la conversation — des options, ou du texte libre — et l’exécution reste bloquée jusqu’à votre réponse. L’outil est du palier lecture : il survit donc à la surface en lecture seule du mode plan, et il est exempté de l’enveloppe d’approbation (un prompt devant un prompt échouerait en mode fermé sans approbateur connecté, privant l’agent de l’acte même de demander).

Il lui faut un espace où s’afficher : une répartition ponctuelle sans conversation ne l’obtient donc pas. Regrouper la portée, le dépôt cible et les critères d’acceptation dès votre premier message reste plus rapide qu’un aller-retour.

La prose n’est pas un livrable ici. Une exécution qui se termine sans appeler submit_plan publie dans la conversation une ligne visible « Ended without submitting a plan (no submit_plan call). » et signale l’exécution comme ayant manqué à son livrable. Le statut de l’exécution reste délibérément completed — cela laisse intactes les machines à états des pipelines et des tickets — lisez donc la ligne, et non le badge de statut.

Approuver le plan

Depuis la ligne du plan dans la conversation, appuyez sur Approuver et lancer. Depuis la barre d’approbation de Plan Studio, appuyez sur Approuver le plan (ou sur Rejeter juste à côté ; l’approbation est désactivée tant que le graphe comporte une erreur de validation).

Ensuite :

Control Center compile le plan en une orchestration et la matérialise — les tickets et l’exécution. Aucun modèle n’intervient dans cette étape ; elle est déterministe
Le plan s’exécute en tant que l’agent qui l’a écrit. C’est à cet agent de décider, au moment de l’exécution, s’il fait intervenir quelqu’un d’autre — il peut delegate_task une étape à un coéquipier mieux adapté, dans la limite du plafond de profondeur de délégation de l’espace de travail
L’objectif du plan devient l’objectif de la conversation et le travail s’exécute dans cette même conversation : chaque étape publie ce qui a été demandé à l’agent et rediffuse son tour en flux, si bien que vous le suivez (et pouvez arrêter un tour) là où vous êtes déjà
La ligne d’objectif du panneau latéral Général de la conversation (sous Tâches) porte la progression de l’exécution sous la forme settled/total ainsi que son bouton d’arrêt ; Plan Studio affiche l’état de chaque nœud sur le graphe et permet aussi d’y annuler

Continuer à travailler sans approuver

Si vous préférez rester dans cette conversation plutôt que d’approuver le plan, l’agent peut appeler exit_plan_mode. C’est la seule sortie autorisée : l’appel ouvre une demande d’approbation durable liée à la conversation et renvoie pending — l’espace reste en mode plan et l’agent ne doit pas agir. Une fois la demande approuvée, le prochain appel à exit_plan_mode fait passer l’espace du mode plan au mode agent et débloque ses outils de mutation. Un refus lui permet d’ouvrir une nouvelle demande sur un plan révisé.

Pour quitter vous-même le mode plan, changez le menu déroulant du compositeur (ou Maj+Tab), ou approuvez le plan soumis. exit_plan_mode ouvre une approbation durable qui se décide avec l’outil MCP decide_approval. La superposition de garde-fous des appels d’outils bloqués est une autre file, en mémoire, et ne transporte pas les demandes de sortie du mode plan.

Le mode plan dans une étape de pipeline

Un nœud de pipeline messaging.createSpace lit le mode de conversation dans l’extra mode de la configuration du nœud — extras['mode']: 'plan'. La clé exige une correspondance exacte : toute autre graphie, y compris conversationMode ou dispatchMode, est ignorée en silence et le salon retombe sur la valeur par défaut du corps, à savoir le mode revue, et non le mode discussion. Une étape promptAgent rejoint un salon qu’elle n’a pas créé et ne modifie pas ses permissions. Le sélecteur Mode de répartition (allParallel / manager) de l’éditeur de configuration de nœud concerne les nœuds de répartition d’équipe. Définissez le mode de conversation avec extras['mode'] sur un modèle qui ouvre l’espace, ou sur la configuration de ce nœud via l’API.