Guide d’introduction à Agency Agents : transformer Claude Code en “dream team” avec plus de 100 rôles d’experts IA

Nous le savons tous : rédiger un prompt est un véritable savoir-faire. Avec le même modèle Claude, les résultats entre « écris-moi un composant React » et « du point de vue d’un ingénieur front-end senior, conforme aux normes WCAG 2.1 AA, utilise TypeScript + React 18 pour créer un tableau virtuel accessible » peuvent être radicalement différents.

Agency Agents est justement là pour résoudre ce problème : il organise 16 départements et plus de 100 rôles d’experts IA (Frontend Developer, Backend Architect, Security Auditor, Reddit Community Ninja… ), en définissant les identités, les processus, les livrables et les indicateurs de réussite—il ne reste qu’à activer le rôle correspondant et l’IA passe automatiquement en « mode professionnel ».

Le plus pratique : le dépôt fournit déjà convert.sh et install.sh. En un clic, vous pouvez synchroniser la même définition de rôles vers plus de 10 outils—Claude Code, OpenClaw, Cursor, OpenCode, Codex, Gemini CLI, etc.—sans avoir à maintenir plusieurs configurations.

Dans cet article, nous allons le faire tourner de zéro, puis montrer comment activer un rôle dans OpenClaw pour répondre à un besoin réel.

Présentation du projet

msitarzewski/agency-agents est né d’une discussion sur Reddit autour de la question : « Si tu pouvais engager une équipe d’employés IA, quels postes choisirais-tu ? ». Après plusieurs mois d’itérations, cela s’est transformé en une bibliothèque de rôles d’agents IA assez complète :

• 16 départements : engineering, design, marketing, finance, security, sales, testing… couvre presque tous les postes dont une entreprise logicielle peut avoir besoin
• 100+ rôles : de Frontend Developer à Backend Architect, jusqu’à Whimsy Injector ou Reality Checker—des rôles avec une « température de personnage »
• Livrables mesurables : pour chaque rôle, success metrics, deliverables et critical rules sont explicitement définis—ce ne sont pas de simples prompts vagues
• Multi-outils : à partir d’une même source Markdown, vous pouvez la convertir en Claude Code subagent, workspace OpenClaw, Cursor rule, OpenCode agent, Codex TOML, etc.

La différence avec un simple template de prompt, c’est que ici chaque rôle dispose d’une configuration entièrement “personnalisée” (ton, style, mécanismes de mémoire) + d’un processus métier (mission / workflow / deliverables). On est bien plus proche d’une « fiche de poste » que d’un prompt générique.

Difficulté / durée / ce que vous y gagnez

• Difficulté : ⭐⭐ (il suffit d’utiliser le terminal, aucune barrière liée au code)
• Durée : 15 à 30 minutes (première installation + activation d’un rôle + exécution d’un besoin réel)
• Ce que vous gagnez : transformer Claude Code / OpenClaw en une équipe d’agents IA « à la demande », et conserver durablement des identités professionnelles cohérentes

Profil des lecteurs visés

• Des développeurs qui veulent gagner en productivité avec l’IA, mais qui trouvent que rédiger des prompts est trop pénible
• Des ingénieurs front-end / back-end / full-stack / sécurité / tests avec 1 à 5 ans d’expérience
• Des personnes qui utilisent déjà des outils de programmation IA comme Claude Code, Cursor, OpenClaw, Codex, etc.
• Des technical leads qui veulent instaurer des « règles de collaboration IA » au sein de leur équipe

Dépendances clés et environnement

Arborescence complète du projet

