Comment fonctionne BMAD+

Cette page explique la mécanique d’un seul tenant, pour qui veut savoir ce qui se passe après npx bmad-plus install avant de lui confier un projet. BMAD+ n’est pas un programme qui exécute vos agents. C’est un ensemble de fichiers (instructions, rôles, workflows) et un petit outil en ligne de commande qui tient des registres. Votre outil de codage IA, appelé l’hôte dans ces pages, lit les fichiers et fait le travail avec son propre modèle et ses propres permissions.

L’exécution est confiée à l’hôte#

Le registre l’énonce comme un contrat : execution: host-managed, lifecycle_events: not-integrated. Concrètement, cela fait quatre choses. L’hôte fournit le modèle : BMAD+ ne détient aucune clé d’API et n’appelle aucun modèle. L’hôte fournit les permissions : une modification de fichier ou une commande shell est autorisée ou refusée par votre outil, pas par BMAD+. L’hôte fournit les sous-agents parallèles éventuels. Et rien ne tourne en arrière-plan : ni démon, ni planificateur, ni télémétrie.

Le vocabulaire#

Ce que l’installateur écrit#

L’installation copie des fichiers dans votre projet et enregistre ce qu’elle a copié. Elle ne touche pas à votre code source et ne lance rien. La seule écriture hors du projet est le cerveau global du pack Memory, dans votre dossier personnel (ligne ~/.bmad-plus/brain/). Le tableau liste les emplacements ; les dernières lignes n’apparaissent que lorsque vous utilisez la fonction correspondante.

$ npx bmad-plus install --yes --lang en --packs core,design,memory --tools claude-code
●  Selected packs: ⚙️ Core, 🧠 Memory, 🎨 Design
●  Detected IDEs: Claude Code
●  🧠 Global brain created: /home/dev/.bmad-plus/brain
◇  ✅ 6 agents, 9 skills, 5 files copied
◇  ✅ 1 IDE(s) configured
└  BMAD+ is ready! Talk to Atlas to get started 🚀
$ npx bmad-plus doctor
│  98/98 checks passed
│  0 error(s), 0 warning(s)
│  Installed: v0.23.0 | Executing CLI: v0.23.0
│  Ownership inventory: complete
│  Integrations use host-managed execution; host capabilities were not probed.
# Extrait : l’encadré de guide de l’installateur et les lignes vides ont été retirés, et le dossier personnel est abrégé. Les nombres dépendent des packs choisis. La ligne du cerveau n’apparaît que si le pack Memory ne trouve aucun cerveau existant.

Qui exécute quoi#

D’une phrase à des fichiers#

1. 01

   Vous écrivez à votre hôte

   Vous interpellez un agent par son nom dans la conversation de votre outil IA, dans votre langue.

   Dans le terminal du projet

   Atlas, help me define a small invoicing app for freelancers.

2. 02

   L’hôte charge les instructions

   L’hôte lit son fichier d’adaptateur, qui renvoie à AGENTS.md. Le socle nomme Atlas et le dossier de son SKILL.md. C’est la lecture de ce fichier qui transforme un assistant généraliste en la persona.

3. 03

   Les réglages sont lus, puis Atlas attend

   L’agent lit _bmad/config.yaml (votre langue, le mode d’exécution, le comportement des points de contrôle), vous salue et affiche son menu de capacités (par exemple CB pour un product brief, MR pour une étude de marché). Atlas attend votre choix : un numéro, un code ou une phrase qui correspond à l’un d’eux.

4. 04

   Un rôle est choisi

   Atlas a deux rôles, Analyste (recherche, découverte) et Product Manager (planification, product briefs, PRD). Un mot-clé comme « market » ou « PRD », ou une situation comme un nouveau projet, fait changer de rôle, et l’agent le dit. Le mode d’exécution et les points de contrôle décident ensuite s’il s’arrête pour demander ou continue.

5. 05

   Un livrable est écrit

   Une fois votre choix fait, par exemple CB pour créer un product brief, l’hôte écrit le résultat dans le projet avec ses propres permissions, normalement dans le dossier de sortie (_bmad-output/ par défaut). Vous le relisez comme n’importe quel fichier.

6. 06

   La CLI tient les registres quand il le faut

   Pour l’intake, les essaims, les revues ou la recette, l’agent appelle bmad-plus pour valider, compter ou sceller des preuves. La CLI répond par des fichiers et des codes de sortie, jamais par des opinions.

Comment les rôles basculent#

Les règles se trouvent dans .agents/data/role-triggers.yaml. Chaque agent peut changer de rôle à trois niveaux, et il annonce le changement pour que vous puissiez le refuser.

L’annonce ressemble à « I’m switching to QA mode - financial calculations detected. Say ’skip’ to stay in current mode. » Mettre auto_role_activation: false dans _bmad/config.yaml désactive le basculement automatique ; vous pouvez toujours demander un rôle par son nom.

Réglages et modes d’exécution#

L’installateur écrit _bmad/config.yaml une fois et conserve vos modifications aux installations suivantes. execution_mode vaut manual par défaut : vous appelez chaque agent vous-même. autopilot laisse Nexus dérouler tout le pipeline ; hybrid est de l’autopilot avec des points de contrôle fréquents. Chaque point de contrôle (discovery, architecture, story, delivery) vaut require_approval, notify_only ou auto.

execution_mode: 'manual'
auto_role_activation: true
parallel_execution: true
checkpoints:
  discovery: 'require_approval'
  architecture: 'require_approval'
  story: 'require_approval'
  delivery: 'require_approval'
uat:
  mode: 'advisory'
swarm:
  budget: 26
  wave: 10
  media_credits: 'ask'

Fichiers générés et vos modifications#

Le socle et les adaptateurs sont générés à partir de registry.yaml dans le dépôt source de BMAD+, si bien que les nombres et les listes ne peuvent pas diverger des déclarations. Dans votre projet, vous pouvez quand même ajouter vos propres règles à un adaptateur. L’installateur enregistre un hash SHA-256 pour chaque fichier qu’il écrit ; un adaptateur ou une compétence dont le hash ne correspond plus est traité comme le vôtre et préservé par les mises à jour et par la désinstallation.

Ce que BMAD+ ne fait volontairement pas#

• Pas de runtime de modèle : il n’appelle aucune API de LLM, ne détient aucune clé pour en utiliser une et n’exécute aucune boucle d’agent propre.
• Pas de processus en arrière-plan : ni démon, ni planificateur, ni exporteur de télémétrie, ni mise à jour automatique silencieuse.
• Pas de moteur de revue qui devine : les constats que le code ne permet pas d’ancrer sont signalés comme tels, jamais repositionnés par un modèle.
• Pas de correction automatique issue d’une revue : une revue n’accorde aucune permission d’écriture, et la recette humaine reste la porte de livraison.
• Pas d’extension d’IDE et pas de publication sur GitHub, GitLab ou d’autres forges.