5.1 KiB
| title | description | sidebar | ||
|---|---|---|---|---|
| Comment passer à la v6 | Migrer de BMad v4 vers v6 |
|
Utilisez l'installateur BMad pour passer de la v4 à la v6, qui inclut une détection automatique des installations existantes et une assistance à la migration.
Quand utiliser ce guide
- Vous avez BMad v4 installé (dossier
.bmad-method) - Vous souhaitez migrer vers la nouvelle architecture v6
- Vous avez des artefacts de planification existants à préserver
:::note[Prérequis]
- Node.js 20+
- Installation BMad v4 existante :::
Étapes
1. Lancer l'installateur
Suivez les Instructions d'installation.
2. Gérer l'installation existante
Quand v4 est détecté, vous pouvez :
- Autoriser l'installateur à sauvegarder et supprimer
.bmad-method - Quitter et gérer le nettoyage manuellement
Si vous avez nommé votre dossier de méthode bmad autrement, vous devrez supprimer le dossier vous-même manuellement.
3. Nettoyer les skills IDE
Supprimez manuellement les commandes/skills IDE v4 existants - par exemple si vous avez Claude Code, recherchez tous les dossiers imbriqués qui commencent par bmad et supprimez-les :
.claude/commands/
Les nouveaux skills v6 sont installés dans :
.claude/skills/
4. Migrer les artefacts de planification
Si vous avez des documents de planification (Brief/PRD/UX/Architecture) :
Déplacez-les dans _bmad-output/planning-artifacts/ avec des noms descriptifs :
- Incluez
PRDdans le nom de fichier pour les documents PRD1 - Incluez
brief,architecture, ouux-designselon le cas - Les documents divisés peuvent être dans des sous-dossiers nommés
Si vous êtes en cours de planification : Envisagez de redémarrer avec les workflows v6. Utilisez vos documents existants comme entrées - les nouveaux workflows de découverte progressive avec recherche web et mode plan IDE produisent de meilleurs résultats.
5. Migrer le développement en cours
Si vous avez des stories2 créées ou implémentées :
- Terminez l'installation v6
- Placez
epics.mdouepics/epic*.md3 dans_bmad-output/planning-artifacts/ - Lancez le workflow
bmad-sprint-planning4 du Scrum Master5 - Indiquez au SM quels epics/stories sont déjà terminés
Ce que vous obtenez
Structure unifiée v6 :
votre-projet/
├── _bmad/ # Dossier d'installation unique
│ ├── _config/ # Vos personnalisations
│ │ └── agents/ # Fichiers de personnalisation des agents
│ ├── core/ # Framework core universel
│ ├── bmm/ # Module BMad Method
│ ├── bmb/ # BMad Builder
│ └── cis/ # Creative Intelligence Suite
└── _bmad-output/ # Dossier de sortie (était le dossier doc en v4)
Migration des modules
| Module v4 | Statut v6 |
|---|---|
.bmad-2d-phaser-game-dev |
Intégré dans le Module BMGD |
.bmad-2d-unity-game-dev |
Intégré dans le Module BMGD |
.bmad-godot-game-dev |
Intégré dans le Module BMGD |
.bmad-infrastructure-devops |
Déprécié - nouvel agent DevOps bientôt disponible |
.bmad-creative-writing |
Non adapté - nouveau module v6 bientôt disponible |
Changements clés
| Concept | v4 | v6 |
|---|---|---|
| Core | _bmad-core était en fait la méthode BMad |
_bmad/core/ est le framework universel |
| Method | _bmad-method |
_bmad/bmm/ |
| Config | Fichiers modifiés directement | config.yaml par module |
| Documents | Division ou non division requise | Entièrement flexible, scan automatique |
Glossaire
-
PRD (Product Requirements Document) : document de référence qui décrit les objectifs du produit, les besoins utilisateurs, les fonctionnalités attendues, les contraintes et les critères de succès, afin d'aligner les équipes sur ce qui doit être construit et pourquoi. ↩︎
-
Story (User Story) : une description courte et simple d'une fonctionnalité du point de vue de l'utilisateur. Les stories sont des unités de travail suffisamment petites pour être complétées en un sprint. ↩︎
-
Epic : dans les méthodologies agiles, une grande unité de travail qui peut être décomposée en plusieurs stories. Un epic représente généralement une fonctionnalité majeure ou un ensemble de capacités livrable sur plusieurs sprints. ↩︎
-
Sprint : dans Scrum, une période de temps fixe (généralement 1 à 4 semaines) pendant laquelle l'équipe travaille à livrer un incrément de produit potentiellement libérable. ↩︎
-
Scrum Master : rôle dans la méthodologie Scrum responsable de faciliter le processus, de supprimer les obstacles et d'aider l'équipe à suivre les pratiques agiles. ↩︎