Sous-agents

Définition

Agents spécialisés lancés par un agent principal, chacun avec son propre contexte, son system prompt, ses outils autorisés et éventuellement un modèle moins cher. Dans Claude Code, un fichier .claude/agents/<nom>.md (front-matter name, description, tools, model) suffit ; le sous-agent ne voit pas l'historique parent et ne renvoie qu'un résumé. Avantages : contexte principal préservé, contraintes imposées par construction.

Analogie

Le chef de projet qui envoie un expert enquêter et ne lit que son compte rendu d'une page.

Exemple de code

# .claude/agents/security-reviewer.md
---
name: security-reviewer
description: Relit un diff pour des failles (injection, secrets, authz). À utiliser avant toute PR touchant l'API.
tools: Read, Grep, Glob            # lecture seule : ne peut rien casser
model: sonnet                      # moins cher que le modèle principal
maxTurns: 15
---
Tu es relecteur sécurité. Pour chaque problème : fichier:ligne, gravité,
explication en une phrase, correctif proposé. Ignore le style.
Termine par un verdict : BLOQUANT / À CORRIGER / OK.

Cas d'usage

Exploration de code, revue, recherche documentaire : tâches verbeuses dont seul le résultat compte.

Anti-pattern

Termes liés

Sources

• code.claude.com/docs/en/sub-agents
• anthropic.com/engineering/effective-context-engineering-for-ai-agents