Sub-agents (Task tool)

Qu’est-ce qu’un sub-agent ?

Dans Claude Code, le Task tool permet de lancer un sous-agent — une instance séparée du LLM avec son propre contexte vierge. Le sub-agent ne voit rien de la conversation parent : ni l’historique, ni les fichiers déjà lus, ni les décisions prises.

Point clé : Un sub-agent est comme un collègue qui entre dans la pièce. Il ne sait rien de ce que tu as fait avant. Tu dois le briefer explicitement : objectif, contraintes, format de sortie attendu.

Ce mécanisme résout un problème fondamental : la saturation du contexte. Plutôt que de tout faire dans une seule session qui finit par dépasser la fenêtre de contexte, on découpe en sous-tâches isolées.

Quand utiliser un sub-agent ?

Cas d’usage principaux

• Exploration de codebase — un agent dédié (Explore) cherche dans une grande codebase sans polluer le contexte principal.
• Planification complexe — un agent Plan rédige un plan structuré avant que l’agent principal n’exécute.
• Review indépendante — un sub-agent qui n’a PAS vu le processus de création reçoit le code final et les conventions. Plus objectif qu’une self-review.
• Tâches parallèles — plusieurs sub-agents lancés en même temps pour des tâches indépendantes.

Attention : Ne pas utiliser un sub-agent pour une tâche simple que l’agent principal peut traiter en quelques secondes. Chaque sub-agent a un coût en tokens (le briefing + sa propre exécution) et en temps. Le gain ne se justifie que sur des tâches suffisamment conséquentes.

Briefer un sub-agent : l’art du prompt de délégation

Le brief envoyé au sub-agent est un prompt complet. Il doit contenir tout ce dont l’agent a besoin pour travailler de manière autonome :

Point clé : Un brief vague produit un résultat vague. Traite le brief comme une user story : qui, quoi, pourquoi, contraintes, critères d’acceptation.

Parallélisme et orchestration

Quand plusieurs sub-agents sont indépendants (aucun n’a besoin du résultat de l’autre), ils peuvent être lancés en parallèle dans le même message. Claude Code gère la concurrence nativement.

Piège récurrent : Lancer des sub-agents en série alors qu’ils sont indépendants. Ça double ou triple le temps d’exécution sans raison.

Lien avec le modèle PITER

Le pattern PITER (Planner, Implementer, Tester, Evaluator, Reviewer) distribue des rôles entre agents. En pratique avec Claude Code :

• Le plan mode joue le rôle de Planner.
• Le Task tool lance des sub-agents pour les rôles Implementer, Tester, Evaluator, Reviewer.
• Chaque sub-agent a un contexte frais, adapté à son rôle.

Point clé : Avant de monter une orchestration PITER complète, vérifie qu’un seul agent bien briefé ne suffit pas. La complexité a un coût — en tokens, en temps, et en coordination.