Un parcours de débutant, du terminal vide à un premier résultat relu : installer, vérifier, parler à un premier agent, relire, garder le contexte, rester à jour. Chaque étape avec la vraie commande.
Cette page vous mène de rien à un premier résultat que vous avez relu vous-même, dans un ordre qui marche. Il vous faut un dossier de projet, Node.js 20 ou plus récent, et un outil de codage IA que vous utilisez déjà (Claude Code, Gemini CLI, Cursor, Codex CLI et d’autres). BMAD+ fournit les instructions, les rôles et les workflows ; votre outil fournit le modèle et les permissions de modifier des fichiers et d’exécuter des commandes. Rien ici ne demande un compte BMAD+, une clé d’API propre ou un service en arrière-plan.
BMAD+ en brefCe que BMAD+ installe, comment un pack pose ses questions avant d’agir, comment un essaim est compté honnêtement, et les dix packs.Transcription
BMAD+ installe des rôles, des workflows et un contexte partagé dans l’outil de codage IA que vous utilisez déjà. Tout commence par des questions : un pack déclare ce qu’il doit savoir avant d’agir. Vous répondez quelques-unes à la fois, et ce que vous ignorez est noté comme inconnu, avec son risque. Ensuite, Nexus peut lancer un essaim de sous-agents, dans un budget que vous fixez. Chacun lit un brief et écrit une réponse, et seules les réponses valides sont comptées. Le décompte affiché est une démonstration, et il le dit sans détour : des unités simulées ne sont pas des personnes. Pour un travail planifié, Nexus exige des contrôles indépendants avant d’accepter un résultat. Les quatre rôles du Core, neuf packs optionnels, et des adaptateurs pour sept outils de codage IA. Une seule commande npx, depuis le dossier de votre projet, suffit pour l’installer.
Les commandes qui commencent par npx bmad-plus vont dans un terminal. Les phrases comme bmad-help, autopilot, parallel ou « Atlas, ... » vont dans la conversation de votre outil IA. Taper autopilot dans un terminal ne sert à rien.
Ouvrez un terminal dans votre projet et vérifiez Node.js
Utilisez le dépôt sur lequel vous voulez travailler. La commande doit afficher v20 ou plus ; installez ou mettez à jour Node.js séparément sinon.
Dans le terminal du projet
node --version
02
Lancez l’installateur
L’assistant interactif demande votre langue, les packs, les outils (si aucun n’est détecté), votre nom, votre langue de communication, l’URL d’un environnement de test pour les recettes (facultatif) et le mode d’exécution. Core est toujours installé. Les outils sont détectés à partir de dossiers comme .claude/ ou .cursor/.
Dans le terminal du projet
npx bmad-plus@0.23.1 install
03
Ou installez sans question
Pour un script ou un premier essai, donnez tout en ligne de commande. --yes saute l’assistant (anglais par défaut sauf si vous passez --lang) ; --tools accepte des ids comme claude-code, gemini-cli, antigravity, cursor, codex-cli, opencode, aider, ou all ou none.
L’installateur se termine par un court guide de « à qui parler » et une ligne comme « BMAD+ is ready! Talk to Atlas to get started ». Avec un id de pack ou d’outil inconnu, il s’arrête et affiche les ids valides ; sans terminal et sans --yes, il refuse de s’exécuter.
Ce que l’installation laisse dans un projet Git
$ npx bmad-plus install --yes --lang en --packs core --tools claude-code$ git status --short?? .agents/?? AGENTS.md?? CLAUDE.md?? _bmad/$ ls .agents/skillsagent-architect-devagent-orchestratoragent-qualityagent-strategistbmad-plus-autopilotbmad-plus-intakebmad-plus-parallelbmad-plus-swarmbmad-plus-syncbmad-plus-uat# Quatre nouveaux chemins, rien dans votre arbre source. Décidez avec votre équipe de les commiter ou de les ignorer ; dans les deux cas, `_bmad/.bmad-plus-install.json` consigne les fichiers dont BMAD+ est propriétaire.
npx bmad-plus install --yes --lang en --packs core --tools claude-code
git status --short
ls .agents/skills
Sortie capturée lors d’une exécution réelle. Source: Rejoué sur un serveur de test le 2026-10-18 avec la source 0.23.0 (tools/cli/bmad-plus-cli.js) dans un projet Git jetable
L’installateur ne place pas bmad-plus dans le node_modules de votre projet, et les commandes npx --no-install utilisées à partir d’ici n’exécutent qu’une copie locale : sans elle, elles s’arrêtent avec npx canceled due to missing packages and no YES option. Cela ajoute une dépendance de développement à package.json. Sautez l’étape si vous préférez taper npx bmad-plus <command>, qui télécharge le paquet au besoin. Sans copie locale, la vérification de mise à jour que les CLAUDE.md et AGENTS.md générés demandent à votre assistant de lancer est simplement sautée.
Dans le terminal du projet
npm install --save-dev bmad-plus
02
Lancez le diagnostic
doctor est en lecture seule : il ne modifie jamais le projet et ne contacte jamais npm. Il se termine par une ligne comme « 98/98 checks passed » et « 0 error(s) » et sort avec 1 en cas d’erreur.
Dans le terminal du projet
npx --no-install bmad-plus doctor
03
Ouvrez votre outil IA dans le même dossier
Démarrez une nouvelle session (ou redémarrez l’outil) pour qu’il charge son fichier d’adaptateur et AGENTS.md. Il n’y a aucune commande d’initialisation BMAD+ supplémentaire.
04
Demandez-lui ce qu’il sait
Dans la conversation, pas dans le terminal. S’il liste Atlas, Forge, Sentinel et Nexus, votre outil a lu les instructions. Sinon, vérifiez que l’outil est ouvert dans le projet installé, que vous avez choisi son adaptateur, et que AGENTS.md et .agents/skills/ existent.
Choisissez la plus petite chose réelle dont vous avez besoin. Les quatre agents Core couvrent la plupart des départs : Atlas pour les idées et les besoins, Forge pour l’architecture et le code, Sentinel pour la revue et les tests, Nexus pour les plans et la coordination. Une bonne demande donne l’objectif, les contraintes et le résultat que vous voulez relire.
À utiliser quand il n’y a pas encore de code, ou quand vous voulez écrire le problème avant de changer quoi que ce soit.
Dans votre assistant IA
Atlas, je veux un petit outil qui permet à notre équipe support de trier les tickets entrants. Interroge-moi sur les utilisateurs et leur travail quotidien, puis rédige un product brief avec le premier workflow utile et des critères d’acceptation que je peux vérifier. Une page au plus.
Ce que vous devriez obtenir Atlas peut d’abord afficher son menu et attendre : répondez par votre demande, ou par le code de menu CB (créer un product brief). Il pose ensuite des questions et écrit le brief sous _bmad-output/ ; c’est la compétence qui choisit le nom du fichier, lisez donc le chemin qu’il indique. Lisez le brief comme le brouillon d’un collègue : les critères d’acceptation doivent être vérifiables, et tout ce que vous n’avez pas dit doit être marqué comme hypothèse.
À utiliser pour un changement borné. « Quick dev » est le chemin de Forge à cérémonie minimale ; il garde les contrôles proportionnés et saute le pipeline complet.
Dans votre assistant IA
Forge, quick dev : ajoute un état de chargement à la liste des factures. Montre-moi quels fichiers tu vas toucher avant de modifier, ne change que ceux-là, lance les tests existants qui les couvrent et dis-moi exactement ce que tu as lancé et ce qui a réussi.
Ce que vous devriez obtenir Une courte liste de fichiers, un petit diff, et un compte rendu des contrôles réellement exécutés. Si les tests n’ont pas pu tourner dans l’environnement de l’assistant, le compte rendu le dit au lieu d’annoncer un succès.
Demandez à Sentinel, un autre rôle, de vérifier ce que Forge a produit par rapport aux critères d’acceptation. Si la ligne de commande BMAD+ est disponible, la revue peut être scellée pour que son verdict découle de la couverture et non du ton : elle liste les fichiers qu’elle doit lire, cite le code de chaque constat et se termine par incomplete, findings ou clean. La page sur la revue de code explique ces trois mots.
À utiliser juste après un changement, avant de commiter.
Dans votre assistant IA
Sentinel, relis ce changement par rapport aux critères d’acceptation du brief. Vérifie le chemin nominal et les principaux chemins d’échec. Si la CLI BMAD+ est disponible, scelle d’abord le périmètre avec bmad-plus review scope first-change --workspace, cite le code de chaque constat, prends en compte chaque fichier sélectionné et rapporte ce que répond bmad-plus review gate. Dis ce que tu n’as pas pu vérifier.
Ce que vous devriez obtenir Une revue dans _bmad-output/review/first-change/ qui se termine par un verdict. incomplete signifie qu’un fichier n’a pas été pris en compte ; findings liste ce qu’il faut corriger, chaque point avec le code cité ; clean signifie aucun constat ouvert dans un périmètre entièrement couvert, ce qui n’est pas une preuve que le code est correct.
Une nouvelle session démarre de zéro. Sans le pack Memory, demandez à l’assistant une courte note de passation que vous enregistrez dans le projet : ce qui est fait et vérifié, ce qui reste, les décisions et la prochaine étape. Avec le pack Memory, Zecher s’en charge et garde décisions, leçons et passations dans .agents/memory/. Vous pouvez ajouter le pack plus tard : relancer l’installateur avec --packs core,memory n’ajoute que ce qui manque et conserve votre configuration.
Dans le terminal de votre projet, pour ajouter plus tard le pack Memory
À utiliser à la fin d’une session de travail, avec le pack Memory installé. Sans le pack, retirez le nom « Zecher », adressez-vous à votre assistant et enregistrez la note vous-même.
Dans votre assistant IA
Zecher, rédige une passation pour la prochaine session. Sépare ce qui est implémenté, ce qui est testé, ce qui est seulement prévu, les décisions prises et pourquoi, les questions ouvertes et la toute première étape à faire ensuite. Dates en AAAA-MM-JJ. N’inclus aucun secret.
Ce que vous devriez obtenir Une note datée (avec le pack Memory, .agents/memory/sessions/YYYY-MM-DD-<topic>.md et un context.md mis à jour) qu’une session à froid peut lire en moins d’une minute et croire, parce qu’elle sépare le fait du prévu.
Par défaut, BMAD+ se contente de notifier. update-check indique les versions installée et publiée sans rien changer, et hors ligne il répond « inconnu » plutôt que de deviner. update-policy affiche ou fixe si les mises à jour sont off, notify (par défaut) ou auto (qui exige une plage de versions explicite). update sans option dit « Nothing to update » quand la version installée égale le paquet qui l’exécute ; update --latest consulte npm.
Lire l’état des mises à jour, hors ligne
$ npx --no-install bmad-plus update-check --offlineInstalled: 0.23.0; running: 0.23.0; channel latest: unknownunknown: offline$ npx --no-install bmad-plus update-policyUpdate policy: notify; channel=latest; range=none; prereleases=false$ npx --no-install bmad-plus update● Installed: v0.23.0 -> Executing package: v0.23.0◆ The installed version matches this executing package. Use --latest to check the registry.└ Nothing to update.
Sortie capturée lors d’une exécution réelle. Source: Rejoué sur un serveur de test le 2026-10-18 avec la source 0.23.0 (tools/cli/bmad-plus-cli.js) dans un projet Git jetable
Quand une mise à jour s’applique, les fichiers que vous avez modifiés sont conservés et signalés, un reçu et des sauvegardes sont écrits sous .bmad/updates/, et update --restore <receipt-id> --yes la défait. Le guide d’équipe et la page sur le cycle de vie de l’installation donnent les détails.