Conception de sous-agents dans Claude Code

Problème : Les grosses tâches de code ont besoin de plus d'un type d'expert, mais une seule session Claude commence à dérailler quand tu lui demandes d'être tous à la fois.

Gain rapide : Colle ce prompt sur n'importe quelle revue qui nécessite plus d'un angle :

Create sub-agents and analyze this from these perspectives:
- Senior engineer: Review architecture decisions
- Security expert: Identify vulnerabilities
- Performance reviewer: Find optimization opportunities

Tu obtiens trois lectures spécialisées en parallèle, en quelques minutes.

Pourquoi un seul contexte échoue

Demande à Claude de revoir le code, optimiser les performances et vérifier la sécurité en même temps, et les réponses deviennent génériques. Chaque angle se bat pour de la place dans la même fenêtre de contexte. Tout finit superficiel.

Les sous-agents règlent ça en donnant à chaque vue son propre contexte. Chaque agent reste dans sa voie, choisit ses propres outils, et travaille avec sa propre méthode. Tu ramènes les résultats ensemble à la fin.

Claude Code te donne deux façons de les lancer :

1. Task Tool : l'outil intégré crée des sous-agents isolés, chacun avec sa propre fenêtre de contexte.
2. Prompting de perspectives : un seul prompt qui demande plusieurs points de vue experts en une passe.

Task lance du vrai travail parallèle. Les prompts de perspectives le simulent dans une seule session. Dans les deux cas, la qualité de l'analyse monte.

1. Trouver les tâches parallélisables

Bons candidats pour un split en sous-agents :

• Revue de code depuis plusieurs angles
• Recherche sur différentes technologies
• Revue de documentation pour différents publics
• Analyse de performance sur différentes métriques

Passe les sous-agents quand le travail est série :

• Modifications de fichiers qui dépendent les unes des autres
• Étapes de build séquentielles
• Migrations de base de données

2. Concevoir des rôles spécialistes

Choisis les points de vue qui correspondent à ton domaine. Quelques templates de prompt qui valent leur poids :

Revue qualité du code :

Analyze this codebase using sub-agents with these specialist roles:
- Factual reviewer: Check technical accuracy against documentation
- Senior engineer: Review architecture decisions and patterns
- Security expert: Identify vulnerabilities and attack vectors
- Consistency reviewer: Check coding standards compliance
- Redundancy checker: Find duplicate logic to consolidate

Analyse de l'expérience utilisateur :

Create sub-agents for UX review of this feature:
- Creative thinker: Suggest innovative interaction solutions
- Beginner user: Test ease of use and onboarding friction
- Designer: Evaluate visual hierarchy and spacing
- Marketing analyst: Assess conversion potential
- Accessibility auditor: Check WCAG compliance

3. Orchestrer l'analyse

Chaque sous-agent choisit ses propres outils. Les agents de sécurité atteignent les scanners de vulnérabilités. Les réviseurs de performance tirent des outils de profilage. Les architectes regardent la structure. Un seul agent ne peut pas couvrir les trois de la même façon.

Mode Plan pour les lectures sûres

Avant de lâcher des sous-agents spécialistes sur du code critique, passe en mode plan. Appuie sur Shift+Tab deux fois dans Claude Code. Ça garde l'exécution en lecture seule pendant qu'ils travaillent.

Puis demande la revue multi-angles :

Use sub-agents to validate this API design from:
- Backend perspective: Data flow and scalability
- Frontend perspective: Consumption patterns and DX
- Security perspective: Authentication and authorization gaps

Le mode plan prouve sa valeur quand un sous-agent pourrait sinon essayer de corriger les choses lui-même.

Le schéma de consolidation

Une fois les sous-agents terminés, rassemble les sorties :

1. Rapports individuels : chaque agent rédige ses propres résultats.
2. Résolution des conflits : choisis un gagnant quand deux recommandations ne s'accordent pas.
3. Classement par priorité : trie les corrections par impact.
4. Plan d'action : trace les étapes pour implémenter.

