Utiliser BMAD+ en équipe

BMAD+ vit dans le projet : une équipe le partage donc comme n’importe quelle autre partie du dépôt, en décidant ce qui est versionné, ce qui est configuré de la même façon pour tous et qui le modifie. Cette page liste ces décisions et les faits qui rendent chacune sûre : hashes de propriété, modifications préservées, politique de mise à jour par projet, adaptateurs générés à partir d’un seul socle. Elle s’adresse aux responsables techniques et à quiconque doit accueillir des collègues qui utilisent des outils IA différents. Quand un choix relève du goût plutôt que d’un fait, le texte le dit.

Ce qu’il faut versionner et ce qui reste local#

Conventions à convenir ensemble#

Un socle, un adaptateur par collègue#

Tous les adaptateurs sont générés à partir du même registre que AGENTS.md : un collègue sous Cursor et un autre sous Claude Code obtiennent donc la même liste et les mêmes règles, seul le format de fichier diffère. --tools accepte plusieurs ids à la fois (--tools claude-code,cursor), all ou none. L’installateur détecte les outils d’après leurs dossiers (.claude/, .gemini/, .cursor/, .codex/, .opencode/, .aider.conf.yml) quand vous ne passez pas --tools ; --yes sans outil détecté n’écrit aucun adaptateur. Un adaptateur BMAD+ que vous avez modifié est préservé. Un fichier d’instructions que vous avez écrit vous-même est préservé par une installation interactive et par update ; install --yes le copie d’abord en <file>.bak, puis le remplace. Les anciens fichiers de l’installateur sont sauvegardés en <file>.bak.

Un collègue qui ajoute un outil plus tard relance l’installateur avec cet outil : l’exécution garde ce qui est déjà installé et ajoute l’adaptateur manquant. --tools none installe agents, compétences et mémoire sans toucher à la configuration d’aucun outil, ce qui convient à un projet dont le CLAUDE.md ou l’AGENTS.md est tenu à la main.

Une politique de mise à jour sûre#

Le défaut est la notification : les instructions générées demandent à l’assistant de lancer update-check une fois par session et de le signaler. Rien n’est appliqué. Pour une équipe, le schéma pratique est une personne (ou un job de CI) qui décide du moment, applique update, relit le rapport et commite ; les autres reçoivent le résultat à leur prochain pull. Si l’équipe veut que les mises à jour passent sans humain, auto exige une plage semver explicite et plusieurs garde-fous : le résultat du registre doit être frais, les fichiers gérés inchangés, l’inventaire de hashes de l’installation complet, la version cible exactement celle de la commande, et l’exigence Node satisfaite. Une recherche hors ligne, périmée ou en échec n’autorise jamais une mise à jour automatique.

$ npx bmad-plus update-policy
Update policy: notify; channel=latest; range=none; prereleases=false
$ npx bmad-plus update-policy --json
{"policy":{"mode":"notify","channel":"latest","allowedRange":null,"allowPrerelease":false,"registry":"https://registry.npmjs.org/"},"changed":false}
$ npx bmad-plus update-policy --mode auto --range "^0.23.0"
Update policy saved: auto; channel=latest; range=^0.23.0; prereleases=false
$ npx bmad-plus update-policy --mode notify
Update policy saved: notify; channel=latest; range=^0.23.0; prereleases=false
$ npx bmad-plus update-check --offline --json
{"schemaVersion":1,"installedVersion":"0.23.0","runningVersion":"0.23.0","latestVersion":null,"targetVersion":null,"channel":"latest","status":"unknown","checkedAt":null,"source":"none","stale":false,"updateAvailable":null,"releaseEligible":false,"versionEligible":false,"canAutoApply":false,"engineCompatible":null,"engines":{},"reason":"offline"}

