You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
fix(docs): correct skill names in getting-started tutorials (#2103)
Agent skills referenced with shortened names (bmad-pm, bmad-architect,
etc.) that don't match installed skill names. Fixed to use actual names
(bmad-agent-pm, bmad-agent-architect, etc.) across EN, ZH-CN, and FR.
Also fixed bmad-research to three specific research skills (EN, FR) and
bmad-product-brief to bmad-create-product-brief (ZH-CN).
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: docs/tutorials/getting-started.md
+10-10Lines changed: 10 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -114,7 +114,7 @@ BMad-Help will detect what you've completed and recommend exactly what to do nex
114
114
:::
115
115
116
116
:::note[How to Load Agents and Run Workflows]
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).
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-agent-pm` for the PM agent).
118
118
:::
119
119
120
120
:::caution[Fresh Chats]
@@ -135,27 +135,27 @@ Create it manually at `_bmad-output/project-context.md` or generate it after arc
-**research** (`bmad-research`) — Market and technical research
138
+
-**research** (`bmad-market-research` / `bmad-domain-research` / `bmad-technical-research`) — Market, domain, and technical research
139
139
-**create-product-brief** (`bmad-create-product-brief`) — Recommended foundation document
140
140
141
141
### Phase 2: Planning (Required)
142
142
143
143
**For BMad Method and Enterprise tracks:**
144
-
1. Invoke the **PM agent** (`bmad-pm`) in a new chat
144
+
1. Invoke the **PM agent** (`bmad-agent-pm`) in a new chat
145
145
2. Run the `bmad-create-prd` workflow (`bmad-create-prd`)
146
146
3. Output: `PRD.md`
147
147
148
148
**For Quick Flow track:**
149
149
- Run `bmad-quick-dev` — it handles planning and implementation in a single workflow, skip to implementation
150
150
151
151
:::note[UX Design (Optional)]
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.
152
+
If your project has a user interface, invoke the **UX-Designer agent** (`bmad-agent-ux-designer`) and run the UX design workflow (`bmad-create-ux-design`) after creating your PRD.
153
153
:::
154
154
155
155
### Phase 3: Solutioning (BMad Method/Enterprise)
156
156
157
157
**Create Architecture**
158
-
1. Invoke the **Architect agent** (`bmad-architect`) in a new chat
158
+
1. Invoke the **Architect agent** (`bmad-agent-architect`) in a new chat
159
159
2. Run `bmad-create-architecture` (`bmad-create-architecture`)
160
160
3. Output: Architecture document with technical decisions
161
161
@@ -165,12 +165,12 @@ If your project has a user interface, invoke the **UX-Designer agent** (`bmad-ux
165
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.
166
166
:::
167
167
168
-
1. Invoke the **PM agent** (`bmad-pm`) in a new chat
168
+
1. Invoke the **PM agent** (`bmad-agent-pm`) in a new chat
169
169
2. Run `bmad-create-epics-and-stories` (`bmad-create-epics-and-stories`)
170
170
3. The workflow uses both PRD and Architecture to create technically-informed stories
1. Invoke the **Architect agent** (`bmad-architect`) in a new chat
173
+
1. Invoke the **Architect agent** (`bmad-agent-architect`) in a new chat
174
174
2. Run `bmad-check-implementation-readiness` (`bmad-check-implementation-readiness`)
175
175
3. Validates cohesion across all planning documents
176
176
@@ -180,7 +180,7 @@ Once planning is complete, move to implementation. **Each workflow should run in
180
180
181
181
### Initialize Sprint Planning
182
182
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.
183
+
Invoke the **SM agent** (`bmad-agent-sm`) and run `bmad-sprint-planning` (`bmad-sprint-planning`). This creates `sprint-status.yaml` to track all epics and stories.
184
184
185
185
### The Build Cycle
186
186
@@ -192,7 +192,7 @@ For each story, repeat this cycle with fresh chats:
192
192
| 2 | DEV |`bmad-dev-story`|`bmad-dev-story`| Implement the story |
193
193
| 3 | DEV |`bmad-code-review`|`bmad-code-review`| Quality validation *(recommended)*|
194
194
195
-
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-agent-sm`) and run `bmad-retrospective` (`bmad-retrospective`).
196
196
197
197
## What You've Accomplished
198
198
@@ -243,7 +243,7 @@ Only for BMad Method and Enterprise tracks. Quick Flow skips from tech-spec to i
243
243
Yes. The SM agent has a `bmad-correct-course` workflow (`bmad-correct-course`) for handling scope changes.
244
244
245
245
**What if I want to brainstorm first?**
246
-
Invoke the Analyst agent (`bmad-analyst`) and run `bmad-brainstorming` (`bmad-brainstorming`) before starting your PRD.
246
+
Invoke the Analyst agent (`bmad-agent-analyst`) and run `bmad-brainstorming` (`bmad-brainstorming`) before starting your PRD.
247
247
248
248
**Do I need to follow a strict order?**
249
249
Not strictly. Once you learn the flow, you can run workflows directly using the Quick Reference above.
0 commit comments