agency-agents/
├── academic/                       # Recherches académiques
├── design/                         # Design UI/UX
├── engineering/                    # Développement (le plus grand département, 30+ rôles)
├── finance/                        # Finance
├── game-development/              # Développement de jeux
├── gis/                            # Systèmes d’information géographique
├── marketing/                      # Marketing
├── paid-media/                     # Publicité payante
├── product/                        # Produit
├── project-management/           # Gestion de projet
├── sales/                          # Ventes
├── security/                       # Sécurité
├── spatial-computing/            # Informatique spatiale
├── specialized/                    # Experts spécialisés
├── strategy/                       # Stratégie
├── support/                        # Support client
├── testing/                        # Tests
├── integrations/                   # Résultats d’intégration multi-outils
│   ├── openclaw/                   # Workspace OpenClaw (SOUL.md + AGENTS.md + IDENTITY.md)
│   ├── opencode/                   # Agent OpenCode (.md + frontmatter YAML)
│   ├── claude-code/                # Subagent Claude Code
│   ├── cursor/                     # Cursor rule (.mdc)
│   ├── codex/                      # Agent custom Codex (TOML)
│   ├── gemini-cli/                 # Subagent Gemini CLI
│   ├── github-copilot/             # GitHub Copilot
│   ├── aider/                      # Aider CONVENTIONS.md
│   ├── windsurf/                   # Règles Windsurf .windsurfrules
│   ├── kimi/                       # Kimi Code CLI
│   ├── qwen/                       # Qwen Code SubAgent
│   └── mcp-memory/                 # Mémoire long terme MCP
├── scripts/
│   ├── convert.sh                  # Convertisseur de définitions de rôles → format d’outil
│   ├── install.sh                  # Installation en un clic en local
│   ├── lib.sh                      # Fonctions partagées
│   └── lint-agents.sh              # Validation (lint) des définitions de rôles
├── README.md
└── CONTRIBUTING.md

Étapes pas à pas

Dans la suite, prenons OpenClaw comme exemple pour montrer le processus complet. Pour les autres outils, il suffit de remplacer --tool par le nom correspondant.

Étape 1 : cloner le dépôt

git clone https://github.com/msitarzewski/agency-agents.git
cd agency-agents

Si le réseau est limité, vous pouvez d’abord fork sur Gitee / votre GitHub puis cloner :

git clone https://github.com/<your-fork>/agency-agents.git
cd agency-agents

Étape 2 : voir les départements et rôles installables

install.sh propose un mode « liste » très pratique :

./scripts/install.sh --list teams

Vous verrez une sortie comme celle-ci :

engineering          33 agents
design               12 agents
marketing            18 agents
security              9 agents
testing              11 agents
...

Si vous souhaitez n’en installer que quelques-uns (par exemple engineering + security), utilisez ensuite --division pour filtrer.

Étape 3 : générer les fichiers d’intégration au format OpenClaw

convert.sh découpe la source Markdown en trois fichiers attendus par OpenClaw : SOUL.md (personnalité) + AGENTS.md (processus) + IDENTITY.md (identité) :

./scripts/convert.sh --tool openclaw

En cas de succès, le dossier integrations/openclaw/ contiendra alors plus de 100 nouveaux sous-dossiers :

ls integrations/openclaw/ | head -20
# agency-frontend-developer
# agency-backend-architect
# agency-security-auditor
# agency-reddit-community-ninja
# agency-whimsy-injector
# ...

Chaque sous-dossier ressemble à ceci :

agency-frontend-developer/
├── SOUL.md        # Personnalité du rôle : identité, mémoire, ton, style
├── AGENTS.md      # Processus métier : mission, deliverables, workflow
└── IDENTITY.md    # Carte d’identité : emoji + nom + vibe

Étape 4 : installation en un clic dans OpenClaw

# Installation complète (environ 100+ rôles)
./scripts/install.sh --tool openclaw

# Recommandé : sélectionner par département (éviter de tout entasser d’un coup)
./scripts/install.sh --tool openclaw --division engineering,security

Le script copie automatiquement le workspace vers ~/.openclaw/agency-agents/ et enregistre les agents auprès de la passerelle OpenClaw.

Étape 5 : redémarrer la passerelle OpenClaw pour activer les nouveaux rôles

openclaw gateway restart

Étape 6 : activer Frontend Developer dans OpenClaw