• off arrête toute recherche. notify (défaut) informe. auto exige --range ; ajoutez --allow-prerelease ou --stable-only pour gérer les préversions. Le registre est fixé à https://registry.npmjs.org/.
• Une mise à jour préserve les fichiers modifiés depuis leur hash enregistré et les signale ; un conflit bloque la voie automatique. Les fichiers qu’une nouvelle version ne livre plus sont retirés après une sauvegarde restaurable. Chaque mise à jour appliquée écrit .bmad/updates/<receipt-id>/ avec receipt.json et backups/ ; update --restore <receipt-id> --yes y revient et refuse d’écraser des modifications locales ultérieures.
• Une installation antérieure à 0.13 (sans hashes de fichiers) ne peut pas être mise à jour automatiquement ; une migration explicite, npx --yes bmad-plus@0.23.1 update --yes, sauvegarde ce qu’elle remplace.
• install ne change jamais la version installée : un retour en arrière est refusé et une montée de version passe par update. Si deux collègues ont installé des versions différentes, celui qui a la plus ancienne lance update.
• Un verrou .bmad/update.lock protège le projet pendant une mise à jour (considéré périmé après 60 minutes ou quand son propriétaire est mort) ; doctor signale un verrou qui n’est pas le sien.

CI et portes#

BMAD+ n’installe aucun hook Git ni hook de cycle de vie dans votre projet, parce qu’une consigne peut être contournée. Ce qu’une équipe veut imposer, elle l’impose avec sa propre CI, grâce à des codes de sortie conçus pour cela.

Accueillir un collègue#

1. 01

   Récupérer le dépôt et vérifier l’installation

   Si les fichiers générés sont commités, doctor fonctionne déjà. Sinon, lancez l’installateur avec la liste de packs de l’équipe, puis doctor.

   Dans le terminal du projet

   npx bmad-plus@0.23.1 install --packs core,memory --tools claude-code
   npx bmad-plus@0.23.1 doctor

2. 02

   Ajouter votre propre outil

   Installez avec l’id de votre outil ; les fichiers existants sont conservés et votre adaptateur est ajouté.

   Dans le terminal du projet

   npx bmad-plus@0.23.1 install --packs core,memory --tools cursor

3. 03

   Lire le socle, puis interroger l’assistant

   Ouvrez AGENTS.md pour la liste des agents et les règles de l’équipe, puis tapez bmad-help dans la conversation. Lisez les réglages de _bmad/config.yaml pour savoir quels points de contrôle s’arrêteront pour vous demander.

4. 04

   Relier la mémoire à votre machine

   Avec le pack Memory, l’installation détecte un cerveau sur votre machine (BMAD_PLUS_BRAIN, un dossier _brain/ dans un dossier parent, ~/.bmad-plus/brain/, puis un ~/.claude/memory/ non vide) et l’enregistre dans .agents/memory/.brain-link. Ce fichier est à vous seul ; les fichiers de mémoire du projet qui l’entourent sont ceux de l’équipe.

Notes de gouvernance pour les équipes#

• Approbations : si l’équipe veut qu’une personne approuve l’architecture et la livraison, gardez require_approval sur ces points de contrôle. Un autopilot avec auto partout est un choix délibéré, pas un défaut.
• Budget : un essaim plus grand que swarm.budget est refusé tant qu’un humain n’a pas dit oui ; la génération de médias payants est demandée à chaque fois. Personne ne devrait passer --approved à la place d’un autre.
• OSINT : rechercher une personne nommée exige un but et une base légale consignés, à chaque exécution. En équipe, cela suppose quelqu’un qui porte cette décision. Voir la page de confiance.
• Shield : les rapports sont générés par IA et portent la mention « not legal advice » ; une décision de conformité reste à une personne qualifiée.
• Secrets : les clés d’API relèvent de l’environnement de chaque personne ou de la CI, jamais du dépôt. Le plancher de masquage de la revue et celui des notes de recette masquent les formes courantes d’identifiants ; ils ne remplacent pas le fait de ne pas commiter de secrets.
• Propriété : chaque fichier écrit par BMAD+ est haché. Un fichier modifié par un collègue est conservé par la mise à jour et la désinstallation et signalé par doctor comme modifié (un avertissement) : la personnalisation locale est visible, pas écrasée en silence.

Lis _bmad/config.yaml, _bmad/update-policy.json s’il existe, _bmad/review-rules.yaml s’il existe et le manifeste _bmad/.bmad-plus-install.json. Résume dans un tableau : version installée, packs, outils, mode d’exécution, comportement de chaque point de contrôle, mode uat, budget d’essaim, mode et plage de la politique de mise à jour. Liste ensuite ce qu’un nouveau collègue devrait faire pour obtenir la même configuration, et signale tout réglage qui semble incohérent avec les autres. Ne change rien.