Ce qu’est BMAD+, ce que fait chaque pack et chaque agent, toutes les commandes et tous les fichiers, et des guides pas à pas. Commencez par le guide rapide ci-dessous ou choisissez un thème.
Commencez par une petite tâche dans votre projet. Ce guide distingue les commandes du terminal, les demandes à votre assistant IA et les étapes de mise à jour de BMAD+.
Démarrer, pas à pas
Il vous faut Node.js 20 ou plus récent et votre outil habituel de développement avec l’IA. BMAD+ fournit les instructions, les rôles et les workflows ; votre outil fournit le modèle et les autorisations d’exécution.
01
Ouvrir le dossier du projet
Ouvrez un terminal dans le dépôt sur lequel vous souhaitez travailler, puis vérifiez la version de Node.js. Conservez votre méthode habituelle de gestion de versions.
Dans le terminal du projet
node --version
La commande doit afficher v20 ou plus récent. Installez ou mettez à jour Node.js séparément si nécessaire.
02
Installer BMAD+ et choisir vos outils
Lancez l’installateur. Sélectionnez les adaptateurs de vos outils IA et les packs utiles au projet. Core contient Atlas, Forge, Sentinel et Nexus.
Dans le terminal du projet
npx bmad-plus@0.23.1 install
L’installateur crée les instructions des agents, le socle partagé et les adaptateurs sélectionnés. Certains packs facultatifs nécessitent d’autres environnements ou des accès API.
03
Démarrer une session dans ce même dossier
Ouvrez ou redémarrez votre assistant de code IA dans le projet pour qu’il charge son adaptateur et AGENTS.md. Demandez-lui les agents et workflows installés.
Dans votre assistant IA
bmad-help
Aucune commande d’initialisation BMAD+ supplémentaire n’est nécessaire. bmad-help est un message à l’assistant, pas une commande de terminal.
04
Confier une tâche précise à un rôle
Décrivez l’objectif, les contraintes et le résultat attendu. Pour une idée nouvelle, commencez avec Atlas. Pour modifier du code existant, commencez avec Forge.
Dans votre assistant IA
Atlas, aide-moi à cadrer une petite application de facturation pour indépendants. Pose des questions sur les utilisateurs, identifie le premier parcours utile et rédige un brief avec des critères d’acceptation.
Relisez le brief avant de demander à Forge d’implémenter une story. Un livrable précis facilite la vérification des progrès.
05
Vérifier le résultat et conserver le contexte
Demandez à Sentinel de contrôler le changement selon les critères d’acceptation. Demandez les résultats des tests et une courte transmission pour la prochaine session.
Dans votre assistant IA
Sentinel, relis ce changement selon les critères d’acceptation. Vérifie les principaux cas de réussite et d’échec, signale les problèmes restants et résume ce que la prochaine session doit savoir. Si le CLI BMAD+ est disponible, scelle le périmètre avec bmad-plus review scope, applique les règles de sa checklist, cite le code de chaque remarque, rends compte de chaque fichier retenu, puis rapporte ce que répond bmad-plus review gate.
Relisez les changements et les résultats des tests. L’assistant suit les autorisations et les capacités de son outil hôte.
Exemples à adapter
Remplacez les détails du projet par les vôtres. Ces points de départ précisent le résultat que vous pourrez relire.
Passer d’une idée à une première version
À utiliser après avoir décrit les utilisateurs et le problème.
Dans votre assistant IA
Nexus, planifie la première version utilisable de mon application de prise de rendez-vous. Demande à Atlas de cadrer le périmètre, à Forge de proposer l’implémentation minimale et à Sentinel de définir les contrôles d’acceptation. Liste les dépendances et arrête-toi à la revue du plan avant l’implémentation.
Résultat attendu : un plan priorisé, une première story limitée et des points de revue explicites.
Corriger un bug dans un projet existant
Indiquez le comportement observé, les étapes de reproduction et les erreurs pertinentes.
Dans votre assistant IA
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. Ajoute un contrôle de régression correspondant à l’échec réel, puis demande à Sentinel de revoir le parcours concerné.
Résultat attendu : un échec reproduit, une correction ciblée et la preuve que la régression est couverte.
Concevoir un écran avec Atelier
À utiliser avec le pack Design facultatif installé. Atelier pose d’abord ses questions, puis suit des règles vérifiables.
Dans votre assistant IA
Atelier, fais la lecture design de la liste des factures de mon application, construis l’écran et termine par le verdict de pré-vol.
Résultat attendu : la lecture design enregistrée, l’écran avec tous ses états couverts, et le verdict de pré-vol cité en dernière ligne.
Reprendre sans perdre les décisions
À utiliser au début d’une nouvelle session dans le même projet ; aucun pack facultatif n’est nécessaire.
Dans votre assistant IA
Lis AGENTS.md et la mémoire de projet disponible. Résume le dernier état vérifié, les décisions ouvertes et la prochaine tâche inachevée. Distingue les fonctionnalités publiées des candidates locales, et les contrôles automatisés de la recette humaine. Vérifie que les notes correspondent encore au code avant de continuer.
Résultat attendu : une reprise courte et fondée sur des éléments vérifiés. Les notes apportent du contexte, à confronter au travail actuel.
Exemples avancés : coordination, recette et mémoire
Coordonner du travail indépendant
À utiliser si votre outil hôte gère les agents en parallèle et si les tâches n’écrivent pas dans les mêmes fichiers.
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.
Résultat attendu : des missions délimitées, des dépendances explicites et une revue intégrée. L’exécution parallèle est fournie par l’outil hôte.
Faire confirmer une livraison par une personne
À utiliser quand une version arrive sur votre environnement de test et que quelqu’un doit la vérifier à l’écran.
Dans votre assistant IA
Sentinel, écris la recette de cette livraison sur notre environnement de test. Une étape par geste, un fait vérifiable par ligne, les libellés cités depuis le code, et signale les étapes qui écrivent pour de vrai. Fabrique la page, puis donne-moi le lien, la durée et ce que je ne dois pas sauter. Utilise si possible des données d’essai jetables, nomme le dossier et les fichiers que chaque commande modifie, et distingue les preuves automatisées des réponses de la personne. Avant de me remettre la page, construis-la avec uat build, vérifie les garanties qu’elle liste, joue toi-même le passage essentiel dans un vrai navigateur — démarrer, cocher, écrire une remarque, recharger, tout revient — et dis-moi quels contrôles ont tourné.
Résultat attendu : une page qu’une personne non technique peut jouer, et un passage que l’agent relit pour classer chaque échec avant toute correction.
Sauvegarder une session avec Zecher
À utiliser avant de terminer une session, avec le pack Memory facultatif installé.
Dans votre assistant IA
Zecher, mets à jour la mémoire de ce projet à partir des changements et des vérifications réellement effectués. Distingue ce qui est développé, testé, publié et encore en attente. Consigne les décisions et les preuves utiles, archive les notes remplacées sans les supprimer et écris un court prompt pour la prochaine session. Garde la mémoire dans ce projet et exclus les secrets.
Résultat attendu : un contexte actuel concis, une passation datée et un prompt de reprise qui indique la prochaine tâche inachevée.
Relire un passage sans deviner
À utiliser lorsqu’une personne a terminé ou interrompu une recette.
Dans votre assistant IA
Sentinel, lis le dernier passage de recette et compare son empreinte avec la recette actuelle. Demande ce qui a réellement été fait lorsque les réponses et les preuves se contredisent. Classe les échecs avant de proposer des corrections, vérifie les étapes d’écriture en lecture seule et distingue les observations humaines, les contrôles automatisés et toute acceptation explicite de risque par son responsable nommé. Ne valide jamais une étape non réalisée.
Résultat attendu : un verdict clair, des preuves pour les écritures confirmées et une courte liste des contrôles qui restent à effectuer.
Vérifier et appliquer les mises à jour
Lancez ces commandes depuis le projet installé. Les contrôles ci-dessous utilisent une CLI déjà disponible. Si npx --no-install ne la trouve pas, utilisez la commande avec version explicite indiquée ensuite.
Vérifier la version publiée
Comparez la version installée avec npm. Le résultat contient installedVersion, latestVersion, status, updateAvailable et canAutoApply.
Si la CLI manque ou si l’installation est ancienne
Cette commande explicite télécharge la CLI documentée et vérifie le projet. Pour une version 0.12.2 ou antérieure, utilisez la migration du paragraphe suivant pour ajouter la détection des mises à jour.
Cette commande consulte à nouveau npm et demande confirmation de la version cible exacte. Lisez le rapport, notamment les fichiers personnalisés conservés.
Dans le terminal du projet
npx --no-install bmad-plus update --latest
La notification est le mode par défaut. Vérifier une version n’active pas les mises à jour automatiques. Un résultat hors ligne, périmé ou indisponible signifie que la dernière version est inconnue.
Les mises à jour préservent les personnalisations identifiées. Le rapport peut signaler une application partielle lorsque des fichiers locaux sont conservés ; le numéro installé ne prouve pas que chaque fichier correspond à la version.
Après une mise à jour réussie, demandez à l’assistant de relire AGENTS.md et les compétences utiles, ou démarrez une nouvelle session.
La mise à jour du package BMAD+ et la synchronisation des sources BMAD-METHOD sont distinctes. Ces commandes mettent à jour BMAD+ ; elles ne fusionnent pas les sources amont dans votre projet.
Avancé : migration, comportement des mises à jour et politique automatique
Migrer depuis la version 0.12.2 ou antérieure
Utilisez une fois la CLI avec version explicite. Cette migration confirmée sauvegarde les fichiers remplacés, car les anciennes installations ne disposent pas d’empreintes complètes de propriété.
Dans le terminal du projet
npx --yes bmad-plus@0.23.1 update --yes
Facultatif : autoriser une plage de mises à jour automatiques
Activez ce mode seulement si vous souhaitez appliquer les versions admissibles dans la plage semver indiquée. La CLI vérifie toujours l’environnement, la propriété des fichiers et la politique. Le mode notify rétablit les notifications.
Dans le terminal du projet
npx --no-install bmad-plus update-policy --mode auto --range "^0.23.1"
Les reçus et sauvegardes sont dans .bmad/updates/. Remplacez RECEIPT_ID par l’identifiant réel du reçu. La restauration vérifie les sauvegardes et refuse d’écraser des modifications locales ultérieures.
Ces notes décrivent la version vérifiée sur npm. Le guide, la commande d’installation et le flux des versions correspondent à cette même publication.
v0.23.1 ·
Le site de documentation est refait en quatre langues, avec sept vidéos. Plusieurs commandes se comportent désormais exactement comme leurs pages le disent : les refus se lisent partout de la même façon, une revue de l’arbre de travail part de HEAD et le fichier de configuration est du YAML simple. Installation et mise à jour ne changent pas.
Sélection de versions récentes, datées selon leur publication réelle sur npm. Les résumés décrivent les changements livrés dans chaque version. La page du package donne l’historique complet des versions.
v0.23.1 ·
Un site plus fidèle, des commandes plus régulières
Le site de documentation est refait en quatre langues, avec sept vidéos. Plusieurs commandes se comportent désormais exactement comme leurs pages le disent : les refus se lisent partout de la même façon, une revue de l’arbre de travail part de HEAD et le fichier de configuration est du YAML simple. Installation et mise à jour ne changent pas.
Le site compte désormais 52 pages de documentation, chacune en anglais, français, espagnol et allemand, une landing refaite et sept vidéos de présentation avec sous-titres et transcriptions décrites, dont une étude de cas sur la refonte du site lui-même par un essaim d’agents.
Une mise à jour --auto que la politique n’autorise pas est refusée avec le même message partout : Update refused: automatic-updates-not-authorized. Les refus pour inventaire de propriété ancien et pour conflits locaux suivent la même forme Update refused:.
bmad-plus review scope --workspace part de HEAD quand vous ne donnez pas --base : relire du travail non commité n’échoue plus et n’embarque plus le dernier commit.
_bmad/config.yaml est écrit en YAML simple (auto_role_activation: true, et non un !!bool 'true' typé), quelle que soit la version prise en charge de js-yaml qui l’écrit.
Les fichiers d’instructions générés demandent de passer le contrôle de version sans le mentionner quand npx ne trouve pas de copie locale de bmad-plus ; les erreurs de Nexus portent une seule fois le préfixe Nexus: au lieu de deux.
Shield nomme PCI DSS v4.0.1 partout, les compétences swarm annoncent trois types, la variante Bash du pack Backup affiche la taille de l’archive comme la variante PowerShell, et la description npm, les mots-clés et les crédits du README sont mis à jour.
Un pack déclare désormais les questions auxquelles il lui faut une réponse avant d’agir, et Nexus peut lancer un essaim de sous-agents, un panel simulé ou un jury, dans un budget que vous fixez. Atelier, le moteur de design, devient le dixième pack. Installation et mise à jour ne changent pas.
bmad-plus intake pose les questions d’un pack par petits lots, marque les indispensables, propose des valeurs par défaut, note ce que vous ignorez avec le risque associé, et rédige le brief qui devient le contrat de tout ce que le pack fait ensuite. Rien n’y est inventé.
bmad-plus swarm tire des unités simulées à partir d’un profil sous une graine, écrit un brief par sous-agent, valide chaque fichier de réponse, ne compte que les réponses valides, et rappelle que des acheteurs simulés ne sont pas des clients. Le bloc swarm de _bmad/config.yaml fixe le nombre de sous-agents lancés avant que l’assistant ne vous demande ; la génération de médias payante demande toujours.
Le registre enregistre désormais quelles compétences un agent pilote, de quel paquet npm viennent les compétences d’un pack, quelles étapes de pipeline et quelles portes un pack déclare et quel questionnaire il joue. Les instructions générées portent tout cela, rien n’est tapé deux fois.
Pack Design : Atelier, construit à partir du paquet design-skill, vous interroge avec une lecture design, puis construit, audite ou refond une interface selon des règles vérifiables. L’installateur copie ses trois compétences et leurs modules de référence, et doctor les vérifie.
Une porte de déclencheurs refuse les règles d’activation automatique qui nomment un agent ou un pipeline inconnu du registre, et l’installateur n’écrit rien quand les fichiers d’un pack ne peuvent pas tous être listés d’abord.
BMAD+ déclare désormais chaque envoi de données et chaque processus qu’il lance, et sa CI refuse tout ce qui n’est pas déclaré. La page de recette et le rapport SEO ne chargent plus rien depuis d’autres sites, les appels OSINT passent uniquement en HTTPS, et Shield gagne un dossier de sécurité fondé sur des preuves exécutées et un registre des traitements IA. Rien ne change dans l’installation ou la mise à jour.
Le registre indique ce que BMAD+ envoie, à qui, quand et avec quel consentement ; SECURITY.md l’affiche et les instructions installées pour les agents le résument. Une vérification de build échoue quand un appel réseau ou un processus lancé n’est pas déclaré. BMAD+ n’a aucune télémétrie, et la vérification de mise à jour peut être désactivée.
La page de recette ne charge plus Google Fonts ni rien d’un autre site : l’ouvrir ne le signale à personne. Le build refuse une page qui le ferait, et un vrai navigateur contrôle chaque requête d’un passage. Le rapport HTML SEO s’ouvre aussi hors ligne.
La clé d’API Google du pack SEO voyage dans un en-tête de requête, jamais dans une URL, et n’apparaît pas dans les messages d’erreur. Les appels aux fournisseurs OSINT refusent tout sauf HTTPS et ne suivent jamais une redirection vers un autre hôte.
Les captures d’écran SEO n’atteignent que l’adresse vérifiée : Chromium ne résout rien d’autre, et les redirections ou ressources qui pointent ailleurs sont bloquées et listées.
Shield : bmad-plus assurance construit un dossier de sécurité dont chaque preuve est une vérification réellement exécutée, consignée dans un journal infalsifiable ; bmad-plus ai-register tient le registre des outils IA d’un projet et signale ceux qui n’y figurent pas ; six règles de revue nomment les contrôles de conformité qu’un changement touche.
Le serveur MCP ferme proprement les flux SSE quand un client part ou que le serveur s’arrête, et accepte les dates de jeton avec un décalage horaire.
L’assistant ne voit pas les agents. Que vérifier ?
Vérifiez qu’il est ouvert dans le projet installé, que son adaptateur a été choisi et que AGENTS.md et .agents/skills/ existent. Ouvrez une nouvelle session et demandez-lui de lire ces instructions. Chaque outil a ses propres règles de chargement.
Faut-il taper autopilot ou parallel dans le terminal ?
Non. bmad-help, autopilot et parallel sont des consignes de conversation pour l’assistant IA. Les commandes du terminal utilisent la CLI BMAD+, comme dans les exemples ci-dessus.
Le contrôle indique unknown ou offline. Suis-je à jour ?
Ce résultat ne permet pas de connaître la dernière version publiée. Continuez le travail puis relancez le contrôle quand le registre sera accessible. Un contrôle indisponible n’autorise pas à modifier la politique de mise à jour.