bmad-method 6.0.5-next.1 → 6.0.5-next.2

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.
Files changed (44) hide show
  1. package/CHANGELOG.md +2 -2
  2. package/README.md +3 -3
  3. package/README_CN.md +2 -2
  4. package/docs/explanation/quick-dev-new-preview.md +73 -0
  5. package/docs/explanation/quick-flow.md +4 -0
  6. package/docs/how-to/get-answers-about-bmad.md +12 -8
  7. package/docs/how-to/install-bmad.md +9 -0
  8. package/docs/tutorials/getting-started.md +40 -38
  9. package/docs/zh-cn/how-to/established-projects.md +1 -1
  10. package/docs/zh-cn/how-to/get-answers-about-bmad.md +1 -1
  11. package/docs/zh-cn/how-to/install-bmad.md +1 -1
  12. package/docs/zh-cn/index.md +1 -1
  13. package/docs/zh-cn/reference/commands.md +20 -20
  14. package/docs/zh-cn/reference/workflow-map.md +2 -2
  15. package/docs/zh-cn/tutorials/getting-started.md +40 -40
  16. package/package.json +1 -1
  17. package/src/core/tasks/bmad-help/workflow.md +4 -4
  18. package/tools/build-docs.mjs +1 -0
  19. package/tools/cli/installers/lib/core/installer.js +1 -1
  20. package/tools/docs/fix-refs.md +1 -1
  21. package/website/public/diagrams/quick-dev-diagram.png +0 -0
  22. package/.claude/skills/bmad-os-audit-file-refs/SKILL.md +0 -6
  23. package/.claude/skills/bmad-os-audit-file-refs/prompts/instructions.md +0 -59
  24. package/.claude/skills/bmad-os-changelog-social/SKILL.md +0 -177
  25. package/.claude/skills/bmad-os-changelog-social/examples/discord-example.md +0 -53
  26. package/.claude/skills/bmad-os-changelog-social/examples/linkedin-example.md +0 -49
  27. package/.claude/skills/bmad-os-changelog-social/examples/twitter-example.md +0 -55
  28. package/.claude/skills/bmad-os-diataxis-style-fix/SKILL.md +0 -6
  29. package/.claude/skills/bmad-os-diataxis-style-fix/prompts/instructions.md +0 -229
  30. package/.claude/skills/bmad-os-draft-changelog/SKILL.md +0 -6
  31. package/.claude/skills/bmad-os-draft-changelog/prompts/instructions.md +0 -82
  32. package/.claude/skills/bmad-os-findings-triage/SKILL.md +0 -6
  33. package/.claude/skills/bmad-os-findings-triage/prompts/agent-prompt.md +0 -104
  34. package/.claude/skills/bmad-os-findings-triage/prompts/instructions.md +0 -286
  35. package/.claude/skills/bmad-os-gh-triage/SKILL.md +0 -6
  36. package/.claude/skills/bmad-os-gh-triage/prompts/agent-prompt.md +0 -60
  37. package/.claude/skills/bmad-os-gh-triage/prompts/instructions.md +0 -74
  38. package/.claude/skills/bmad-os-release-module/SKILL.md +0 -6
  39. package/.claude/skills/bmad-os-release-module/prompts/instructions.md +0 -53
  40. package/.claude/skills/bmad-os-review-pr/SKILL.md +0 -6
  41. package/.claude/skills/bmad-os-review-pr/prompts/instructions.md +0 -288
  42. package/.claude/skills/bmad-os-review-prompt/SKILL.md +0 -177
  43. package/.claude/skills/bmad-os-root-cause-analysis/SKILL.md +0 -12
  44. package/.claude/skills/bmad-os-root-cause-analysis/prompts/instructions.md +0 -74
