# Documentation BMAD+ — Démarrage, exemples et versions
> Installez BMAD+, lancez votre premier workflow d’agents, essayez des prompts concrets et gardez votre projet à jour. Guide pas à pas et historique des versions publiées.
Canonical: https://bmad-plus.rochetta.fr/fr/docs/
Language: fr
BMAD+ version: 0.23.1
Documentation reviewed: 2026-10-19
Author: Laurent Rochetta
License: MIT
De l’installation au premier workflow.
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](#start)
- [Exemples à adapter](#examples)
- [Vérifier et appliquer les mises à jour](#updates)
- [Nouveautés](#news)
- [Historique des versions](#changelog)
- [En cas de doute](#help)
## Parcourir par thème
- [Concepts](https://bmad-plus.rochetta.fr/fr/docs/concepts/): Ce qu’est BMAD+ et les idées qui le structurent : agents, skills, packs et mémoire, et comment ils s’articulent.
- [Comment fonctionne BMAD+](https://bmad-plus.rochetta.fr/fr/docs/concepts/how-bmad-plus-works/): Ce que BMAD+ installe dans votre projet, qui exécute quoi, et comment une demande comme « Atlas, ... » devient des fichiers : exécution par l’hôte, socle AGENTS.md, packs, agents, compétences.
- [Intake : demander d’abord, agir ensuite](https://bmad-plus.rochetta.fr/fr/docs/concepts/intake/): Pourquoi un pack interroge avant d’agir, comment un intake.yaml définit ses questions champ par champ, comment les réponses reçoivent un statut, et un design read complet en sortie réelle.
- [Les essaims de sous-agents](https://bmad-plus.rochetta.fr/fr/docs/concepts/swarm/): Quand lancer un panel, un jury ou un fanout de sous-agents, les quatre fichiers qui les définissent, la distribution à graine, le budget de 26, des décomptes honnêtes et un exemple réel.
- [Nexus : autopilot, travail parallèle et exécutions durables](https://bmad-plus.rochetta.fr/fr/docs/concepts/nexus-orchestration/): Autopilot avec points de contrôle, travail parallèle supervisé, export de plan depuis un essaim, et runtime durable (create, start, launch, collect, verify, accept), adaptateur Codex et limites.
- [Mémoire : décisions, leçons et cerveau](https://bmad-plus.rochetta.fr/fr/docs/concepts/how-memory-works/): Comment BMAD+ garde décisions, leçons et passations entre sessions : mémoire de projet, cerveau global ou de portefeuille et sa détection, Zecher, mem et memory, ce qui n’est jamais écrasé.
- [Revue de code et recette humaine](https://bmad-plus.rochetta.fr/fr/docs/concepts/code-review-and-acceptance/): Comment review scope, anchor et gate rendent une revue vérifiable, les règles intégrées, et comment une personne déroule une recette lue, triée et soumise à la porte. Pourquoi un tag en exige une.
- [Le registre et les compétences](https://bmad-plus.rochetta.fr/fr/docs/concepts/registry-and-skills/): registry.yaml, source unique de vérité : champs d’un pack, uses_skills, external_module, pipelines, intake, les contrôles, le généré, et comment une équipe ajoute un agent ou un pack avec Maker.
- [Packs](https://bmad-plus.rochetta.fr/fr/docs/packs/): Ce qu’apporte chaque pack, à qui il s’adresse et comment l’installer.
- [Les dix packs : ce que chacun apporte et comment choisir](https://bmad-plus.rochetta.fr/fr/docs/packs/packs-overview/): Un pack est un groupe installable d’agents et de compétences. Comparez les dix packs BMAD+ dans un tableau, apprenez à choisir, installer, ajouter, retirer, et comment les packs voisins cohabitent.
- [Pack Core : Atlas, Forge, Sentinel et Nexus](https://bmad-plus.rochetta.fr/fr/docs/packs/core/): Le pack de base obligatoire de BMAD+ : quatre agents de l’idée à la livraison relue, six compétences partagées, commande d’installation, huit consignes à copier, sorties et limites.
- [Pack OSINT : Shadow, recherche en sources ouvertes encadrée](https://bmad-plus.rochetta.fr/fr/docs/packs/osint/): Shadow mène une enquête en sources ouvertes par phases, avec une porte de base légale obligatoire pour toute personne nommée. Installation, clés d’API, budget, sept consignes, sorties, limites.
- [Pack Maker : créer et empaqueter vos propres agents](https://bmad-plus.rochetta.fr/fr/docs/packs/maker/): Maker est un méta-agent qui conçoit, valide et empaquette de nouveaux agents BMAD+. Commande d’installation, les quatre phases de création, six consignes, dossier de sortie et usage du paquet.
- [Pack Shield : 27 spécialistes de conformité et 11 workflows](https://bmad-plus.rochetta.fr/fr/docs/packs/shield/): Shield aiguille les questions de conformité vers 27 spécialistes de référentiels et 11 workflows RGPD et AI Act, et ajoute dossiers d’assurance, registre IA et règles de revue. Pas un avis juridique.
- [Pack SEO / GEO : auditer la visibilité en recherche et dans les réponses IA](https://bmad-plus.rochetta.fr/fr/docs/packs/seo/): SEO / GEO : trois agents auditent la visibilité en recherche et dans les réponses générées par IA (qualité du contenu, données structurées, préparation IA), via 15 commandes. Installation, limites.
- [Pack Memory : Zecher et le cerveau persistant](https://bmad-plus.rochetta.fr/fr/docs/packs/memory-pack/): Zecher conserve décisions, leçons et passations de session dans des fichiers simples, entre sessions et projets. Installation, détection du cerveau, huit exemples, sorties, commandes CLI, limites.
- [Pack Dev Studio : six personas et 38 workflows](https://bmad-plus.rochetta.fr/fr/docs/packs/dev-studio/): Dev Studio couvre le cycle de vie logiciel avec six personas et 38 workflows nommés, du brief produit à la revue de code. Installation, catalogue par phase, huit exemples, CLI studio, limites.
- [Pack Backup : sauvegardes ZIP horodatées, restauration et rotation](https://bmad-plus.rochetta.fr/fr/docs/packs/backup/): Backup Manager compresse votre projet en ZIP horodaté, liste, restaure et fait tourner les archives avec quatre commandes slash. Installation, cinq exemples, exclusions, limites.
- [Pack Animated : transformer un MP4 en site animé au défilement](https://bmad-plus.rochetta.fr/fr/docs/packs/animated/): L’Animated Website Creator transforme une vidéo en page pilotée par le défilement en cinq étapes : analyse, extraction, six sections, construction, aperçu. Prérequis, six exemples, limites.
- [Pack Design : Atelier interroge d’abord, puis construit, audite et refond](https://bmad-plus.rochetta.fr/fr/docs/packs/design/): Atelier, moteur de design de BMAD+ : intake de 13 questions, puis construction, revue ou refonte via trois compétences, preuves étiquetées, verdict de pré-vol cité. Installation, vraie session.
- [Agents](https://bmad-plus.rochetta.fr/fr/docs/agents/): Chaque agent en détail : son rôle, quand l’appeler et les skills qu’il apporte.
- [Répertoire des 48 agents](https://bmad-plus.rochetta.fr/fr/docs/agents/agents-roster/): Tous les agents BMAD+ au même endroit : 15 points d’entrée, 6 personas Dev Studio et 27 spécialistes Shield, avec leur pack, leur rôle et la façon de les appeler, chacun relié à la page de son pack.
- [Comment les agents s’activent : noms, rôles, déclencheurs et commandes de conversation](https://bmad-plus.rochetta.fr/fr/docs/agents/agents-activation/): Appelez un agent par son nom, utilisez les codes de menu, laissez les rôles changer via trois niveaux de déclencheurs, et employez bmad-help, autopilot et parallel. Que vérifier si un agent se tait.
- [Référence](https://bmad-plus.rochetta.fr/fr/docs/reference/): Chaque commande, option, fichier et réglage, avec la syntaxe exacte.
- [La ligne de commande, vue d’ensemble](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-overview/): Comment lancer bmad-plus, les options communes à toutes les commandes, les langues de l’installateur, l’usage sans interaction avec --yes et les codes de sortie utilisables en script et en CI.
- [install](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-install/): Installer les agents, compétences, fichiers d’instructions et la configuration BMAD+ dans un projet : chaque option, ce qui est écrit, une réinstallation, la sortie réelle et les erreurs possibles.
- [update](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-update/): Faire passer un projet installé à une version plus récente de BMAD+ avec un plan, des sauvegardes et un reçu restaurable : options, fichiers préservés, refus, récupération et chaque message.
- [uninstall](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-uninstall/): Retirer d’un projet ce que BMAD+ possède et garder votre mémoire, vos réglages, vos fichiers modifiés ou inconnus : options, ce qui est supprimé, ce qui reste, sortie réelle et messages possibles.
- [doctor](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-doctor/): Rapport de santé en lecture seule : manifeste, inventaire de propriété, fichiers modifiés, fichiers d’instructions, environnements. Options, codes de contrôle, rapport JSON, sortie réelle.
- [update-check](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-update-check/): Demander à npm s’il existe une version plus récente de BMAD+ et si votre politique la laisserait s’appliquer, sans rien changer : options, statuts, raisons, champs JSON, cache et mode hors ligne.
- [update-policy](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-update-policy/): Afficher ou fixer la politique du projet qui décide si BMAD+ cherche des mises à jour et si certaines peuvent s’appliquer sans vous : modes off, notify, auto, canal, plage, préversions, erreurs.
- [autoconfig](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-autoconfig/): Amorcez BMAD+ dans un dépôt existant ou un dossier vide : détection de la pile, score de santé, packs recommandés, installation et amorçage de la mémoire du projet.
- [scan](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-scan/): Parcourez une arborescence, trouvez vos projets, détectez leur pile et leur activité, puis indexez-les dans le cerveau global pour que BMAD+ connaisse tout votre portefeuille.
- [bmad-plus memory](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-memory/): Lire la santé de la mémoire du projet et du cerveau global, et exporter le cerveau global dans un seul fichier Markdown. Options, lectures et écritures, sortie, codes de sortie et erreurs.
- [bmad-plus mem](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-mem/): Rappeler décisions et événements passés, journaliser le travail d’un agent, renforcer un motif par des signaux de récompense, relier une leçon à un travail Nexus accepté. Options, sortie, erreurs.
- [studio](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-studio/): Listez les workflows de Dev Studio et préparez un lot de contexte en lecture seule pour l’un d’eux, afin que votre assistant l’exécute avec les instructions exactes livrées dans votre projet.
- [bmad-plus intake](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-intake/): Valider le questionnaire d’un pack, planifier les prochaines questions, enregistrer les réponses avec leur statut et rédiger le brief. Options, codes de sortie, sortie réelle et erreurs.
- [bmad-plus swarm](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-swarm/): Tirer, briefer, vérifier, classer et compter un essaim de sous-agents dans un budget : panel, jury ou fanout. Options, arborescence, approbation au code 2, règles d’honnêteté, sortie réelle, erreurs.
- [nexus](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-nexus/): Exécutions de tâches durables : un plan de tâches à périmètres d’écriture disjoints, des tentatives récupérables après une interruption, une vérification indépendante et une acceptation distincte.
- [bmad-plus uat](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-uat/): Référence de bmad-plus uat (alias recette) : lint, build, serve, import, read, gate et order pour les recettes d’acceptation humaine, avec options, codes de sortie et exemples.
- [bmad-plus review](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-review/): Référence de bmad-plus review : sceller un périmètre, ancrer les constats dans le code, tirer un verdict de la couverture, reprendre, comparer, lister les règles, avec options et codes de sortie.
- [assurance](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-assurance/): Construire un dossier d’assurance sécurité : des affirmations étayées uniquement par des contrôles réellement exécutés, consignés dans un registre chaîné, puis vérifiés à un commit.
- [ai-register](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-ai-register/): Tenir un registre des outils d’IA de votre projet, de leurs données, base légale et transferts, et laisser un contrôle souple signaler toute intégration d’IA du dépôt que le registre ignore.
- [Fichier de configuration](https://bmad-plus.rochetta.fr/fr/docs/reference/config-yaml/): Chaque clé de _bmad/config.yaml : mode d’exécution, quatre points de contrôle, bloc uat et budget de l’essaim. Valeurs par défaut, qui lit quoi, et l’effet d’un changement.
- [Adaptateurs](https://bmad-plus.rochetta.fr/fr/docs/reference/adapters/): Les sept outils d’IA que BMAD+ prépare : le fichier écrit pour chacun, la détection, le socle AGENTS.md commun, et la façon dont install et update protègent vos propres instructions.
- [Arborescence du projet](https://bmad-plus.rochetta.fr/fr/docs/reference/project-layout/): Chaque dossier et fichier que BMAD+ crée dans un projet et sur votre machine, la commande qui le crée, et s’il vous appartient, s’il est géré par BMAD+ ou s’il s’agit d’un état à ne pas toucher.
- [Guides](https://bmad-plus.rochetta.fr/fr/docs/guides/): Des parcours pas à pas pour les tâches courantes, de l’installation aux mises à jour.
- [Votre première heure avec BMAD+](https://bmad-plus.rochetta.fr/fr/docs/guides/first-hour/): 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.
- [Installer, mettre à jour, désinstaller](https://bmad-plus.rochetta.fr/fr/docs/guides/install-lifecycle/): Toute la vie de BMAD+ dans un projet : installer, contrôler, mettre à jour avec une politique et des reçus, restaurer, désinstaller en gardant votre mémoire. Ce que chaque étape écrit et retire.
- [Tutoriel : d’une idée à un essaim](https://bmad-plus.rochetta.fr/fr/docs/guides/idea-to-swarm/): Un parcours complet en sorties réelles : installer, Atelier demande d’abord, brief, panel simulé sous budget, décompte honnête, désinstallation avec mémoire conservée.
- [Étude de cas : vérifier ce que les agents disent avoir terminé](https://bmad-plus.rochetta.fr/fr/docs/guides/case-study-rebuild-the-site/): Une relecture a jugé 11 affirmations fausses dans ce que 39 agents ont écrit en moins de douze heures, et les relecteurs se sont trompés deux fois. Voyez comment, et rejouez les cinq commandes.
- [Utiliser BMAD+ en équipe](https://bmad-plus.rochetta.fr/fr/docs/guides/for-teams/): Ce qu’il faut commiter et ce qui reste local, les réglages à convenir, un adaptateur par collègue sur un socle commun, une politique de mise à jour sûre, portes de CI et accueil.
- [Livre de recettes](https://bmad-plus.rochetta.fr/fr/docs/guides/recipes-cookbook/): Des consignes et commandes à copier pour les agents Core et chaque pack, avec ce qu’ils font réellement : Atlas, Forge, Sentinel, Nexus, Shadow, Zecher, SEO, Shield, Dev Studio, Atelier, la CLI.
- [Sécurité et données](https://bmad-plus.rochetta.fr/fr/docs/security/): Ce qui reste sur votre machine, ce qui peut en sortir et comment le vérifier.
- [Traitement des données et vie privée](https://bmad-plus.rochetta.fr/fr/docs/security/data-handling/): Ni télémétrie ni mise à jour silencieuse. Les onze flux du paquet npm pouvant envoyer des données hors de votre machine : quoi, à qui, quand, sur quelle base de consentement, et ce qui reste local.
- [Confiance, propriété et licences](https://bmad-plus.rochetta.fr/fr/docs/security/trust-and-ownership/): Qui a écrit quoi, quelles licences, quels fichiers BMAD+ possède dans votre projet et comment il le prouve, ce que gardent mise à jour et désinstallation, l’encadrement d’OSINT.
- [Questions et dépannage](https://bmad-plus.rochetta.fr/fr/docs/faq/): Des réponses courtes aux questions des débutants, et que faire quand quelque chose échoue.
- [Questions fréquentes](https://bmad-plus.rochetta.fr/fr/docs/faq/faq/): Trente-quatre réponses à ce que demandent les nouveaux venus : ce qu’est BMAD+, installation et mise à jour, agents et autopilot, essaims, revues et recettes, données et droit, mémoire et équipes.
- [Dépannage](https://bmad-plus.rochetta.fr/fr/docs/faq/troubleshooting/): Symptôme, cause, solution pour les échecs réels de BMAD+ : installations et mises à jour refusées, verrous périmés, erreurs de doctor, instructions périmées, essaims à approuver, gates rouges.
- [Glossaire](https://bmad-plus.rochetta.fr/fr/docs/faq/glossary/): Chaque terme de la documentation BMAD+ en mots simples, par thème : hôte, socle, pack, compétence, intake, essaim, graine, porte, reçu, recette et mots d’état des outils.
## 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.
### 1. 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**
```sh
node --version
```
La commande doit afficher v20 ou plus récent. Installez ou mettez à jour Node.js séparément si nécessaire.
### 2. 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**
```sh
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.
### 3. 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**
```text
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.
### 4. 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**
```text
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.
### 5. 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**
```text
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**
```text
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**
```text
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.
### 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**
```text
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**
```text
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**
```text
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.
### 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**
```text
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.
### Relire un passage sans deviner
À utiliser lorsqu’une personne a terminé ou interrompu une recette.
**Dans votre assistant IA**
```text
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.
### 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**
```text
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.
## 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.
**Dans le terminal du projet**
```sh
npx --no-install bmad-plus update-check --refresh --json
```
### 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.
**Dans le terminal du projet**
```sh
npx bmad-plus@0.23.1 update-check --refresh --json
```
### Examiner puis appliquer une mise à 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**
```sh
npx --no-install bmad-plus update --latest
```
### 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**
```sh
npx --yes bmad-plus@0.23.1 update --yes
```
- 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.
### 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**
```sh
npx --no-install bmad-plus update-policy --mode auto --range "^0.23.1"
```
**Dans le terminal du projet**
```sh
npx --no-install bmad-plus update-policy --mode notify
```
### Restaurer après une mise à jour
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.
**Dans le terminal du projet**
```sh
npx --no-install bmad-plus update --restore RECEIPT_ID --yes
```
## Nouveautés
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** · 2026-10-20
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.
[Historique des versions](#release-0-23-1)
## Historique des versions
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
2026-10-20
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.
[Package publié · v0.23.1](https://www.npmjs.com/package/bmad-plus/v/0.23.1)
### v0.23.0 — Demander d’abord, puis lancer l’essaim
2026-10-18
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.
[Package publié · v0.23.0](https://www.npmjs.com/package/bmad-plus/v/0.23.0)
### v0.22.0 — Ce qui sort de votre machine, déclaré et vérifié
2026-09-29
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.
[Package publié · v0.22.0](https://www.npmjs.com/package/bmad-plus/v/0.22.0)
[Toutes les versions publiées sur npm](https://www.npmjs.com/package/bmad-plus?activeTab=versions)
## En cas de doute
### 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.
[Code sur GitHub](https://github.com/lrochetta/BMAD-PLUS)
[Package publié](https://www.npmjs.com/package/bmad-plus)