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.
- package/CHANGELOG.md +2 -2
- package/README.md +3 -3
- package/README_CN.md +2 -2
- package/docs/explanation/quick-dev-new-preview.md +73 -0
- package/docs/explanation/quick-flow.md +4 -0
- package/docs/how-to/get-answers-about-bmad.md +12 -8
- package/docs/how-to/install-bmad.md +9 -0
- package/docs/tutorials/getting-started.md +40 -38
- package/docs/zh-cn/how-to/established-projects.md +1 -1
- package/docs/zh-cn/how-to/get-answers-about-bmad.md +1 -1
- package/docs/zh-cn/how-to/install-bmad.md +1 -1
- package/docs/zh-cn/index.md +1 -1
- package/docs/zh-cn/reference/commands.md +20 -20
- package/docs/zh-cn/reference/workflow-map.md +2 -2
- package/docs/zh-cn/tutorials/getting-started.md +40 -40
- package/package.json +1 -1
- package/src/core/tasks/bmad-help/workflow.md +4 -4
- package/tools/build-docs.mjs +1 -0
- package/tools/cli/installers/lib/core/installer.js +1 -1
- package/tools/docs/fix-refs.md +1 -1
- package/website/public/diagrams/quick-dev-diagram.png +0 -0
- package/.claude/skills/bmad-os-audit-file-refs/SKILL.md +0 -6
- package/.claude/skills/bmad-os-audit-file-refs/prompts/instructions.md +0 -59
- package/.claude/skills/bmad-os-changelog-social/SKILL.md +0 -177
- package/.claude/skills/bmad-os-changelog-social/examples/discord-example.md +0 -53
- package/.claude/skills/bmad-os-changelog-social/examples/linkedin-example.md +0 -49
- package/.claude/skills/bmad-os-changelog-social/examples/twitter-example.md +0 -55
- package/.claude/skills/bmad-os-diataxis-style-fix/SKILL.md +0 -6
- package/.claude/skills/bmad-os-diataxis-style-fix/prompts/instructions.md +0 -229
- package/.claude/skills/bmad-os-draft-changelog/SKILL.md +0 -6
- package/.claude/skills/bmad-os-draft-changelog/prompts/instructions.md +0 -82
- package/.claude/skills/bmad-os-findings-triage/SKILL.md +0 -6
- package/.claude/skills/bmad-os-findings-triage/prompts/agent-prompt.md +0 -104
- package/.claude/skills/bmad-os-findings-triage/prompts/instructions.md +0 -286
- package/.claude/skills/bmad-os-gh-triage/SKILL.md +0 -6
- package/.claude/skills/bmad-os-gh-triage/prompts/agent-prompt.md +0 -60
- package/.claude/skills/bmad-os-gh-triage/prompts/instructions.md +0 -74
- package/.claude/skills/bmad-os-release-module/SKILL.md +0 -6
- package/.claude/skills/bmad-os-release-module/prompts/instructions.md +0 -53
- package/.claude/skills/bmad-os-review-pr/SKILL.md +0 -6
- package/.claude/skills/bmad-os-review-pr/prompts/instructions.md +0 -288
- package/.claude/skills/bmad-os-review-prompt/SKILL.md +0 -177
- package/.claude/skills/bmad-os-root-cause-analysis/SKILL.md +0 -12
- 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
|
|
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
|
|
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** —
|
|
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
|
-
>
|
|
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?**
|
|
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 智能帮助** — 随时使用
|
|
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
|
-
> **不确定该做什么?** 运行
|
|
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
|
+

