team-builder

Team Builder

Menu interactif pour parcourir et composer des équipes d'agents à la demande. Fonctionne avec des collections d'agents en structure plate ou en sous-répertoires par domaine.

Quand l'utiliser

• Vous avez plusieurs personnages d'agents (fichiers markdown) et souhaitez choisir lesquels utiliser pour une tâche
• Vous voulez composer une équipe ad-hoc à partir de différents domaines (ex. : Sécurité + SEO + Architecture)
• Vous voulez parcourir les agents disponibles avant de décider

Prérequis

Les fichiers d'agents doivent être des fichiers markdown contenant un prompt de personnage (identité, règles, workflow, livrables). Le premier # Titre est utilisé comme nom de l'agent et le premier paragraphe comme description.

Les structures plate et en sous-répertoires sont toutes deux prises en charge :

Structure en sous-répertoires — le domaine est déduit du nom du dossier parent :

agents/
├── ingénierie/
│   ├── ingénieur-securite.md
│   └── architecte-logiciel.md
├── marketing/
│   └── specialiste-seo.md
└── ventes/
    └── coach-decouverte.md

Structure plate — le domaine est déduit des préfixes de noms de fichiers partagés. Un préfixe est considéré comme un domaine lorsque 2 fichiers ou plus le partagent. Les fichiers avec des préfixes uniques vont dans "Général". Remarque : l'algorithme coupe au premier -, donc les domaines multi-mots (ex. gestion-produit) doivent utiliser la structure en sous-répertoires :

avatars/
├── ingénierie-ingenieur-securite.md
├── ingénierie-architecte-logiciel.md
├── marketing-specialiste-seo.md
├── marketing-strategiste-contenu.md
├── ventes-coach-decouverte.md
└── ventes-strategiste-outbound.md

Configuration

Les agents sont découverts via deux méthodes, fusionnées et dédupliquées par nom d'agent :

