Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 0 additions & 1 deletion .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,6 @@
"./src/bmm-skills/3-solutioning/bmad-create-epics-and-stories",
"./src/bmm-skills/3-solutioning/bmad-generate-project-context",
"./src/bmm-skills/4-implementation/bmad-agent-dev",
"./src/bmm-skills/4-implementation/bmad-agent-sm",
"./src/bmm-skills/4-implementation/bmad-dev-story",
"./src/bmm-skills/4-implementation/bmad-quick-dev",
"./src/bmm-skills/4-implementation/bmad-sprint-planning",
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Traditional AI tools do the thinking for you, producing average results. BMad ag
- **AI Intelligent Help** — Invoke the `bmad-help` skill anytime for guidance on what's next
- **Scale-Domain-Adaptive** — Automatically adjusts planning depth based on project complexity
- **Structured Workflows** — Grounded in agile best practices across analysis, planning, architecture, and implementation
- **Specialized Agents** — 12+ domain experts (PM, Architect, Developer, UX, Scrum Master, and more)
- **Specialized Agents** — 12+ domain experts (PM, Architect, Developer, UX, and more)
- **Party Mode** — Bring multiple agent personas into one session to collaborate and discuss
- **Complete Lifecycle** — From brainstorming to deployment

Expand Down
2 changes: 1 addition & 1 deletion README_CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@
- **AI 智能引导** —— 随时调用 `bmad-help` 获取下一步建议
- **规模与领域自适应** —— 按项目复杂度自动调整规划深度
- **结构化工作流** —— 覆盖分析、规划、架构、实施全流程
- **专业角色智能体** —— 提供 PM、架构师、开发者、UX、Scrum Master 等 12+ 角色
- **专业角色智能体** —— 提供 PM、架构师、开发者、UX 等 12+ 角色
- **派对模式** —— 多个智能体可在同一会话协作讨论
- **完整生命周期** —— 从头脑风暴一路到交付上线

Expand Down
2 changes: 1 addition & 1 deletion docs/_STYLE_GUIDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -353,7 +353,7 @@ Only for BMad Method and Enterprise tracks. Quick Flow skips to implementation.

### Can I change my plan later?

Yes. The SM agent has a `bmad-correct-course` workflow for handling scope changes.
Yes. The `bmad-correct-course` workflow handles scope changes mid-implementation.

**Have a question not answered here?** [Open an issue](...) or ask in [Discord](...).
```
Expand Down
4 changes: 2 additions & 2 deletions docs/how-to/upgrade-to-v6.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,8 +61,8 @@ If you have stories created or implemented:

1. Complete the v6 installation
2. Place `epics.md` or `epics/epic*.md` in `_bmad-output/planning-artifacts/`
3. Run the Scrum Master's `bmad-sprint-planning` workflow
4. Tell the SM which epics/stories are already complete
3. Run the Developer's `bmad-sprint-planning` workflow
4. Tell the agent which epics/stories are already complete

## What You Get

Expand Down
3 changes: 1 addition & 2 deletions docs/reference/agents.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,8 +20,7 @@ This page lists the default BMM (Agile suite) agents that install with BMad Meth
| Analyst (Mary) | `bmad-analyst` | `BP`, `RS`, `CB`, `WB`, `DP` | Brainstorm Project, Research, Create Brief, PRFAQ Challenge, Document Project |
| Product Manager (John) | `bmad-pm` | `CP`, `VP`, `EP`, `CE`, `IR`, `CC` | Create/Validate/Edit PRD, Create Epics and Stories, Implementation Readiness, Correct Course |
| Architect (Winston) | `bmad-architect` | `CA`, `IR` | Create Architecture, Implementation Readiness |
| Scrum Master (Bob) | `bmad-sm` | `SP`, `CS`, `ER`, `CC` | Sprint Planning, Create Story, Epic Retrospective, Correct Course |
| Developer (Amelia) | `bmad-dev` | `DS`, `QD`, `QA`, `CR` | Dev Story, Quick Dev, QA Test Generation, Code Review |
| Developer (Amelia) | `bmad-agent-dev` | `DS`, `QD`, `QA`, `CR`, `SP`, `CS`, `ER` | Dev Story, Quick Dev, QA Test Generation, Code Review, Sprint Planning, Create Story, Epic Retrospective |
| UX Designer (Sally) | `bmad-ux-designer` | `CU` | Create UX Design |
| Technical Writer (Paige) | `bmad-tech-writer` | `DP`, `WD`, `US`, `MG`, `VD`, `EC` | Document Project, Write Document, Update Standards, Mermaid Generate, Validate Doc, Explain Concept |

Expand Down
9 changes: 4 additions & 5 deletions docs/reference/commands.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,12 +54,12 @@ Each skill is a directory containing a `SKILL.md` file. For example, a Claude Co
│ └── SKILL.md
├── bmad-create-prd/
│ └── SKILL.md
├── bmad-dev/
├── bmad-agent-dev/
│ └── SKILL.md
└── ...
```

