119 lines
8.8 KiB
Markdown
119 lines
8.8 KiB
Markdown
---
|
|
title: "Workflow Map"
|
|
description: Visual reference for BMad Method workflow phases and outputs
|
|
sidebar:
|
|
order: 1
|
|
---
|
|
|
|
The BMad Method (BMM) is a module in the BMad Ecosystem, targeted at following the best practices of context engineering
|
|
and planning. AI agents work best with clear, structured context. The BMM system builds that context progressively
|
|
across 4 distinct phases - each phase, and multiple workflows optionally within each phase, produce documents that
|
|
inform the next, so agents always know what to build and why.
|
|
|
|
The rationale and concepts come from agile methodologies that have been used across the industry with great success as a
|
|
mental framework.
|
|
|
|
If at any time you are unsure what to do, the `bmad-help` skill will help you stay on track or know what to do next. You
|
|
can always refer to this for reference also - but `bmad-help` is fully interactive and much quicker if you have already
|
|
installed the BMad Method. Additionally, if you are using different modules that have extended the BMad Method or added
|
|
other complementary non-extension modules - `bmad-help` evolves to know all that is available to give you the best
|
|
in-the-moment advice.
|
|
|
|
Final important note: Every workflow below can be run directly with your tool of choice via skill or by loading an agent
|
|
first and using the entry from the agents menu.
|
|
|
|
<iframe src="/workflow-map-diagram.html" title="BMad Method Workflow Map Diagram" width="100%" height="100%" style="border-radius: 8px; border: 1px solid #334155; min-height: 900px;"></iframe>
|
|
|
|
<p style="font-size: 0.8rem; text-align: right; margin-top: -0.5rem; margin-bottom: 1rem;">
|
|
<a href="/workflow-map-diagram.html" target="_blank" rel="noopener noreferrer">Open diagram in new tab ↗</a>
|
|
</p>
|
|
|
|
## Phase 1: Analysis (Optional)
|
|
|
|
Explore the problem space and validate ideas before committing to planning. [**Learn what each tool does and when to use
|
|
it**](../explanation/analysis-phase.md).
|
|
|
|
| Workflow | Purpose | Produces |
|
|
|---------------------------------------------------------------------------|----------------------------------------------------------------------------|---------------------------|
|
|
| `bmad-brainstorming` | Brainstorm Project Ideas with guided facilitation of a brainstorming coach | `brainstorm.html` keepsake plus an optional `brainstorm-intent.md` |
|
|
| `bmad-forge-idea` | Pressure-test an idea until it hardens, proves out, or dies cheaply | `forge-report.html` every run; `forged-idea.md` when an idea hardens |
|
|
| `bmad-domain-research`, `bmad-market-research`, `bmad-technical-research` | Validate market, technical, or domain assumptions | Research findings |
|
|
| `bmad-product-brief` | Capture strategic vision — best when your concept is clear | `brief.md` + `addendum.md`, plus any desired HTML or presentation output |
|
|
| `bmad-prfaq` | Working Backwards — stress-test your product concept customer-first | `prfaq-{project}.md` |
|
|
|
|
## Phase 2: Planning
|
|
|
|
Define what to build and for whom.
|
|
|
|
| Workflow | Purpose | Produces |
|
|
|-------------------------|-------------------------------------------------------------------------------------|---------------------------------------------------|
|
|
| `bmad-prd` | Create, update, or validate a PRD — facilitated discovery, three intents in one skill | Create/Update: `prd.md`, `addendum.md`, `.memlog.md`; Validate: `validation-report.html` + `.md` |
|
|
| `bmad-ux` | Design user experience (when UX matters) — DESIGN.md (visual) + EXPERIENCE.md (behavioral) spine pair | `DESIGN.md`, `EXPERIENCE.md`, `.memlog.md` |
|
|
|
|
:::tip[Three intents in one skill]
|
|
`bmad-prd` handles the full PRD lifecycle. State your intent when invoking or the skill will ask:
|
|
|
|
- **Create** — new PRD from scratch via coached discovery; produces `prd.md`, `addendum.md`, and `.memlog.md`
|
|
- **Update** — reconcile an existing PRD with a change signal, surfacing conflicts before applying changes
|
|
- **Validate** — critique a PRD against a configurable checklist and produce a structured HTML findings report
|
|
:::
|
|
|
|
:::tip[Upstream: `bmad-product-brief`]
|
|
`bmad-product-brief` (Phase 1) produces a `product-brief.md` that `bmad-prd` can source-extract during Discovery, reducing re-explanation and keeping the two documents aligned. Neither skill requires the other — start with `bmad-prd` directly if you already know what you're building.
|
|
:::
|
|
|
|
## Phase 3: Solutioning
|
|
|
|
Decide how to build it and break work into stories.
|
|
|
|
| Workflow | Purpose | Produces |
|
|
|---------------------------------------|--------------------------------------------|-----------------------------|
|
|
| `bmad-architecture` | Make technical decisions explicit | `ARCHITECTURE-SPINE.md` is the spine by default but can hydrate to your desired output or presentation needs also |
|
|
| `bmad-create-epics-and-stories` | Break requirements into implementable work | Epic files with stories |
|
|
| `bmad-check-implementation-readiness` | Gate check before implementation | PASS/CONCERNS/FAIL decision |
|
|
|
|
## Phase 4: Implementation
|
|
|
|
Build it, one story at a time. Phase 4 epic and story automation is now available also. So you can choose how you want to stay in the loop. You can choose the full flow, or go right to quick flow.
|
|
|
|
| Workflow | Purpose | Produces |
|
|
|------------------------|-------------------------------------------------------------------------------|------------------------------------------------------|
|
|
| `bmad-sprint-planning` | Initialize tracking (once per project to sequence the dev cycle) | `sprint-status.yaml` |
|
|
| `bmad-create-story` | Prepare next story for implementation | `story-[slug].md` |
|
|
| `bmad-dev-story` | Implement the story | Working code + tests |
|
|
| `bmad-code-review` | Validate implementation quality | Approved or changes requested |
|
|
| `bmad-correct-course` | Handle significant mid-sprint changes | Updated plan or re-routing |
|
|
| `bmad-sprint-status` | Track sprint progress and story status | Sprint status update |
|
|
| `bmad-retrospective` | Review after epic completion | Lessons learned |
|
|
| `bmad-investigate` | Forensic case investigation with evidence-graded findings, calibrated to the input | `{slug}-investigation.md` |
|
|
|
|
## Quick Flow (Parallel Track)
|
|
|
|
Skip phases 1-3 for small, well-understood work.
|
|
|
|
| Workflow | Purpose | Produces |
|
|
|------------------|---------------------------------------------------------------------------|--------------------|
|
|
| `bmad-quick-dev` | Unified quick flow — clarify intent, plan, implement, review, and present | `spec-*.md` + code |
|
|
|
|
## Context Management
|
|
|
|
Each document becomes context for the next phase. The PRD tells the architect what constraints matter. The architecture
|
|
tells the dev agent which patterns to follow. Story files give focused, complete context for implementation. Without
|
|
this structure, agents make inconsistent decisions.
|
|
|
|
### Project Context
|
|
|
|
:::tip[Recommended]
|
|
Create `project-context.md` to ensure AI agents follow your project's rules and preferences. This file works like a
|
|
constitution for your project — it guides implementation decisions across all workflows. This optional file can be
|
|
generated at the end of Architecture Creation, or in an existing project it can be generated also to capture whats
|
|
important to keep aligned with current conventions.
|
|
:::
|
|
|
|
**How to create it:**
|
|
|
|
- **Manually** — Create `_bmad-output/project-context.md` with your technology stack and implementation rules
|
|
- **Generate it** — Run `bmad-generate-project-context` to auto-generate from your architecture or codebase
|
|
|
|
[**Learn more about project-context.md**](../explanation/project-context.md)
|