bmad-method 6.0.3 → 6.0.5-next.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.augment/code_review_guidelines.yaml +2 -42
- package/.claude/skills/bmad-os-findings-triage/SKILL.md +6 -0
- package/.claude/skills/bmad-os-findings-triage/prompts/agent-prompt.md +104 -0
- package/.claude/skills/bmad-os-findings-triage/prompts/instructions.md +286 -0
- package/.claude/skills/bmad-os-review-pr/SKILL.md +1 -1
- package/.claude/skills/bmad-os-review-pr/prompts/instructions.md +63 -6
- package/.claude/skills/bmad-os-review-prompt/SKILL.md +177 -0
- package/.claude/skills/bmad-os-root-cause-analysis/SKILL.md +12 -0
- package/.claude/skills/bmad-os-root-cause-analysis/prompts/instructions.md +74 -0
- package/.github/ISSUE_TEMPLATE/config.yaml +1 -1
- package/.github/ISSUE_TEMPLATE/documentation.yaml +1 -1
- package/.github/workflows/publish.yaml +243 -0
- package/CHANGELOG.md +32 -0
- package/CONTRIBUTING.md +1 -1
- package/README.md +8 -8
- package/README_CN.md +121 -0
- package/docs/_STYLE_GUIDE.md +10 -10
- package/docs/explanation/brainstorming.md +1 -1
- package/docs/explanation/party-mode.md +1 -1
- package/docs/explanation/preventing-agent-conflicts.md +1 -1
- package/docs/explanation/project-context.md +15 -15
- package/docs/explanation/quick-flow.md +9 -9
- package/docs/how-to/established-projects.md +7 -7
- package/docs/how-to/get-answers-about-bmad.md +2 -2
- package/docs/how-to/install-bmad.md +16 -6
- package/docs/how-to/project-context.md +2 -2
- package/docs/how-to/quick-fixes.md +5 -5
- package/docs/how-to/shard-large-documents.md +1 -1
- package/docs/how-to/upgrade-to-v6.md +8 -5
- package/docs/index.md +2 -2
- package/docs/reference/agents.md +14 -14
- package/docs/reference/commands.md +64 -70
- package/docs/reference/testing.md +1 -1
- package/docs/reference/workflow-map.md +19 -19
- package/docs/tutorials/getting-started.md +34 -34
- package/docs/zh-cn/404.md +9 -0
- package/docs/zh-cn/_STYLE_GUIDE.md +370 -0
- package/docs/zh-cn/explanation/advanced-elicitation.md +62 -0
- package/docs/zh-cn/explanation/adversarial-review.md +71 -0
- package/docs/zh-cn/explanation/brainstorming.md +43 -0
- package/docs/zh-cn/explanation/established-projects-faq.md +60 -0
- package/docs/zh-cn/explanation/party-mode.md +79 -0
- package/docs/zh-cn/explanation/preventing-agent-conflicts.md +137 -0
- package/docs/zh-cn/explanation/project-context.md +176 -0
- package/docs/zh-cn/explanation/quick-flow.md +93 -0
- package/docs/zh-cn/explanation/why-solutioning-matters.md +90 -0
- package/docs/zh-cn/how-to/customize-bmad.md +182 -0
- package/docs/zh-cn/how-to/established-projects.md +134 -0
- package/docs/zh-cn/how-to/get-answers-about-bmad.md +144 -0
- package/docs/zh-cn/how-to/install-bmad.md +105 -0
- package/docs/zh-cn/how-to/non-interactive-installation.md +181 -0
- package/docs/zh-cn/how-to/project-context.md +152 -0
- package/docs/zh-cn/how-to/quick-fixes.md +140 -0
- package/docs/zh-cn/how-to/shard-large-documents.md +86 -0
- package/docs/zh-cn/how-to/upgrade-to-v6.md +120 -0
- package/docs/zh-cn/index.md +69 -0
- package/docs/zh-cn/reference/agents.md +41 -0
- package/docs/zh-cn/reference/commands.md +166 -0
- package/docs/zh-cn/reference/modules.md +94 -0
- package/docs/zh-cn/reference/testing.md +122 -0
- package/docs/zh-cn/reference/workflow-map.md +104 -0
- package/docs/zh-cn/roadmap.mdx +152 -0
- package/docs/zh-cn/tutorials/getting-started.md +300 -0
- package/package.json +1 -1
- package/src/bmm/agents/analyst.agent.yaml +1 -1
- package/src/bmm/agents/bmad-skill-manifest.yaml +39 -0
- package/src/bmm/agents/dev.agent.yaml +2 -2
- package/src/bmm/agents/pm.agent.yaml +1 -1
- package/src/bmm/agents/qa.agent.yaml +1 -1
- package/src/bmm/agents/quick-flow-solo-dev.agent.yaml +6 -2
- package/src/bmm/agents/sm.agent.yaml +4 -4
- package/src/bmm/agents/tech-writer/bmad-skill-manifest.yaml +3 -0
- package/src/bmm/agents/tech-writer/tech-writer.agent.yaml +1 -1
- package/src/bmm/module-help.csv +11 -10
- package/src/bmm/workflows/1-analysis/create-product-brief/bmad-skill-manifest.yaml +3 -0
- package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-02-vision.md +1 -1
- package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-03-users.md +1 -1
- package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-04-metrics.md +1 -1
- package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-05-scope.md +1 -1
- package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-06-complete.md +1 -1
- package/src/bmm/workflows/1-analysis/research/bmad-skill-manifest.yaml +14 -0
- package/src/bmm/workflows/2-plan-workflows/create-prd/bmad-skill-manifest.yaml +14 -0
- package/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-02-discovery.md +1 -1
- package/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-02b-vision.md +1 -1
- package/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-02c-executive-summary.md +1 -1
- package/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-03-success.md +1 -1
- package/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-04-journeys.md +1 -1
- package/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-05-domain.md +1 -1
- package/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-06-innovation.md +1 -1
- package/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-07-project-type.md +1 -1
- package/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-08-scoping.md +1 -1
- package/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-09-functional.md +1 -1
- package/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-10-nonfunctional.md +1 -1
- package/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-11-polish.md +1 -1
- package/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-12-complete.md +1 -1
- package/src/bmm/workflows/2-plan-workflows/create-prd/steps-e/step-e-01-discovery.md +1 -1
- package/src/bmm/workflows/2-plan-workflows/create-prd/steps-e/step-e-02-review.md +1 -1
- package/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-01-discovery.md +1 -1
- package/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-10-smart-validation.md +1 -1
- package/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-11-holistic-quality-validation.md +1 -1
- package/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-13-report-complete.md +1 -1
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/bmad-skill-manifest.yaml +3 -0
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-02-discovery.md +1 -1
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-03-core-experience.md +2 -2
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-04-emotional-response.md +2 -2
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-05-inspiration.md +2 -2
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-06-design-system.md +2 -2
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-07-defining-experience.md +2 -2
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-08-visual-foundation.md +2 -2
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-09-design-directions.md +2 -2
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-10-user-journeys.md +2 -2
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-11-component-strategy.md +2 -2
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-12-ux-patterns.md +2 -2
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-13-responsive-accessibility.md +2 -2
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-14-complete.md +1 -1
- package/src/bmm/workflows/3-solutioning/check-implementation-readiness/bmad-skill-manifest.yaml +3 -0
- package/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-06-final-assessment.md +1 -1
- package/src/bmm/workflows/3-solutioning/create-architecture/bmad-skill-manifest.yaml +3 -0
- package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-02-context.md +2 -2
- package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-03-starter.md +2 -2
- package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-04-decisions.md +2 -2
- package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-05-patterns.md +2 -2
- package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-06-structure.md +2 -2
- package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-07-validation.md +2 -2
- package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-08-complete.md +1 -1
- package/src/bmm/workflows/3-solutioning/create-epics-and-stories/bmad-skill-manifest.yaml +3 -0
- package/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-01-validate-prerequisites.md +1 -1
- package/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-02-design-epics.md +1 -1
- package/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-03-create-stories.md +1 -1
- package/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-04-final-validation.md +2 -2
- package/src/bmm/workflows/4-implementation/code-review/bmad-skill-manifest.yaml +3 -0
- package/src/bmm/workflows/4-implementation/code-review/discover-inputs.md +88 -0
- package/src/bmm/workflows/4-implementation/code-review/workflow.md +271 -0
- package/src/bmm/workflows/4-implementation/correct-course/bmad-skill-manifest.yaml +3 -0
- package/src/bmm/workflows/4-implementation/correct-course/checklist.md +1 -1
- package/src/bmm/workflows/4-implementation/correct-course/{instructions.md → workflow.md} +79 -12
- package/src/bmm/workflows/4-implementation/create-story/bmad-skill-manifest.yaml +3 -0
- package/src/bmm/workflows/4-implementation/create-story/checklist.md +9 -10
- package/src/bmm/workflows/4-implementation/create-story/discover-inputs.md +88 -0
- package/src/bmm/workflows/4-implementation/create-story/workflow.md +388 -0
- package/src/bmm/workflows/4-implementation/dev-story/bmad-skill-manifest.yaml +3 -0
- package/src/bmm/workflows/4-implementation/dev-story/{instructions.xml → workflow.md} +49 -2
- package/src/bmm/workflows/4-implementation/retrospective/bmad-skill-manifest.yaml +3 -0
- package/src/bmm/workflows/4-implementation/retrospective/{instructions.md → workflow.md} +64 -23
- package/src/bmm/workflows/4-implementation/sprint-planning/bmad-skill-manifest.yaml +3 -0
- package/src/bmm/workflows/4-implementation/sprint-planning/sprint-status-template.yaml +1 -0
- package/src/bmm/workflows/4-implementation/sprint-planning/{instructions.md → workflow.md} +55 -10
- package/src/bmm/workflows/4-implementation/sprint-status/bmad-skill-manifest.yaml +3 -0
- package/src/bmm/workflows/4-implementation/sprint-status/{instructions.md → workflow.md} +45 -8
- package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/SKILL.md +6 -0
- package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/bmad-skill-manifest.yaml +1 -0
- package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/steps/step-01-clarify-and-route.md +54 -0
- package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/steps/step-02-plan.md +39 -0
- package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/steps/step-03-implement.md +35 -0
- package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/steps/step-04-review.md +55 -0
- package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/steps/step-05-present.md +19 -0
- package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/tech-spec-template.md +90 -0
- package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/workflow.md +84 -0
- package/src/bmm/workflows/bmad-quick-flow/quick-dev/bmad-skill-manifest.yaml +3 -0
- package/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-05-adversarial-review.md +8 -14
- package/src/bmm/workflows/bmad-quick-flow/quick-dev/workflow.md +1 -1
- package/src/bmm/workflows/bmad-quick-flow/quick-spec/bmad-skill-manifest.yaml +3 -0
- package/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-04-review.md +4 -6
- package/src/bmm/workflows/bmad-quick-flow/quick-spec/workflow.md +1 -1
- package/src/bmm/workflows/document-project/bmad-skill-manifest.yaml +3 -0
- package/src/bmm/workflows/document-project/instructions.md +5 -7
- package/src/bmm/workflows/document-project/workflow.md +39 -0
- package/src/bmm/workflows/document-project/workflows/deep-dive-instructions.md +0 -1
- package/src/bmm/workflows/document-project/workflows/deep-dive-workflow.md +42 -0
- package/src/bmm/workflows/document-project/workflows/full-scan-instructions.md +0 -1
- package/src/bmm/workflows/document-project/workflows/full-scan-workflow.md +42 -0
- package/src/bmm/workflows/generate-project-context/bmad-skill-manifest.yaml +3 -0
- package/src/bmm/workflows/generate-project-context/steps/step-02-generate.md +2 -2
- package/src/bmm/workflows/qa-generate-e2e-tests/bmad-skill-manifest.yaml +3 -0
- package/src/bmm/workflows/qa-generate-e2e-tests/checklist.md +1 -1
- package/src/bmm/workflows/qa-generate-e2e-tests/{instructions.md → workflow.md} +40 -7
- package/src/core/agents/bmad-master.agent.yaml +1 -1
- package/src/core/agents/bmad-skill-manifest.yaml +3 -0
- package/src/core/module-help.csv +3 -2
- package/src/core/module.yaml +1 -1
- package/src/core/tasks/bmad-help/SKILL.md +6 -0
- package/src/core/tasks/bmad-help/bmad-skill-manifest.yaml +1 -0
- package/src/core/tasks/{help.md → bmad-help/workflow.md} +6 -4
- package/src/core/tasks/bmad-review-adversarial-general/SKILL.md +6 -0
- package/src/core/tasks/bmad-review-adversarial-general/bmad-skill-manifest.yaml +1 -0
- package/src/core/tasks/bmad-review-adversarial-general/workflow.md +32 -0
- package/src/core/tasks/bmad-review-edge-case-hunter/SKILL.md +6 -0
- package/src/core/tasks/bmad-review-edge-case-hunter/bmad-skill-manifest.yaml +1 -0
- package/src/core/tasks/bmad-review-edge-case-hunter/workflow.md +62 -0
- package/src/core/tasks/bmad-skill-manifest.yaml +19 -0
- package/src/core/workflows/advanced-elicitation/bmad-skill-manifest.yaml +3 -0
- package/src/core/workflows/advanced-elicitation/workflow.md +138 -0
- package/src/core/workflows/brainstorming/bmad-skill-manifest.yaml +3 -0
- package/src/core/workflows/brainstorming/steps/step-01-session-setup.md +31 -18
- package/src/core/workflows/brainstorming/steps/step-01b-continue.md +1 -1
- package/src/core/workflows/brainstorming/steps/step-03-technique-execution.md +3 -3
- package/src/core/workflows/brainstorming/steps/step-04-idea-organization.md +2 -2
- package/src/core/workflows/brainstorming/workflow.md +5 -3
- package/src/core/workflows/party-mode/bmad-skill-manifest.yaml +3 -0
- package/src/core/workflows/party-mode/workflow.md +1 -1
- package/src/utility/agent-components/activation-steps.txt +2 -2
- package/src/utility/agent-components/handler-multi.txt +1 -2
- package/test/adversarial-review-tests/README.md +3 -3
- package/test/adversarial-review-tests/test-cases.yaml +2 -2
- package/test/fixtures/agent-schema/valid/menu/multiple-menu-items.agent.yaml +1 -1
- package/test/fixtures/agent-schema/valid/menu-commands/all-command-types.agent.yaml +1 -1
- package/test/fixtures/agent-schema/valid/menu-commands/multiple-commands.agent.yaml +1 -2
- package/test/fixtures/file-refs-csv/valid/bmm-style.csv +1 -1
- package/test/test-file-refs-csv.js +1 -1
- package/test/test-install-to-bmad.js +154 -0
- package/test/test-installation-components.js +1586 -2
- package/test/test-workflow-path-regex.js +88 -0
- package/tools/cli/installers/install-messages.yaml +1 -1
- package/tools/cli/installers/lib/core/installer.js +34 -1
- package/tools/cli/installers/lib/core/manifest-generator.js +332 -41
- package/tools/cli/installers/lib/ide/_base-ide.js +24 -15
- package/tools/cli/installers/lib/ide/_config-driven.js +547 -53
- package/tools/cli/installers/lib/ide/manager.js +26 -62
- package/tools/cli/installers/lib/ide/platform-codes.yaml +116 -29
- package/tools/cli/installers/lib/ide/shared/agent-command-generator.js +1 -0
- package/tools/cli/installers/lib/ide/shared/bmad-artifacts.js +7 -0
- package/tools/cli/installers/lib/ide/shared/path-utils.js +68 -3
- package/tools/cli/installers/lib/ide/shared/skill-manifest.js +90 -0
- package/tools/cli/installers/lib/ide/shared/task-tool-command-generator.js +2 -0
- package/tools/cli/installers/lib/ide/shared/workflow-command-generator.js +6 -145
- package/tools/cli/installers/lib/ide/templates/agent-command-template.md +1 -1
- package/tools/cli/installers/lib/ide/templates/combined/default-workflow.md +1 -1
- package/tools/cli/installers/lib/ide/templates/combined/gemini-workflow-yaml.toml +1 -1
- package/tools/cli/installers/lib/ide/templates/combined/gemini-workflow.toml +1 -1
- package/tools/cli/installers/lib/ide/templates/combined/opencode-agent.md +1 -1
- package/tools/cli/installers/lib/ide/templates/combined/opencode-task.md +0 -1
- package/tools/cli/installers/lib/ide/templates/combined/opencode-tool.md +0 -1
- package/tools/cli/installers/lib/ide/templates/combined/opencode-workflow-yaml.md +0 -1
- package/tools/cli/installers/lib/ide/templates/combined/opencode-workflow.md +0 -1
- package/tools/cli/installers/lib/modules/manager.js +9 -132
- package/tools/cli/lib/agent/compiler.js +1 -10
- package/tools/cli/lib/agent-analyzer.js +2 -14
- package/tools/cli/lib/yaml-xml-builder.js +1 -18
- package/tools/docs/native-skills-migration-checklist.md +281 -0
- package/tools/platform-codes.yaml +1 -1
- package/tools/schema/agent.js +1 -3
- package/tools/validate-file-refs.js +2 -0
- package/website/astro.config.mjs +24 -3
- package/website/src/content/config.ts +2 -1
- package/website/src/content/i18n/zh-CN.json +28 -0
- package/src/bmm/workflows/4-implementation/code-review/instructions.xml +0 -227
- package/src/bmm/workflows/4-implementation/code-review/workflow.yaml +0 -43
- package/src/bmm/workflows/4-implementation/correct-course/workflow.yaml +0 -53
- package/src/bmm/workflows/4-implementation/create-story/instructions.xml +0 -346
- package/src/bmm/workflows/4-implementation/create-story/workflow.yaml +0 -52
- package/src/bmm/workflows/4-implementation/dev-story/workflow.yaml +0 -20
- package/src/bmm/workflows/4-implementation/retrospective/workflow.yaml +0 -52
- package/src/bmm/workflows/4-implementation/sprint-planning/workflow.yaml +0 -47
- package/src/bmm/workflows/4-implementation/sprint-status/workflow.yaml +0 -25
- package/src/bmm/workflows/document-project/workflow.yaml +0 -22
- package/src/bmm/workflows/document-project/workflows/deep-dive.yaml +0 -31
- package/src/bmm/workflows/document-project/workflows/full-scan.yaml +0 -31
- package/src/bmm/workflows/qa-generate-e2e-tests/workflow.yaml +0 -42
- package/src/core/tasks/review-adversarial-general.xml +0 -49
- package/src/core/tasks/workflow.xml +0 -235
- package/src/core/workflows/advanced-elicitation/workflow.xml +0 -118
- package/src/utility/agent-components/handler-validate-workflow.txt +0 -7
- package/src/utility/agent-components/handler-workflow.txt +0 -10
- package/tools/cli/installers/lib/ide/codex.js +0 -440
- package/tools/cli/installers/lib/ide/github-copilot.js +0 -699
- package/tools/cli/installers/lib/ide/kilo.js +0 -269
- package/tools/cli/installers/lib/ide/rovodev.js +0 -257
- package/tools/cli/installers/lib/ide/templates/combined/default-workflow-yaml.md +0 -14
- package/tools/cli/installers/lib/ide/templates/combined/kiro-workflow-yaml.md +0 -15
- package/tools/cli/installers/lib/ide/templates/workflow-command-template.md +0 -13
- package/tools/cli/installers/lib/ide/templates/workflow-commander.md +0 -5
|
@@ -1,111 +1,113 @@
|
|
|
1
1
|
---
|
|
2
|
-
title:
|
|
3
|
-
description: Reference for BMad
|
|
2
|
+
title: Skills
|
|
3
|
+
description: Reference for BMad skills — what they are, how they work, and where to find them.
|
|
4
4
|
sidebar:
|
|
5
5
|
order: 3
|
|
6
6
|
---
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
Skills are pre-built prompts that load agents, run workflows, or execute tasks inside your IDE. The BMad installer generates them from your installed modules at install time. If you later add, remove, or change modules, re-run the installer to keep skills in sync (see [Troubleshooting](#troubleshooting)).
|
|
9
9
|
|
|
10
|
-
##
|
|
10
|
+
## Skills vs. Agent Menu Triggers
|
|
11
11
|
|
|
12
12
|
BMad offers two ways to start work, and they serve different purposes.
|
|
13
13
|
|
|
14
14
|
| Mechanism | How you invoke it | What happens |
|
|
15
15
|
| --- | --- | --- |
|
|
16
|
-
| **
|
|
16
|
+
| **Skill** | Type the skill name (e.g. `bmad-help`) in your IDE | Directly loads an agent, runs a workflow, or executes a task |
|
|
17
17
|
| **Agent menu trigger** | Load an agent first, then type a short code (e.g. `DS`) | The agent interprets the code and starts the matching workflow while staying in character |
|
|
18
18
|
|
|
19
|
-
Agent menu triggers require an active agent session. Use
|
|
19
|
+
Agent menu triggers require an active agent session. Use skills when you know which workflow you want. Use triggers when you are already working with an agent and want to switch tasks without leaving the conversation.
|
|
20
20
|
|
|
21
|
-
## How
|
|
21
|
+
## How Skills Are Generated
|
|
22
22
|
|
|
23
|
-
When you run `npx bmad-method install`, the installer reads the manifests for every selected module and writes one
|
|
23
|
+
When you run `npx bmad-method install`, the installer reads the manifests for every selected module and writes one skill per agent, workflow, task, and tool. Each skill is a directory containing a `SKILL.md` file that instructs the AI to load the corresponding source file and follow its instructions.
|
|
24
24
|
|
|
25
|
-
The installer uses templates for each
|
|
25
|
+
The installer uses templates for each skill type:
|
|
26
26
|
|
|
27
|
-
|
|
|
27
|
+
| Skill type | What the generated file does |
|
|
28
28
|
| --- | --- |
|
|
29
29
|
| **Agent launcher** | Loads the agent persona file, activates its menu, and stays in character |
|
|
30
|
-
| **Workflow
|
|
31
|
-
| **Task
|
|
32
|
-
| **Tool
|
|
30
|
+
| **Workflow skill** | Loads the workflow config and follows its steps |
|
|
31
|
+
| **Task skill** | Loads a standalone task file and follows its instructions |
|
|
32
|
+
| **Tool skill** | Loads a standalone tool file and follows its instructions |
|
|
33
33
|
|
|
34
34
|
:::note[Re-running the installer]
|
|
35
|
-
If you add or remove modules, run the installer again. It regenerates all
|
|
35
|
+
If you add or remove modules, run the installer again. It regenerates all skill files to match your current module selection.
|
|
36
36
|
:::
|
|
37
37
|
|
|
38
|
-
## Where
|
|
38
|
+
## Where Skill Files Live
|
|
39
39
|
|
|
40
|
-
The installer writes
|
|
40
|
+
The installer writes skill files into an IDE-specific directory inside your project. The exact path depends on which IDE you selected during installation.
|
|
41
41
|
|
|
42
|
-
| IDE / CLI |
|
|
42
|
+
| IDE / CLI | Skills directory |
|
|
43
43
|
| --- | --- |
|
|
44
|
-
| Claude Code | `.claude/
|
|
45
|
-
| Cursor | `.cursor/
|
|
46
|
-
| Windsurf | `.windsurf/
|
|
44
|
+
| Claude Code | `.claude/skills/` |
|
|
45
|
+
| Cursor | `.cursor/skills/` |
|
|
46
|
+
| Windsurf | `.windsurf/skills/` |
|
|
47
47
|
| Other IDEs | See the installer output for the target path |
|
|
48
48
|
|
|
49
|
-
|
|
49
|
+
Each skill is a directory containing a `SKILL.md` file. For example, a Claude Code installation looks like:
|
|
50
50
|
|
|
51
51
|
```text
|
|
52
|
-
.claude/
|
|
53
|
-
├── bmad-
|
|
54
|
-
|
|
55
|
-
├── bmad-
|
|
56
|
-
|
|
57
|
-
├── bmad-
|
|
52
|
+
.claude/skills/
|
|
53
|
+
├── bmad-help/
|
|
54
|
+
│ └── SKILL.md
|
|
55
|
+
├── bmad-create-prd/
|
|
56
|
+
│ └── SKILL.md
|
|
57
|
+
├── bmad-dev/
|
|
58
|
+
│ └── SKILL.md
|
|
58
59
|
└── ...
|
|
59
60
|
```
|
|
60
61
|
|
|
61
|
-
The
|
|
62
|
+
The directory name determines the skill name in your IDE. For example, the directory `bmad-dev/` registers the skill `bmad-dev`.
|
|
62
63
|
|
|
63
|
-
## How to Discover Your
|
|
64
|
+
## How to Discover Your Skills
|
|
64
65
|
|
|
65
|
-
Type
|
|
66
|
+
Type the skill name in your IDE to invoke it. Some platforms require you to enable skills in settings before they appear.
|
|
66
67
|
|
|
67
|
-
Run
|
|
68
|
+
Run `bmad-help` for context-aware guidance on your next step.
|
|
68
69
|
|
|
69
70
|
:::tip[Quick discovery]
|
|
70
|
-
The generated
|
|
71
|
+
The generated skill directories in your project are the canonical list. Open them in your file explorer to see every skill with its description.
|
|
71
72
|
:::
|
|
72
73
|
|
|
73
|
-
##
|
|
74
|
+
## Skill Categories
|
|
74
75
|
|
|
75
|
-
### Agent
|
|
76
|
+
### Agent Skills
|
|
76
77
|
|
|
77
|
-
Agent
|
|
78
|
+
Agent skills load a specialized AI persona with a defined role, communication style, and menu of workflows. Once loaded, the agent stays in character and responds to menu triggers.
|
|
78
79
|
|
|
79
|
-
| Example
|
|
80
|
+
| Example skill | Agent | Role |
|
|
80
81
|
| --- | --- | --- |
|
|
81
|
-
|
|
|
82
|
-
|
|
|
83
|
-
|
|
|
84
|
-
|
|
|
82
|
+
| `bmad-dev` | Amelia (Developer) | Implements stories with strict adherence to specs |
|
|
83
|
+
| `bmad-pm` | John (Product Manager) | Creates and validates PRDs |
|
|
84
|
+
| `bmad-architect` | Winston (Architect) | Designs system architecture |
|
|
85
|
+
| `bmad-sm` | Bob (Scrum Master) | Manages sprints and stories |
|
|
85
86
|
|
|
86
87
|
See [Agents](./agents.md) for the full list of default agents and their triggers.
|
|
87
88
|
|
|
88
|
-
### Workflow
|
|
89
|
+
### Workflow Skills
|
|
89
90
|
|
|
90
|
-
Workflow
|
|
91
|
+
Workflow skills run a structured, multi-step process without loading an agent persona first. They load a workflow configuration and follow its steps.
|
|
91
92
|
|
|
92
|
-
| Example
|
|
93
|
+
| Example skill | Purpose |
|
|
93
94
|
| --- | --- |
|
|
94
|
-
|
|
|
95
|
-
|
|
|
96
|
-
|
|
|
97
|
-
|
|
|
98
|
-
|
|
|
95
|
+
| `bmad-create-prd` | Create a Product Requirements Document |
|
|
96
|
+
| `bmad-create-architecture` | Design system architecture |
|
|
97
|
+
| `bmad-create-epics-and-stories` | Create epics and stories |
|
|
98
|
+
| `bmad-dev-story` | Implement a story |
|
|
99
|
+
| `bmad-code-review` | Run a code review |
|
|
100
|
+
| `bmad-quick-spec` | Define an ad-hoc change (Quick Flow) |
|
|
99
101
|
|
|
100
102
|
See [Workflow Map](./workflow-map.md) for the complete workflow reference organized by phase.
|
|
101
103
|
|
|
102
|
-
### Task and Tool
|
|
104
|
+
### Task and Tool Skills
|
|
103
105
|
|
|
104
106
|
Tasks and tools are standalone operations that do not require an agent or workflow context.
|
|
105
107
|
|
|
106
108
|
#### BMad-Help: Your Intelligent Guide
|
|
107
109
|
|
|
108
|
-
|
|
110
|
+
**`bmad-help`** is your primary interface for discovering what to do next. It's not just a lookup tool — it's an intelligent assistant that:
|
|
109
111
|
|
|
110
112
|
- **Inspects your project** to see what's already been done
|
|
111
113
|
- **Understands natural language queries** — ask questions in plain English
|
|
@@ -116,36 +118,28 @@ Tasks and tools are standalone operations that do not require an agent or workfl
|
|
|
116
118
|
**Examples:**
|
|
117
119
|
|
|
118
120
|
```
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
121
|
+
bmad-help
|
|
122
|
+
bmad-help I have a SaaS idea and know all the features. Where do I start?
|
|
123
|
+
bmad-help What are my options for UX design?
|
|
124
|
+
bmad-help I'm stuck on the PRD workflow
|
|
123
125
|
```
|
|
124
126
|
|
|
125
127
|
#### Other Tasks and Tools
|
|
126
128
|
|
|
127
|
-
| Example
|
|
129
|
+
| Example skill | Purpose |
|
|
128
130
|
| --- | --- |
|
|
129
|
-
|
|
|
130
|
-
|
|
|
131
|
-
|
|
|
131
|
+
| `bmad-shard-doc` | Split a large markdown file into smaller sections |
|
|
132
|
+
| `bmad-index-docs` | Index project documentation |
|
|
133
|
+
| `bmad-editorial-review-prose` | Review document prose quality |
|
|
132
134
|
|
|
133
135
|
## Naming Convention
|
|
134
136
|
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
| Pattern | Meaning | Example |
|
|
138
|
-
| --- | --- | --- |
|
|
139
|
-
| `bmad-agent-<module>-<name>` | Agent launcher | `bmad-agent-bmm-dev` |
|
|
140
|
-
| `bmad-<module>-<workflow>` | Workflow command | `bmad-bmm-create-prd` |
|
|
141
|
-
| `bmad-<name>` | Core task or tool | `bmad-help` |
|
|
142
|
-
|
|
143
|
-
Module codes: `bmm` (Agile suite), `bmb` (Builder), `tea` (Test Architect), `cis` (Creative Intelligence), `gds` (Game Dev Studio). See [Modules](./modules.md) for descriptions.
|
|
137
|
+
All skills use the `bmad-` prefix followed by a descriptive name (e.g., `bmad-dev`, `bmad-create-prd`, `bmad-help`). See [Modules](./modules.md) for available modules.
|
|
144
138
|
|
|
145
139
|
## Troubleshooting
|
|
146
140
|
|
|
147
|
-
**
|
|
141
|
+
**Skills not appearing after install.** Some platforms require skills to be explicitly enabled in settings. Check your IDE's documentation or ask your AI assistant how to enable skills. You may also need to restart your IDE or reload the window.
|
|
148
142
|
|
|
149
|
-
**Expected
|
|
143
|
+
**Expected skills are missing.** The installer only generates skills for modules you selected. Run `npx bmad-method install` again and verify your module selection. Check that the skill files exist in the expected directory.
|
|
150
144
|
|
|
151
|
-
**
|
|
145
|
+
**Skills from a removed module still appear.** The installer does not delete old skill files automatically. Remove the stale directories from your IDE's skills directory, or delete the entire skills directory and re-run the installer for a clean set.
|
|
@@ -26,7 +26,7 @@ Most projects should start with Quinn. If you later need test strategy, quality
|
|
|
26
26
|
|
|
27
27
|
Quinn is the built-in QA agent in the BMM (Agile suite) module. It generates working tests quickly using your project's existing test framework -- no configuration or additional installation required.
|
|
28
28
|
|
|
29
|
-
**Trigger:** `QA` or `bmad-
|
|
29
|
+
**Trigger:** `QA` or `bmad-qa-generate-e2e-tests`
|
|
30
30
|
|
|
31
31
|
### What Quinn Does
|
|
32
32
|
|
|
@@ -9,9 +9,9 @@ The BMad Method (BMM) is a module in the BMad Ecosystem, targeted at following t
|
|
|
9
9
|
|
|
10
10
|
The rationale and concepts come from agile methodologies that have been used across the industry with great success as a mental framework.
|
|
11
11
|
|
|
12
|
-
If at any time you are unsure what to do, the
|
|
12
|
+
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.
|
|
13
13
|
|
|
14
|
-
Final important note: Every workflow below can be run directly with your tool of choice via
|
|
14
|
+
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.
|
|
15
15
|
|
|
16
16
|
<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>
|
|
17
17
|
|
|
@@ -26,8 +26,8 @@ Explore the problem space and validate ideas before committing to planning.
|
|
|
26
26
|
| Workflow | Purpose | Produces |
|
|
27
27
|
| ------------------------------- | -------------------------------------------------------------------------- | ------------------------- |
|
|
28
28
|
| `bmad-brainstorming` | Brainstorm Project Ideas with guided facilitation of a brainstorming coach | `brainstorming-report.md` |
|
|
29
|
-
| `bmad-
|
|
30
|
-
| `bmad-
|
|
29
|
+
| `bmad-domain-research`, `bmad-market-research`, `bmad-technical-research` | Validate market, technical, or domain assumptions | Research findings |
|
|
30
|
+
| `bmad-create-product-brief` | Capture strategic vision | `product-brief.md` |
|
|
31
31
|
|
|
32
32
|
## Phase 2: Planning
|
|
33
33
|
|
|
@@ -35,8 +35,8 @@ Define what to build and for whom.
|
|
|
35
35
|
|
|
36
36
|
| Workflow | Purpose | Produces |
|
|
37
37
|
| --------------------------- | ---------------------------------------- | ------------ |
|
|
38
|
-
| `bmad-
|
|
39
|
-
| `bmad-
|
|
38
|
+
| `bmad-create-prd` | Define requirements (FRs/NFRs) | `PRD.md` |
|
|
39
|
+
| `bmad-create-ux-design` | Design user experience (when UX matters) | `ux-spec.md` |
|
|
40
40
|
|
|
41
41
|
## Phase 3: Solutioning
|
|
42
42
|
|
|
@@ -44,9 +44,9 @@ Decide how to build it and break work into stories.
|
|
|
44
44
|
|
|
45
45
|
| Workflow | Purpose | Produces |
|
|
46
46
|
| ----------------------------------------- | ------------------------------------------ | --------------------------- |
|
|
47
|
-
| `bmad-
|
|
48
|
-
| `bmad-
|
|
49
|
-
| `bmad-
|
|
47
|
+
| `bmad-create-architecture` | Make technical decisions explicit | `architecture.md` with ADRs |
|
|
48
|
+
| `bmad-create-epics-and-stories` | Break requirements into implementable work | Epic files with stories |
|
|
49
|
+
| `bmad-check-implementation-readiness` | Gate check before implementation | PASS/CONCERNS/FAIL decision |
|
|
50
50
|
|
|
51
51
|
## Phase 4: Implementation
|
|
52
52
|
|
|
@@ -54,13 +54,13 @@ Build it, one story at a time. Coming soon, full phase 4 automation!
|
|
|
54
54
|
|
|
55
55
|
| Workflow | Purpose | Produces |
|
|
56
56
|
| -------------------------- | ------------------------------------------------------------------------ | -------------------------------- |
|
|
57
|
-
| `bmad-
|
|
58
|
-
| `bmad-
|
|
59
|
-
| `bmad-
|
|
60
|
-
| `bmad-
|
|
61
|
-
| `bmad-
|
|
62
|
-
| `bmad-
|
|
63
|
-
| `bmad-
|
|
57
|
+
| `bmad-sprint-planning` | Initialize tracking (once per project to sequence the dev cycle) | `sprint-status.yaml` |
|
|
58
|
+
| `bmad-create-story` | Prepare next story for implementation | `story-[slug].md` |
|
|
59
|
+
| `bmad-dev-story` | Implement the story | Working code + tests |
|
|
60
|
+
| `bmad-code-review` | Validate implementation quality | Approved or changes requested |
|
|
61
|
+
| `bmad-correct-course` | Handle significant mid-sprint changes | Updated plan or re-routing |
|
|
62
|
+
| `bmad-sprint-status` | Track sprint progress and story status | Sprint status update |
|
|
63
|
+
| `bmad-retrospective` | Review after epic completion | Lessons learned |
|
|
64
64
|
|
|
65
65
|
## Quick Flow (Parallel Track)
|
|
66
66
|
|
|
@@ -68,8 +68,8 @@ Skip phases 1-3 for small, well-understood work.
|
|
|
68
68
|
|
|
69
69
|
| Workflow | Purpose | Produces |
|
|
70
70
|
| --------------------- | ------------------------------------------ | --------------------------------------------- |
|
|
71
|
-
| `bmad-
|
|
72
|
-
| `bmad-
|
|
71
|
+
| `bmad-quick-spec` | Define an ad-hoc change | `tech-spec.md` (story file for small changes) |
|
|
72
|
+
| `bmad-quick-dev` | Implement from spec or direct instructions | Working code + tests |
|
|
73
73
|
|
|
74
74
|
## Context Management
|
|
75
75
|
|
|
@@ -84,6 +84,6 @@ Create `project-context.md` to ensure AI agents follow your project's rules and
|
|
|
84
84
|
**How to create it:**
|
|
85
85
|
|
|
86
86
|
- **Manually** — Create `_bmad-output/project-context.md` with your technology stack and implementation rules
|
|
87
|
-
- **Generate it** — Run
|
|
87
|
+
- **Generate it** — Run `bmad-generate-project-context` to auto-generate from your architecture or codebase
|
|
88
88
|
|
|
89
89
|
[**Learn more about project-context.md**](../explanation/project-context.md)
|
|
@@ -37,16 +37,16 @@ Build software faster using AI-powered workflows with specialized agents that gu
|
|
|
37
37
|
|
|
38
38
|
### How to Use BMad-Help
|
|
39
39
|
|
|
40
|
-
Run it in your AI IDE
|
|
40
|
+
Run it in your AI IDE by invoking the skill:
|
|
41
41
|
|
|
42
42
|
```
|
|
43
|
-
|
|
43
|
+
bmad-help
|
|
44
44
|
```
|
|
45
45
|
|
|
46
46
|
Or combine it with a question for context-aware guidance:
|
|
47
47
|
|
|
48
48
|
```
|
|
49
|
-
|
|
49
|
+
bmad-help I have an idea for a SaaS product, I already know all the features I want. where do I get started?
|
|
50
50
|
```
|
|
51
51
|
|
|
52
52
|
BMad-Help will respond with:
|
|
@@ -112,7 +112,7 @@ BMad-Help will detect what you've completed and recommend exactly what to do nex
|
|
|
112
112
|
:::
|
|
113
113
|
|
|
114
114
|
:::note[How to Load Agents and Run Workflows]
|
|
115
|
-
Each workflow has a **
|
|
115
|
+
Each workflow has a **skill** you invoke in your IDE (e.g., `/bmad-create-prd`). Running a workflow skill automatically loads the appropriate agent — you don't need to load agents separately. You can also invoke an agent directly for general conversation (e.g., `/bmad-pm` for the PM agent).
|
|
116
116
|
:::
|
|
117
117
|
|
|
118
118
|
:::caution[Fresh Chats]
|
|
@@ -126,35 +126,35 @@ Work through phases 1-3. **Use fresh chats for each workflow.**
|
|
|
126
126
|
:::tip[Project Context (Optional)]
|
|
127
127
|
Before starting, consider creating `project-context.md` to document your technical preferences and implementation rules. This ensures all AI agents follow your conventions throughout the project.
|
|
128
128
|
|
|
129
|
-
Create it manually at `_bmad-output/project-context.md` or generate it after architecture using `/bmad-
|
|
129
|
+
Create it manually at `_bmad-output/project-context.md` or generate it after architecture using `/bmad-generate-project-context`. [Learn more](../explanation/project-context.md).
|
|
130
130
|
:::
|
|
131
131
|
|
|
132
132
|
### Phase 1: Analysis (Optional)
|
|
133
133
|
|
|
134
134
|
All workflows in this phase are optional:
|
|
135
135
|
- **brainstorming** (`/bmad-brainstorming`) — Guided ideation
|
|
136
|
-
- **research** (`/bmad-
|
|
137
|
-
- **create-product-brief** (`/bmad-
|
|
136
|
+
- **research** (`/bmad-research`) — Market and technical research
|
|
137
|
+
- **create-product-brief** (`/bmad-create-product-brief`) — Recommended foundation document
|
|
138
138
|
|
|
139
139
|
### Phase 2: Planning (Required)
|
|
140
140
|
|
|
141
141
|
**For BMad Method and Enterprise tracks:**
|
|
142
|
-
1.
|
|
143
|
-
2. Run the `prd` workflow (`/bmad-
|
|
142
|
+
1. Invoke the **PM agent** (`/bmad-pm`) in a new chat
|
|
143
|
+
2. Run the `bmad-create-prd` workflow (`/bmad-create-prd`)
|
|
144
144
|
3. Output: `PRD.md`
|
|
145
145
|
|
|
146
146
|
**For Quick Flow track:**
|
|
147
|
-
- Use the `quick-spec` workflow (`/bmad-
|
|
147
|
+
- Use the `bmad-quick-spec` workflow (`/bmad-quick-spec`) instead of PRD, then skip to implementation
|
|
148
148
|
|
|
149
149
|
:::note[UX Design (Optional)]
|
|
150
|
-
If your project has a user interface,
|
|
150
|
+
If your project has a user interface, invoke the **UX-Designer agent** (`/bmad-ux-designer`) and run the UX design workflow (`/bmad-create-ux-design`) after creating your PRD.
|
|
151
151
|
:::
|
|
152
152
|
|
|
153
153
|
### Phase 3: Solutioning (BMad Method/Enterprise)
|
|
154
154
|
|
|
155
155
|
**Create Architecture**
|
|
156
|
-
1.
|
|
157
|
-
2. Run `create-architecture` (`/bmad-
|
|
156
|
+
1. Invoke the **Architect agent** (`/bmad-architect`) in a new chat
|
|
157
|
+
2. Run `bmad-create-architecture` (`/bmad-create-architecture`)
|
|
158
158
|
3. Output: Architecture document with technical decisions
|
|
159
159
|
|
|
160
160
|
**Create Epics and Stories**
|
|
@@ -163,13 +163,13 @@ If your project has a user interface, load the **UX-Designer agent** (`/bmad-age
|
|
|
163
163
|
Epics and stories are now created *after* architecture. This produces better quality stories because architecture decisions (database, API patterns, tech stack) directly affect how work should be broken down.
|
|
164
164
|
:::
|
|
165
165
|
|
|
166
|
-
1.
|
|
167
|
-
2. Run `create-epics-and-stories` (`/bmad-
|
|
166
|
+
1. Invoke the **PM agent** (`/bmad-pm`) in a new chat
|
|
167
|
+
2. Run `bmad-create-epics-and-stories` (`/bmad-create-epics-and-stories`)
|
|
168
168
|
3. The workflow uses both PRD and Architecture to create technically-informed stories
|
|
169
169
|
|
|
170
170
|
**Implementation Readiness Check** *(Highly Recommended)*
|
|
171
|
-
1.
|
|
172
|
-
2. Run `check-implementation-readiness` (`/bmad-
|
|
171
|
+
1. Invoke the **Architect agent** (`/bmad-architect`) in a new chat
|
|
172
|
+
2. Run `bmad-check-implementation-readiness` (`/bmad-check-implementation-readiness`)
|
|
173
173
|
3. Validates cohesion across all planning documents
|
|
174
174
|
|
|
175
175
|
## Step 2: Build Your Project
|
|
@@ -178,7 +178,7 @@ Once planning is complete, move to implementation. **Each workflow should run in
|
|
|
178
178
|
|
|
179
179
|
### Initialize Sprint Planning
|
|
180
180
|
|
|
181
|
-
|
|
181
|
+
Invoke the **SM agent** (`/bmad-sm`) and run `bmad-sprint-planning` (`/bmad-sprint-planning`). This creates `sprint-status.yaml` to track all epics and stories.
|
|
182
182
|
|
|
183
183
|
### The Build Cycle
|
|
184
184
|
|
|
@@ -186,11 +186,11 @@ For each story, repeat this cycle with fresh chats:
|
|
|
186
186
|
|
|
187
187
|
| Step | Agent | Workflow | Command | Purpose |
|
|
188
188
|
| ---- | ----- | -------------- | -------------------------- | ---------------------------------- |
|
|
189
|
-
| 1 | SM | `create-story` | `/bmad-
|
|
190
|
-
| 2 | DEV | `dev-story` | `/bmad-
|
|
191
|
-
| 3 | DEV | `code-review` | `/bmad-
|
|
189
|
+
| 1 | SM | `bmad-create-story` | `/bmad-create-story` | Create story file from epic |
|
|
190
|
+
| 2 | DEV | `bmad-dev-story` | `/bmad-dev-story` | Implement the story |
|
|
191
|
+
| 3 | DEV | `bmad-code-review` | `/bmad-code-review` | Quality validation *(recommended)* |
|
|
192
192
|
|
|
193
|
-
After completing all stories in an epic,
|
|
193
|
+
After completing all stories in an epic, invoke the **SM agent** (`/bmad-sm`) and run `bmad-retrospective` (`/bmad-retrospective`).
|
|
194
194
|
|
|
195
195
|
## What You've Accomplished
|
|
196
196
|
|
|
@@ -221,16 +221,16 @@ your-project/
|
|
|
221
221
|
|
|
222
222
|
| Workflow | Command | Agent | Purpose |
|
|
223
223
|
| ------------------------------------- | ------------------------------------------ | --------- | ----------------------------------------------- |
|
|
224
|
-
| **`help`** ⭐
|
|
225
|
-
| `prd`
|
|
226
|
-
| `create-architecture`
|
|
227
|
-
| `generate-project-context`
|
|
228
|
-
| `create-epics-and-stories` | `/bmad-
|
|
229
|
-
| `check-implementation-readiness` | `/bmad-
|
|
230
|
-
| `sprint-planning` | `/bmad-
|
|
231
|
-
| `create-story` | `/bmad-
|
|
232
|
-
| `dev-story` | `/bmad-
|
|
233
|
-
| `code-review` | `/bmad-
|
|
224
|
+
| **`bmad-help`** ⭐ | `/bmad-help` | Any | **Your intelligent guide — ask anything!** |
|
|
225
|
+
| `bmad-create-prd` | `/bmad-create-prd` | PM | Create Product Requirements Document |
|
|
226
|
+
| `bmad-create-architecture` | `/bmad-create-architecture` | Architect | Create architecture document |
|
|
227
|
+
| `bmad-generate-project-context` | `/bmad-generate-project-context` | Analyst | Create project context file |
|
|
228
|
+
| `bmad-create-epics-and-stories` | `/bmad-create-epics-and-stories` | PM | Break down PRD into epics |
|
|
229
|
+
| `bmad-check-implementation-readiness` | `/bmad-check-implementation-readiness` | Architect | Validate planning cohesion |
|
|
230
|
+
| `bmad-sprint-planning` | `/bmad-sprint-planning` | SM | Initialize sprint tracking |
|
|
231
|
+
| `bmad-create-story` | `/bmad-create-story` | SM | Create a story file |
|
|
232
|
+
| `bmad-dev-story` | `/bmad-dev-story` | DEV | Implement a story |
|
|
233
|
+
| `bmad-code-review` | `/bmad-code-review` | DEV | Review implemented code |
|
|
234
234
|
|
|
235
235
|
## Common Questions
|
|
236
236
|
|
|
@@ -238,10 +238,10 @@ your-project/
|
|
|
238
238
|
Only for BMad Method and Enterprise tracks. Quick Flow skips from tech-spec to implementation.
|
|
239
239
|
|
|
240
240
|
**Can I change my plan later?**
|
|
241
|
-
Yes. The SM agent has a `correct-course` workflow (`/bmad-
|
|
241
|
+
Yes. The SM agent has a `bmad-correct-course` workflow (`/bmad-correct-course`) for handling scope changes.
|
|
242
242
|
|
|
243
243
|
**What if I want to brainstorm first?**
|
|
244
|
-
|
|
244
|
+
Invoke the Analyst agent (`/bmad-analyst`) and run `bmad-brainstorming` (`/bmad-brainstorming`) before starting your PRD.
|
|
245
245
|
|
|
246
246
|
**Do I need to follow a strict order?**
|
|
247
247
|
Not strictly. Once you learn the flow, you can run workflows directly using the Quick Reference above.
|