|
|
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
|
|
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
|
-
|
|
21
|
+
Call it by name in your AI session:
|
|
22
22
|
|
|
23
23
|
```
|
|
24
|
-
|
|
24
|
+
bmad-help
|
|
25
25
|
```
|
|
26
26
|
|
|
27
|
-
|
|
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
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
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** →
|
|
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,
|
|
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
|
-
|
|
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.,
|
|
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
|
|
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** (
|
|
136
|
-
- **research** (
|
|
137
|
-
- **create-product-brief** (
|
|
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** (
|
|
143
|
-
2. Run the `bmad-create-prd` workflow (
|
|
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 (
|
|
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** (
|
|
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** (
|
|
157
|
-
2. Run `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** (
|
|
167
|
-
2. Run `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** (
|
|
172
|
-
2. Run `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** (
|
|
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` |
|
|
190
|
-
| 2 | DEV | `bmad-dev-story` |
|
|
191
|
-
| 3 | DEV | `bmad-code-review` |
|
|
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** (
|
|
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`** ⭐ |
|
|
225
|
-
| `bmad-create-prd` |
|
|
226
|
-
| `bmad-create-architecture` |
|
|
227
|
-
| `bmad-generate-project-context` |
|
|
228
|
-
| `bmad-create-epics-and-stories` |
|
|
229
|
-
| `bmad-check-implementation-readiness` |
|
|
230
|
-
| `bmad-sprint-planning` |
|
|
231
|
-
| `bmad-create-story` |
|
|
232
|
-
| `bmad-dev-story` |
|
|
233
|
-
| `bmad-code-review` |
|
|
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 (
|
|
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 (
|
|
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
|
-
**
|
|
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
|
|
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,
|
|
275
|
+
Ready to start? Install BMad, invoke `bmad-help`, and let your intelligent guide lead the way.
|
package/docs/zh-cn/index.md
CHANGED
|
@@ -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 并运行
|
|
22
|
+
安装 BMad 并运行 `bmad-help` — 它会根据您的项目和已安装的模块引导您完成所有操作。
|
|
23
23
|
:::
|
|
24
24
|
|
|
25
25
|
## 如何使用本文档
|
|
@@ -13,7 +13,7 @@ BMad 提供两种开始工作的方式,它们服务于不同的目的。
|
|
|
13
13
|
|
|
14
14
|
| 机制 | 调用方式 | 发生什么 |
|
|
15
15
|
| --- | --- | --- |
|
|
16
|
-
| **斜杠命令** | 在 IDE 中输入
|
|
16
|
+
| **斜杠命令** | 在 IDE 中输入 `bmad-...` | 直接加载智能体、运行工作流或执行任务 |
|
|
17
17
|
| **智能体菜单触发器** | 先加载智能体,然后输入简短代码(例如 `DS`) | 智能体解释代码并启动匹配的工作流,同时保持角色设定 |
|
|
18
18
|
|
|
19
19
|
智能体菜单触发器需要活动的智能体会话。当您知道要使用哪个工作流时,使用斜杠命令。当您已经与智能体一起工作并希望在不离开对话的情况下切换任务时,使用触发器。
|
|
@@ -58,13 +58,13 @@ BMad 提供两种开始工作的方式,它们服务于不同的目的。
|
|
|
58
58
|
└── ...
|
|
59
59
|
```
|
|
60
60
|
|
|
61
|
-
文件名决定了 IDE
|
|
61
|
+
文件名决定了 IDE 中的技能名称。例如,文件 `bmad-agent-bmm-dev.md` 注册技能 `bmad-agent-bmm-dev`。
|
|
62
62
|
|
|
63
63
|
## 如何发现您的命令
|
|
64
64
|
|
|
65
65
|
在 IDE 中输入 `/bmad` 并使用自动完成功能浏览可用命令。
|
|
66
66
|
|
|
67
|
-
运行
|
|
67
|
+
运行 `bmad-help` 获取关于下一步的上下文感知指导。
|
|
68
68
|
|
|
69
69
|
:::tip[快速发现]
|
|
70
70
|
项目中生成的命令文件夹是权威列表。在文件资源管理器中打开它们以查看每个命令及其描述。
|
|
@@ -78,10 +78,10 @@ BMad 提供两种开始工作的方式,它们服务于不同的目的。
|
|
|
78
78
|
|
|
79
79
|
| 示例命令 | 智能体 | 角色 |
|
|
80
80
|
| --- | --- | --- |
|
|
81
|
-
|
|
|
82
|
-
|
|
|
83
|
-
|
|
|
84
|
-
|
|
|
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
|
-
|
|
|
95
|
-
|
|
|
96
|
-
|
|
|
97
|
-
|
|
|
98
|
-
|
|
|
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
|
-
|
|
108
|
+
**`bmad-help`** 是您发现下一步操作的主要界面。它不仅仅是一个查找工具——它是一个智能助手,可以:
|
|
109
109
|
|
|
110
110
|
- **检查您的项目**以查看已经完成的工作
|
|
111
111
|
- **理解自然语言查询**——用简单的英语提问
|
|
@@ -116,19 +116,19 @@ BMad 提供两种开始工作的方式,它们服务于不同的目的。
|
|
|
116
116
|
**示例:**
|
|
117
117
|
|
|
118
118
|
```
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
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
|
-
|
|
|
130
|
-
|
|
|
131
|
-
|
|
|
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
|
-
|
|
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
|
-
- **生成它** — 运行
|
|
87
|
+
- **生成它** — 运行 `bmad-bmm-generate-project-context` 以从您的架构或代码库自动生成
|
|
88
88
|
|
|
89
89
|
[**了解更多关于 project-context.md**](../explanation/project-context.md)
|
|
90
90
|
|