Premiers pas

Accélérez le développement de vos applications grâce à des workflows alimentés par l’IA et des agents spécialisés qui vous guident dans la planification, l’architecture et l’implémentation.

Ce que vous allez apprendre

• Installer et initialiser la méthode BMad pour un nouveau projet
• Utiliser BMad-Help — votre guide intelligent qui sait quoi faire ensuite
• Choisir la profondeur de planification adaptée à votre travail
• Progresser dans les phases, de la définition des exigences au code fonctionnel
• Utiliser efficacement les agents et les workflows

Prérequis

• Node.js 20.12+ — Nécessaire pour l’installation
• Git — Recommandé pour la gestion de versions
• IDE avec IA intégrée — Claude Code, Cursor ou équivalent
• Une idée de projet — Même simple, elle fera l’affaire pour commencer

Le chemin le plus rapide

Installer → npx bmad-method install Demander → bmad-help que dois-je faire en premier ? Développez → Laissez BMad-Help vous guider, workflow par workflow

Découvrez BMad-Help : votre guide intelligent

BMad-Help est le moyen le plus rapide de démarrer avec BMad. Pas besoin de mémoriser les workflows ou les phases — posez simplement votre question et BMad-Help saura :

• Inspecter votre projet pour voir ce qui a déjà été fait
• Vous présenter vos options en fonction des modules installés
• Vous recommander la prochaine étape — y compris la première tâche obligatoire
• Répondre à vos questions, par exemple : « J’ai une idée de SaaS, par où commencer ? »

Comment utiliser BMad-Help

Dans votre IDE IA, invoquez le skill :

bmad-help

Ou accompagnez-le d’une question pour obtenir des conseils contextualisés :

bmad-help J’ai une idée de produit SaaS, je connais déjà toutes les fonctionnalités que je veux. Par où dois-je commencer ?

BMad-Help vous indiquera :

• Ce qui est recommandé pour votre situation
• Quelle est la première tâche obligatoire
• À quoi ressemble le reste du processus

Il intervient aussi dans les workflows

BMad-Help ne se contente pas de répondre aux questions — il se lance automatiquement à la fin de chaque workflow pour vous indiquer exactement la suite. Finies les devinettes et les recherches dans la doc : vous recevez des instructions claires sur le prochain workflow à exécuter.

Commencez ici

Après avoir installé BMad, invoquez immédiatement le skill bmad-help. Il détectera les modules que vous avez installés et vous orientera vers le bon point de départ pour votre projet.

Comprendre BMad

BMad vous aide à développer des logiciels grâce à des workflows guidés par des agents IA spécialisés. Le processus s’articule en quatre phases :

Phase	Nom	Ce qui se passe
1	Analyse	Brainstorming, recherche, product brief ou PRFAQ (optionnel)
2	Planification	Définir les exigences (PRD1 ou spécification technique)
3	Solutioning	Concevoir l’architecture selon les besoins
4	Implémentation	Implémenter chaque changement ou story planifiée, éventuellement via une orchestration automatisée

Ouvrez la carte des workflows pour explorer les phases, les workflows et la gestion du contexte.

La profondeur de planification reste flexible :

Profondeur	Idéal pour	Contexte disponible avant l’implémentation
Directe	Corrections, fonctionnalités, issues ou spécifications claires	Intention, issue ou spécification
Planification produit	Produits, plateformes et fonctionnalités complexes	PRD et conception UX optionnelle
Solutioning complet	Initiatives coordonnées, risquées ou multi-systèmes	PRD, UX, architecture, epics, stories et plan de sprint

Note

Il ne s’agit pas de voies d’implémentation distinctes. Tous les points d’entrée convergent vers bmad-build; la planification ne change que la quantité de contexte disponible.

Installation

Ouvrez un terminal dans le répertoire de votre projet et exécutez :

npx bmad-method install

Si vous préférez la dernière version préliminaire au lieu du canal de publication par défaut, utilisez npx bmad-method@next install.

À l’invite de sélection des modules, choisissez BMad Method.

L’installateur crée deux dossiers :

• _bmad/ — agents, workflows, tâches et configuration
• _bmad-output/ — vide pour le moment, mais c’est là que seront enregistrés vos artefacts

Votre prochaine étape

Ouvrez votre IDE avec IA dans le dossier du projet et exécutez :

bmad-help

BMad-Help détectera ce que vous avez déjà accompli et vous recommandera exactement la suite. Vous pouvez aussi lui poser des questions comme « Quelles sont mes options ? » ou « J’ai une idée de SaaS, par où devrais-je commencer ? »

Comment charger les agents et exécuter les workflows

