Chapitre 8.1 — Les subagents
⏱️ TL;DR — Un subagent, c’est Claude qui lance Claude : une instance secondaire, avec son propre contexte, à qui l’agent principal confie une tâche précise et qui renvoie un résultat — pas un fil de discussion. L’intérêt fondamental : isoler. La grosse exploration, l’analyse verbeuse, la revue indépendante se font « ailleurs », et ta session principale ne récupère que la conclusion. Il en existe des types (exploration, planification, généraliste, sur-mesure), chacun outillé pour son rôle.
🎯 Objectifs
- Définir un subagent et son contexte isolé.
- Connaître les principaux types et leur usage.
- Comprendre pourquoi « résultat, pas conversation » change la donne.
- Distinguer subagent et simple prompt.
Le principe : un contexte à part
Quand l’agent principal délègue, le subagent démarre avec un contexte frais, fait son travail (lire, chercher, analyser), et renvoie une synthèse. Tout le « bruit » de sa tâche (les 40 fichiers lus, les 2000 lignes de log) reste dans son contexte à lui — ta session principale ne voit que la conclusion.
C’est la clé de la gestion de contexte à l’échelle (5.2, 6.4) : au lieu de saturer ta session avec une exploration, tu la sous-traites. Le subagent absorbe le bruit ; tu récupères le signal.
💡 Réflexe d’architecte — Pense « délègue le bruit, garde le signal ». Toute tâche qui génère beaucoup de contexte pour produire peu de conclusion (explorer, analyser des logs, auditer des dépendances, chercher où est géré X) est un candidat parfait à la délégation. Tu paies un contexte jetable, tu gardes ta session pour décider.
« Résultat, pas conversation »
Différence essentielle avec un simple prompt : le subagent est orienté livrable. On ne « discute » pas avec lui en dix tours ; on lui confie un objectif, il exécute sa propre boucle (1.1), il renvoie un résultat. C’est pour ça qu’on lui donne des consignes de sortie claires : « renvoie les fichiers clés et le flux », « renvoie une liste de findings avec fichier:ligne ». Un subagent bien briefé, c’est un objectif + un format de retour.
Les types de subagents
Claude Code propose des types outillés pour des rôles différents. Les principaux :
| Type | Rôle | Outillage |
|---|---|---|
| Explore | recherche large en lecture seule | lit des extraits, localise, ne modifie rien |
| Plan | concevoir un plan d’implémentation | raisonne l’archi, ne code pas |
| general-purpose | tâche multi-étapes autonome | accès large aux outils |
sur-mesure (.claude/agents/) | un rôle que tu définis | outils + prompt système choisis |
- Explore : ton outil d’onboarding et de navigation (6.1, 6.4). Lecture seule = sans risque.
- Plan : pour faire concevoir une approche complexe à part, sans polluer ta session.
- general-purpose : le couteau suisse, pour une sous-tâche autonome de bout en bout.
- Sur-mesure : tu peux définir tes propres agents (un « relecteur sécurité », un « auditeur de perf ») dans
.claude/agents/, avec leurs outils et leur prompt. On y revient en 8.4 et en Partie 9/11.
📚 Aller plus loin — Les agents sur-mesure se déclarent dans
.claude/agents/(niveau projet ou utilisateur) : un fichier par agent, avec sa description, ses outils autorisés et son prompt système. C’est le même mécanisme que les types intégrés, mais spécialisé pour ton usage. Ta config actuelle n’en a aucun — un terrain à explorer une fois que tu sauras quels rôles tu délègues souvent.
Subagent ≠ juste « un autre prompt »
Un subagent a un coût (le lancer, le briefer, attendre sa synthèse) et une latence. Il n’est pas gratuit. Sa valeur vient de l’isolation et de la spécialisation — pas de « faire plus de choses ». Déléguer une micro-tâche triviale coûte plus que ça ne rapporte (8.2). On délègue ce qui mérite un contexte séparé.
🧭 Sur TaskFlow — On a déjà utilisé Explore implicitement (P6) pour cartographier. En 8.4, on déléguera deux choses : une exploration (« comment TaskFlow gère les erreurs, synthèse ») et une revue indépendante d’une feature (un regard neuf, non biaisé par la session qui l’a écrite). Deux usages canoniques : absorber le bruit, obtenir un regard neuf.
✏️ Exercices
Exercice 1 — Signal vs bruit. Liste 4 tâches de ton quotidien. Pour chacune, estime « contexte généré » vs « conclusion utile ». Lesquelles ont un fort ratio bruit/signal (donc à déléguer) ?
✅ Solution
Fort ratio bruit/signal (à déléguer) : explorer un module, analyser des logs, auditer les dépendances, chercher tous les usages d’une API. Faible ratio (à garder) : éditer un fichier connu, corriger un typo, ajouter un champ. Le subagent brille quand il faut beaucoup lire pour conclure peu.
Exercice 2 — Brief de sortie. Écris le brief d’un subagent Explore pour « comprendre la gestion d’auth d’un repo », en précisant le format de retour attendu (fichiers clés + flux, pas le code).
✅ Solution
Un bon brief de subagent = objectif + format de sortie explicite : « renvoie les fichiers clés, le flux d’authentification, et où sont vérifiés les rôles — pas le code entier ». Sans consigne de sortie, le subagent peut te renvoyer trop (ou pas assez). Le format de retour fait partie du brief.
🧠 Quiz de révision
1. Quel est l’intérêt fondamental d’un subagent ?
L’isolation : il travaille dans son propre contexte et ne renvoie qu’une conclusion. Le bruit de sa tâche (fichiers lus, logs) reste chez lui ; ta session principale récupère le signal.
2. « Résultat, pas conversation » : qu’est-ce que ça implique pour le brief ?
Qu’on lui donne un objectif + un format de sortie clairs (« renvoie X sous la forme Y »), pas un dialogue en dix tours. Il exécute sa boucle et livre.
3. Cite deux types de subagents et leur rôle.
Par exemple : Explore (recherche large en lecture seule, sans risque) et Plan (concevoir une approche sans coder). Aussi : general-purpose (tâche autonome), sur-mesure (rôle défini par toi dans .claude/agents/).
4. Un subagent est-il gratuit ?
Non : le lancer, le briefer et attendre sa synthèse a un coût et une latence. Sa valeur vient de l’isolation et de la spécialisation, pas de « faire plus ». On ne délègue pas une micro-tâche triviale.
5. Quel type pour cartographier un repo sans rien casser ?
Explore : recherche large en lecture seule. Idéal pour l’onboarding et la navigation (P6), sans aucun risque de modification.
Chapitre suivant : Quand déléguer (et quand pas) — le calcul qui évite de sur- ou sous-déléguer.