Subagents Codex : faire du fan-out propre sans polluer le contexte

Les subagents donnent vite l’impression d’avoir une équipe.

Le piège, c’est que l’équipe travaille parfois sur un problème qui ne demandait qu’une lecture attentive. Tu récupères quatre réponses, trois niveaux de confiance, des doublons, et tu dois faire l’intégration mentale toi-même.

Le fan-out propre commence par une question simple : “est-ce que ces recherches sont indépendantes ?“

1. Quand ça vaut le coup

Utilise des subagents quand les branches de travail peuvent avancer sans se marcher dessus.

Bons cas :

• comparer trois approches d’architecture;
• inspecter cinq dossiers indépendants;
• vérifier sécurité, tests, performance et UX sur une même PR;
• préparer des angles éditoriaux à partir de plusieurs sources officielles.

Mauvais cas :

• corriger une fonction sous tes yeux;
• écrire un seul article court;
• faire une recherche qui dépend fortement du résultat précédent;
• déléguer juste parce que la tâche est floue.

La parallélisation ne compense pas un mauvais cadrage.

2. Donne une sortie normalisée

Le parent doit pouvoir comparer les résultats. Sinon, tu reçois des formats différents et tu perds le bénéfice.

Prompt utile :

Spawne 4 subagents.
Chaque subagent doit répondre avec :
- constat principal;
- preuves avec chemins ou sources;
- risque;
- recommandation;
- confiance: faible, moyenne ou haute.
Attends tous les résultats puis consolide.

Cette structure force les agents à produire des éléments actionnables, pas des mini-essais.

3. Garde le parent comme décideur

Un subagent explore. Le parent décide.

Ne demande pas à chaque agent de proposer une modification complète du même fichier. Tu vas créer des recommandations incompatibles. Demande plutôt :

• “trouve les risques”;
• “liste les fichiers concernés”;
• “vérifie si une contrainte existe”;
• “propose un angle, pas le patch final”.

Le patch final doit rester consolidé dans la session principale.

4. Limite la profondeur

Le fan-out récursif est tentant, mais il explose vite. Un agent qui spawn trois agents, qui spawnent chacun trois agents, ce n’est pas une équipe. C’est une facture et un arbre difficile à relire.

Pour un blog, un seul niveau suffit :

• parent : décide du sujet;
• agents : recherchent sources, angles, conflits;
• parent : rédige ou choisit.

5. Checklist avant de spawn

Avant de demander des subagents, vérifie :

• les tâches sont indépendantes;
• chaque agent a une question claire;
• la sortie est normalisée;
• le parent garde la décision finale;
• le coût en tokens vaut le gain de temps.

Si un point manque, reste en mono-agent.

Sources

• OpenAI Codex - Subagents
• OpenAI Codex - Best practices