Modèles de composition d'équipe

Meilleures pratiques pour composer des équipes multi-agents, sélectionner les tailles d'équipe, choisir les types d'agents et configurer les modes d'affichage pour la fonctionnalité Agent Teams de Claude Code.

Quand utiliser cette compétence

Décider du nombre de coéquipiers à créer pour une tâche
Choisir entre les configurations d'équipe prédéfinies
Sélectionner le bon type d'agent (subagent_type) pour chaque rôle
Configurer les modes d'affichage des coéquipiers (tmux, iTerm2, in-process)
Construire des compositions d'équipe personnalisées pour les workflows non standard

Heuristiques de dimensionnement d'équipe

Complexité	Taille d'équipe	Quand l'utiliser
Simple	1-2	Revue unidimensionnelle, bug isolé, petite fonctionnalité
Modérée	2-3	Changements multi-fichiers, 2-3 préoccupations, fonctionnalités moyennes
Complexe	3-4	Préoccupations transversales, grandes fonctionnalités, débogage approfondi
Très complexe	4-5	Fonctionnalités full-stack, revues complètes, problèmes systémiques

Règle générale : Commencez avec la plus petite équipe qui couvre toutes les dimensions requises. Ajouter des coéquipiers augmente la surcharge de coordination.

Compositions d'équipe prédéfinies

Review Team

Taille : 3 relecteurs
Agents : 3x team-reviewer
Dimensions par défaut : sécurité, performance, architecture
À utiliser quand : Les changements de code nécessitent une évaluation de qualité multidimensionnelle

Debug Team

Taille : 3 enquêteurs
Agents : 3x team-debugger
Hypothèses par défaut : 3 hypothèses concurrentes
À utiliser quand : Le bug a plusieurs causes racine plausibles

Feature Team

Taille : 3 (1 lead + 2 implémenteurs)
Agents : 1x team-lead + 2x team-implementer
À utiliser quand : La fonctionnalité peut être décomposée en flux de travail parallèles

Fullstack Team

Taille : 4 (1 lead + 3 implémenteurs)
Agents : 1x team-lead + 1x team-implementer frontend + 1x team-implementer backend + 1x team-implementer test
À utiliser quand : La fonctionnalité s'étend sur les couches frontend, backend et test

Research Team

Taille : 3 chercheurs
Agents : 3x general-purpose
Domaines par défaut : Chacun assigné à une question de recherche, module ou sujet différent
Capacités : Recherche dans la base de code (Grep, Glob, Read), recherche web (WebSearch, WebFetch)
À utiliser quand : Besoin de comprendre une base de code, rechercher des bibliothèques, comparer des approches, ou rassembler des informations à partir de sources web et de code en parallèle

Security Team

Taille : 4 relecteurs
Agents : 4x team-reviewer
Dimensions par défaut : OWASP/vulnérabilités, auth/contrôle d'accès, dépendances/chaîne d'approvisionnement, secrets/configuration
À utiliser quand : Audit de sécurité complet couvrant plusieurs surfaces d'attaque

Migration Team

Taille : 4 (1 lead + 2 implémenteurs + 1 relecteur)
Agents : 1x team-lead + 2x team-implementer + 1x team-reviewer
À utiliser quand : Migration de grande base de code (upgrade de framework, portage de langage, bump de version d'API) nécessitant un travail parallèle avec vérification de la correction

Sélection du type d'agent

Lors de la création de coéquipiers avec l'outil Agent, choisissez subagent_type selon les outils dont le coéquipier a besoin :

Type d'agent	Outils disponibles	À utiliser pour
`general-purpose`	Tous les outils (Read, Write, Edit, Bash, etc.)	Implémentation, débogage, toute tâche nécessitant des modifications de fichiers
`Explore`	Outils en lecture seule (Read, Grep, Glob)	Recherche, exploration de code, analyse
`Plan`	Outils en lecture seule	Planification d'architecture, décomposition de tâches
`agent-teams:team-reviewer`	Tous les outils	Revue de code avec résultats structurés
`agent-teams:team-debugger`	Tous les outils	Investigation basée sur des hypothèses
`agent-teams:team-implementer`	Tous les outils	Construction de fonctionnalités au sein des limites de propriété de fichiers
`agent-teams:team-lead`	Tous les outils	Orchestration et coordination d'équipe

Distinction clé : Les agents en lecture seule (Explore, Plan) ne peuvent pas modifier les fichiers. Ne jamais assigner des tâches d'implémentation à des agents en lecture seule.

Configuration du mode d'affichage

Configurer dans ~/.claude/settings.json :

{
  "teammateMode": "tmux"
}

Mode	Comportement	Optimal pour
`"tmux"`	Chaque coéquipier dans un volet tmux	Flux de travail de développement, surveillance de plusieurs agents
`"iterm2"`	Chaque coéquipier dans un onglet iTerm2	Utilisateurs macOS qui préfèrent iTerm2
`"in-process"`	Tous les coéquipiers dans le même processus	Tâches simples, environnements CI/CD

Directives d'équipe personnalisée

Lors de la construction d'équipes personnalisées :

Chaque équipe a besoin d'un coordinateur — Désignez un team-lead ou coordonnez directement avec l'utilisateur
Faire correspondre les rôles aux types d'agents — Utiliser des agents spécialisés (reviewer, debugger, implementer) quand disponibles
Éviter les rôles en doublon — Deux agents faisant la même chose gaspillent des ressources
Définir les limites en amont — Chaque coéquipier a besoin d'une propriété claire de fichiers ou de responsabilités
Garder c'est petit — 2-4 coéquipiers est la zone optimale ; 5+ nécessite une surcharge de coordination importante

Dépannage

Un coéquipier a été créé en tant que Explore mais a besoin d'écrire des fichiers. Explore et Plan sont des agents en lecture seule. Changez le subagent_type en general-purpose ou un type d'agent spécialisé approprié. Ne jamais assigner des tâches d'implémentation à des agents en lecture seule.

L'équipe devient trop grande et la coordination ralentit tout. Chaque coéquipier supplémentaire ajoute une surcharge de communication. Consolider les rôles : un agent peut-il couvrir deux dimensions ? Une équipe de 4 personnes faisant 6 tâches indépendantes est généralement mieux servie par 3 agents couvrant 2 tâches chacun.

Le mode tmux n'affiche pas les volets. Vérifiez que tmux est installé et qu'une session est déjà en cours avant de créer des coéquipiers. Le mode in-process fonctionne sans tmux et convient aux environnements CI ou scriptés.

Deux relecteurs signalent les mêmes problèmes. Les dimensions de revue se chevauchent. Redéfinissez la zone de focus de chaque relecteur : l'un sur la correction/logique, l'un sur la sécurité, l'un sur la performance/scalabilité. La couverture chevauchante gaspille les tokens et produit des résultats en doublon.

Un team-lead crée des coéquipiers mais ils ne reçoivent pas de tâches. Vérifiez que le lead utilise l'outil Agent pour créer des coéquipiers et passe un contexte complet dans le prompt. Les coéquipiers commencent frais sans aucun historique de conversation préalable — ils ont besoin de toutes les informations pertinentes dans leur prompt initial.

Compétences associées

parallel-feature-development — Décomposer les flux de travail et assigner la propriété des fichiers une fois l'équipe composée
team-communication-protocols — Établir les normes de messagerie et les procédures d'arrêt pour l'équipe assemblée

team-composition-patterns