Comment les agents s’activent : noms, rôles, déclencheurs et commandes de conversation
Appelez un agent par son nom, utilisez les codes de menu, laissez les rôles changer via trois niveaux de déclencheurs, et employez bmad-help, autopilot et parallel. Que vérifier si un agent se tait.
Installer BMAD+ écrit les agents dans votre projet ; en activer un, c’est simplement parler à votre outil de codage IA. Il n’y a aucun processus à lancer. Vous dites le nom d’un agent, votre outil charge ses instructions, et l’agent vous salue et travaille. Cette page explique les façons d’appeler un agent, comment un agent change de rôle tout seul (et comment l’en empêcher), ce que font les mots de conversation bmad-help, autopilot et parallel, et quoi vérifier quand rien ne répond.
Par son nom, suivi de la tâche : Atlas, analyse le marché des applications de notes par IA. Le nom peut ouvrir n’importe quelle phrase ; un nom de persona fonctionne aussi (Miriam, Oholiab, Atelier).
Par code de menu, après avoir appelé l’agent : chaque agent affiche un menu avec des codes à deux lettres (PR pour un PRD avec Atlas, CA pour une architecture avec Forge, RG pour la porte d’acceptation avec Sentinel, AP pour l’autopilot avec Nexus). Un code, un numéro de ligne ou une description proche fonctionnent, et l’agent invoque la capacité par son nom enregistré au lieu d’en inventer une.
Par mot de commande pour les packs qui en définissent un : /seo … (SEO / GEO) et /design … (Design) se saisissent dans la conversation et sont aiguillés par la compétence du pack ; votre outil ne les enregistre pas comme commandes slash, une demande ordinaire fonctionne donc aussi. /backup, /backup-list, /backup-restore et /backup-clean sont les quatre entrées du menu de Backup Manager. Le pack Animated n’en a aucune : décrivez la tâche, par exemple animated website from hero.mp4.
Par identifiant de workflow Dev Studio : nommez la persona et le workflow (Yosef, validate-prd sur docs/prd.md). Chaque workflow répond aussi à bmad-<id> et bmad-plus-<id>.
Au premier appel, un agent lit _bmad/config.yaml pour votre nom, votre langue de communication, le mode d’exécution et les deux commutateurs ci-dessous, charge un project-context.md et les déclencheurs de rôle s’il les trouve, vous salue dans votre langue et affiche son menu. Atlas, Shadow et Maker s’arrêtent alors et attendent votre choix ; avec eux, redites la tâche ou choisissez un code de menu si seul le menu revient. Forge, Sentinel, Nexus et Atelier poursuivent quand votre demande est déjà claire, comme dans les exemples ci-dessous, car un salut n’est pas une seconde confirmation ; ils n’attendent un choix que si vous les avez appelés sans tâche.
Forge, cherche pourquoi l’enregistrement d’une facture modifiée crée un doublon. Reproduis le problème, trouve sa cause et propose la correction minimale.
Ce que vous devriez obtenir Forge répond dans votre langue de communication et travaille en Developer ou Architect selon la formulation. Il rapporte la défaillance reproduite, la cause et un correctif ciblé, et distingue contrôles échoués, ignorés et non lancés.
Les codes sont propres à chaque agent : les deux mêmes lettres peuvent désigner des choses différentes selon l’agent (CA crée une architecture pour Forge et un agent pour Maker ; QA génère des tests pour Sentinel et crée un agent rapide pour Maker).
Dans votre assistant IA
Sentinel, RG
Ce que vous devriez obtenir Sentinel exécute la capacité derrière RG : calculer la porte d’acceptation de la recette humaine et émettre son vérificateur pour Nexus. Il répond passed, failed, awaiting ou stale, avec les raisons, et ne valide jamais une étape non réalisée.
La plupart des agents ont plusieurs rôles. Atlas est Analyst et Product Manager ; Forge Architect, Developer et Tech Writer ; Sentinel QA Engineer, UX Reviewer et un rôle Recette (acceptation humaine) ; Nexus Scrum Master, Quick Flow, Autopilot Controller et Parallel Supervisor. Quand auto_role_activation vaut true (par défaut), l’agent change de rôle tout seul lorsque la conversation en appelle un autre, et il le dit d’abord : « I’m switching to [Role] mode — [reason]. Say skip to stay in current mode. » Répondez skip et il reste. Vous pouvez aussi demander un rôle explicitement.
Le mot architecture envoie Forge dans son rôle Architect
2, contextes
Situations détectées pendant le travail
Un changement touchant plus de cinq fichiers (multi_file_change_gt_5) appelle le rôle Architect ; une version candidate sur un environnement de test appelle le rôle Recette de Sentinel
3, raisonnement
Découvertes faites en cours d’exécution
Le codage révèle un problème d’architecture (implementation_exposes_architectural_issue), le rôle Architect revient
Mots-clés types par agent, tirés de role-triggers.yaml
Agent
Rôle par défaut
Rôles et mots-clés types
Atlas
pm
analyst: analyze, research, market, benchmark, SWOT, stakeholder; pm: PRD, product brief, roadmap, MVP, user story
qa: test, review, bug, edge case, coverage; ux-review: UX, responsive, accessibility, usability; uat: recette, UAT, acceptance test, what should I check
Nexus
scrum-master
scrum-master: sprint, story, backlog, epic; quick-flow: quick, hotfix, simple, patch; autopilot: autopilot, full pipeline, from scratch; parallel-supervisor: parallel, concurrent, batch
SEO Scout, Chief, Judge
seo-chief
seo-chief: SEO, SERP, meta tags; seo-scout: crawl, sitemap, robots.txt, core web vitals; seo-judge: E-E-A-T, PageSpeed, CrUX, quality gate
Atelier
design-engine
Atelier, /design, design tokens, maquette, wireframe, landing page, make it look good, accessibility, redesign
Les mots-clés incluent des mots français et anglais (par exemple « recherche », « marché », « rapide », « refonte »), si bien qu’une demande dans l’une ou l’autre langue déclenche les mêmes rôles. Les listes complètes se trouvent dans .agents/data/role-triggers.yaml, que vous pouvez lire. Notez que ce fichier donne Product Manager comme rôle par défaut d’Atlas, alors que les instructions d’Atlas présentent Analyst comme le rôle par défaut pour la recherche et la découverte.
Voir un changement de rôle automatique, et le refuser#
Commencez dans le rôle par défaut d’Atlas (Product Manager dans role-triggers.yaml), puis employez un mot de recherche. Le changement est annoncé avant d’avoir lieu.
Dans votre assistant IA
Atlas, compare nos prix à ceux des trois principaux concurrents et fais une SWOT de chacun.
Ce que vous devriez obtenir Atlas vous salue et affiche d’abord son menu, car il attend à l’activation ; renvoyez la demande si seul le menu revient. Les mots benchmark et SWOT correspondent aux motifs de l’Analyst : Atlas annonce le passage en mode Analyst avec sa raison et propose de rester dans le mode actuel si vous répondez skip. Si vous répondez skip, il continue en Product Manager et l’analyse est cadrée en conséquence.
Utile quand vous voulez un rôle que la formulation ne déclencherait pas, ou quand le changement automatique est désactivé.
Dans votre assistant IA
Sentinel, passe en rôle UX Reviewer et relis le parcours de paiement pour l’accès au clavier et les états d’erreur.
Ce que vous devriez obtenir Sentinel travaille en UX Reviewer pour toute la réponse. Si le pack Design est installé, le jugement sur le design visuel et l’accessibilité revient à Atelier, et Sentinel lui passe ces points.
Pour arrêter le changement automatique, mettez-le à false dans _bmad/config.yaml
auto_role_activation: false
Les mots de conversation : bmad-help, autopilot, parallel#
Trois formules sont des consignes à votre assistant, pas des commandes de terminal. Les taper dans un shell ne fait rien.
Mots de conversation
Dites
Effet
bmad-help
Affiche les agents et workflows installés et recommande une étape suivante. Avec Dev Studio, c’est aussi un workflow de Miriam.
autopilot
Lance Nexus en mode pipeline complet : Discovery, Build et Ship avec points de contrôle, après l’intake de chaque pack concerné.
parallel
Demande à Nexus de détecter les tâches indépendantes et de les superviser en parallèle ; le vrai parallélisme dépend de votre outil hôte.
Les arrêts qui vous attendent sont fixés par checkpoints dans _bmad/config.yaml. La valeur execution_mode fixe le rôle de départ de Nexus : manual le démarre en Scrum Master, autopilot en Autopilot Controller ; hybrid n’a pas de rôle de départ propre.
Dans votre assistant IA
autopilot. Le projet : un portail client où les clients téléchargent leurs factures et ouvrent des tickets de support. Arrête-toi au PRD et à l’architecture.
Ce que vous devriez obtenir Nexus devient Autopilot Controller et déroule le pipeline : Discovery avec Atlas (et la spécification UX de Sentinel), un point de contrôle au PRD, Build avec Forge, un point de contrôle à l’architecture, puis stories, tests et Ship. Avec execution_mode: autopilot il annonce que l’autopilot est actif. Avec les checkpoints par défaut, deux autres arrêts s’appliquent : chaque story terminée est seulement signalée (story vaut notify_only en mode autopilot) et la livraison finale attend votre accord (delivery).
Des stories indépendantes qui ne partagent aucun fichier peuvent tourner en parallèle ; les dépendantes, les modifications d’un même fichier, l’architecture avant le code et la revue avant la fusion restent séquentielles.
Dans votre assistant IA
Nexus, découpe le travail approuvé en tâches indépendantes. Donne à chaque rôle un périmètre, des fichiers à sa charge et une définition de terminé. Utilise des agents en parallèle uniquement si cet outil le permet ; sinon, exécute les tâches successivement. Intègre les résultats et demande à Sentinel de vérifier le parcours complet.
Ce que vous devriez obtenir Des missions délimitées, des dépendances explicites et une revue intégrée. L’exécution parallèle vient de l’outil hôte ; s’il ne peut pas créer d’agents indépendants, Nexus le dit et traite les tâches une par une. Pour une trace durable des tentatives et des contrôles indépendants, Nexus peut utiliser bmad-plus nexus.
Manual : vous appelez les agents. Autopilot : Nexus gère le pipeline. Hybrid : proposé par l’installateur comme autopilot avec points de contrôle fréquents ; les instructions de Nexus ne lui définissent aucun comportement au-delà des valeurs de checkpoints. Fixé à l’installation avec --mode ; seul autopilot met story à notify_only, les autres modes demandent aussi un accord à cet endroit.
auto_role_activation
true, false
Indique si les agents changent de rôle d’eux-mêmes.
parallel_execution
true, false
Indique si Nexus peut lancer des tâches indépendantes en parallèle.
checkpoints
discovery, architecture, story, delivery : require_approval, notify_only, auto
Indique si chaque étape s’arrête pour votre accord, informe seulement, ou continue en journalisant.
Core et Dev Studio se recoupent (Atlas et Miriam, Forge et Bezalel, Sentinel et Oholiab, Nexus et Oholiab pour les sprints). Les deux peuvent coexister ; celui que vous nommez est celui qui répond.
Design recoupe la revue UX de Sentinel et Rachel. Ses mots déclencheurs sont volontairement étroits (Atelier, /design, design tokens, maquette, wireframe, landing page, make it look good, accessibilité, refonte) : les simples mots design, UI et interface restent à Forge en rôle Architect et à la revue UX de Sentinel. Quand Design est installé, ses règles gouvernent le design visuel et l’accessibilité.
Les agents SEO (Scout, Chief, Judge) ont leurs propres mots déclencheurs et aiguillent aussi les mots de commande /seo.
L’outil doit tourner dans le dossier où BMAD+ a été installé, pour charger AGENTS.md et son fichier d’adaptateur (par exemple CLAUDE.md ou GEMINI.md).
02
Vérifier que les fichiers existent
Il faut AGENTS.md à la racine du projet et le dossier .agents/skills/. Si aucun adaptateur n’a été choisi à l’installation, relancez l’installation avec --tools.
Dans le terminal du projet
npx bmad-plus install --tools claude-code --yes
03
Redémarrer la session
Beaucoup d’outils ne lisent les instructions du projet qu’au démarrage de la session. Ouvrez une nouvelle session, puis redites le nom de l’agent.
04
Lancer le diagnostic
Il vérifie l’installation et nomme les fichiers manquants ou modifiés.
Dans le terminal du projet
npx bmad-plus doctor
Remarque· Ce que l’activation ne fait pas
Un agent est un ensemble d’instructions que votre outil suit. Rien ne tourne en arrière-plan, il n’y a pas de planificateur, et les agents parallèles, la navigation et l’exécution de commandes n’existent que si votre outil hôte les fournit. Les permissions et le modèle viennent de cet outil.