Utiliser le mode plan

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

En mode plan, l’agent fait ses recherches en lecture seule et son unique livrable est un plan typé : un graphe de dépendances d’étapes que vous approuvez, que Control Center compile ensuite en vrai travail. Utilisez-le quand vous voulez voir l’ampleur d’une modification, faire décomposer les é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

Chacune de ces actions bascule le mode de l’espace, et la modification est enregistrée :

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

/plan ne circule jamais comme texte — il définit le mode enregistré, qui est la référence 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 changiez.

Le mode est enregistré sur l’espace, de sorte que le même agent peut être en mode plan ici et en mode agent ailleurs.

Ce que l’agent produit

Il fait ses recherches en lecture seule — la mémoire, l’index de code, les fichiers
Il appelle submit_plan une 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 pendantes, cycles — et renvoie les violations à l’agent pour qu’il les corrige plutôt que d’accepter un plan brisé.

Le plan apparaît dans la conversation sous forme de ligne compacte montrant 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.

Quand la demande est ambiguë, un agent en mode plan peut faire une pause 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 se bloque jusqu’à ce que vous répondiez. L’outil est de palier lecture, donc il survit à la surface en lecture seule du mode plan, et il est exempté de l’enveloppe d’approbation (une invite devant une invite échoue en mode fermé lorsqu’aucun approbateur n’est connecté, refusant à l’agent le fait même de poser la question).

Il a besoin d’un espace pour s’afficher ; un lancement ponctuel sans conversation ne l’obtient donc pas. Mettre d’emblée l’ampleur, le dépôt cible et les critères d’acceptation dans 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 une ligne visible « Ended without submitting a plan (no submit_plan call). » dans la conversation 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 — alors lisez la ligne, pas la pastille 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 à 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 à cette étape ; elle est déterministe
Le plan s’exécute sous l’agent qui l’a écrit. C’est à cet agent de décider à l’exécution s’il faut faire intervenir quelqu’un d’autre — il peut delegate_task une étape à un coéquipier mieux adapté, dans les limites 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 diffuse son tour en retour, de sorte que vous le suivez (et pouvez arrêter un tour) là où vous êtes déjà
La ligne de l’objectif dans le panneau latéral Général de la conversation (sous Tâches) porte la progression de l’exécution sous la forme settled/total et son bouton d’arrêt ; Plan Studio affiche l’état de chaque nœud sur le graphe et y permet aussi l’annulation

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 reconnue : elle 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 de l’agent fait passer l’espace du mode plan au mode agent et déverrouille ses outils de mutation. Un rejet lui permet d’ouvrir une nouvelle demande contre un plan révisé.

Pour quitter le mode plan, changez le menu déroulant du compositeur (ou Shift+Tab), ou approuvez le plan soumis. exit_plan_mode ouvre une approbation durable décidée avec l’outil MCP decide_approval. La surcouche de garde-fous des appels d’outils bloqués est une autre file, en mémoire, et ne porte 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 depuis 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 silencieusement et la salle retombe sur la valeur par défaut du corps, qui est le mode révision, et non le clavardage. Une étape promptAgent se joint à une salle qu’elle n’a pas créée et ne redéfinit pas ses autorisations. La liste Mode de répartition de l’éditeur de configuration des nœuds (allParallel / manager) sert aux 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 par l’API.