Chaque workflow possède une skill que vous invoquez par son nom dans votre IDE (par ex. bmad-prd). Votre outil IA reconnaîtra le nom bmad-* et l’exécutera — pas besoin de charger les agents séparément. Vous pouvez aussi invoquer directement une skill d’agent pour une conversation générale (par ex. bmad-agent-pm pour l’agent PM).

Nouveaux chats

Démarrez toujours un nouveau chat pour chaque workflow. Cela évite les problèmes liés aux limites de contexte de l’IA.

Étape 1 : Choisir la profondeur de planification

Utilisez les phases 1 à 3 selon les besoins du travail. Pour un changement clair et délimité, vous pouvez passer directement à l’Étape 2. Utilisez un nouveau chat pour chaque workflow.

Contexte projet (optionnel)

Avant de commencer, pensez à créer project-context.md pour documenter vos préférences techniques et vos règles d’implémentation. Ainsi, tous les agents IA respecteront vos conventions tout au long du projet.

Créez-le manuellement à l’emplacement _bmad-output/project-context.md, ou générez-le après l’architecture avec bmad-generate-project-context. En savoir plus.

Phase 1 : Analyse (optionnelle)

Tous les workflows de cette phase sont optionnels. Vous ne savez pas lequel choisir ?

• brainstorming (bmad-brainstorming) — Idéation guidée
• research (bmad-deep-recon) — Rédigez un prompt de recherche approfondie pour votre propre outil IA, transformez un rapport terminé en synthèse exploitable en aval, ou menez la recherche ici — marché, domaine, technique, concurrentiel, voix des utilisateurs et académique — avec vérification des affirmations et cycle de rafraîchissement
• product-brief (bmad-product-brief) — Document fondateur recommandé une fois votre concept bien défini
• prfaq (bmad-prfaq) — Exercice Working Backwards pour tester et affiner votre concept produit

Phase 2 : Planification (selon les besoins)

Pour les travaux qui bénéficient d’une planification produit :

1. Exécutez bmad-prd dans un nouveau chat — précisez votre intention (Create / Update / Validate) ou laissez le skill vous la demander
2. Résultat : prd.md, addendum.md, .memlog.md

Intentions de bmad-prd

• Create — exploration guidée à partir de zéro ; le skill nomme le dossier de travail et vous accompagne jusqu’à l’obtention d’un PRD dont vous serez fier
• Update — pointez vers un PRD existant et un changement à apporter ; le skill met en évidence les conflits avant d’appliquer les modifications
• Validate — critiquez un PRD finalisé à l’aide d’une liste de contrôle et générez un rapport HTML des constatations

Design UX (optionnel)

Si votre projet comporte une interface utilisateur, invoquez l’agent UX Designer (bmad-agent-ux-designer) et lancez le workflow de design UX (bmad-ux) après avoir créé votre PRD.

Phase 3 : Solutioning (selon les besoins)

Créer l’architecture

1. Invoquez l’agent Architecte (bmad-agent-architect) dans un nouveau chat
2. Exécutez bmad-architecture (bmad-architecture)
3. Résultat : document d’architecture avec les décisions techniques

Créer les epics et les stories

Amélioration V6

Les epics et stories sont désormais créés après l’architecture. Cela produit des stories de meilleure qualité, car les décisions d’architecture (choix de la base de données, patterns d’API, pile technologique) influencent directement la façon dont le travail doit être découpé.

1. Invoquez l’agent PM (bmad-agent-pm) dans un nouveau chat
2. Exécutez bmad-create-epics-and-stories (bmad-create-epics-and-stories)
3. Le workflow s’appuie sur le PRD et l’architecture pour créer des stories techniquement fondées

Vérification de la préparation à l’implémentation (fortement recommandée)

1. Invoquez l’agent Architecte (bmad-agent-architect) dans un nouveau chat
2. Exécutez bmad-sprint-planning (bmad-sprint-planning) — il s’ouvre sur le jalon de préparation
3. Valide la cohérence de l’ensemble des documents de planification

Étape 2 : Développer votre projet

Passez à l’implémentation avec le contexte disponible : demande directe, issue, spécification ou story entièrement planifiée. Chaque workflow doit être exécuté dans un nouveau chat.

Pour un travail planifié, invoquez bmad-build et indiquez la story ou l’élément de sprint sélectionné, par exemple : Implémente la story 2.3 depuis _bmad-output/planning-artifacts/epics.md.

Initialiser la planification de sprint (pour le travail planifié)

Invoquez l’agent Développeur (bmad-agent-dev) et exécutez bmad-sprint-planning (bmad-sprint-planning). Cette commande crée sprint-status.yaml pour suivre tous les epics et stories.

