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.
BMAD+ vit dans votre projet, à côté de votre code. Cela soulève trois questions légitimes : comment l’installer sans qu’il prenne le dessus, comment le tenir à jour sans perdre mes modifications, comment le retirer sans perdre mon travail. Cette page suit une installation de la première à la dernière commande et dit, à chaque étape, ce qui est lu, écrit et retiré. Le principe est partout le même : BMAD+ tient la liste des fichiers qu’il possède, avec l’empreinte de chacun, et n’agit que sur les fichiers qui y correspondent encore.
Installer, mettre à jour, désinstaller, et garder sa mémoireUne commande d’installation, un contrôle de santé avec doctor, des mises à jour qui gardent vos modifications, et une désinstallation qui laisse la mémoire et la configuration en place.Transcription
Une seule commande depuis le dossier de votre projet, puis le choix de vos adaptateurs et de vos packs. L’installeur écrit les instructions des agents, le socle partagé du projet et les adaptateurs que vous avez choisis. Ensuite, doctor contrôle l’installation et indique combien de vérifications ont réussi. Les mises à jour conservent vos fichiers personnalisés : BMAD+ suit les fichiers qu’il gère. Une vérification de version se contente de regarder. Les mises à jour automatiques exigent une politique explicite du projet. La désinstallation ne retire que les fichiers qui correspondent encore à ce qui a été installé. Votre mémoire, vos modifications et votre configuration restent en place. Elle ne supprime jamais un dossier de façon récursive : fichiers cachés et contenus imbriqués sont épargnés.
Planifier, sauvegarder, écrire, vérifier, laisser un reçu. Annuler avec --restore.
Dans le terminal du projet
npx --no-install bmad-plus update --latest --yes
06
Désinstaller
Ne retirer que ce que BMAD+ possède ; mémoire, réglages et vos modifications restent.
Dans le terminal du projet
npx --no-install bmad-plus uninstall --yes
Attention· Les étapes 2 à 6 demandent une copie locale
L’installateur ne place pas bmad-plus dans le node_modules de votre projet : npx --no-install bmad-plus ... échoue donc juste après l’étape 1 (npx canceled due to missing packages and no YES option). Ajoutez le paquet une fois avec npm install --save-dev bmad-plus, ou lancez ces étapes avec npx bmad-plus ..., qui le télécharge au besoin. Les fichiers CLAUDE.md et AGENTS.md générés demandent à l’assistant de lancer npx --no-install bmad-plus update-check ; sans copie locale, la commande est indisponible, et l’assistant saute la vérification de mise à jour et poursuit votre tâche. Voir la vue d’ensemble de la CLI.
Tout repose sur un fichier écrit par install : _bmad/.bmad-plus-install.json, le manifeste. Il note la version, les packs, les outils, votre nom et langue, le mode d’exécution, une table adapterHashes (une empreinte par fichier d’instructions) et un fileInventory : pour chaque fichier d’agent, de compétence et de données posé par BMAD+, son empreinte SHA-256. Les fins de ligne sont normalisées avant l’empreinte des fichiers d’instructions : une copie de travail Windows ne ressemble donc pas à une modification.
États de l’inventaire de propriété affichés par doctor
État
Signification
Conséquence
complete
Chaque fichier livré est enregistré.
Les mises à jour peuvent être automatiques si la politique le permet.
incomplete
Un fichier était déjà là, au contenu différent, lors de l’installation.
Ces fichiers sont traités comme les vôtres.
legacy
Installé avant l’existence des empreintes de propriété.
Les mises à jour sauvegardent d’abord les fichiers d’origine des packs ; --auto refuse.
invalid
L’inventaire est mal formé.
doctor signale une erreur ; réparez le manifeste ou réinstallez.
Une fois le paquet installé en local (ajoutez-le une fois avec npm install --save-dev bmad-plus, puis utilisez npx --no-install bmad-plus ...), install, doctor, update-policy, uninstall et un simple update tournent sans aucun réseau.
update-check et update --latest sont les seules commandes qui interrogent npm. Sans connexion, update-check rapporte le statut unknown (raison registry-unavailable, ou offline avec --offline), sort avec 0, et un assistant poursuit simplement votre tâche.
Une réponse de cache périmée est présentée comme telle, avec stale: true ; elle n’est jamais présentée comme à jour.
Seul le tout premier npx bmad-plus install demande le réseau, pour récupérer le paquet, sauf si vous l’avez installé depuis un fichier.
Une mise à jour qui échoue revient en arrière d’elle-même et affiche la commande exacte update --restore <id>. Les reçus restent sous .bmad/updates/.
Un verrou de projet (.bmad/update.lock) de plus de 60 minutes, ou dont le processus a disparu, est signalé par doctor comme périmé avec le fichier à supprimer. Un verrou dont le processus est mort sans doute possible sur cette machine est repris par la prochaine installation ou mise à jour.
Un manifeste abîmé est copié vers _bmad/.bmad-plus-install.json.corrupt.bak avant que install ne le remplace.
Une installation antérieure aux empreintes de propriété (0.12.2 ou plus ancienne) est migrée une fois en lançant explicitement un paquet plus récent : npx --yes bmad-plus@0.13.0 update --yes. Les originaux sont d’abord sauvegardés.
Un retour en arrière de version est toujours refusé. Pour revenir, utilisez update --restore avec le reçu de la mise à jour à annuler.
Mettre à jour un projet dont vous avez modifié les fichiers d’instructions#
Vous avez ajouté vos propres règles à CLAUDE.md et retouché un fichier d’agent, et vous voulez la dernière version de BMAD+ sans perdre ni l’un ni l’autre.
Dans votre assistant IA
Vérifie s’il existe une version plus récente de BMAD+ pour ce projet. Si oui, mets-la à jour et liste exactement quels fichiers ont été gardés parce que je les ai modifiés, et pourquoi.
Ce que vous devriez obtenir L’assistant lance update-check, puis update --latest --yes avec votre accord. La commande affiche un plan du type Planned changes: N files (R no longer shipped, removed with backup); preserved conflicts: 2. et une ligne par conflit : CLAUDE.md: preserved (local-instructions). et <agent file>: preserved (modified-managed-file). Ces deux fichiers ne sont pas touchés ; tout le reste est mis à jour après sauvegarde, et le chemin du reçu sous .bmad/updates/ est indiqué pour pouvoir annuler avec update --restore.