Erreurs courantes

Erreur : lancer des sous-agents pour des petites tâches.

Fautes de frappe, corrections d'une ligne, renommages rapides. La surcharge de coordination efface le gain. Passe les agents.

Mieux : garde l'équipe spécialiste pour les problèmes épineux et multidimensionnels :

Use sub-agents to redesign this authentication system:
- Security expert: Audit current vulnerabilities
- UX designer: Simplify the login flow
- Performance engineer: Optimize token handling

Erreur : empiler des rôles qui se recoupent en grande partie.

"Security expert, penetration tester, vulnerability scanner, security architect" c'est le même point de vue avec quatre chapeaux.

Mieux : choisis des rôles qui couvrent des côtés différents du problème et ne se marchent pas dessus.

Exécution en arrière-plan

N'importe quel sous-agent peut maintenant tourner en arrière-plan. Appuie sur Ctrl+B pendant qu'il travaille :

You: Audit our authentication module for security issues
Claude: I'll spawn a sub-agent to analyze the auth module...
[Sub-agent starts]
You: [Press Ctrl+B]
You: While that runs, let's optimize the database queries...

Suit l'exécution en arrière-plan avec /tasks. Quand il finit, il réveille l'agent principal et lui remet les résultats.

Les spécialistes bloquants deviennent des spécialistes parallèles. La couverture async complète vit dans le guide des agents en arrière-plan.

Gain économique

Les sous-agents font travailler Claude Sonnet sans payer pour Opus. L'analyse parallèle te rapproche de la qualité Opus aux prix Sonnet.

D'où viennent les économies :

• Plusieurs lectures expertes en une session
• Le travail parallèle réduit le temps total d'exécution
• Le contexte spécialiste évite la lecture généraliste superficielle
• Meilleure sortie qu'un seul modèle premium
• L'exécution en arrière-plan tue l'attente

Rotation des rôles

Sur les projets longs, fais tourner la liste de spécialistes sur les composants.

Semaine 1 - Architecture centrale :

Analyze the database design using sub-agents:
- Data architect: Schema optimization and normalization
- Security expert: Access control and encryption
- Performance optimizer: Query patterns and indexing

Semaine 2 - Couche API :

Review API endpoints with these specialist sub-agents:
- Backend engineer: Implementation quality and patterns
- Documentation writer: API clarity and examples
- Integration specialist: Third-party compatibility

Raffinement itératif

Les sous-agents s'adaptent naturellement aux passes progressives :

1. Perspectives larges au premier coup d'oeil
2. Plongée spécialisée au deuxième
3. Revue centrée sur l'utilisateur au troisième

Le résultat est plus complet, plus centré sur l'utilisateur, et attrape des choses qu'un agent seul manque.

Où les sous-agents rapportent

• Revues d'architecture : plusieurs lentilles techniques en même temps
• Audits de documentation : différents publics lisent différentes choses
• Portes qualité de code : de nombreuses dimensions qualité en une passe
• Stratégie produit : lecture inter-fonctionnelle
• Analyse concurrentielle : différents angles de marché

Commence avec les revues de code. Étend vers le travail stratégique une fois que tu as "l'envie du parallélisme."

Prochaines étapes

• Schémas d'exécution : quand aller en parallèle, séquentiel ou arrière-plan.
• Fondations : les fondamentaux des agents couvrent les bases.
• Implémentation : les agents personnalisés pour les scénarios spécialisés.
• Coordination : la distribution de tâches pour les grands projets multi-agents.
• Optimisation : les modes de planification pour des exécutions sûres de sous-agents.
• Gestion du contexte : maintenir la qualité sur toute une équipe.

Essaie-le sur ta prochaine revue de code. Le split spécialiste, c'est le genre de chose que tu remarques la première fois.