Files
Keep/_bmad/COMMANDS.md

13 KiB

BMAD Commands

Auto-generated by bmalph. Do not edit.

Agents

Command Description Invocation
analyst Research, briefs, discovery Read and follow the agent defined in _bmad/bmm/agents/analyst.agent.yaml.
architect Technical design, architecture Read and follow the agent defined in _bmad/bmm/agents/architect.agent.yaml.
brainstorm-project brainstorm-project Adopt the role of the agent defined in _bmad/bmm/agents/analyst.agent.yaml, then read and execute the workflow at _bmad/core/skills/bmad-brainstorming/workflow.md using _bmad/bmm/data/project-context-template.md as context data.
dev Implementation, coding Read and follow the agent defined in _bmad/bmm/agents/dev.agent.yaml.
pm PRDs, epics, stories Read and follow the agent defined in _bmad/bmm/agents/pm.agent.yaml.
qa Test automation, quality assurance Read and follow the agent defined in _bmad/bmm/agents/qa.agent.yaml.
quick-flow-solo-dev Quick one-off tasks, small changes Read and follow the agent defined in _bmad/bmm/agents/quick-flow-solo-dev.agent.yaml.
sm Sprint planning, status, coordination Read and follow the agent defined in _bmad/bmm/agents/sm.agent.yaml.
tech-writer Documentation, technical writing Read and follow the agent defined in _bmad/bmm/agents/tech-writer/tech-writer.agent.yaml.
ux-designer User experience, wireframes Read and follow the agent defined in _bmad/bmm/agents/ux-designer.agent.yaml.

Phase 1: Analysis

Command Description Invocation
create-brief A guided experience to nail down your product idea Adopt the role of the agent defined in _bmad/bmm/agents/analyst.agent.yaml, then read and execute the workflow at _bmad/bmm/workflows/1-analysis/bmad-create-product-brief/workflow.md in Create mode.
domain-research Industry domain deep dive subject matter expertise and terminology Adopt the role of the agent defined in _bmad/bmm/agents/analyst.agent.yaml, then read and execute the workflow at _bmad/bmm/workflows/1-analysis/research/bmad-domain-research/workflow.md.
market-research Market analysis competitive landscape customer needs and trends Adopt the role of the agent defined in _bmad/bmm/agents/analyst.agent.yaml, then read and execute the workflow at _bmad/bmm/workflows/1-analysis/research/bmad-market-research/workflow.md.
technical-research Technical feasibility architecture options and implementation approaches Adopt the role of the agent defined in _bmad/bmm/agents/analyst.agent.yaml, then read and execute the workflow at _bmad/bmm/workflows/1-analysis/research/bmad-technical-research/workflow.md.
validate-brief A guided experience to nail down your product idea Adopt the role of the agent defined in _bmad/bmm/agents/analyst.agent.yaml, then read and execute the workflow at _bmad/bmm/workflows/1-analysis/bmad-create-product-brief/workflow.md in Validate mode.

Phase 2: Planning

Command Description Invocation
create-prd Expert led facilitation to produce your Product Requirements Document Adopt the role of the agent defined in _bmad/bmm/agents/pm.agent.yaml, then read and execute the workflow at _bmad/core/tasks/bmad-create-prd/workflow.md.
create-ux Guidance through realizing the plan for your UX, strongly recommended if a UI is a primary piece of the proposed project Adopt the role of the agent defined in _bmad/bmm/agents/ux-designer.agent.yaml, then read and execute the workflow at _bmad/bmm/workflows/2-plan-workflows/bmad-create-ux-design/workflow.md in Create mode.
edit-prd Improve and enhance an existing PRD Adopt the role of the agent defined in _bmad/bmm/agents/pm.agent.yaml, then read and execute the workflow at _bmad/bmm/workflows/2-plan-workflows/bmad-edit-prd/workflow.md.
validate-prd Validate PRD is comprehensive lean well organized and cohesive Adopt the role of the agent defined in _bmad/bmm/agents/pm.agent.yaml, then read and execute the workflow at _bmad/bmm/workflows/2-plan-workflows/bmad-validate-prd/workflow.md.
validate-ux Guidance through realizing the plan for your UX, strongly recommended if a UI is a primary piece of the proposed project Adopt the role of the agent defined in _bmad/bmm/agents/ux-designer.agent.yaml, then read and execute the workflow at _bmad/bmm/workflows/2-plan-workflows/bmad-create-ux-design/workflow.md in Validate mode.

