# Votre première heure avec BMAD+
> 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.
Canonical: https://bmad-plus.rochetta.fr/fr/docs/guides/first-hour/
Language: fr
BMAD+ version: 0.23.1
Documentation reviewed: 2026-10-19
Author: Laurent Rochetta
License: MIT
Documentation BMAD+ › [Guides](https://bmad-plus.rochetta.fr/fr/docs/guides/) › Votre première heure avec BMAD+
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.
Video: [BMAD+ en bref](https://bmad-plus.rochetta.fr/media/overview-fr.mp4) — Ce que BMAD+ installe, comment un pack pose ses questions avant d’agir, comment un essaim est compté honnêtement, et les dix packs.
[Sous-titres (WebVTT)](https://bmad-plus.rochetta.fr/media/overview-fr.vtt)
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.
Transcription avec description visuelle:
- **0:00** À l’écran : Une brume bleu sombre remplit l’écran. Le titre « BMAD+ 0.23.0 » est au centre, et une lumière chaude grandit lentement derrière lui. Voix off : BMAD+ installe des rôles, des workflows et un contexte partagé dans l’outil de codage IA que vous utilisez déjà.
- **0:09** À l’écran : Un unique point de lumière ambre dans un nuage vert sombre, d’où partent de faibles rayons. La légende, en bas, indique « D’abord, demander ». Voix off : Tout commence par des questions : un pack déclare ce qu’il doit savoir avant d’agir.
- **0:16** À l’écran : Une fenêtre de terminal intitulée « ~/app ». On tape une commande : bmad-plus intake record, avec le fichier intake.yaml du pack Design et un fichier de réponses, trois réponses (surface_kind=dashboard ; audience=« Accountants in a practice, on a desktop, at month end » ; job=UNKNOWN) et une valeur par défaut pour design_system. La sortie affiche « Recorded surface_kind, audience, job, design_system », puis « design-read (design): ready — 2 answered, 1 defaulted, 1 unknown, 9 not asked yet. » et la liste des questions suivantes, chacune avec son type (choice, number ou text) : brand_assets, aesthetic_family, variance, motion, density et stack. L’image zoome sur la dernière ligne, où « Unknown: job » est entouré : « risk: There is no goal to review against, so hierarchy and the primary action cannot be judged, only decorated. » Tout le texte du terminal est en anglais. Voix off : Vous répondez quelques-unes à la fois, et ce que vous ignorez est noté comme inconnu, avec son risque.
- **0:24** À l’écran : Des particules ambre jaillissent d’un centre lumineux et forment un anneau qui s’élargit sur un fond violet sombre. La légende indique « Un essaim, dans un budget ». Voix off : Ensuite, Nexus peut lancer un essaim de sous-agents, dans un budget que vous fixez.
- **0:31** À l’écran : Deux panneaux de terminal côte à côte. À gauche, on tape bmad-plus swarm tally buyer-panel-20261018-zho8. La commande affiche le chemin d’un fichier tally.md, « 8 of 40 units counted; 32 skipped. » et une ligne qui commence par « Disclosure: », la mention de transparence : « Simulated units are not people. Read rates as an upper bound and confirm with real ones. » Le panneau de droite ouvre tally.md. Son titre, entouré en orange, indique « Simulated buyers see the pitch (run buyer-panel-20261018-zho8) », suivi de « 8 of 40 units gave a valid answer; 32 skipped » et d’un tableau « Rate: buys » (la ligne « all » donne 4 yes sur 8, 50.0%). Le panneau défile sur de courtes réponses citées, regroupées par segment et par comportement, puis s’arrête sur « Numbers: price_floor » : un tableau aux colonnes group, count, median, mean, min et max, dont la première ligne, « all », donne 8, 3.65, 3.7, 3 et 4.5. Voix off : 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.
- **0:46** À l’écran : Un nœud de fines lignes ambre emmêlées se redresse, ligne après ligne, en une grille carrée dont le centre est un point brillant. La légende indique « Contrôles indépendants avant acceptation ». Voix off : Pour un travail planifié, Nexus exige des contrôles indépendants avant d’accepter un résultat.
- **0:53** À l’écran : De hauts blocs sombres, semblables à du verre, se dressent en rangée, éclairés de côté par une lueur chaude. La légende indique « 10 packs · 7 adaptateurs ». Voix off : Les quatre rôles du Core, neuf packs optionnels, et des adaptateurs pour sept outils de codage IA.
- **1:01** À l’écran : Un terminal. On tape la commande npx bmad-plus install --lang en --packs core,design --tools claude-code. Les lignes de l’installateur apparaissent : « BMAD+ Installer v0.23.0 », « Installing to: /home/dev/app », « Selected packs: Core, Design », « Detected IDEs: Claude Code », une question sur le prénom (Developer), la langue de communication (English), une question sur l’URL d’un environnement de test, puis le mode d’exécution, avec Manual, Autopilot et Hybrid proposés et « Manual — You call agents yourself » retenu. L’image zoome sur deux coches vertes : « 5 agents, 9 skills, 4 files copied », avec « files copied » entouré en orange, et « 1 IDE(s) configured ». Tout le texte du terminal est en anglais. Voix off : Une seule commande npx, depuis le dossier de votre projet, suffit pour l’installer.
- **1:09** À l’écran : Un ciel bleu-noir terne, avec une faible bande de lumière à l’horizon. L’adresse « bmad-plus.rochetta.fr » apparaît en orange, puis disparaît.
> **Astuce · Deux sortes d’instruction** 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.
## Partie 1. Installer
1. **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.
```sh
node --version
```
2. **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/`.
```sh
npx bmad-plus@0.23.1 install
```
3. **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`.
```sh
npx bmad-plus@0.23.1 install --yes --packs core --tools claude-code
```
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**
```text
$ npx bmad-plus install --yes --lang en --packs core --tools claude-code
$ git status --short
?? .agents/
?? AGENTS.md
?? CLAUDE.md
?? _bmad/
$ ls .agents/skills
agent-architect-dev
agent-orchestrator
agent-quality
agent-strategist
bmad-plus-autopilot
bmad-plus-intake
bmad-plus-parallel
bmad-plus-swarm
bmad-plus-sync
bmad-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.
```
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
## Partie 2. Vérifier et réveiller votre assistant
1. **Ajoutez le paquet au projet (une seule fois)** 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 `, 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.
```sh
npm install --save-dev bmad-plus
```
2. **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.
```sh
npx --no-install bmad-plus doctor
```
3. **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.
4. **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.
```sh
bmad-help
```
## Partie 3. Une première tâche
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.
### Partir d’une idée
À 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**
```text
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.
### Faire un petit changement dans du code existant
À 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**
```text
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.
## Partie 4. Le faire relire
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.
### Demander à Sentinel une revue honnête
À utiliser juste après un changement, avant de commiter.
**Dans votre assistant IA**
```text
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.
## Partie 5. Garder ce que vous avez appris
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**
```sh
npx bmad-plus install --packs core,memory
```
### Terminer la session par une passation
À 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**
```text
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-.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.
## Partie 6. Rester à jour, en sécurité
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**
```text
$ npx --no-install bmad-plus update-check --offline
Installed: 0.23.0; running: 0.23.0; channel latest: unknown
unknown: offline
$ npx --no-install bmad-plus update-policy
Update 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 --yes` la défait. Le guide d’équipe et la page sur le cycle de vie de l’installation donnent les détails.
## Et ensuite
**Choisissez la page suivante selon ce que vous voulez faire**
| Vous voulez | Lisez |
| --- | --- |
| Comprendre ce que BMAD+ fait et ne fait pas | Comment fonctionne BMAD+ |
| Automatiser un projet entier, ou lancer des tâches en parallèle | Nexus, autopilot et travail parallèle |
| Laisser un pack vous poser d’abord les bonnes questions | Intake : demander d’abord, agir ensuite |
| Tester un argumentaire ou une page auprès de nombreux lecteurs simulés | Les essaims de sous-agents |
| Suivre un exemple complet de l’idée au décompte | Tutoriel : d’une idée à un essaim |
| Copier des consignes pour chaque pack | Livre de recettes |
| Savoir ce qui quitte votre machine | Traitement des données |
| Partager une même configuration dans une équipe | Utiliser BMAD+ en équipe |
| Résoudre un problème | Dépannage et FAQ |
**Voir aussi**
- [Comment fonctionne BMAD+](https://bmad-plus.rochetta.fr/fr/docs/concepts/how-bmad-plus-works/)
- [Tutoriel : d’une idée à un essaim](https://bmad-plus.rochetta.fr/fr/docs/guides/idea-to-swarm/)
- [Livre de recettes](https://bmad-plus.rochetta.fr/fr/docs/guides/recipes-cookbook/)
- [Utiliser BMAD+ en équipe](https://bmad-plus.rochetta.fr/fr/docs/guides/for-teams/)
- [FAQ](https://bmad-plus.rochetta.fr/fr/docs/faq/faq/)
- [Dépannage](https://bmad-plus.rochetta.fr/fr/docs/faq/troubleshooting/)
[Documentation BMAD+](https://bmad-plus.rochetta.fr/fr/docs/) · [Guides](https://bmad-plus.rochetta.fr/fr/docs/guides/)
[Code sur GitHub](https://github.com/lrochetta/BMAD-PLUS)