4 choses que votre orchestrateur de code Claude doit avoir pour être utile

Si vous construisez des agents d'orchestration (des agents qui gèrent d'autres agents) avec Claude Code, quatre composants distinguent un outil utile d'un outil chaotique. Voici ce que j'ai appris après des mois à les construire.

1. Un document de mission

Ne laissez pas votre orchestrateur se reposer sur l'intelligence par défaut du modèle. Rédigez un « document de mission » — une description de poste qui définit quoi faire, comment le faire et quand escalader. Pour un orchestrateur de rapports de bugs, cela pourrait être :

• Vérifier les e-mails avec « feedback client » dans l'objet
• Créer un ticket localement
• Lancer un agent enfant pour reproduire le bug et implémenter un correctif en utilisant le génie logiciel composé (ou un autre plugin comme superpowers ou GSD)
• M'alerter une fois prêt pour la QA

Vous n'intervenez qu'à l'étape 4. Dans le meilleur des cas, cela vous fait gagner du temps ; dans le pire, le code est jeté.

2. Un battement de cœur (boucle)

Un orchestrateur sans boucle n'est qu'un script à usage unique. La vraie puissance réside dans la cadence — relire le document de mission selon un calendrier (toutes les 10 minutes, toutes les heures, selon vos besoins). La plupart des CLI d'agents offrent une primitive de boucle ou de cron. À chaque tick, l'orchestrateur vérifie les nouvelles tâches, suit l'avancement des tâches existantes et agit selon ce que la mission dicte.

3. Communication inter-agents

Votre orchestrateur détient un contexte que vous n'avez pas chargé dans les enfants. Il peut répondre à leurs questions, coordonner des approches entre eux, ou lancer des relectures adversariales où un agent vérifie le travail d'un autre. L'implémentation peut être simple : un fichier markdown partagé avec des règles structurées, un outil de passage de messages, ou un système de canal secondaire. Le mécanisme importe moins que l'existence du canal.

4. Contrôle vérifiable

Construisez votre orchestrateur pour produire des enregistrements : ce qu'il a décidé, ce qu'il a lancé, ce que les enfants ont produit. Vous devez pouvoir plonger dans n'importe quel agent enfant, revoir son travail et l'interrompre à tout moment. La visibilité sur tout est le seul moyen d'être confiant dans le résultat — vous êtes responsable de tout.

Ces principes s'appliquent que vous utilisiez l'outil présenté dans la vidéo originale ou tout autre outil d'agent. Vous pouvez construire un orchestrateur avec ce que vous utilisez déjà.