Lorsque Build retrouve la story sélectionnée dans ce fichier, il la passe à in-progress pendant l’implémentation, puis à review quand l’implémentation est terminée.

Le cycle de développement

Pour chaque changement direct ou story planifiée, répétez ce cycle dans de nouveaux chats :

Étape	Agent	Workflow	Commande	Objectif
1	DEV	bmad-build	bmad-build	Clarifier, planifier, implémenter, réviser et présenter
2	DEV	bmad-code-review	bmad-code-review	Validation qualité supplémentaire (recommandée)

La revue de Build fait partie de chaque exécution. bmad-code-review est une couche facultative de validation indépendante dans un contexte neuf.

Après avoir terminé toutes les stories d’un epic, invoquez l’agent Développeur (bmad-agent-dev) et exécutez bmad-retrospective (bmad-retrospective).

Ce que vous avez accompli

Vous maîtrisez maintenant les bases du développement avec BMad :

• Installation et configuration de BMad pour votre IDE
• Choix d’une profondeur de planification adaptée au travail
• Création des documents de planification (PRD, Architecture, Epics & Stories)
• Compréhension du cycle de développement pour l’implémentation

Votre projet contient désormais :

your-project/
├── _bmad/                                   # Configuration BMad
├── _bmad-output/
│   ├── planning-artifacts/
│   │   ├── PRD.md                           # Document d’exigences
│   │   ├── architecture.md                  # Décisions techniques
│   │   └── epics/                           # Fichiers epic et story
│   ├── implementation-artifacts/
│   │   └── sprint-status.yaml               # Suivi de sprint
│   └── project-context.md                   # Règles d’implémentation (optionnel)
└── ...

Référence rapide

Workflow	Commande	Agent	Objectif
bmad-help ⭐	bmad-help	Tous	Votre guide intelligent — posez n’importe quelle question !
bmad-prd	bmad-prd	Tous	Créer, mettre à jour ou valider un PRD
bmad-architecture	bmad-architecture	Architect	Créer le document d’architecture
bmad-generate-project-context	bmad-generate-project-context	Analyst	Créer le fichier de contexte projet
bmad-create-epics-and-stories	bmad-create-epics-and-stories	PM	Décomposer le PRD en epics
bmad-sprint-planning	bmad-sprint-planning	DEV	Jalon de préparation + initialisation du suivi de sprint + vue d’état
bmad-build	bmad-build	DEV	Implémenter une intention, une issue, une fonctionnalité, un correctif ou une story
bmad-code-review	bmad-code-review	DEV	Revoir le code implémenté

Questions fréquentes

Ai-je toujours besoin d’une architecture ? Non. Utilisez l’architecture lorsque les décisions techniques ou contraintes multi-systèmes doivent être explicites. Un travail clair peut entrer directement dans bmad-build; une initiative plus vaste fournit ses artefacts de planification au même workflow.

Puis-je modifier mon plan en cours de route ? Oui. Le workflow bmad-correct-course gère les changements de périmètre en cours d’implémentation.

Et si je veux d’abord brainstormer ? Invoquez l’agent Analyste (bmad-agent-analyst) et exécutez bmad-brainstorming (bmad-brainstorming) avant de commencer votre PRD.

Dois-je suivre un ordre strict ? Pas strictement. Une fois le flux maîtrisé, vous pouvez exécuter les workflows directement en vous référant au tableau ci-dessus.

Obtenir de l’aide

Premier réflexe : BMad-Help

Invoquez bmad-help à tout moment — c’est le moyen le plus rapide de vous débloquer. Posez-lui n’importe quelle question :

• « Que dois-je faire après l’installation ? »
• « Je suis bloqué sur le workflow X »
• « Quelles sont mes options pour Y ? »
• « Montre-moi ce qui a été fait jusqu’ici »

BMad-Help inspecte votre projet, détecte ce que vous avez accompli et vous indique exactement la prochaine étape.

• Pendant les workflows — Les agents vous guident à l’aide de questions et d’explications
• Communauté — Discord (#bmad-method-help, #report-bugs-and-issues)

Points clés à retenir

Retenez ceci

• Commencez par bmad-help — Votre guide intelligent qui connaît votre projet et vos options
• Utilisez toujours de nouveaux chats — Démarrez un nouveau chat pour chaque workflow
• La profondeur de planification varie — une intention directe et une story entièrement planifiée entrent toutes deux dans bmad-build
• BMad-Help se lance automatiquement — Chaque workflow se termine par des conseils sur la prochaine étape

Prêt à commencer ? Installez BMad, invoquez bmad-help, et laissez votre guide intelligent vous accompagner.

Glossaire

Footnotes

1. 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. ↩