Phase 3: Solutioning

Command Description Invocation
create-architecture Guided Workflow to document technical decisions Adopt the role of the agent defined in _bmad/bmm/agents/architect.agent.yaml, then read and execute the workflow at _bmad/bmm/workflows/3-solutioning/bmad-create-architecture/workflow.md in Create mode.
create-epics-stories Create the Epics and Stories Listing Adopt the role of the agent defined in _bmad/bmm/agents/pm.agent.yaml, then read and execute the workflow at _bmad/bmm/workflows/3-solutioning/bmad-create-epics-and-stories/workflow.md in Create mode.
implementation-readiness Ensure PRD UX Architecture and Epics Stories are aligned Adopt the role of the agent defined in _bmad/bmm/agents/architect.agent.yaml, then read and execute the workflow at _bmad/bmm/workflows/3-solutioning/bmad-check-implementation-readiness/workflow.md in Validate mode.
validate-architecture Guided Workflow to document technical decisions Adopt the role of the agent defined in _bmad/bmm/agents/architect.agent.yaml, then read and execute the workflow at _bmad/bmm/workflows/3-solutioning/bmad-create-architecture/workflow.md in Validate mode.
validate-epics-stories Create the Epics and Stories Listing Adopt the role of the agent defined in _bmad/bmm/agents/pm.agent.yaml, then read and execute the workflow at _bmad/bmm/workflows/3-solutioning/bmad-create-epics-and-stories/workflow.md in Validate mode.

Phase 4: Implementation

Command Description Invocation
create-story Story cycle start: Prepare first found story in the sprint plan that is next, or if the command is run with a specific epic and story designation with context. Once complete, then VS then DS then CR then back to DS if needed or next CS or ER Adopt the role of the agent defined in _bmad/bmm/agents/sm.agent.yaml, then read and execute the workflow at _bmad/bmm/workflows/4-implementation/bmad-create-story/workflow.md in Create mode.
qa-automate Generate automated API and E2E tests for implemented code using the project's existing test framework (detects existing well known in use test frameworks). Use after implementation to add test coverage. NOT for code review or story validation - use CR for that. Adopt the role of the agent defined in _bmad/bmm/agents/qa.agent.yaml, then read and execute the workflow at _bmad/bmm/workflows/bmad-qa-generate-e2e-tests/workflow.md.
retrospective Optional at epic end: Review completed work lessons learned and next epic or if major issues consider CC Adopt the role of the agent defined in _bmad/bmm/agents/sm.agent.yaml, then read and execute the workflow at _bmad/bmm/workflows/4-implementation/bmad-retrospective/workflow.md.
sprint-planning Generate sprint plan for development tasks - this kicks off the implementation phase by producing a plan the implementation agents will follow in sequence for every story in the plan. Adopt the role of the agent defined in _bmad/bmm/agents/sm.agent.yaml, then read and execute the workflow at _bmad/bmm/workflows/4-implementation/bmad-sprint-planning/workflow.md in Create mode.
sprint-status Anytime: Summarize sprint status and route to next workflow Adopt the role of the agent defined in _bmad/bmm/agents/sm.agent.yaml, then read and execute the workflow at _bmad/bmm/workflows/4-implementation/bmad-sprint-status/workflow.md.
validate-story Story cycle start: Prepare first found story in the sprint plan that is next, or if the command is run with a specific epic and story designation with context. Once complete, then VS then DS then CR then back to DS if needed or next CS or ER Adopt the role of the agent defined in _bmad/bmm/agents/sm.agent.yaml, then read and execute the workflow at _bmad/bmm/workflows/4-implementation/bmad-create-story/workflow.md in Validate mode.

Utilities