package/CHANGELOG.md CHANGED
@@ -47,7 +47,7 @@
47
47
  * Add CodeBuddy platform support with installer configuration (#1483)
48
48
  * Add LLM audit prompt for file reference conventions - new audit tool using parallel subagents (#1720)
49
49
  * Migrate Codex installer from `.codex/prompts` to `.agents/skills` format to align with Codex CLI changes (#1729)
50
- * Convert review-pr and audit-file-refs tools to proper bmad-os skills with slash commands `/bmad-os-review-pr` and `/bmad-os-audit-file-refs` (#1732)
50
+ * Convert review-pr and audit-file-refs tools to proper bmad-os skills with slash commands `bmad-os-review-pr` and `bmad-os-audit-file-refs` (#1732)
51
51
 
52
52
  ### 🐛 Bug Fixes
53
53
 
@@ -365,7 +365,7 @@ V6 Stable Release! The End of Beta!
365
365
  - TEA documentation restructured using Diátaxis framework (25 docs)
366
366
  - Style guide optimized for LLM readers (367 lines, down from 767)
367
367
  - Glossary rewritten using table format (123 lines, down from 373)
368
- - README overhaul with numbered command flows and prominent `/bmad-help` callout
368
+ - README overhaul with numbered command flows and prominent `bmad-help` callout
369
369
  - New workflow map diagram with interactive HTML
370
370
  - New editorial review tasks for document quality
371
371
  - E2E testing methodology for Game Dev Studio
package/README.md CHANGED
@@ -13,7 +13,7 @@
13
13
 
14
14
  Traditional AI tools do the thinking for you, producing average results. BMad agents and facilitated workflows act as expert collaborators who guide you through a structured process to bring out your best thinking in partnership with the AI.
15
15
 
16
- - **AI Intelligent Help** — Ask `/bmad-help` anytime for guidance on what's next
16
+ - **AI Intelligent Help** — Invoke the `bmad-help` skill anytime for guidance on what's next
17
17
  - **Scale-Domain-Adaptive** — Automatically adjusts planning depth based on project complexity
18
18
  - **Structured Workflows** — Grounded in agile best practices across analysis, planning, architecture, and implementation
19
19
  - **Specialized Agents** — 12+ domain experts (PM, Architect, Developer, UX, Scrum Master, and more)
@@ -40,7 +40,7 @@ Traditional AI tools do the thinking for you, producing average results. BMad ag
40
40
  npx bmad-method install
41
41
  ```
42
42
 
43
- > If you are getting a stale beta version, use: `npx bmad-method@6.0.1 install`
43
+ > Want the newest prerelease build? Use `npx bmad-method@next install`. Expect higher churn than the default install.
44
44
 
45
45
  Follow the installer prompts, then open your AI IDE (Claude Code, Cursor, etc.) in your project folder.
46
46
 
@@ -52,7 +52,7 @@ npx bmad-method install --directory /path/to/project --modules bmm --tools claud
52
52
 
53
53
  [See all installation options](https://docs.bmad-method.org/how-to/non-interactive-installation/)
54
54
 
55
- > **Not sure what to do?** Run `/bmad-help` — it tells you exactly what's next and what's optional. You can also ask questions like `/bmad-help I just finished the architecture, what do I do next?`
55
+ > **Not sure what to do?** Ask `bmad-help` — it tells you exactly what's next and what's optional. You can also ask questions like `bmad-help I just finished the architecture, what do I do next?`
56
56
 
57
57
  ## Modules
58
58
 
package/README_CN.md CHANGED
@@ -13,7 +13,7 @@
13
13
 
14
14
  传统 AI 工具替你思考,产生平庸的结果。BMad 智能体和辅助工作流充当专家协作者,引导你通过结构化流程,与 AI 的合作发挥最佳思维,产出最有效优秀的结果。
15
15
 
16
- - **AI 智能帮助** — 随时使用 `/bmad-help` 获取下一步指导
16
+ - **AI 智能帮助** — 随时使用 `bmad-help` 获取下一步指导
17
17
  - **规模-领域自适应** — 根据项目复杂度自动调整规划深度
18
18
  - **结构化工作流** — 基于分析、规划、架构和实施的敏捷最佳实践
19
19
  - **专业智能体** — 12+ 领域专家(PM、架构师、开发者、UX、Scrum Master 等)
@@ -52,7 +52,7 @@ npx bmad-method install --directory /path/to/project --modules bmm --tools claud
52
52
 
53
53
  [查看所有安装选项](http://docs.bmad-method.org/how-to/non-interactive-installation/)
54
54
 
55
- > **不确定该做什么?** 运行 `/bmad-help` — 它会准确告诉你下一步做什么以及什么是可选的。你也可以问诸如 `/bmad-help 我刚刚完成了架构设计,接下来该做什么?` 之类的问题。
55
+ > **不确定该做什么?** 运行 `bmad-help` — 它会准确告诉你下一步做什么以及什么是可选的。你也可以问诸如 `bmad-help 我刚刚完成了架构设计,接下来该做什么?` 之类的问题。
56
56
 
57
57
  ## 模块
58
58
 
@@ -0,0 +1,73 @@
1
+ ---
2
+ title: "Quick Dev New Preview"
3
+ description: Reduce human-in-the-loop friction without giving up the checkpoints that protect output quality
4
+ sidebar:
5
+ order: 2
6
+ ---
7
+
8
+ `bmad-quick-dev-new-preview` is an experimental attempt to radically improve Quick Flow: intent in, code changes out, with lower ceremony and fewer human-in-the-loop turns without sacrificing quality.
9
+
10
+ It lets the model run longer between checkpoints, then brings the human back only when the task cannot safely continue without human judgment or when it is time to review the end result.
11
+
12
+ ![Quick Dev New Preview workflow diagram](/diagrams/quick-dev-diagram.png)
13
+
14
+ ## Why This Exists
15
+
16
+ Human-in-the-loop turns are necessary and expensive.
17
+
18
+ Current LLMs still fail in predictable ways: they misread intent, fill gaps with confident guesses, drift into unrelated work, and generate noisy review output. At the same time, constant human intervention limits development velocity. Human attention is the bottleneck.
19
+
20
+ This experimental version of Quick Flow is an attempt to rebalance that tradeoff. It trusts the model to run unsupervised for longer stretches, but only after the workflow has created a strong enough boundary to make that safe.
21
+
22
+ ## The Core Design
23
+
24
+ ### 1. Compress intent first
25
+
26
+ The workflow starts by having the human and the model compress the request into one coherent goal. The input can begin as a rough expression of intent, but before the workflow runs autonomously it has to become small enough, clear enough, and contradiction-free enough to execute.
27
+
28
+ Intent can come in many forms: a couple of phrases, a bug tracker link, output from plan mode, text copied from a chat session, or even a story number from BMAD's own `epics.md`. In that last case, the workflow will not understand BMAD story-tracking semantics, but it can still take the story itself and run with it.
29
+
30
+ This workflow does not eliminate human control. It relocates it to a small number of high-value moments:
31
+
32
+ - **Intent clarification** - turning a messy request into one coherent goal without hidden contradictions
33
+ - **Spec approval** - confirming that the frozen understanding is the right thing to build
34
+ - **Review of the final product** - the primary checkpoint, where the human decides whether the result is acceptable at the end
35
+
36
+ ### 2. Route to the smallest safe path
37
+
38
+ Once the goal is clear, the workflow decides whether this is a true one-shot change or whether it needs the fuller path. Small, zero-blast-radius changes can go straight to implementation. Everything else goes through planning so the model has a stronger boundary before it runs longer on its own.
39
+
40
+ ### 3. Run longer with less supervision
41
+
42
+ After that routing decision, the model can carry more of the work on its own. On the fuller path, the approved spec becomes the boundary the model executes against with less supervision, which is the whole point of the experiment.
43
+
44
+ ### 4. Diagnose failure at the right layer
45
+
46
+ If the implementation is wrong because the intent was wrong, patching the code is the wrong fix. If the code is wrong because the spec was weak, patching the diff is also the wrong fix. The workflow is designed to diagnose where the failure entered the system, go back to that layer, and regenerate from there.
47
+
48
+ Review findings are used to decide whether the problem came from intent, spec generation, or local implementation. Only truly local problems get patched locally.
49
+
50
+ ### 5. Bring the human back only when needed
51
+
52
+ The intent interview is human-in-the-loop, but it is not the same kind of interruption as a recurring checkpoint. The workflow tries to keep those recurring checkpoints to a minimum. After the initial shaping of intent, the human mainly comes back when the workflow cannot safely continue without judgment and at the end, when it is time to review the result.
53
+
54
+ - **Intent-gap resolution** - stepping back in when review proves the workflow could not safely infer what was meant
55
+
56
+ Everything else is a candidate for longer autonomous execution. That tradeoff is deliberate. Older patterns spend more human attention on continuous supervision. Quick Dev New Preview spends more trust on the model, but saves human attention for the moments where human reasoning has the highest leverage.
57
+
58
+ ## Why the Review System Matters
59
+
60
+ The review phase is not just there to find bugs. It is there to route correction without destroying momentum.
61
+
62
+ This workflow works best on a platform that can spawn subagents, or at least invoke another LLM through the command line and wait for a result. If your platform does not support that natively, you can add a skill to do it. Context-free subagents are a cornerstone of the review design.
63
+
64
+ Agentic reviews often go wrong in two ways:
65
+
66
+ - They generate too many findings, forcing the human to sift through noise.
67
+ - They derail the current change by surfacing unrelated issues and turning every run into an ad hoc cleanup project.
68
+
69
+ Quick Dev New Preview addresses both by treating review as triage.
70
+
71
+ Some findings belong to the current change. Some do not. If a finding is incidental rather than causally tied to the current work, the workflow can defer it instead of forcing the human to handle it immediately. That keeps the run focused and prevents random tangents from consuming the budget of attention.
72
+
73
+ That triage will sometimes be imperfect. That is acceptable. It is usually better to misjudge some findings than to flood the human with thousands of low-value review comments. The system is optimizing for signal quality, not exhaustive recall.
@@ -7,6 +7,10 @@ sidebar:
7
7
 
8
8
  Skip the ceremony. Quick Flow takes you from idea to working code in two skills - no Product Brief, no PRD, no Architecture doc.
9
9
 
10
+ :::tip[Want a Unified Variant?]
11
+ If you want one workflow to clarify, plan, implement, review, and present in a single run, see [Quick Dev New Preview](./quick-dev-new-preview.md).
12
+ :::
13
+
10
14
  ## When to Use It
11
15
 
12
16
  - Bug fixes and patches
@@ -7,7 +7,7 @@ sidebar:
7
7
 
8
8
  ## Start Here: BMad-Help
9
9
 
10
- **The fastest way to get answers about BMad is `/bmad-help`.** This intelligent guide will answer upwards of 80% of all questions and is available to you directly in your IDE as you work.
10
+ **The fastest way to get answers about BMad is the `bmad-help` skill.** This intelligent guide will answer upwards of 80% of all questions and is available to you directly in your IDE as you work.
11
11
 
12
12
  BMad-Help is more than a lookup tool — it:
13
13
  - **Inspects your project** to see what's already been completed
@@ -18,19 +18,23 @@ BMad-Help is more than a lookup tool — it:
18
18
 
19
19
  ### How to Use BMad-Help
20
20
 
21
- Run it with just the skill name:
21
+ Call it by name in your AI session:
22
22
 
23
23
  ```
24
- /bmad-help
24
+ bmad-help
25
25
  ```
26
26
 
27
- Or combine it with a natural language query:
27
+ :::tip
28
+ You can also use `/bmad-help` or `$bmad-help` depending on your platform, but just `bmad-help` should work everywhere.
29
+ :::
30
+
31
+ Combine it with a natural language query:
28
32
 
29
33
  ```
30
- /bmad-help I have a SaaS idea and know all the features. Where do I start?
31
- /bmad-help What are my options for UX design?
32
- /bmad-help I'm stuck on the PRD workflow
33
- /bmad-help Show me what's been done so far
34
+ bmad-help I have a SaaS idea and know all the features. Where do I start?
35
+ bmad-help What are my options for UX design?
36
+ bmad-help I'm stuck on the PRD workflow
37
+ bmad-help Show me what's been done so far
34
38
  ```
35
39
 
36
40
  BMad-Help responds with:
@@ -29,6 +29,15 @@ If you want to use a non interactive installer and provide all install options o
29
29
  npx bmad-method install
30
30
  ```
31
31
 
32
+ :::tip[Want the newest prerelease build?]
33
+ Use the `next` dist-tag:
34
+ ```bash
35
+ npx bmad-method@next install
36
+ ```
37
+
38
+ This gets you newer changes earlier, with a higher chance of churn than the default install.
39
+ :::
40
+
32
41
  :::tip[Bleeding edge]
33
42
  To install the latest from the main branch (may be unstable):
34
43
  ```bash
@@ -22,7 +22,7 @@ Build software faster using AI-powered workflows with specialized agents that gu
22
22
 
23
23
  :::tip[The Easiest Path]
24
24
  **Install** → `npx bmad-method install`
25
- **Ask** → `/bmad-help what should I do first?`
25
+ **Ask** → `bmad-help what should I do first?`
26
26
  **Build** → Let BMad-Help guide you workflow by workflow
27
27
  :::
28
28
 
@@ -59,7 +59,7 @@ BMad-Help will respond with:
59
59
  BMad-Help doesn't just answer questions — **it automatically runs at the end of every workflow** to tell you exactly what to do next. No guessing, no searching docs — just clear guidance on the next required workflow.
60
60
 
61
61
  :::tip[Start Here]
62
- After installing BMad, run `/bmad-help` immediately. It will detect what modules you have installed and guide you to the right starting point for your project.
62
+ After installing BMad, invoke the `bmad-help` skill immediately. It will detect what modules you have installed and guide you to the right starting point for your project.
63
63
  :::
64
64
 
65
65
  ## Understanding BMad
@@ -95,6 +95,8 @@ Open a terminal in your project directory and run:
95
95
  npx bmad-method install
96
96
  ```
97
97
 
98
+ If you want the newest prerelease build instead of the default release channel, use `npx bmad-method@next install`.
99
+
98
100
  When prompted to select modules, choose **BMad Method**.
99
101
 
100
102
  The installer creates two folders:
@@ -105,14 +107,14 @@ The installer creates two folders:
105
107
  Open your AI IDE in the project folder and run:
106
108
 
107
109
  ```
108
- /bmad-help
110
+ bmad-help
109
111
  ```
110
112
 
111
113
  BMad-Help will detect what you've completed and recommend exactly what to do next. You can also ask it questions like "What are my options?" or "I have a SaaS idea, where should I start?"
112
114
  :::
113
115
 
114
116
  :::note[How to Load Agents and Run Workflows]
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).
117
+ Each workflow has a **skill** you invoke by name in your IDE (e.g., `bmad-create-prd`). Your AI tool will recognize the `bmad-*` name and run it — you don't need to load agents separately. You can also invoke an agent skill directly for general conversation (e.g., `bmad-pm` for the PM agent).
116
118
  :::
117
119
 
118
120
  :::caution[Fresh Chats]
@@ -126,35 +128,35 @@ Work through phases 1-3. **Use fresh chats for each workflow.**
126
128
  :::tip[Project Context (Optional)]
127
129
  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
130
 
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).
131
+ 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
132
  :::
131
133
 
132
134
  ### Phase 1: Analysis (Optional)
133
135
 
134
136
  All workflows in this phase are optional:
135
- - **brainstorming** (`/bmad-brainstorming`) — Guided ideation
136
- - **research** (`/bmad-research`) — Market and technical research
137
- - **create-product-brief** (`/bmad-create-product-brief`) — Recommended foundation document
137
+ - **brainstorming** (`bmad-brainstorming`) — Guided ideation
138
+ - **research** (`bmad-research`) — Market and technical research
139
+ - **create-product-brief** (`bmad-create-product-brief`) — Recommended foundation document
138
140
 
139
141
  ### Phase 2: Planning (Required)
140
142
 
141
143
  **For BMad Method and Enterprise tracks:**
142
- 1. Invoke the **PM agent** (`/bmad-pm`) in a new chat
143
- 2. Run the `bmad-create-prd` workflow (`/bmad-create-prd`)
144
+ 1. Invoke the **PM agent** (`bmad-pm`) in a new chat
145
+ 2. Run the `bmad-create-prd` workflow (`bmad-create-prd`)
144
146
  3. Output: `PRD.md`
145
147
 
146
148
  **For Quick Flow track:**
147
- - Use the `bmad-quick-spec` workflow (`/bmad-quick-spec`) instead of PRD, then skip to implementation
149
+ - Use the `bmad-quick-spec` workflow (`bmad-quick-spec`) instead of PRD, then skip to implementation
148
150
 
149
151
  :::note[UX Design (Optional)]
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.
152
+ 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
153
  :::
152
154
 
153
155
  ### Phase 3: Solutioning (BMad Method/Enterprise)
154
156
 
155
157
  **Create Architecture**
156
- 1. Invoke the **Architect agent** (`/bmad-architect`) in a new chat
157
- 2. Run `bmad-create-architecture` (`/bmad-create-architecture`)
158
+ 1. Invoke the **Architect agent** (`bmad-architect`) in a new chat
159
+ 2. Run `bmad-create-architecture` (`bmad-create-architecture`)
158
160
  3. Output: Architecture document with technical decisions
159
161
 
160
162
  **Create Epics and Stories**
@@ -163,13 +165,13 @@ If your project has a user interface, invoke the **UX-Designer agent** (`/bmad-u
163
165
  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
166
  :::
165
167
 
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
+ 1. Invoke the **PM agent** (`bmad-pm`) in a new chat
169
+ 2. Run `bmad-create-epics-and-stories` (`bmad-create-epics-and-stories`)
168
170
  3. The workflow uses both PRD and Architecture to create technically-informed stories
169
171
 
170
172
  **Implementation Readiness Check** *(Highly Recommended)*
171
- 1. Invoke the **Architect agent** (`/bmad-architect`) in a new chat
172
- 2. Run `bmad-check-implementation-readiness` (`/bmad-check-implementation-readiness`)
173
+ 1. Invoke the **Architect agent** (`bmad-architect`) in a new chat
174
+ 2. Run `bmad-check-implementation-readiness` (`bmad-check-implementation-readiness`)
173
175
  3. Validates cohesion across all planning documents
174
176
 
175
177
  ## Step 2: Build Your Project
@@ -178,7 +180,7 @@ Once planning is complete, move to implementation. **Each workflow should run in
178
180
 
179
181
  ### Initialize Sprint Planning
180
182
 
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.
183
+ 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
184
 
183
185
  ### The Build Cycle
184
186
 
@@ -186,11 +188,11 @@ For each story, repeat this cycle with fresh chats:
186
188
 
187
189
  | Step | Agent | Workflow | Command | Purpose |
188
190
  | ---- | ----- | -------------- | -------------------------- | ---------------------------------- |
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)* |
191
+ | 1 | SM | `bmad-create-story` | `bmad-create-story` | Create story file from epic |
192
+ | 2 | DEV | `bmad-dev-story` | `bmad-dev-story` | Implement the story |
193
+ | 3 | DEV | `bmad-code-review` | `bmad-code-review` | Quality validation *(recommended)* |
192
194
 
193
- After completing all stories in an epic, invoke the **SM agent** (`/bmad-sm`) and run `bmad-retrospective` (`/bmad-retrospective`).
195
+ After completing all stories in an epic, invoke the **SM agent** (`bmad-sm`) and run `bmad-retrospective` (`bmad-retrospective`).
194
196
 
195
197
  ## What You've Accomplished
196
198
 
@@ -221,16 +223,16 @@ your-project/
221
223
 
222
224
  | Workflow | Command | Agent | Purpose |
223
225
  | ------------------------------------- | ------------------------------------------ | --------- | ----------------------------------------------- |
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 |
226
+ | **`bmad-help`** ⭐ | `bmad-help` | Any | **Your intelligent guide — ask anything!** |
227
+ | `bmad-create-prd` | `bmad-create-prd` | PM | Create Product Requirements Document |
228
+ | `bmad-create-architecture` | `bmad-create-architecture` | Architect | Create architecture document |
229
+ | `bmad-generate-project-context` | `bmad-generate-project-context` | Analyst | Create project context file |
230
+ | `bmad-create-epics-and-stories` | `bmad-create-epics-and-stories` | PM | Break down PRD into epics |
231
+ | `bmad-check-implementation-readiness` | `bmad-check-implementation-readiness` | Architect | Validate planning cohesion |
232
+ | `bmad-sprint-planning` | `bmad-sprint-planning` | SM | Initialize sprint tracking |
233
+ | `bmad-create-story` | `bmad-create-story` | SM | Create a story file |
234
+ | `bmad-dev-story` | `bmad-dev-story` | DEV | Implement a story |
235
+ | `bmad-code-review` | `bmad-code-review` | DEV | Review implemented code |
234
236
 
235
237
  ## Common Questions
236
238
 
@@ -238,10 +240,10 @@ your-project/
238
240
  Only for BMad Method and Enterprise tracks. Quick Flow skips from tech-spec to implementation.
239
241
 
240
242
  **Can I change my plan later?**
241
- Yes. The SM agent has a `bmad-correct-course` workflow (`/bmad-correct-course`) for handling scope changes.
243
+ Yes. The SM agent has a `bmad-correct-course` workflow (`bmad-correct-course`) for handling scope changes.
242
244
 
243
245
  **What if I want to brainstorm first?**
244
- Invoke the Analyst agent (`/bmad-analyst`) and run `bmad-brainstorming` (`/bmad-brainstorming`) before starting your PRD.
246
+ Invoke the Analyst agent (`bmad-analyst`) and run `bmad-brainstorming` (`bmad-brainstorming`) before starting your PRD.
245
247
 
246
248
  **Do I need to follow a strict order?**
247
249
  Not strictly. Once you learn the flow, you can run workflows directly using the Quick Reference above.
@@ -249,7 +251,7 @@ Not strictly. Once you learn the flow, you can run workflows directly using the
249
251
  ## Getting Help
250
252
 
251
253
  :::tip[First Stop: BMad-Help]
252
- **Run `/bmad-help` anytime** — it's the fastest way to get unstuck. Ask it anything:
254
+ **Invoke `bmad-help` anytime** — it's the fastest way to get unstuck. Ask it anything:
253
255
  - "What should I do after installing?"
254
256
  - "I'm stuck on workflow X"
255
257
  - "What are my options for Y?"
@@ -264,10 +266,10 @@ BMad-Help inspects your project, detects what you've completed, and tells you ex
264
266
  ## Key Takeaways
265
267
 
266
268
  :::tip[Remember These]
267
- - **Start with `/bmad-help`** — Your intelligent guide that knows your project and options
269
+ - **Start with `bmad-help`** — Your intelligent guide that knows your project and options
268
270
  - **Always use fresh chats** — Start a new chat for each workflow
269
271
  - **Track matters** — Quick Flow uses quick-spec; Method/Enterprise need PRD and architecture
270
272
  - **BMad-Help runs automatically** — Every workflow ends with guidance on what's next
271
273
  :::
272
274
 
273
- Ready to start? Install BMad, run `/bmad-help`, and let your intelligent guide lead the way.
275
+ Ready to start? Install BMad, invoke `bmad-help`, and let your intelligent guide lead the way.
@@ -61,7 +61,7 @@ sidebar:
61
61
 
62
62
  ### BMad-Help:你的起点
63
63
 
64
- **随时运行 `/bmad-help`,当你不确定下一步该做什么时。** 这个智能指南:
64
+ **随时运行 `bmad-help`,当你不确定下一步该做什么时。** 这个智能指南:
65
65
 
66
66
  - 检查你的项目以查看已经完成了什么
67
67
  - 根据你安装的模块显示选项
@@ -7,7 +7,7 @@ sidebar:
7
7
 
8
8
  ## 从这里开始:BMad-Help
9
9
 
10
- **获取关于 BMad 答案的最快方式是 `/bmad-help`。** 这个智能指南可以回答超过 80% 的问题,并且直接在您的 IDE 中可用,方便您工作时使用。
10
+ **获取关于 BMad 答案的最快方式是 `bmad-help`。** 这个智能指南可以回答超过 80% 的问题,并且直接在您的 IDE 中可用,方便您工作时使用。
11
11
 
12
12
  BMad-Help 不仅仅是一个查询工具——它:
13
13
  - **检查您的项目**以查看已完成的内容
@@ -77,7 +77,7 @@ your-project/
77
77
 
78
78
  ## 验证安装
79
79
 
80
- 运行 `/bmad-help` 来验证一切正常并查看下一步操作。
80
+ 运行 `bmad-help` 来验证一切正常并查看下一步操作。
81
81
 
82
82
  **BMad-Help 是你的智能向导**,它会:
83
83
  - 确认你的安装正常工作
@@ -19,7 +19,7 @@ BMad 方法(**B**reakthrough **M**ethod of **A**gile AI **D**riven Development
19
19
  - **[工作流地图](./reference/workflow-map.md)** — BMM 阶段、工作流和上下文管理的可视化概览
20
20
 
21
21
  :::tip[只想直接上手?]
22
- 安装 BMad 并运行 `/bmad-help` — 它会根据您的项目和已安装的模块引导您完成所有操作。
22
+ 安装 BMad 并运行 `bmad-help` — 它会根据您的项目和已安装的模块引导您完成所有操作。
23
23
  :::
24
24
 
25
25
  ## 如何使用本文档
@@ -13,7 +13,7 @@ BMad 提供两种开始工作的方式,它们服务于不同的目的。
13
13
 
14
14
  | 机制 | 调用方式 | 发生什么 |
15
15
  | --- | --- | --- |
16
- | **斜杠命令** | 在 IDE 中输入 `/bmad-...` | 直接加载智能体、运行工作流或执行任务 |
16
+ | **斜杠命令** | 在 IDE 中输入 `bmad-...` | 直接加载智能体、运行工作流或执行任务 |
17
17
  | **智能体菜单触发器** | 先加载智能体,然后输入简短代码(例如 `DS`) | 智能体解释代码并启动匹配的工作流,同时保持角色设定 |
18
18
 
19
19
  智能体菜单触发器需要活动的智能体会话。当您知道要使用哪个工作流时,使用斜杠命令。当您已经与智能体一起工作并希望在不离开对话的情况下切换任务时,使用触发器。
@@ -58,13 +58,13 @@ BMad 提供两种开始工作的方式,它们服务于不同的目的。
58
58
  └── ...
59
59
  ```
60
60
 
61
- 文件名决定了 IDE 中的斜杠命令名称。例如,文件 `bmad-agent-bmm-dev.md` 注册命令 `/bmad-agent-bmm-dev`。
61
+ 文件名决定了 IDE 中的技能名称。例如,文件 `bmad-agent-bmm-dev.md` 注册技能 `bmad-agent-bmm-dev`。
62
62
 
63
63
  ## 如何发现您的命令
64
64
 
65
65
  在 IDE 中输入 `/bmad` 并使用自动完成功能浏览可用命令。
66
66
 
67
- 运行 `/bmad-help` 获取关于下一步的上下文感知指导。
67
+ 运行 `bmad-help` 获取关于下一步的上下文感知指导。
68
68
 
69
69
  :::tip[快速发现]
70
70
  项目中生成的命令文件夹是权威列表。在文件资源管理器中打开它们以查看每个命令及其描述。
@@ -78,10 +78,10 @@ BMad 提供两种开始工作的方式,它们服务于不同的目的。
78
78
 
79
79
  | 示例命令 | 智能体 | 角色 |
80
80
  | --- | --- | --- |
81
- | `/bmad-agent-bmm-dev` | Amelia(开发者) | 严格按照规范实现故事 |
82
- | `/bmad-agent-bmm-pm` | John(产品经理) | 创建和验证 PRD |
83
- | `/bmad-agent-bmm-architect` | Winston(架构师) | 设计系统架构 |
84
- | `/bmad-agent-bmm-sm` | Bob(Scrum Master) | 管理冲刺和故事 |
81
+ | `bmad-agent-bmm-dev` | Amelia(开发者) | 严格按照规范实现故事 |
82
+ | `bmad-agent-bmm-pm` | John(产品经理) | 创建和验证 PRD |
83
+ | `bmad-agent-bmm-architect` | Winston(架构师) | 设计系统架构 |
84
+ | `bmad-agent-bmm-sm` | Bob(Scrum Master) | 管理冲刺和故事 |
85
85
 
86
86
  参见[智能体](./agents.md)获取默认智能体及其触发器的完整列表。
87
87
 
@@ -91,11 +91,11 @@ BMad 提供两种开始工作的方式,它们服务于不同的目的。
91
91
 
92
92
  | 示例命令 | 目的 |
93
93
  | --- | --- |
94
- | `/bmad-bmm-create-prd` | 创建产品需求文档 |
95
- | `/bmad-bmm-create-architecture` | 设计系统架构 |
96
- | `/bmad-bmm-dev-story` | 实现故事 |
97
- | `/bmad-bmm-code-review` | 运行代码审查 |
98
- | `/bmad-bmm-quick-spec` | 定义临时更改(快速流程) |
94
+ | `bmad-bmm-create-prd` | 创建产品需求文档 |
95
+ | `bmad-bmm-create-architecture` | 设计系统架构 |
96
+ | `bmad-bmm-dev-story` | 实现故事 |
97
+ | `bmad-bmm-code-review` | 运行代码审查 |
98
+ | `bmad-bmm-quick-spec` | 定义临时更改(快速流程) |
99
99
 
100
100
  参见[工作流地图](./workflow-map.md)获取按阶段组织的完整工作流参考。
101
101
 
@@ -105,7 +105,7 @@ BMad 提供两种开始工作的方式,它们服务于不同的目的。
105
105
 
106
106
  #### BMad-Help:您的智能向导
107
107
 
108
- **`/bmad-help`** 是您发现下一步操作的主要界面。它不仅仅是一个查找工具——它是一个智能助手,可以:
108
+ **`bmad-help`** 是您发现下一步操作的主要界面。它不仅仅是一个查找工具——它是一个智能助手,可以:
109
109
 
110
110
  - **检查您的项目**以查看已经完成的工作
111
111
  - **理解自然语言查询**——用简单的英语提问
@@ -116,19 +116,19 @@ BMad 提供两种开始工作的方式,它们服务于不同的目的。
116
116
  **示例:**
117
117
 
118
118
  ```
119
- /bmad-help
120
- /bmad-help 我有一个 SaaS 想法并且知道所有功能。我应该从哪里开始?
121
- /bmad-help 我在 UX 设计方面有哪些选择?
122
- /bmad-help 我在 PRD 工作流上卡住了
119
+ bmad-help
120
+ bmad-help 我有一个 SaaS 想法并且知道所有功能。我应该从哪里开始?
121
+ bmad-help 我在 UX 设计方面有哪些选择?
122
+ bmad-help 我在 PRD 工作流上卡住了
123
123
  ```
124
124
 
125
125
  #### 其他任务和工具
126
126
 
127
127
  | 示例命令 | 目的 |
128
128
  | --- | --- |
129
- | `/bmad-shard-doc` | 将大型 Markdown 文件拆分为较小的部分 |
130
- | `/bmad-index-docs` | 索引项目文档 |
131
- | `/bmad-editorial-review-prose` | 审查文档散文质量 |
129
+ | `bmad-shard-doc` | 将大型 Markdown 文件拆分为较小的部分 |
130
+ | `bmad-index-docs` | 索引项目文档 |
131
+ | `bmad-editorial-review-prose` | 审查文档散文质量 |
132
132
 
133
133
  ## 命名约定
134
134
 
@@ -9,7 +9,7 @@ BMad Method(BMM)是 BMad 生态系统中的一个模块,旨在遵循上下
9
9
 
10
10
  其基本原理和概念来自敏捷方法论,这些方法论在整个行业中被广泛用作思维框架,并取得了巨大成功。
11
11
 
12
- 如果您在任何时候不确定该做什么,`/bmad-help` 命令将帮助您保持正轨或了解下一步该做什么。您也可以随时参考此文档以获取参考信息——但如果您已经安装了 BMad Method,`/bmad-help` 是完全交互式的,速度要快得多。此外,如果您正在使用扩展了 BMad Method 或添加了其他互补非扩展模块的不同模块——`/bmad-help` 会不断演进以了解所有可用内容,从而为您提供最佳即时建议。
12
+ 如果您在任何时候不确定该做什么,`bmad-help` 命令将帮助您保持正轨或了解下一步该做什么。您也可以随时参考此文档以获取参考信息——但如果您已经安装了 BMad Method,`bmad-help` 是完全交互式的,速度要快得多。此外,如果您正在使用扩展了 BMad Method 或添加了其他互补非扩展模块的不同模块——`bmad-help` 会不断演进以了解所有可用内容,从而为您提供最佳即时建议。
13
13
 
14
14
  最后的重要说明:以下每个工作流程都可以通过斜杠命令直接使用您选择的工具运行,或者先加载智能体,然后使用智能体菜单中的条目来运行。
15
15
 
@@ -84,7 +84,7 @@ BMad Method(BMM)是 BMad 生态系统中的一个模块,旨在遵循上下
84
84
  **如何创建它:**
85
85
 
86
86
  - **手动** — 使用您的技术栈和实施规则创建 `_bmad-output/project-context.md`
87
- - **生成它** — 运行 `/bmad-bmm-generate-project-context` 以从您的架构或代码库自动生成
87
+ - **生成它** — 运行 `bmad-bmm-generate-project-context` 以从您的架构或代码库自动生成
88
88
 
89
89
  [**了解更多关于 project-context.md**](../explanation/project-context.md)
90
90