The directory name determines the skill name in your IDE. For example, the directory `bmad-dev/` registers the skill `bmad-dev`.
The directory name determines the skill name in your IDE. For example, the directory `bmad-agent-dev/` registers the skill `bmad-agent-dev`.

## How to Discover Your Skills

Expand All @@ -79,10 +79,9 @@ Agent skills load a specialized AI persona with a defined role, communication st

| Example skill | Agent | Role |
| --- | --- | --- |
| `bmad-dev` | Amelia (Developer) | Implements stories with strict adherence to specs |
| `bmad-agent-dev` | Amelia (Developer) | Implements stories with strict adherence to specs |
| `bmad-pm` | John (Product Manager) | Creates and validates PRDs |
| `bmad-architect` | Winston (Architect) | Designs system architecture |
| `bmad-sm` | Bob (Scrum Master) | Manages sprints and stories |

See [Agents](./agents.md) for the full list of default agents and their triggers.

Expand Down Expand Up @@ -125,7 +124,7 @@ The core module includes 11 built-in tools — reviews, compression, brainstormi

## Naming Convention

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.
All skills use the `bmad-` prefix followed by a descriptive name (e.g., `bmad-agent-dev`, `bmad-create-prd`, `bmad-help`). See [Modules](./modules.md) for available modules.

## Troubleshooting

Expand Down
12 changes: 6 additions & 6 deletions docs/tutorials/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -181,19 +181,19 @@ Once planning is complete, move to implementation. **Each workflow should run in

### Initialize Sprint Planning

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.
Invoke the **Developer agent** (`bmad-agent-dev`) and run `bmad-sprint-planning` (`bmad-sprint-planning`). This creates `sprint-status.yaml` to track all epics and stories.

### The Build Cycle

For each story, repeat this cycle with fresh chats:

| Step | Agent | Workflow | Command | Purpose |
| ---- | ----- | -------------- | -------------------------- | ---------------------------------- |
| 1 | SM | `bmad-create-story` | `bmad-create-story` | Create story file from epic |
| 1 | DEV | `bmad-create-story` | `bmad-create-story` | Create story file from epic |
| 2 | DEV | `bmad-dev-story` | `bmad-dev-story` | Implement the story |
| 3 | DEV | `bmad-code-review` | `bmad-code-review` | Quality validation *(recommended)* |

After completing all stories in an epic, invoke the **SM agent** (`bmad-agent-sm`) and run `bmad-retrospective` (`bmad-retrospective`).
After completing all stories in an epic, invoke the **Developer agent** (`bmad-agent-dev`) and run `bmad-retrospective` (`bmad-retrospective`).

## What You've Accomplished