openclaw chat --agent agency-frontend-developer

Ou bien, modifiez l’agent par défaut dans le fichier de configuration en le mettant sur agency-frontend-developer : à chaque démarrage d’OpenClaw, vous entrerez automatiquement dans ce rôle.

Étape 7 : exécuter un besoin réel

On demande à Frontend Developer—juste activé—d’écrire un composant de tableau virtuel accessible :

openclaw chat --agent agency-frontend-developer <<'EOF'
Aide-moi à écrire un composant DataTable avec React 18 + TypeScript, avec les exigences suivantes :
1. Utiliser @tanstack/react-virtual pour la virtualisation
2. Respecter les normes d’accessibilité WCAG 2.1 AA
3. Les cellules doivent permettre un rendu personnalisé
4. L’événement de clic sur la ligne doit être configurable
5. Fournir un code complet exécutable tel quel
EOF

Vous verrez que le style de son code est extrêmement cohérent : parce que la définition du rôle a déjà figé ces contraintes—« WCAG 2.1 AA », l’encapsulation avec memo, « Core Web Vitals Optimization ». Nous n’avons plus besoin de répéter ces exigences à chaque prompt.

Étape 8 : démonstration multi-outils (optionnel)

Avec la même définition de rôle, la conversion vers Cursor ne demande qu’une ligne :

./scripts/convert.sh --tool cursor
./scripts/install.sh --tool cursor --agent frontend-developer,backend-architect

Résolution des problèmes courants

Q1 : install.sh renvoie « permission denied »

C’est généralement parce que install.sh n’a pas les permissions d’exécution. Pour les utilisateurs macOS / Linux :

chmod +x scripts/install.sh scripts/convert.sh scripts/lib.sh
./scripts/install.sh --tool openclaw

Pour les utilisateurs Windows : si vous lancez via Git Bash et que cela renvoie cette erreur, vérifiez d’abord que le dépôt a bien été téléchargé avec git clone (ne pas dézipper un fichier zip), et exécutez les scripts avec Git Bash.

Q2 : OpenClaw renvoie « agent not found » ou indique que l’agent n’est pas enregistré

Dans 99% des cas, c’est que vous avez installé les rôles sans redémarrer la gateway :

openclaw gateway restart
openclaw agent list | grep frontend-developer
# Si vous voyez une sortie, l’enregistrement a réussi

Si cela ne marche toujours pas, vérifiez que le fichier agency-frontend-developer/SOUL.md existe bien dans ~/.openclaw/agency-agents/ :

ls ~/.openclaw/agency-agents/agency-frontend-developer/
# Vous devriez voir SOUL.md  AGENTS.md  IDENTITY.md

Q3 : OpenCode installe trop de rôles et n’affiche que les 119 premiers