1. Commande claude agents (principale) — exécutez claude agents pour obtenir tous les agents connus du CLI, y compris les agents utilisateur, les agents de plugins (ex. ecc:architect) et les agents intégrés. Cela couvre automatiquement les installations de la place de marché ECC sans aucune configuration de chemin.
2. Glob de fichiers (solution de repli, pour lire le contenu des agents) — les fichiers markdown des agents sont lus depuis :
   • ./agents/**/*.md + ./agents/*.md — agents locaux au projet
   • ~/.claude/agents/**/*.md + ~/.claude/agents/*.md — agents utilisateur globaux

Les sources antérieures ont priorité en cas de collision de noms : agents utilisateur > agents de plugins > agents intégrés. Un chemin personnalisé peut être utilisé à la place si l'utilisateur en spécifie un.

Comment ça fonctionne

Étape 1 : Découvrir les agents disponibles

Exécutez claude agents pour obtenir la liste complète des agents. Analysez chaque ligne :

• Agents de plugins sont préfixés par nom-plugin: (ex. ecc:security-reviewer). Utilisez la partie après : comme nom de l'agent et le nom du plugin comme domaine.
• Agents utilisateur n'ont pas de préfixe. Lisez le fichier markdown correspondant depuis ~/.claude/agents/ ou ./agents/ pour extraire le nom et la description.
• Agents intégrés (ex. Explorer, Planifier) sont ignorés sauf si l'utilisateur demande explicitement de les inclure.

Pour les agents utilisateur chargés depuis des fichiers markdown :

• Structure en sous-répertoires : extraire le domaine du nom du dossier parent
• Structure plate : collecter tous les préfixes de noms de fichiers (texte avant le premier -). Un préfixe est qualifié de domaine seulement s'il apparaît dans 2 noms de fichiers ou plus (ex. ingenierie-ingenieur-securite.md et ingenierie-architecte-logiciel.md commencent tous deux par ingenierie → domaine Ingénierie). Les fichiers avec des préfixes uniques (ex. relecteur-code.md, guide-tdd.md) sont regroupés sous "Général"
• Extraire le nom de l'agent du premier # Titre. Si aucun titre n'est trouvé, dériver le nom du nom de fichier (supprimer .md, remplacer les tirets par des espaces, mettre en casse titre)
• Extraire un résumé d'une ligne du premier paragraphe après le titre

Si aucun agent n'est trouvé après avoir exécuté claude agents et sondé les emplacements de fichiers, informez l'utilisateur : "Aucun agent trouvé. Exécutez claude agents pour vérifier votre configuration." Puis arrêtez.

Étape 2 : Présenter le menu des domaines

Domaines d'agents disponibles :
1. Ingénierie — Architecte Logiciel, Ingénieur Sécurité
2. Marketing — Spécialiste SEO
3. Ventes — Coach Découverte, Stratégiste Outbound

Choisissez des domaines ou nommez des agents spécifiques (ex. : "1,3" ou "sécurité + seo") :

• Ignorer les domaines avec zéro agent (dossiers vides)
• Afficher le nombre d'agents par domaine

Étape 3 : Gérer la sélection

Accepter une entrée flexible :

• Chiffres : "1,3" sélectionne tous les agents d'Ingénierie et de Ventes
• Noms : "sécurité + seo" effectue une correspondance floue avec les agents découverts
• "tout de l'ingénierie" sélectionne tous les agents de ce domaine

Si plus de 5 agents sont sélectionnés, listez-les par ordre alphabétique et demandez à l'utilisateur de réduire : "Vous avez sélectionné N agents (max 5). Choisissez lesquels garder, ou dites 'premiers 5' pour utiliser les cinq premiers alphabétiquement."

Confirmez la sélection :

Sélectionnés : Ingénieur Sécurité + Spécialiste SEO
Sur quoi doivent-ils travailler ? (décrivez la tâche) :

Étape 4 : Lancer les agents en parallèle

1. Lire le fichier markdown de chaque agent sélectionné
2. Demander la description de la tâche si elle n'a pas déjà été fournie
3. Lancer tous les agents en parallèle à l'aide de l'outil Agent :
   • subagent_type: "general-purpose"
   • prompt: "{contenu du fichier agent}\n\nTâche : {description de la tâche}"
   • Chaque agent fonctionne indépendamment — aucune communication entre agents n'est nécessaire
4. Si un agent échoue (erreur, dépassement de temps ou sortie vide), notez l'échec en ligne (ex. "Ingénieur Sécurité : échec — [raison]") et continuez avec les résultats des agents qui ont réussi

Étape 5 : Synthétiser les résultats

Collectez toutes les sorties et présentez un rapport unifié :

• Résultats regroupés par agent
• Section de synthèse mettant en évidence :
  • Points d'accord entre agents
  • Conflits ou tensions entre les recommandations
  • Prochaines étapes recommandées

Si un seul agent a été sélectionné, ignorez la synthèse et présentez la sortie directement.

Règles

• Découverte dynamique uniquement. Ne jamais coder en dur les listes d'agents. Les nouveaux fichiers dans le répertoire apparaissent automatiquement dans le menu.
• Max 5 agents par équipe. Plus de 5 produit des rendements décroissants et une consommation excessive de jetons. Appliquez cela au moment de la sélection.
• Envoi parallèle. Tous les agents s'exécutent simultanément — utilisez le modèle d'invocation parallèle de l'outil Agent.
• Appels Agent parallèles, pas TeamCreate. Cette compétence utilise des appels parallèles à l'outil Agent pour un travail indépendant. TeamCreate (un outil de Claude Code pour le dialogue multi-agent) n'est nécessaire que lorsque les agents doivent débattre ou se répondre.

Exemples

Utilisateur : team builder

Claude :
Domaines d'agents disponibles :
1. Ingénierie (2) — Architecte Logiciel, Ingénieur Sécurité
2. Marketing (1) — Spécialiste SEO
3. Ventes (4) — Coach Découverte, Stratégiste Outbound, Stratégiste Proposition, Ingénieur Commercial
4. Support (1) — Résumé Exécutif

Choisissez des domaines ou nommez des agents spécifiques :

Utilisateur : sécurité + seo

Claude :
Sélectionnés : Ingénieur Sécurité + Spécialiste SEO
Sur quoi doivent-ils travailler ?

Utilisateur : Auditez mon site e-commerce Next.js avant le lancement

[Les deux agents se lancent en parallèle, chacun appliquant sa spécialité au code]

Claude :
## Résultats de l'Ingénieur Sécurité
- [constats...]

## Résultats du Spécialiste SEO
- [constats...]

## Synthèse
Les deux agents s'accordent sur : [...]
Tension : La Sécurité recommande une CSP qui bloque les styles inline, le SEO a besoin de balisage schema inline. Résolution : [...]
Prochaines étapes : [...]