Expand Down Expand Up @@ -230,8 +230,8 @@ your-project/
| `bmad-generate-project-context` | `bmad-generate-project-context` | Analyst | Create project context file |
| `bmad-create-epics-and-stories` | `bmad-create-epics-and-stories` | PM | Break down PRD into epics |
| `bmad-check-implementation-readiness` | `bmad-check-implementation-readiness` | Architect | Validate planning cohesion |
| `bmad-sprint-planning` | `bmad-sprint-planning` | SM | Initialize sprint tracking |
| `bmad-create-story` | `bmad-create-story` | SM | Create a story file |
| `bmad-sprint-planning` | `bmad-sprint-planning` | DEV | Initialize sprint tracking |
| `bmad-create-story` | `bmad-create-story` | DEV | Create a story file |
| `bmad-dev-story` | `bmad-dev-story` | DEV | Implement a story |
| `bmad-code-review` | `bmad-code-review` | DEV | Review implemented code |

Expand All @@ -241,7 +241,7 @@ your-project/
Only for BMad Method and Enterprise tracks. Quick Flow skips from spec to implementation.

**Can I change my plan later?**
Yes. The SM agent has a `bmad-correct-course` workflow (`bmad-correct-course`) for handling scope changes.
Yes. The `bmad-correct-course` workflow handles scope changes mid-implementation.

**What if I want to brainstorm first?**
Invoke the Analyst agent (`bmad-agent-analyst`) and run `bmad-brainstorming` (`bmad-brainstorming`) before starting your PRD.
Expand Down
2 changes: 1 addition & 1 deletion docs/zh-cn/_STYLE_GUIDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -353,7 +353,7 @@ Only for BMad Method and Enterprise tracks. Quick Flow skips to implementation.

### Can I change my plan later?

Yes. The SM agent has a `bmad-correct-course` workflow for handling scope changes.
Yes. The `bmad-correct-course` workflow handles scope changes mid-implementation.

**Have a question not answered here?** [Open an issue](...) or ask in [Discord](...).
```
Expand Down
4 changes: 2 additions & 2 deletions docs/zh-cn/how-to/upgrade-to-v6.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,8 +65,8 @@ v6 新技能会安装到:

1. 完成 v6 安装
2.`epics.md``epics/epic*.md` 放入 `_bmad-output/planning-artifacts/`
3. 运行 Scrum Master`bmad-sprint-planning` 工作流
4. 告诉 SM 哪些史诗/故事已经完成
3. 运行 Developer`bmad-sprint-planning` 工作流
4. 告知智能体哪些史诗/故事已经完成

## 你将获得

Expand Down
5 changes: 2 additions & 3 deletions docs/zh-cn/reference/agents.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,14 +14,13 @@ sidebar:
| Analyst (Mary) | `bmad-analyst` | `BP`、`RS`、`CB`、`DP` | Brainstorm、Research、Create Brief、Document Project |
| Product Manager (John) | `bmad-pm` | `CP`、`VP`、`EP`、`CE`、`IR`、`CC` | Create/Validate/Edit PRD、Create Epics and Stories、Implementation Readiness、Correct Course |
| Architect (Winston) | `bmad-architect` | `CA`、`IR` | Create Architecture、Implementation Readiness |
| Scrum Master (Bob) | `bmad-sm` | `SP`、`CS`、`ER`、`CC` | Sprint Planning、Create Story、Epic Retrospective、Correct Course |
| Developer (Amelia) | `bmad-dev` | `DS`、`QD`、`QA`、`CR` | Dev Story、Quick Dev、QA Test Generation、Code Review |
| Developer (Amelia) | `bmad-agent-dev` | `DS`、`QD`、`QA`、`CR`、`SP`、`CS`、`ER` | Dev Story、Quick Dev、QA Test Generation、Code Review、Sprint Planning、Create Story、Epic Retrospective |
| UX Designer (Sally) | `bmad-ux-designer` | `CU` | Create UX Design |
| Technical Writer (Paige) | `bmad-tech-writer` | `DP`、`WD`、`US`、`MG`、`VD`、`EC` | Document Project、Write Document、Update Standards、Mermaid Generate、Validate Doc、Explain Concept |

## 使用说明

- `Skill ID` 是直接调用该智能体的名称(例如 `bmad-dev`)
- `Skill ID` 是直接调用该智能体的名称(例如 `bmad-agent-dev`)
- 触发器是进入智能体会话后可使用的菜单短码
- QA 测试生成由 `bmad-qa-generate-e2e-tests` workflow skill 处理,通过 Developer 智能体调用;完整 TEA 能力位于独立模块

Expand Down
9 changes: 4 additions & 5 deletions docs/zh-cn/reference/commands.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,12 +48,12 @@ sidebar:
│ └── SKILL.md
├── bmad-create-prd/
│ └── SKILL.md
├── bmad-dev/
├── bmad-agent-dev/
│ └── SKILL.md
└── ...
```

