Brian
bb45db4aa4
* feat(bmm): consolidate research trio into bmad-deep-recon
Replace bmad-market-research, bmad-domain-research, and bmad-technical-research
(5,136 lines of near-duplicate legacy step files) with one modern skill,
bmad-deep-recon (~650 lines):
- Research-master-orchestrator persona; conclusions never rest on training
data alone; lead-following rounds with coverage/novelty-exhaustion stops
- Six type packs as ~25-line policy+craft cards (market, domain, technical,
competitive, user-voice, academic-lit) + select decision shape layering a
weighted-matrix method over any type
- Three acquisition modes: Generate (subagent fan-out), Delegate (engine
registry: CLI/MCP, engine-first strategy), Import (provenance-tracked)
- Claims-ledger verification (normal/high/max) with independence rules and
optional red-team pass; cited synthesis with staleness map
- Effort presets (quick/standard/deep) over four knobs (subagents,
sources/round, depth, validation); precedence request > knob > preset
- Plan gate with surface discovery (MCPs/CLIs/engines), routing table, and
time estimate; use_workflows and subagent_models config
- Create/Refresh/Deepen intents, memlog run-folder workspace, headless JSON
- v6 shims forward the three old IDs with type pre-set; analyst menu,
catalog, marketplace, docs and translation mirrors updated
* feat(bmm): runtime output_format for bmad-deep-recon (v7 artifact protocol)
Replace the output_formats array with output_format = auto|html|md|both
(default auto): interactive runs render the HTML briefing, headless or
skill-invoked runs present the canonical markdown only. research.md always
exists in the workspace as the machine-readable report; the briefing is its
regenerable face. First instance of the v7 artifact protocol (memlog = truth,
md = distillation under contract, html = face).
* feat(core): move bmad-deep-recon to core-skills; address review findings
Move: research is not code-project-specific — home it in core-skills
(brainstorming precedent) so CIS and core-only installs get it. Skill ID
unchanged; standalone marketplace plugin added; catalogs moved to Core;
{planning_artifacts} falls back to {output_folder} on core-only installs.
v6 shims stay in bmm-skills (the legacy trio were bmm skills).
Review fixes (CodeRabbit):
- Engine briefs are now file-based: invoke templates substitute
{brief_file} (a skill-generated path), never inline brief text — quotes
and shell metacharacters in researched content can't shape a command.
- Refresh/Deepen preserve verification statuses for out-of-scope claims.
- HTML briefing: http(s)-only source links, escape source-derived text.
- user-voice pack: redact usernames/handles/emails from verbatim quotes;
communities complement surveys (triangulate) rather than beat them.
- engine.md: explicit single-writer rule — digests return to the lead,
which alone writes research.md in plan order.
* feat(core): deep-recon v2 — draft/process/run, faster defaults, research firewall
Rework after first real-run feedback (slow, token-heavy, locally biased
report, end-pass verification degraded quality, digests stranded in
subagent contexts):
- Three modes replace the acquisition-mode machinery: Draft (build a
deep-research prompt the user runs in their own subscribed tool),
Process (file a finished report into imports/, extract to digests/,
distill research.md summary + metadata so downstream never reprocesses),
Run (native fan-out, first-class). Bare research asks get the choice up
front with the trade stated honestly.
- Engine/Delegate registry cut: the Draft->Process round-trip is the
integration with dedicated deep-research tools; engine.md -> run.md.
- Files-first: digests hit {doc_workspace}/digests/ on landing, sections
commit per dimension, synthesis reads files never conversation memory,
dead runs resume from disk.
- Research firewall: persistent_facts default now empty, assistants get
only their brief, project context frames questions but is inadmissible
as evidence.
- Verification at landing, not end-of-run: normal = spot-check
load-bearing claims only; red_team default off; heavy passes behind
high/max. Presets rescaled faster (standard 3 subagents/8 sources/
depth 2).
- Multi-agent research lessons folded into run.md and the plan gate:
decomposition topology (breadth/depth/straightforward), per-assistant
tool-call budgets, query craft with OODA pause, shared source-quality
card, stop-and-write valve, mechanical citation check at finalize.
- Ripple: v6 shims, catalogs, marketplace, docs one-liners (all five
languages), template gains source: provenance field.
* feat(core): deep-recon quality pass — carve SKILL.md, recon_kit scripts, single-source verification
- SKILL.md 3989→2091 tokens: Draft/Process/Refresh+Deepen/Finalize carved to
references/{draft,process,lifecycle,finalize}.md; Run effort knobs + plan
gate moved into run.md; Overview and pack prose trimmed
- verification.md: red-team pass is the single adversarial mechanism (max
runs it at full breadth — no double-spawn); level semantics single-sourced
- scripts/recon_kit.py + tests: citations cross-check, memlog claim tally
(ref=/status= convention, last wins), staleness date math from per-class
windows, deterministic run-folder slugs, escaped source-appendix HTML
- Draft wired with preferred/banned source policies and an open-floor opening
- external_sources examples (Tavily/Sonar/xAI X-Search MCPs); source-quality
card: answer engines are aggregators — chase their citations
* docs: Deep Recon explanation page + integration
- new docs/explanation/deep-recon.md: three modes, mode-choice guidance,
research types, native-run internals diagram, firewall/verification, refresh
- analysis-phase.md research section rewritten for bmad-deep-recon
- core-tools.md: deep-recon in thinking-skills table, full catalog entry,
migration note for the merged market/domain/technical trio
- workflow-map.md + getting-started.md link the new page
- vi-vn developer guide: last stale old-skill flow mention updated
17 KiB
title, description
| title | description |
|---|---|
| Premiers pas | Installer BMad et développer votre premier projet |
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 bonne voie de planification selon la taille de votre projet
- Progresser dans les phases, de la définition des exigences au code fonctionnel
- Utiliser efficacement les agents et les workflows
:::note[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 :::
:::tip[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.
:::tip[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 (BMad Method/Enterprise uniquement) |
| 4 | Implémentation | Développer epic2 par epic, story3 par story |
Ouvrez la carte des workflows pour explorer les phases, les workflows et la gestion du contexte.
Selon la complexité de votre projet, BMad propose trois voies de planification :
| Voie | Idéal pour | Documents créés |
|---|---|---|
| Quick Dev | Corrections de bugs, fonctionnalités simples, périmètre clair (1-15 stories) | Spécification technique uniquement |
| BMad Method | Produits, plateformes, fonctionnalités complexes (10-50+ stories) | PRD + Architecture + UX4 |
| Enterprise | Conformité, systèmes multi-tenant5 (30+ stories) | PRD + Architecture + Security + DevOps |
:::note Le nombre de stories est indicatif, pas strictement défini. Choisissez votre voie en fonction de vos besoins de planification, pas d’un simple décompte de stories. :::
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
:::tip[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 ? » :::
:::note[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).
:::
:::caution[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 : Élaborer votre plan
Parcourez les phases 1 à 3. Utilisez un nouveau chat pour chaque workflow.
:::tip[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 (requise)
Pour les voies BMad Method et Enterprise :
- Exécutez
bmad-prddans un nouveau chat — précisez votre intention (Create / Update / Validate) ou laissez le skill vous la demander - Résultat :
prd.md,addendum.md,.memlog.md
:::note[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 :::
Pour la voie Quick Dev :
- Exécutez
bmad-quick-dev— ce workflow couvre la planification et l’implémentation en une seule fois ; vous pouvez passer directement à l’implémentation
:::note[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 (BMad Method/Enterprise)
Créer l’architecture
- Invoquez l'agent Architecte (
bmad-agent-architect) dans un nouveau chat - Exécutez
bmad-architecture(bmad-architecture) - Résultat : document d’architecture avec les décisions techniques
Créer les epics et les stories
:::tip[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é. :::
- Invoquez l'agent PM (
bmad-agent-pm) dans un nouveau chat - Exécutez
bmad-create-epics-and-stories(bmad-create-epics-and-stories) - 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)
- Invoquez l'agent Architecte (
bmad-agent-architect) dans un nouveau chat - Exécutez
bmad-check-implementation-readiness(bmad-check-implementation-readiness) - Valide la cohérence de l’ensemble des documents de planification
Étape 2 : Développer votre projet
Une fois la planification terminée, passez à l’implémentation. Chaque workflow doit être exécuté dans un nouveau chat.
Initialiser la planification de sprint
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.
Le cycle de développement
Pour chaque story, répétez ce cycle dans de nouveaux chats :
| Étape | Agent | Workflow | Commande | Objectif |
|---|---|---|---|---|
| 1 | DEV | bmad-create-story |
bmad-create-story |
Créer le fichier story depuis l’epic |
| 2 | DEV | bmad-dev-story |
bmad-dev-story |
Implémenter la story |
| 3 | DEV | bmad-code-review |
bmad-code-review |
Validation qualité (recommandée) |
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
- Initialisation d’un projet avec la voie de planification choisie
- 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-check-implementation-readiness |
bmad-check-implementation-readiness |
Architect | Valider la cohérence de la planification |
bmad-sprint-planning |
bmad-sprint-planning |
DEV | Initialiser le suivi de sprint |
bmad-create-story |
bmad-create-story |
DEV | Créer un fichier story |
bmad-dev-story |
bmad-dev-story |
DEV | Implémenter une story |
bmad-code-review |
bmad-code-review |
DEV | Revoir le code implémenté |
Questions fréquentes
Ai-je toujours besoin d’une architecture ? Seulement pour les voies BMad Method et Enterprise. Quick Dev passe directement de la spécification à l’implémentation.
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
:::tip[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
:::tip[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
- Le choix de la voie est important — Quick Dev utilise
bmad-quick-dev; BMad Method/Enterprise nécessitent un PRD et une architecture - 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
-
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. ↩︎
-
Epic : grand ensemble de fonctionnalités ou de travaux qui peut être décomposé en plusieurs user stories. ↩︎
-
Story (User Story) : description courte et simple d’une fonctionnalité du point de vue de l’utilisateur ou du client. Elle représente une unité de travail implémentable en un court délai. ↩︎
-
UX (User Experience) : expérience utilisateur, englobant l’ensemble des interactions et perceptions d’un utilisateur face à un produit. Le design UX vise à créer des interfaces intuitives, efficaces et agréables en tenant compte des besoins, des comportements et du contexte d’utilisation. ↩︎
-
Multi-tenant : architecture logicielle où une seule instance de l’application sert plusieurs clients (tenants) tout en maintenant leurs données isolées et sécurisées les unes des autres. ↩︎