Comment installer BMad

Utilisez la commande npx bmad-method install pour configurer BMad dans votre projet avec votre choix de modules et d’outils d’IA.

Si vous souhaitez utiliser un installateur non interactif et fournir toutes les options d’installation en ligne de commande, consultez ce guide.

Quand l’utiliser

• Démarrer un nouveau projet avec BMad
• Ajouter BMad à une base de code existante
• Mettre à jour une installation BMad existante

Prérequis

• Node.js 20+ (requis pour l’installateur)
• Git (recommandé)
• Outil d’IA (Claude Code, Cursor, ou similaire)

Étapes

1. Lancer l’installateur

npx bmad-method install

Vous voulez la dernière version préliminaire ?

Utilisez le dist-tag next :

npx bmad-method@next install

Cela vous permet d’obtenir les nouvelles modifications plus tôt, avec un risque plus élevé de changements que l’installation par défaut.

Version de développement

Pour installer la dernière version depuis la branche main (peut être instable) :

npx github:bmad-code-org/BMAD-METHOD install

2. Choisir l’emplacement d’installation

L’installateur vous demandera où installer les fichiers BMad :

• Répertoire courant (recommandé pour les nouveaux projets si vous avez créé le répertoire vous-même et l’exécutez depuis ce répertoire)
• Chemin personnalisé

3. Sélectionner vos outils d’IA

Choisissez les outils d’IA que vous utilisez :

• Claude Code
• Cursor
• Autres

Chaque outil a sa propre façon d’intégrer les skills. L’installateur crée de petits fichiers de prompt pour activer les workflows et les agents — il les place simplement là où votre outil s’attend à les trouver.

Activer les skills

Certaines plateformes nécessitent que les skills soient explicitement activés dans les paramètres avant d’apparaître. Si vous installez BMad et ne voyez pas les skills, vérifiez les paramètres de votre plateforme ou demandez à votre assistant IA comment activer les skills.

4. Choisir les modules

L’installateur affiche les modules disponibles. Sélectionnez ceux dont vous avez besoin — la plupart des utilisateurs veulent simplement méthode BMad (le module de développement logiciel).

5. Suivre les instructions

L’installateur vous guide pour le reste — contenu personnalisé, paramètres, etc.

Ce que vous obtenez

votre-projet/
├── _bmad/
│   ├── bmm/            # Vos modules sélectionnés
│   │   └── config.yaml # Paramètres du module (si vous devez les modifier)
│   ├── core/           # Module core requis
│   └── ...
├── _bmad-output/       # Artefacts générés
├── .claude/            # Skills Claude Code (si vous utilisez Claude Code)
│   └── skills/
│       ├── bmad-help/
│       ├── bmad-persona/
│       └── ...
└── .cursor/            # Skills Cursor (si vous utilisez Cursor)
    └── skills/
        └── ...

Vérifier l’installation

Exécutez bmad-help pour vérifier que tout fonctionne et voir quoi faire ensuite.

BMad-Help est votre guide intelligent qui va :

• Confirmer que votre installation fonctionne
• Afficher ce qui est disponible en fonction de vos modules installés
• Recommander votre première étape

Vous pouvez aussi lui poser des questions :

bmad-help Je viens d'installer, que dois-je faire en premier ?
bmad-help Quelles sont mes options pour un projet SaaS ?

Résolution de problèmes

L’installateur affiche une erreur — Copiez-collez la sortie dans votre assistant IA et laissez-le résoudre le problème.

L’installateur a fonctionné mais quelque chose ne fonctionne pas plus tard — Votre IA a besoin du contexte BMad pour vous aider. Consultez Comment obtenir des réponses à propos de BMad pour savoir comment diriger votre IA vers les bonnes sources.