skill 目录名就是调用名,例如 `bmad-dev/` 对应 skill `bmad-dev`。
skill 目录名就是调用名,例如 `bmad-agent-dev/` 对应 skill `bmad-agent-dev`。

## 如何发现可用 skills

Expand All @@ -73,10 +73,9 @@ skill 目录名就是调用名,例如 `bmad-dev/` 对应 skill `bmad-dev`。

| 示例 skill | 角色 | 用途 |
| --- | --- | --- |
| `bmad-dev` | Developer(Amelia) | 按规范实现 story |
| `bmad-agent-dev` | Developer(Amelia) | 按规范实现 story |
| `bmad-pm` | Product Manager(John) | 创建与校验 PRD |
| `bmad-architect` | Architect(Winston) | 架构设计与约束定义 |
| `bmad-sm` | Scrum Master(Bob) | 冲刺与 story 流程管理 |

完整列表见 [智能体参考](./agents.md)。

Expand Down Expand Up @@ -105,7 +104,7 @@ skill 目录名就是调用名,例如 `bmad-dev/` 对应 skill `bmad-dev`。

## 命名规则

所有技能统一以 `bmad-` 开头,后接语义化名称(如 `bmad-dev`、`bmad-create-prd`、`bmad-help`)。
所有技能统一以 `bmad-` 开头,后接语义化名称(如 `bmad-agent-dev`、`bmad-create-prd`、`bmad-help`)。

## 故障排查

Expand Down
12 changes: 6 additions & 6 deletions docs/zh-cn/tutorials/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -180,19 +180,19 @@ BMad-Help 将检测你已完成的内容,并准确推荐下一步该做什么

### 初始化冲刺规划

调用 **SM 智能体**(`bmad-agent-sm`)并运行 `bmad-sprint-planning`(`bmad-sprint-planning`)。这会创建 `sprint-status.yaml` 来跟踪所有史诗和故事。
调用 **Developer 智能体**(`bmad-agent-dev`)并运行 `bmad-sprint-planning`(`bmad-sprint-planning`)。这会创建 `sprint-status.yaml` 来跟踪所有史诗和故事。

### 构建周期

对于每个故事,使用新对话重复此周期:

| 步骤 | 智能体 | 工作流 | 命令 | 目的 |
| ---- | ------ | ------------ | ----------------------- | ------------------------------- |
| 1 | SM | `bmad-create-story` | `bmad-create-story` | 从史诗创建故事文件 |
| 1 | DEV | `bmad-create-story` | `bmad-create-story` | 从史诗创建故事文件 |
| 2 | DEV | `bmad-dev-story` | `bmad-dev-story` | 实现故事 |
| 3 | DEV | `bmad-code-review` | `bmad-code-review` | 质量验证 *(推荐)* |

完成史诗中的所有故事后,调用 **SM 智能体**(`bmad-agent-sm`)并运行 `bmad-retrospective`(`bmad-retrospective`)。
完成史诗中的所有故事后,调用 **Developer 智能体**(`bmad-agent-dev`)并运行 `bmad-retrospective`(`bmad-retrospective`)。

## 你已完成的工作