Command Description Invocation
advanced-elicitation advanced elicitation Read and execute the workflow/task at _bmad/core/skills/bmad-advanced-elicitation/workflow.md.
adversarial-review adversarial review Read and execute the workflow/task at _bmad/core/skills/bmad-review-adversarial-general/workflow.md.
bmad-help bmad help Read and execute the workflow/task at _bmad/core/skills/bmad-help/workflow.md.
brainstorming brainstorming Read and execute the workflow/task at _bmad/core/skills/bmad-brainstorming/workflow.md.
correct-course Anytime: Navigate significant changes. May recommend start over update PRD redo architecture sprint planning or correct epics and stories Adopt the role of the agent defined in _bmad/bmm/agents/sm.agent.yaml, then read and execute the workflow at _bmad/bmm/workflows/4-implementation/bmad-correct-course/workflow.md in Create mode.
distillator distillator Read and execute the workflow/task at _bmad/core/skills/bmad-distillator/SKILL.md.
document-project Analyze an existing project to produce useful documentation Adopt the role of the agent defined in _bmad/bmm/agents/analyst.agent.yaml, then read and execute the workflow at _bmad/bmm/workflows/bmad-document-project/workflow.md in Create mode.
edge-case-hunter edge case hunter Read and execute the workflow/task at _bmad/core/skills/bmad-review-edge-case-hunter/workflow.md.
editorial-prose editorial prose Read and execute the workflow/task at _bmad/core/skills/bmad-editorial-review-prose/workflow.md.
editorial-structure editorial structure Read and execute the workflow/task at _bmad/core/skills/bmad-editorial-review-structure/workflow.md.
generate-project-context Scan existing codebase to generate a lean LLM-optimized project-context.md containing critical implementation rules patterns and conventions for AI agents. Essential for brownfield projects and quick-flow. Adopt the role of the agent defined in _bmad/bmm/agents/analyst.agent.yaml, then read and execute the workflow at _bmad/bmm/workflows/bmad-generate-project-context/workflow.md.
index-docs index docs Read and execute the workflow/task at _bmad/core/skills/bmad-index-docs/workflow.md.
party-mode party mode Read and execute the workflow/task at _bmad/core/skills/bmad-party-mode/workflow.md.
quick-dev-new Unified quick flow (experimental): clarify intent plan implement review and present in a single workflow Adopt the role of the agent defined in _bmad/bmm/agents/quick-flow-solo-dev.agent.yaml, then read and execute the workflow at _bmad/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/workflow.md in Create mode.
quick-dev Quick one-off tasks small changes simple apps utilities without extensive planning - Do not suggest for potentially very complex things unless requested or if the user complains that they do not want to follow the extensive planning of the bmad method, unless the user is already working through the implementation phase and just requests a 1 off things not already in the plan Adopt the role of the agent defined in _bmad/bmm/agents/quick-flow-solo-dev.agent.yaml, then read and execute the workflow at _bmad/bmm/workflows/bmad-quick-flow/bmad-quick-dev/workflow.md in Create mode.
shard-doc shard doc Read and execute the workflow/task at _bmad/core/skills/bmad-shard-doc/workflow.md.
tech-spec Do not suggest for potentially very complex things unless requested or if the user complains that they do not want to follow the extensive planning of the bmad method. Quick one-off tasks small changes simple apps brownfield additions to well established patterns utilities without extensive planning Adopt the role of the agent defined in _bmad/bmm/agents/quick-flow-solo-dev.agent.yaml, then read and execute the workflow at _bmad/bmm/workflows/bmad-quick-flow/bmad-quick-spec/workflow.md in Create mode.

bmalph CLI

Command Description How to run
bmalph-doctor Check project health and report issues Run bmalph doctor
bmalph-implement Transition planning artifacts to Ralph format Run bmalph implement
bmalph-status Show current phase, Ralph progress, version info Run bmalph status
bmalph-upgrade Update bundled assets to current version Run bmalph upgrade
bmalph-watch Launch Ralph live dashboard Run bmalph run
bmalph BMAD master agent — navigate phases Read and follow the master agent instructions in this file