C’est un bug connu en amont d’OpenCode (issue #27988) : au runtime, seuls ~119 subagents sont enregistrés, et les autres sont silencieusement ignorés.

Solution : installez en plusieurs lots via --division, en gardant le total des rôles à l’intérieur de 119 :

./scripts/install.sh --tool opencode --division engineering
./scripts/install.sh --tool opencode --division marketing --out ~/.opencode-extra/

Le script émettra un warning s’il détecte que le nombre dépasse le seuil ; vous pouvez aussi d’abord faire un dry-run :

./scripts/install.sh --tool opencode --division engineering --dry-run

Q4 : les rôles n’ont pas les champs requis dans le frontmatter, donc convert saute le fichier

convert.sh ignore les fichiers sources qui n’ont pas le champ name. Si vous avez forké un rôle mais qu’il n’apparaît pas dans integrations/openclaw/ :

# 1. Vérifiez le frontmatter du fichier source
head -10 engineering/your-custom-agent.md

# 2. Il faut au minimum inclure :
#    ---
#    name: Your Agent Name
#    description: One-line description
#    ---

# 3. Refaire la conversion
./scripts/convert.sh --tool openclaw

Q5 : erreurs liées aux fins de ligne des scripts bash sur Windows

Si vous avez décompressé les scripts depuis un zip sur Windows, les fichiers peuvent être en CRLF. Dans ce cas, bash peut renvoyer une erreur du type \r: command not found :

# Solution A : utiliser git clone plutôt que télécharger un zip
git clone https://github.com/msitarzewski/agency-agents.git

# Solution B : convertir manuellement les fins de ligne (Git Bash)
dos2unix scripts/*.sh

Q6 : conflits de personnalité entre rôles / “pollution” du contexte

Si, dans une même session, vous activez d’abord Frontend Developer puis Security Auditor, vous pourriez remarquer que le ton du rôle précédent persiste dans le contexte. Cela vient du fait que, dans la plupart des outils CLI, l’injection du rôle se fait au niveau « system prompt » : changer d’agent ne vide pas automatiquement l’historique de la conversation.

Solution :

# Avant de changer d’agent, ouvrez une nouvelle session
openclaw chat --new-session --agent agency-security-auditor

Ou bien activez dans la configuration OpenClaw l’option « archiver automatiquement les anciennes sessions lors du changement d’agent ».

Lectures complémentaires / pistes avancées

1. Personnaliser les templates de rôles

engineering/engineering-frontend-developer.md est un excellent modèle. Essayez de fork puis renommez-le en engineering-frontend-developer-chinese.md :

---
name: Ingénieur front-end (version française)
description: Ingénieur front-end spécialisé dans React/Vue, l’implémentation UI et l’optimisation des performances, écrit des commentaires en français
color: cyan
emoji: 🖥️
vibe: Sortie en français, en respectant les conventions front-end de ByteDance
---

# Ingénieur front-end (version française)

Vous êtes** l’ingénieur front-end **, spécialisé dans les technologies web modernes……

## 🧠 Votre identité et votre mémoire
- Rôle : expert en applications web modernes et implémentation UI
- Personnalité : attention aux détails, sensible aux performances, priorité à l’utilisateur
- Mémoire : mémoriser les patterns UI courants et les meilleures pratiques en accessibilité

Ensuite, lancez ./scripts/convert.sh --tool openclaw : le nouveau rôle apparaîtra dans integrations/openclaw/.

2. Ajouter une mémoire long terme aux rôles avec MCP-Memory

Le dossier integrations/mcp-memory/ fournit une configuration pour un serveur de mémoire MCP. Une fois activé, le rôle peut conserver des préférences d’une session à l’autre (par exemple : « cette équipe préfère utiliser pnpm plutôt que npm »). La méthode de configuration se trouve dans mcp-memory/README.md du dépôt.

3. Workflow de collaboration multi-agents

Un seul rôle est déjà très puissant, mais le plus intéressant, c’est de les orchestrer en chaîne de collaboration. Par exemple :

Besoin → [Product Manager] décompose les tâches
     → [Frontend Developer] + [Backend Architect] implémentent en parallèle
     → [Code Reviewer] effectue l’audit automatique
     → [QA Test Engineer] lance les tests
     → [Technical Writer] génère la description du PR

La fonctionnalité « workflow » intégrée dans OpenClaw permet d’enchaîner ces rôles ; voir la documentation officielle d’OpenClaw pour les détails.

4. Réduire les coûts d’appel

Comme mentionné plus haut, derrière les rôles d’experts d’Agency Agents se trouvent des modèles haut de gamme. Sur le long terme, le coût n’est pas négligeable. Pour utiliser les mêmes modèles au prix officiel réduit, vous pouvez directement intégrer Defapi (la section précédente « Dépendances clés » contient une explication détaillée), sans modification de code.

---

Cet article a été rédigé à partir de msitarzewski/agency-agents sur la branche main actuelle (commit au 2026-06-13). Par la suite, le dépôt pourrait ajouter de nouveaux départements ou ajuster les interfaces des scripts. Il est recommandé de faire un git pull avant de vous lancer pour synchroniser la version la plus récente.