Expand Down Expand Up @@ -229,8 +229,8 @@ your-project/
| `bmad-generate-project-context` | `bmad-generate-project-context` | Analyst | 创建项目上下文文件 |
| `bmad-create-epics-and-stories` | `bmad-create-epics-and-stories` | PM | 将 PRD 分解为史诗 |
| `bmad-check-implementation-readiness` | `bmad-check-implementation-readiness` | Architect | 验证规划一致性 |
| `bmad-sprint-planning` | `bmad-sprint-planning` | SM | 初始化冲刺跟踪 |
| `bmad-create-story` | `bmad-create-story` | SM | 创建故事文件 |
| `bmad-sprint-planning` | `bmad-sprint-planning` | DEV | 初始化冲刺跟踪 |
| `bmad-create-story` | `bmad-create-story` | DEV | 创建故事文件 |
| `bmad-dev-story` | `bmad-dev-story` | DEV | 实现故事 |
| `bmad-code-review` | `bmad-code-review` | DEV | 审查已实现的代码 |

Expand All @@ -240,7 +240,7 @@ your-project/
仅对于 BMad Method 和 Enterprise 路径。Quick Flow 从技术规范跳转到实现。

**我可以稍后更改我的计划吗?**
可以。SM 智能体提供 `bmad-correct-course` 工作流(`bmad-correct-course`)来处理范围变化
可以。`bmad-correct-course` 工作流用于处理实现过程中的范围变化

**如果我想先进行头脑风暴怎么办?**
在开始 PRD 之前,调用 Analyst 智能体(`bmad-agent-analyst`)并运行 `bmad-brainstorming`(`bmad-brainstorming`)。
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -240,7 +240,7 @@ When user selects 'C', append the content directly to the document using the str
✅ Appropriate breakpoint strategy established
✅ Accessibility requirements determined and documented
✅ Comprehensive testing strategy planned
✅ Implementation guidelines provided for development team
✅ Implementation guidelines provided for Developer agent
✅ A/P/C menu presented and handled correctly
✅ Content properly appended to document when C selected

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ To discover, inventory, and organize all project documents, identifying duplicat

### Role Reinforcement:

- ✅ You are an expert Product Manager and Scrum Master
- ✅ You are an expert Product Manager
- ✅ Your focus is on finding organizing and documenting what exists
- ✅ You identify ambiguities and ask for clarification
- ✅ Success is measured in clear file inventory and conflict resolution
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ To fully read and analyze the PRD document (whole or sharded) to extract all Fun

### Role Reinforcement:

- ✅ You are an expert Product Manager and Scrum Master
- ✅ You are an expert Product Manager
- ✅ Your expertise is in requirements analysis and traceability
- ✅ You think critically about requirement completeness
- ✅ Success is measured in thorough requirement extraction
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ To validate that all Functional Requirements from the PRD are captured in the ep

### Role Reinforcement:

- ✅ You are an expert Product Manager and Scrum Master
- ✅ You are an expert Product Manager
- ✅ Your expertise is in requirements traceability
- ✅ You ensure no requirements fall through the cracks
- ✅ Success is measured in complete FR coverage
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

**Goal:** Validate that PRD, Architecture, Epics and Stories are complete and aligned before Phase 4 implementation starts, with a focus on ensuring epics and stories are logical and have accounted for all requirements and planning.

**Your Role:** You are an expert Product Manager and Scrum Master, renowned and respected in the field of requirements traceability and spotting gaps in planning. Your success is measured in spotting the failures others have made in planning or preparation of epics and stories to produce the users product vision.
**Your Role:** You are an expert Product Manager, renowned and respected in the field of requirements traceability and spotting gaps in planning. Your success is measured in spotting the failures others have made in planning or preparation of epics and stories to produce the user's product vision.

## WORKFLOW ARCHITECTURE

Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Create Epics and Stories

**Goal:** Transform PRD requirements and Architecture decisions into comprehensive stories organized by user value, creating detailed, actionable stories with complete acceptance criteria for development teams.
**Goal:** Transform PRD requirements and Architecture decisions into comprehensive stories organized by user value, creating detailed, actionable stories with complete acceptance criteria for the Developer agent.

**Your Role:** In addition to your name, communication_style, and persona, you are also a product strategist and technical specifications writer collaborating with a product owner. This is a partnership, not a client-vendor relationship. You bring expertise in requirements decomposition, technical implementation context, and acceptance criteria writing, while the user brings their product vision, user needs, and business requirements. Work together as equals.

Expand Down
Loading
Loading