team-builder

Team Builder

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

Quand l'utiliser

• Vous avez plusieurs personnalités d'agents (fichiers markdown) et souhaitez choisir lesquelles utiliser pour une tâche
• Vous voulez composer une équipe ad-hoc provenant 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 personnalité (identité, règles, workflow, livrables). Le premier # Titre est utilisé comme nom de l'agent et le premier paragraphe comme description.

Les dispositions plates et en sous-répertoires sont toutes deux prises en charge :

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

agents/
├── engineering/
│   ├── security-engineer.md
│   └── software-architect.md
├── marketing/
│   └── seo-specialist.md
└── sales/
    └── discovery-coach.md

Disposition 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 sont regroupés sous "Général". Remarque : l'algorithme coupe au premier -, donc les domaines avec plusieurs mots (ex : gestion-produit) doivent utiliser la disposition en sous-répertoires :

available agents/
├── engineering-security-engineer.md
├── engineering-software-architect.md
├── marketing-seo-specialist.md
├── marketing-content-strategist.md
├── sales-discovery-coach.md
└── sales-outbound-strategist.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 de l'interface 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 secours, 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 précédentes prennent le pas 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 :

• Disposition en sous-répertoires : extrayez le domaine du nom du dossier parent
• Disposition plate : collectez tous les préfixes de noms de fichiers (texte avant le premier -). Un préfixe est qualifié comme domaine seulement s'il apparaît dans 2 fichiers ou plus (ex : engineering-security-engineer.md et engineering-software-architect.md commencent tous deux par engineering → domaine Ingénierie). Les fichiers avec des préfixes uniques (ex : code-reviewer.md, tdd-guide.md) sont regroupés sous "Général"
• Extrayez le nom de l'agent du premier # Titre. Si aucun titre n'est trouvé, dérivez le nom du fichier (supprimez .md, remplacez les tirets par des espaces, mettez en majuscule)
• Extrayez 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 exploré les emplacements de fichiers, informez l'utilisateur : "Aucun agent trouvé. Exécutez claude agents pour vérifier votre configuration." Puis arrêtez-vous.

É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 de Découverte, Stratège Sortant

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

• Ignorez les domaines sans agents (répertoires vides)
• Affichez le nombre d'agents par domaine

Étape 3 : Gérer la sélection

Acceptez une entrée flexible :

• Chiffres : "1,3" sélectionne tous les agents d'Ingénierie et Ventes
• Noms : "sécurité + seo" correspond approximativement aux agents découverts
• "tous de l'ingénierie" sélectionne chaque agent 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 'les 5 premiers' pour utiliser les cinq premiers par ordre alphabétique."

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. Lisez le fichier markdown de chaque agent sélectionné
2. Demandez la description de la tâche si elle n'est pas déjà fournie
3. Lancez tous les agents en parallèle en utilisant l'outil Agent :
   • subagent_type: "general-purpose"
   • prompt: "{contenu du fichier de l'agent}\n\nTâche : {description de la tâche}"
   • Chaque agent s'exécute indépendamment — aucune communication inter-agents n'est nécessaire
4. Si un agent échoue (erreur, délai dépassé 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 groupés par agent
• Section de synthèse mettant en évidence :
  • Convergences entre agents
  • Conflits ou tensions entre 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.
• Maximum 5 agents par équipe. Plus de 5 produit des rendements décroissants et une utilisation excessive de jetons. Appliquez 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 parallèles à l'Agent, 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-agents) 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 de Découverte, Stratège Sortant, Stratège 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 : Révise mon site e-commerce Next.js avant le lancement

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

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

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

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