Comment passer à la 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

É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 votre dossier de méthode BMad porte un nom différent, vous devrez le supprimer manuellement.

3. Nettoyer les skills IDE

Supprimez manuellement les commandes/skills IDE v4 existants - par exemple si vous utilisez 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 _wizz-output/planning-artifacts/ avec des noms descriptifs :

Incluez PRD dans le nom de fichier pour les documents PRD¹
Incluez brief, architecture, ou ux-design selon le cas
Les documents divisés peuvent être dans des sous-dossiers au nom descriptif

Si vous êtes en cours de planification : Envisagez de recommencer avec les workflows v6. Utilisez vos documents existants comme entrées — les nouveaux workflows de découverte progressive avec recherche web et le mode plan de l’IDE produisent de meilleurs résultats.

5. Migrer le développement en cours

Si vous avez des stories² créées ou implémentées :

Terminez l’installation v6
Placez epics.md ou epics/epic*.md³ dans _wizz-output/planning-artifacts/
Lancez le workflow Développeur wizz-sprint-planning⁴
Indiquez à l’agent quels epics/stories sont déjà terminés

Résultat de la migration

Structure unifiée v6 :

votre-projet/
├── _wizz/               # 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
└── _wizz-output/        # Dossier de sortie (remplace le dossier doc de la 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`	Obsolète — nouvel agent DevOps bientôt disponible
`.bmad-creative-writing`	Non migré — nouveau module v6 bientôt disponible

Changements clés

Concept	v4	v6
Core	`_wizz-core` correspondait en réalité à la méthode BMad	`_wizz/core/` est le framework universel
Method	`_wizz-method`	`_wizz/bmm/`
Config	Fichiers modifiés directement	`config.yaml` par module
Documents	Division en fragments obligatoire ou optionnelle	Totalement flexible, analyse 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. ↩