bmad-method 6.2.3-next.8 → 6.3.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/.claude-plugin/marketplace.json +0 -3
- package/README.md +8 -9
- package/README_CN.md +1 -1
- package/README_VN.md +110 -0
- package/package.json +1 -1
- package/removals.txt +17 -0
- package/src/bmm-skills/2-plan-workflows/bmad-create-ux-design/steps/step-13-responsive-accessibility.md +1 -1
- package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/data/prd-purpose.md +197 -0
- package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01-discovery.md +1 -1
- package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01b-legacy-conversion.md +1 -1
- package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-02-review.md +1 -1
- package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md +1 -1
- package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-04-complete.md +1 -3
- package/src/bmm-skills/3-solutioning/bmad-check-implementation-readiness/steps/step-01-document-discovery.md +1 -1
- package/src/bmm-skills/3-solutioning/bmad-check-implementation-readiness/steps/step-02-prd-analysis.md +1 -1
- package/src/bmm-skills/3-solutioning/bmad-check-implementation-readiness/steps/step-03-epic-coverage-validation.md +1 -1
- package/src/bmm-skills/3-solutioning/bmad-check-implementation-readiness/workflow.md +1 -1
- package/src/bmm-skills/3-solutioning/bmad-create-epics-and-stories/workflow.md +1 -1
- package/src/bmm-skills/4-implementation/bmad-agent-dev/SKILL.md +5 -0
- package/src/bmm-skills/4-implementation/bmad-checkpoint-preview/SKILL.md +29 -0
- package/src/bmm-skills/4-implementation/bmad-checkpoint-preview/generate-trail.md +38 -0
- package/src/bmm-skills/4-implementation/bmad-checkpoint-preview/step-01-orientation.md +105 -0
- package/src/bmm-skills/4-implementation/bmad-checkpoint-preview/step-02-walkthrough.md +89 -0
- package/src/bmm-skills/4-implementation/bmad-checkpoint-preview/step-03-detail-pass.md +106 -0
- package/src/bmm-skills/4-implementation/bmad-checkpoint-preview/step-04-testing.md +74 -0
- package/src/bmm-skills/4-implementation/bmad-checkpoint-preview/step-05-wrapup.md +24 -0
- package/src/bmm-skills/4-implementation/bmad-code-review/steps/step-01-gather-context.md +38 -15
- package/src/bmm-skills/4-implementation/bmad-correct-course/checklist.md +2 -2
- package/src/bmm-skills/4-implementation/bmad-correct-course/workflow.md +8 -8
- package/src/bmm-skills/4-implementation/bmad-qa-generate-e2e-tests/checklist.md +1 -1
- package/src/bmm-skills/4-implementation/bmad-quick-dev/compile-epic-context.md +62 -0
- package/src/bmm-skills/4-implementation/bmad-quick-dev/spec-template.md +1 -1
- package/src/bmm-skills/4-implementation/bmad-quick-dev/step-01-clarify-and-route.md +33 -6
- package/src/bmm-skills/4-implementation/bmad-quick-dev/step-02-plan.md +20 -8
- package/src/bmm-skills/4-implementation/bmad-quick-dev/step-03-implement.md +2 -0
- package/src/bmm-skills/4-implementation/bmad-quick-dev/step-oneshot.md +16 -4
- package/src/bmm-skills/4-implementation/bmad-quick-dev/workflow.md +1 -5
- package/src/bmm-skills/4-implementation/bmad-retrospective/workflow.md +134 -134
- package/src/bmm-skills/4-implementation/bmad-sprint-planning/sprint-status-template.yaml +1 -1
- package/src/bmm-skills/4-implementation/bmad-sprint-planning/workflow.md +3 -3
- package/src/bmm-skills/4-implementation/bmad-sprint-status/workflow.md +2 -2
- package/src/bmm-skills/module-help.csv +2 -0
- package/src/core-skills/bmad-help/SKILL.md +4 -2
- package/src/core-skills/bmad-party-mode/SKILL.md +121 -2
- package/src/core-skills/module-help.csv +1 -0
- package/tools/installer/cli-utils.js +18 -9
- package/tools/installer/commands/install.js +1 -1
- package/tools/installer/core/existing-install.js +2 -8
- package/tools/installer/core/install-paths.js +0 -3
- package/tools/installer/core/installer.js +180 -463
- package/tools/installer/core/manifest-generator.js +8 -14
- package/tools/installer/core/manifest.js +94 -102
- package/tools/installer/ide/_config-driven.js +149 -38
- package/tools/installer/ide/shared/skill-manifest.js +1 -16
- package/tools/installer/install-messages.yaml +19 -26
- package/tools/installer/modules/community-manager.js +377 -0
- package/tools/installer/modules/custom-module-manager.js +644 -0
- package/tools/installer/modules/external-manager.js +65 -49
- package/tools/installer/modules/official-modules.js +117 -65
- package/tools/installer/modules/plugin-resolver.js +398 -0
- package/tools/installer/modules/registry-client.js +66 -0
- package/tools/installer/{external-official-modules.yaml → modules/registry-fallback.yaml} +3 -12
- package/tools/installer/ui.js +549 -666
- package/src/bmm-skills/4-implementation/bmad-agent-qa/SKILL.md +0 -61
- package/src/bmm-skills/4-implementation/bmad-agent-qa/bmad-skill-manifest.yaml +0 -11
- package/src/bmm-skills/4-implementation/bmad-agent-quick-flow-solo-dev/SKILL.md +0 -53
- package/src/bmm-skills/4-implementation/bmad-agent-quick-flow-solo-dev/bmad-skill-manifest.yaml +0 -11
- package/src/bmm-skills/4-implementation/bmad-agent-sm/SKILL.md +0 -55
- package/src/bmm-skills/4-implementation/bmad-agent-sm/bmad-skill-manifest.yaml +0 -11
- package/src/core-skills/bmad-party-mode/steps/step-01-agent-loading.md +0 -138
- package/src/core-skills/bmad-party-mode/steps/step-02-discussion-orchestration.md +0 -187
- package/src/core-skills/bmad-party-mode/steps/step-03-graceful-exit.md +0 -167
- package/src/core-skills/bmad-party-mode/workflow.md +0 -183
- package/tools/installer/core/custom-module-cache.js +0 -260
- package/tools/installer/custom-handler.js +0 -112
- package/tools/installer/modules/custom-modules.js +0 -197
|
@@ -59,9 +59,6 @@
|
|
|
59
59
|
"./src/bmm-skills/3-solutioning/bmad-create-epics-and-stories",
|
|
60
60
|
"./src/bmm-skills/3-solutioning/bmad-generate-project-context",
|
|
61
61
|
"./src/bmm-skills/4-implementation/bmad-agent-dev",
|
|
62
|
-
"./src/bmm-skills/4-implementation/bmad-agent-sm",
|
|
63
|
-
"./src/bmm-skills/4-implementation/bmad-agent-qa",
|
|
64
|
-
"./src/bmm-skills/4-implementation/bmad-agent-quick-flow-solo-dev",
|
|
65
62
|
"./src/bmm-skills/4-implementation/bmad-dev-story",
|
|
66
63
|
"./src/bmm-skills/4-implementation/bmad-quick-dev",
|
|
67
64
|
"./src/bmm-skills/4-implementation/bmad-sprint-planning",
|
package/README.md
CHANGED
|
@@ -3,6 +3,8 @@
|
|
|
3
3
|
[](https://www.npmjs.com/package/bmad-method)
|
|
4
4
|
[](LICENSE)
|
|
5
5
|
[](https://nodejs.org)
|
|
6
|
+
[](https://www.python.org)
|
|
7
|
+
[](https://docs.astral.sh/uv/)
|
|
6
8
|
[](https://discord.gg/gk8jAdXWmj)
|
|
7
9
|
|
|
8
10
|
**Build More Architect Dreams** — An AI-driven agile development module for the BMad Method Module Ecosystem, the best and most comprehensive Agile AI Driven Development framework that has true scale-adaptive intelligence that adjusts from bug fixes to enterprise systems.
|
|
@@ -16,7 +18,7 @@ Traditional AI tools do the thinking for you, producing average results. BMad ag
|
|
|
16
18
|
- **AI Intelligent Help** — Invoke the `bmad-help` skill anytime for guidance on what's next
|
|
17
19
|
- **Scale-Domain-Adaptive** — Automatically adjusts planning depth based on project complexity
|
|
18
20
|
- **Structured Workflows** — Grounded in agile best practices across analysis, planning, architecture, and implementation
|
|
19
|
-
- **Specialized Agents** — 12+ domain experts (PM, Architect, Developer, UX,
|
|
21
|
+
- **Specialized Agents** — 12+ domain experts (PM, Architect, Developer, UX, and more)
|
|
20
22
|
- **Party Mode** — Bring multiple agent personas into one session to collaborate and discuss
|
|
21
23
|
- **Complete Lifecycle** — From brainstorming to deployment
|
|
22
24
|
|
|
@@ -34,7 +36,7 @@ Traditional AI tools do the thinking for you, producing average results. BMad ag
|
|
|
34
36
|
|
|
35
37
|
## Quick Start
|
|
36
38
|
|
|
37
|
-
**Prerequisites**: [Node.js](https://nodejs.org) v20+
|
|
39
|
+
**Prerequisites**: [Node.js](https://nodejs.org) v20+ · [Python](https://www.python.org) 3.10+ · [uv](https://docs.astral.sh/uv/)
|
|
38
40
|
|
|
39
41
|
```bash
|
|
40
42
|
npx bmad-method install
|
|
@@ -79,18 +81,15 @@ BMad Method extends with official modules for specialized domains. Available dur
|
|
|
79
81
|
## Community
|
|
80
82
|
|
|
81
83
|
- [Discord](https://discord.gg/gk8jAdXWmj) — Get help, share ideas, collaborate
|
|
82
|
-
- [
|
|
84
|
+
- [YouTube](https://youtube.com/@BMadCode) — Tutorials, master class, and more
|
|
85
|
+
- [X / Twitter](https://x.com/BMadCode)
|
|
86
|
+
- [Website](https://bmadcode.com)
|
|
83
87
|
- [GitHub Issues](https://github.com/bmad-code-org/BMAD-METHOD/issues) — Bug reports and feature requests
|
|
84
88
|
- [Discussions](https://github.com/bmad-code-org/BMAD-METHOD/discussions) — Community conversations
|
|
85
89
|
|
|
86
90
|
## Support BMad
|
|
87
91
|
|
|
88
|
-
BMad is free for everyone
|
|
89
|
-
|
|
90
|
-
- ⭐ Please click the star project icon near the top right of this page
|
|
91
|
-
- ☕ [Buy Me a Coffee](https://buymeacoffee.com/bmad) — Fuel the development
|
|
92
|
-
- 🏢 Corporate sponsorship — DM on Discord
|
|
93
|
-
- 🎤 Speaking & Media — Available for conferences, podcasts, interviews (BM on Discord)
|
|
92
|
+
BMad is free for everyone and always will be. Star this repo, [buy me a coffee](https://buymeacoffee.com/bmad), or email <contact@bmadcode.com> for corporate sponsorship.
|
|
94
93
|
|
|
95
94
|
## Contributing
|
|
96
95
|
|
package/README_CN.md
CHANGED
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
- **AI 智能引导** —— 随时调用 `bmad-help` 获取下一步建议
|
|
17
17
|
- **规模与领域自适应** —— 按项目复杂度自动调整规划深度
|
|
18
18
|
- **结构化工作流** —— 覆盖分析、规划、架构、实施全流程
|
|
19
|
-
- **专业角色智能体** —— 提供 PM、架构师、开发者、UX
|
|
19
|
+
- **专业角色智能体** —— 提供 PM、架构师、开发者、UX 等 12+ 角色
|
|
20
20
|
- **派对模式** —— 多个智能体可在同一会话协作讨论
|
|
21
21
|
- **完整生命周期** —— 从头脑风暴一路到交付上线
|
|
22
22
|
|
package/README_VN.md
ADDED
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+

|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/bmad-method)
|
|
4
|
+
[](LICENSE)
|
|
5
|
+
[](https://nodejs.org)
|
|
6
|
+
[](https://discord.gg/gk8jAdXWmj)
|
|
7
|
+
|
|
8
|
+
[English](README.md) | [简体中文](README_CN.md) | Tiếng Việt
|
|
9
|
+
|
|
10
|
+
**Build More Architect Dreams** - một mô-đun khung phát triển hướng AI trong hệ sinh thái BMad, có khả năng thích ứng theo quy mô từ sửa lỗi nhỏ đến các hệ thống doanh nghiệp.
|
|
11
|
+
|
|
12
|
+
**100% miễn phí và mã nguồn mở.** Không có tường phí. Không có nội dung bị khóa. Không có Discord giới hạn quyền truy cập. Chúng tôi tin vào việc trao quyền cho mọi người, không chỉ cho những ai có thể trả tiền để vào một cộng đồng hay khóa học khép kín.
|
|
13
|
+
|
|
14
|
+
## Vì sao chọn BMad Method?
|
|
15
|
+
|
|
16
|
+
Các công cụ AI truyền thống thường làm thay phần suy nghĩ của bạn và tạo ra kết quả ở mức trung bình. Các agent chuyên biệt và quy trình làm việc có hướng dẫn của BMad hoạt động như những cộng tác viên chuyên gia, dẫn dắt bạn qua một quy trình có cấu trúc để khai mở tư duy tốt nhất của bạn cùng với AI.
|
|
17
|
+
|
|
18
|
+
- **Trợ giúp AI thông minh** - Gọi skill `bmad-help` bất kỳ lúc nào để biết bước tiếp theo
|
|
19
|
+
- **Thích ứng theo quy mô và miền bài toán** - Tự động điều chỉnh độ sâu lập kế hoạch theo độ phức tạp của dự án
|
|
20
|
+
- **Quy trình có cấu trúc** - Dựa trên các thực hành tốt nhất của agile xuyên suốt phân tích, lập kế hoạch, kiến trúc và triển khai
|
|
21
|
+
- **Agent chuyên biệt** - Hơn 12 chuyên gia theo vai trò như PM, Architect, Developer, UX, Scrum Master và nhiều vai trò khác
|
|
22
|
+
- **Party Mode** - Đưa nhiều persona agent vào cùng một phiên để cộng tác và thảo luận
|
|
23
|
+
- **Vòng đời hoàn chỉnh** - Từ động não ý tưởng cho đến triển khai
|
|
24
|
+
|
|
25
|
+
[Tìm hiểu thêm tại **docs.bmad-method.org**](https://docs.bmad-method.org/vi-vn/)
|
|
26
|
+
|
|
27
|
+
---
|
|
28
|
+
|
|
29
|
+
## 🚀 Điều gì tiếp theo cho BMad?
|
|
30
|
+
|
|
31
|
+
**V6 đã có mặt và đây mới chỉ là khởi đầu!** BMad Method đang phát triển rất nhanh với các cải tiến như đội agent đa nền tảng và tích hợp sub-agent, kiến trúc Skills, BMad Builder v1, tự động hóa vòng lặp phát triển và nhiều thứ khác vẫn đang được xây dựng.
|
|
32
|
+
|
|
33
|
+
**[📍 Xem lộ trình đầy đủ →](https://docs.bmad-method.org/vi-vn/roadmap/)**
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## Bắt đầu nhanh
|
|
38
|
+
|
|
39
|
+
**Điều kiện tiên quyết**: [Node.js](https://nodejs.org) v20+
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
npx bmad-method install
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
> Muốn dùng bản prerelease mới nhất? Hãy dùng `npx bmad-method@next install`. Hãy kỳ vọng mức độ biến động cao hơn bản cài đặt mặc định.
|
|
46
|
+
|
|
47
|
+
Làm theo các lời nhắc của trình cài đặt, sau đó mở AI IDE của bạn như Claude Code hoặc Cursor trong thư mục dự án.
|
|
48
|
+
|
|
49
|
+
**Cài đặt không tương tác** (cho CI/CD):
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
npx bmad-method install --directory /path/to/project --modules bmm --tools claude-code --yes
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
[Xem toàn bộ tùy chọn cài đặt](https://docs.bmad-method.org/vi-vn/how-to/non-interactive-installation/)
|
|
56
|
+
|
|
57
|
+
> **Chưa chắc nên làm gì?** Hãy hỏi `bmad-help` - nó sẽ cho bạn biết chính xác bước nào tiếp theo và bước nào là tùy chọn. Bạn cũng có thể hỏi kiểu như `bmad-help Tôi vừa hoàn thành phần kiến trúc, tiếp theo tôi cần làm gì?`
|
|
58
|
+
|
|
59
|
+
## Mô-đun
|
|
60
|
+
|
|
61
|
+
BMad Method có thể được mở rộng bằng các mô-đun chính thức cho những miền chuyên biệt. Chúng có sẵn trong lúc cài đặt hoặc bất kỳ lúc nào sau đó.
|
|
62
|
+
|
|
63
|
+
| Module | Mục đích |
|
|
64
|
+
| ----------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- |
|
|
65
|
+
| **[BMad Method (BMM)](https://github.com/bmad-code-org/BMAD-METHOD)** | Khung lõi với hơn 34 quy trình |
|
|
66
|
+
| **[BMad Builder (BMB)](https://github.com/bmad-code-org/bmad-builder)** | Tạo agent và quy trình BMad tùy chỉnh |
|
|
67
|
+
| **[Test Architect (TEA)](https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise)** | Chiến lược kiểm thử và tự động hóa dựa trên rủi ro |
|
|
68
|
+
| **[Game Dev Studio (BMGD)](https://github.com/bmad-code-org/bmad-module-game-dev-studio)** | Quy trình phát triển game (Unity, Unreal, Godot) |
|
|
69
|
+
| **[Creative Intelligence Suite (CIS)](https://github.com/bmad-code-org/bmad-module-creative-intelligence-suite)** | Đổi mới, động não ý tưởng, tư duy thiết kế |
|
|
70
|
+
|
|
71
|
+
## Tài liệu
|
|
72
|
+
|
|
73
|
+
[Trang tài liệu BMad Method](https://docs.bmad-method.org/vi-vn/) - bài hướng dẫn, hướng dẫn tác vụ, giải thích khái niệm và tài liệu tham chiếu
|
|
74
|
+
|
|
75
|
+
**Liên kết nhanh:**
|
|
76
|
+
- [Hướng dẫn bắt đầu](https://docs.bmad-method.org/vi-vn/tutorials/getting-started/)
|
|
77
|
+
- [Nâng cấp từ các phiên bản trước](https://docs.bmad-method.org/vi-vn/how-to/upgrade-to-v6/)
|
|
78
|
+
- [Tài liệu Test Architect](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/)
|
|
79
|
+
|
|
80
|
+
## Cộng đồng
|
|
81
|
+
|
|
82
|
+
- [Discord](https://discord.gg/gk8jAdXWmj) - Nhận trợ giúp, chia sẻ ý tưởng, cộng tác
|
|
83
|
+
- [Đăng ký trên YouTube](https://www.youtube.com/@BMadCode) - video hướng dẫn, lớp chuyên sâu và podcast (ra mắt tháng 2 năm 2025)
|
|
84
|
+
- [GitHub Issues](https://github.com/bmad-code-org/BMAD-METHOD/issues) - Báo lỗi và yêu cầu tính năng
|
|
85
|
+
- [Discussions](https://github.com/bmad-code-org/BMAD-METHOD/discussions) - Trao đổi cộng đồng
|
|
86
|
+
|
|
87
|
+
## Hỗ trợ BMad
|
|
88
|
+
|
|
89
|
+
BMad miễn phí cho tất cả mọi người - và sẽ luôn như vậy. Nếu bạn muốn hỗ trợ quá trình phát triển:
|
|
90
|
+
|
|
91
|
+
- ⭐ Hãy nhấn sao cho dự án ở góc trên bên phải của trang này
|
|
92
|
+
- ☕ [Buy Me a Coffee](https://buymeacoffee.com/bmad) - Tiếp thêm năng lượng cho quá trình phát triển
|
|
93
|
+
- 🏢 Tài trợ doanh nghiệp - Nhắn riêng trên Discord
|
|
94
|
+
- 🎤 Diễn thuyết và truyền thông - Sẵn sàng cho hội nghị, podcast, phỏng vấn (BM trên Discord)
|
|
95
|
+
|
|
96
|
+
## Đóng góp
|
|
97
|
+
|
|
98
|
+
Chúng tôi luôn chào đón đóng góp. Xem [CONTRIBUTING.md](CONTRIBUTING.md) để biết hướng dẫn.
|
|
99
|
+
|
|
100
|
+
## Giấy phép
|
|
101
|
+
|
|
102
|
+
Giấy phép MIT - xem [LICENSE](LICENSE) để biết chi tiết.
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
**BMad** và **BMAD-METHOD** là các nhãn hiệu của BMad Code, LLC. Xem [TRADEMARK.md](TRADEMARK.md) để biết chi tiết.
|
|
107
|
+
|
|
108
|
+
[](https://github.com/bmad-code-org/BMAD-METHOD/graphs/contributors)
|
|
109
|
+
|
|
110
|
+
Xem [CONTRIBUTORS.md](CONTRIBUTORS.md) để biết thông tin về những người đóng góp.
|
package/package.json
CHANGED
package/removals.txt
ADDED
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
# BMad Method - Skill Removal List
|
|
2
|
+
# Entries listed here will be removed from IDE skill directories during install/update.
|
|
3
|
+
# One entry per line. Lines starting with # are comments.
|
|
4
|
+
# Each entry is a skill directory name (canonicalId) that was removed or renamed.
|
|
5
|
+
|
|
6
|
+
# Removed agents (v6.2.0 - v6.2.2)
|
|
7
|
+
bmad-agent-sm
|
|
8
|
+
bmad-agent-qa
|
|
9
|
+
bmad-agent-quick-flow-solo-dev
|
|
10
|
+
|
|
11
|
+
# Removed skills (v6.2.0 - v6.2.2)
|
|
12
|
+
bmad-create-product-brief
|
|
13
|
+
bmad-product-brief-preview
|
|
14
|
+
bmad-quick-spec
|
|
15
|
+
bmad-quick-flow
|
|
16
|
+
bmad-quick-dev-new-preview
|
|
17
|
+
bmad-init
|
|
@@ -240,7 +240,7 @@ When user selects 'C', append the content directly to the document using the str
|
|
|
240
240
|
✅ Appropriate breakpoint strategy established
|
|
241
241
|
✅ Accessibility requirements determined and documented
|
|
242
242
|
✅ Comprehensive testing strategy planned
|
|
243
|
-
✅ Implementation guidelines provided for
|
|
243
|
+
✅ Implementation guidelines provided for Developer agent
|
|
244
244
|
✅ A/P/C menu presented and handled correctly
|
|
245
245
|
✅ Content properly appended to document when C selected
|
|
246
246
|
|
|
@@ -0,0 +1,197 @@
|
|
|
1
|
+
# BMAD PRD Purpose
|
|
2
|
+
|
|
3
|
+
**The PRD is the top of the required funnel that feeds all subsequent product development work in rhw BMad Method.**
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## What is a BMAD PRD?
|
|
8
|
+
|
|
9
|
+
A dual-audience document serving:
|
|
10
|
+
1. **Human Product Managers and builders** - Vision, strategy, stakeholder communication
|
|
11
|
+
2. **LLM Downstream Consumption** - UX Design → Architecture → Epics → Development AI Agents
|
|
12
|
+
|
|
13
|
+
Each successive document becomes more AI-tailored and granular.
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## Core Philosophy: Information Density
|
|
18
|
+
|
|
19
|
+
**High Signal-to-Noise Ratio**
|
|
20
|
+
|
|
21
|
+
Every sentence must carry information weight. LLMs consume precise, dense content efficiently.
|
|
22
|
+
|
|
23
|
+
**Anti-Patterns (Eliminate These):**
|
|
24
|
+
- ❌ "The system will allow users to..." → ✅ "Users can..."
|
|
25
|
+
- ❌ "It is important to note that..." → ✅ State the fact directly
|
|
26
|
+
- ❌ "In order to..." → ✅ "To..."
|
|
27
|
+
- ❌ Conversational filler and padding → ✅ Direct, concise statements
|
|
28
|
+
|
|
29
|
+
**Goal:** Maximum information per word. Zero fluff.
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## The Traceability Chain
|
|
34
|
+
|
|
35
|
+
**PRD starts the chain:**
|
|
36
|
+
```
|
|
37
|
+
Vision → Success Criteria → User Journeys → Functional Requirements → (future: User Stories)
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
**In the PRD, establish:**
|
|
41
|
+
- Vision → Success Criteria alignment
|
|
42
|
+
- Success Criteria → User Journey coverage
|
|
43
|
+
- User Journey → Functional Requirement mapping
|
|
44
|
+
- All requirements traceable to user needs
|
|
45
|
+
|
|
46
|
+
**Why:** Each downstream artifact (UX, Architecture, Epics, Stories) must trace back to documented user needs and business objectives. This chain ensures we build the right thing.
|
|
47
|
+
|
|
48
|
+
---
|
|
49
|
+
|
|
50
|
+
## What Makes Great Functional Requirements?
|
|
51
|
+
|
|
52
|
+
### FRs are Capabilities, Not Implementation
|
|
53
|
+
|
|
54
|
+
**Good FR:** "Users can reset their password via email link"
|
|
55
|
+
**Bad FR:** "System sends JWT via email and validates with database" (implementation leakage)
|
|
56
|
+
|
|
57
|
+
**Good FR:** "Dashboard loads in under 2 seconds for 95th percentile"
|
|
58
|
+
**Bad FR:** "Fast loading time" (subjective, unmeasurable)
|
|
59
|
+
|
|
60
|
+
### SMART Quality Criteria
|
|
61
|
+
|
|
62
|
+
**Specific:** Clear, precisely defined capability
|
|
63
|
+
**Measurable:** Quantifiable with test criteria
|
|
64
|
+
**Attainable:** Realistic within constraints
|
|
65
|
+
**Relevant:** Aligns with business objectives
|
|
66
|
+
**Traceable:** Links to source (executive summary or user journey)
|
|
67
|
+
|
|
68
|
+
### FR Anti-Patterns
|
|
69
|
+
|
|
70
|
+
**Subjective Adjectives:**
|
|
71
|
+
- ❌ "easy to use", "intuitive", "user-friendly", "fast", "responsive"
|
|
72
|
+
- ✅ Use metrics: "completes task in under 3 clicks", "loads in under 2 seconds"
|
|
73
|
+
|
|
74
|
+
**Implementation Leakage:**
|
|
75
|
+
- ❌ Technology names, specific libraries, implementation details
|
|
76
|
+
- ✅ Focus on capability and measurable outcomes
|
|
77
|
+
|
|
78
|
+
**Vague Quantifiers:**
|
|
79
|
+
- ❌ "multiple users", "several options", "various formats"
|
|
80
|
+
- ✅ "up to 100 concurrent users", "3-5 options", "PDF, DOCX, TXT formats"
|
|
81
|
+
|
|
82
|
+
**Missing Test Criteria:**
|
|
83
|
+
- ❌ "The system shall provide notifications"
|
|
84
|
+
- ✅ "The system shall send email notifications within 30 seconds of trigger event"
|
|
85
|
+
|
|
86
|
+
---
|
|
87
|
+
|
|
88
|
+
## What Makes Great Non-Functional Requirements?
|
|
89
|
+
|
|
90
|
+
### NFRs Must Be Measurable
|
|
91
|
+
|
|
92
|
+
**Template:**
|
|
93
|
+
```
|
|
94
|
+
"The system shall [metric] [condition] [measurement method]"
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
**Examples:**
|
|
98
|
+
- ✅ "The system shall respond to API requests in under 200ms for 95th percentile as measured by APM monitoring"
|
|
99
|
+
- ✅ "The system shall maintain 99.9% uptime during business hours as measured by cloud provider SLA"
|
|
100
|
+
- ✅ "The system shall support 10,000 concurrent users as measured by load testing"
|
|
101
|
+
|
|
102
|
+
### NFR Anti-Patterns
|
|
103
|
+
|
|
104
|
+
**Unmeasurable Claims:**
|
|
105
|
+
- ❌ "The system shall be scalable" → ✅ "The system shall handle 10x load growth through horizontal scaling"
|
|
106
|
+
- ❌ "High availability required" → ✅ "99.9% uptime as measured by cloud provider SLA"
|
|
107
|
+
|
|
108
|
+
**Missing Context:**
|
|
109
|
+
- ❌ "Response time under 1 second" → ✅ "API response time under 1 second for 95th percentile under normal load"
|
|
110
|
+
|
|
111
|
+
---
|
|
112
|
+
|
|
113
|
+
## Domain-Specific Requirements
|
|
114
|
+
|
|
115
|
+
**Auto-Detect and Enforce Based on Project Context**
|
|
116
|
+
|
|
117
|
+
Certain industries have mandatory requirements that must be present:
|
|
118
|
+
|
|
119
|
+
- **Healthcare:** HIPAA Privacy & Security Rules, PHI encryption, audit logging, MFA
|
|
120
|
+
- **Fintech:** PCI-DSS Level 1, AML/KYC compliance, SOX controls, financial audit trails
|
|
121
|
+
- **GovTech:** NIST framework, Section 508 accessibility (WCAG 2.1 AA), FedRAMP, data residency
|
|
122
|
+
- **E-Commerce:** PCI-DSS for payments, inventory accuracy, tax calculation by jurisdiction
|
|
123
|
+
|
|
124
|
+
**Why:** Missing these requirements in the PRD means they'll be missed in architecture and implementation, creating expensive rework. During PRD creation there is a step to cover this - during validation we want to make sure it was covered. For this purpose steps will utilize a domain-complexity.csv and project-types.csv.
|
|
125
|
+
|
|
126
|
+
---
|
|
127
|
+
|
|
128
|
+
## Document Structure (Markdown, Human-Readable)
|
|
129
|
+
|
|
130
|
+
### Required Sections
|
|
131
|
+
1. **Executive Summary** - Vision, differentiator, target users
|
|
132
|
+
2. **Success Criteria** - Measurable outcomes (SMART)
|
|
133
|
+
3. **Product Scope** - MVP, Growth, Vision phases
|
|
134
|
+
4. **User Journeys** - Comprehensive coverage
|
|
135
|
+
5. **Domain Requirements** - Industry-specific compliance (if applicable)
|
|
136
|
+
6. **Innovation Analysis** - Competitive differentiation (if applicable)
|
|
137
|
+
7. **Project-Type Requirements** - Platform-specific needs
|
|
138
|
+
8. **Functional Requirements** - Capability contract (FRs)
|
|
139
|
+
9. **Non-Functional Requirements** - Quality attributes (NFRs)
|
|
140
|
+
|
|
141
|
+
### Formatting for Dual Consumption
|
|
142
|
+
|
|
143
|
+
**For Humans:**
|
|
144
|
+
- Clear, professional language
|
|
145
|
+
- Logical flow from vision to requirements
|
|
146
|
+
- Easy for stakeholders to review and approve
|
|
147
|
+
|
|
148
|
+
**For LLMs:**
|
|
149
|
+
- ## Level 2 headers for all main sections (enables extraction)
|
|
150
|
+
- Consistent structure and patterns
|
|
151
|
+
- Precise, testable language
|
|
152
|
+
- High information density
|
|
153
|
+
|
|
154
|
+
---
|
|
155
|
+
|
|
156
|
+
## Downstream Impact
|
|
157
|
+
|
|
158
|
+
**How the PRD Feeds Next Artifacts:**
|
|
159
|
+
|
|
160
|
+
**UX Design:**
|
|
161
|
+
- User journeys → interaction flows
|
|
162
|
+
- FRs → design requirements
|
|
163
|
+
- Success criteria → UX metrics
|
|
164
|
+
|
|
165
|
+
**Architecture:**
|
|
166
|
+
- FRs → system capabilities
|
|
167
|
+
- NFRs → architecture decisions
|
|
168
|
+
- Domain requirements → compliance architecture
|
|
169
|
+
- Project-type requirements → platform choices
|
|
170
|
+
|
|
171
|
+
**Epics & Stories (created after architecture):**
|
|
172
|
+
- FRs → user stories (1 FR could map to 1-3 stories potentially)
|
|
173
|
+
- Acceptance criteria → story acceptance tests
|
|
174
|
+
- Priority → sprint sequencing
|
|
175
|
+
- Traceability → stories map back to vision
|
|
176
|
+
|
|
177
|
+
**Development AI Agents:**
|
|
178
|
+
- Precise requirements → implementation clarity
|
|
179
|
+
- Test criteria → automated test generation
|
|
180
|
+
- Domain requirements → compliance enforcement
|
|
181
|
+
- Measurable NFRs → performance targets
|
|
182
|
+
|
|
183
|
+
---
|
|
184
|
+
|
|
185
|
+
## Summary: What Makes a Great BMAD PRD?
|
|
186
|
+
|
|
187
|
+
✅ **High Information Density** - Every sentence carries weight, zero fluff
|
|
188
|
+
✅ **Measurable Requirements** - All FRs and NFRs are testable with specific criteria
|
|
189
|
+
✅ **Clear Traceability** - Each requirement links to user need and business objective
|
|
190
|
+
✅ **Domain Awareness** - Industry-specific requirements auto-detected and included
|
|
191
|
+
✅ **Zero Anti-Patterns** - No subjective adjectives, implementation leakage, or vague quantifiers
|
|
192
|
+
✅ **Dual Audience Optimized** - Human-readable AND LLM-consumable
|
|
193
|
+
✅ **Markdown Format** - Professional, clean, accessible to all stakeholders
|
|
194
|
+
|
|
195
|
+
---
|
|
196
|
+
|
|
197
|
+
**Remember:** The PRD is the foundation. Quality here ripples through every subsequent phase. A dense, precise, well-traced PRD makes UX design, architecture, epic breakdown, and AI development dramatically more effective.
|
package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01b-legacy-conversion.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
# File references (ONLY variables used in this step)
|
|
3
3
|
prdFile: '{prd_file_path}'
|
|
4
|
-
prdPurpose: '
|
|
4
|
+
prdPurpose: '../data/prd-purpose.md'
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# Step E-1B: Legacy PRD Conversion Assessment
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
# File references (ONLY variables used in this step)
|
|
3
3
|
prdFile: '{prd_file_path}'
|
|
4
4
|
validationReport: '{validation_report_path}' # If provided
|
|
5
|
-
prdPurpose: '
|
|
5
|
+
prdPurpose: '../data/prd-purpose.md'
|
|
6
6
|
---
|
|
7
7
|
|
|
8
8
|
# Step E-2: Deep Review & Analysis
|
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
# File references (ONLY variables used in this step)
|
|
3
3
|
prdFile: '{prd_file_path}'
|
|
4
|
-
validationWorkflow: '{project-root}/_bmad/bmm-skills/2-plan-workflows/bmad-validate-prd/steps-v/step-v-01-discovery.md'
|
|
5
4
|
---
|
|
6
5
|
|
|
7
6
|
# Step E-4: Complete & Validate
|
|
@@ -117,8 +116,7 @@ Display:
|
|
|
117
116
|
- Display: "This will run all 13 validation checks on the updated PRD."
|
|
118
117
|
- Display: "Preparing to validate: {prd_file_path}"
|
|
119
118
|
- Display: "**Proceeding to validation...**"
|
|
120
|
-
-
|
|
121
|
-
- Note: This hands off to the validation workflow which will run its complete 13-step process
|
|
119
|
+
- Invoke the `bmad-validate-prd` skill to run the complete validation workflow
|
|
122
120
|
|
|
123
121
|
- **IF E (Edit More):**
|
|
124
122
|
- Display: "**Additional Edits**"
|
|
@@ -20,7 +20,7 @@ To discover, inventory, and organize all project documents, identifying duplicat
|
|
|
20
20
|
|
|
21
21
|
### Role Reinforcement:
|
|
22
22
|
|
|
23
|
-
- ✅ You are an expert Product Manager
|
|
23
|
+
- ✅ You are an expert Product Manager
|
|
24
24
|
- ✅ Your focus is on finding organizing and documenting what exists
|
|
25
25
|
- ✅ You identify ambiguities and ask for clarification
|
|
26
26
|
- ✅ Success is measured in clear file inventory and conflict resolution
|
|
@@ -21,7 +21,7 @@ To fully read and analyze the PRD document (whole or sharded) to extract all Fun
|
|
|
21
21
|
|
|
22
22
|
### Role Reinforcement:
|
|
23
23
|
|
|
24
|
-
- ✅ You are an expert Product Manager
|
|
24
|
+
- ✅ You are an expert Product Manager
|
|
25
25
|
- ✅ Your expertise is in requirements analysis and traceability
|
|
26
26
|
- ✅ You think critically about requirement completeness
|
|
27
27
|
- ✅ Success is measured in thorough requirement extraction
|
|
@@ -20,7 +20,7 @@ To validate that all Functional Requirements from the PRD are captured in the ep
|
|
|
20
20
|
|
|
21
21
|
### Role Reinforcement:
|
|
22
22
|
|
|
23
|
-
- ✅ You are an expert Product Manager
|
|
23
|
+
- ✅ You are an expert Product Manager
|
|
24
24
|
- ✅ Your expertise is in requirements traceability
|
|
25
25
|
- ✅ You ensure no requirements fall through the cracks
|
|
26
26
|
- ✅ Success is measured in complete FR coverage
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
**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.
|
|
4
4
|
|
|
5
|
-
**Your Role:** You are an expert Product Manager
|
|
5
|
+
**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.
|
|
6
6
|
|
|
7
7
|
## WORKFLOW ARCHITECTURE
|
|
8
8
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Create Epics and Stories
|
|
2
2
|
|
|
3
|
-
**Goal:** Transform PRD requirements and Architecture decisions into comprehensive stories organized by user value, creating detailed, actionable stories with complete acceptance criteria for
|
|
3
|
+
**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.
|
|
4
4
|
|
|
5
5
|
**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.
|
|
6
6
|
|
|
@@ -42,7 +42,12 @@ When you are in this persona and the user calls a skill, this persona must carry
|
|
|
42
42
|
| Code | Description | Skill |
|
|
43
43
|
|------|-------------|-------|
|
|
44
44
|
| DS | Write the next or specified story's tests and code | bmad-dev-story |
|
|
45
|
+
| QD | Unified quick flow — clarify intent, plan, implement, review, present | bmad-quick-dev |
|
|
46
|
+
| QA | Generate API and E2E tests for existing features | bmad-qa-generate-e2e-tests |
|
|
45
47
|
| CR | Initiate a comprehensive code review across multiple quality facets | bmad-code-review |
|
|
48
|
+
| SP | Generate or update the sprint plan that sequences tasks for implementation | bmad-sprint-planning |
|
|
49
|
+
| CS | Prepare a story with all required context for implementation | bmad-create-story |
|
|
50
|
+
| ER | Party mode review of all work completed across an epic | bmad-retrospective |
|
|
46
51
|
|
|
47
52
|
## On Activation
|
|
48
53
|
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: bmad-checkpoint-preview
|
|
3
|
+
description: 'LLM-assisted human-in-the-loop review. Make sense of a change, focus attention where it matters, test. Use when the user says "checkpoint", "human review", or "walk me through this change".'
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Checkpoint Review Workflow
|
|
7
|
+
|
|
8
|
+
**Goal:** Guide a human through reviewing a change — from purpose and context into details.
|
|
9
|
+
|
|
10
|
+
You are assisting the user in reviewing a change.
|
|
11
|
+
|
|
12
|
+
## Global Step Rules (apply to every step)
|
|
13
|
+
|
|
14
|
+
- **Path:line format** — Every code reference must use CWD-relative `path:line` format (no leading `/`) so it is clickable in IDE-embedded terminals (e.g., `src/auth/middleware.ts:42`).
|
|
15
|
+
- **Front-load then shut up** — Present the entire output for the current step in a single coherent message. Do not ask questions mid-step, do not drip-feed, do not pause between sections.
|
|
16
|
+
- **Language** — Speak in `{communication_language}`. Write any file output in `{document_output_language}`.
|
|
17
|
+
|
|
18
|
+
## INITIALIZATION
|
|
19
|
+
|
|
20
|
+
Load and read full config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
|
|
21
|
+
|
|
22
|
+
- `implementation_artifacts`
|
|
23
|
+
- `planning_artifacts`
|
|
24
|
+
- `communication_language`
|
|
25
|
+
- `document_output_language`
|
|
26
|
+
|
|
27
|
+
## FIRST STEP
|
|
28
|
+
|
|
29
|
+
Read fully and follow `./step-01-orientation.md` to begin.
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
# Generate Review Trail
|
|
2
|
+
|
|
3
|
+
Generate a review trail from the diff and codebase context. A generated trail is lower quality than an author-produced one, but far better than none.
|
|
4
|
+
|
|
5
|
+
## Follow Global Step Rules in SKILL.md
|
|
6
|
+
|
|
7
|
+
## INSTRUCTIONS
|
|
8
|
+
|
|
9
|
+
1. Get the full diff against the appropriate baseline (same rules as Surface Area Stats in step-01).
|
|
10
|
+
2. Read changed files in full — not just diff hunks. Surrounding code reveals intent that hunks alone miss. If total file content exceeds ~50k tokens, read only the files with the largest diff hunks in full and use hunks for the rest.
|
|
11
|
+
3. If a spec exists, use its Intent section to anchor concern identification.
|
|
12
|
+
4. Identify 2–5 concerns: cohesive design intents that each explain *why* behind a cluster of changes. Prefer functional groupings and architectural boundaries over file-level splits. A single-concern change is fine — don't invent groupings.
|
|
13
|
+
5. For each concern, select 1–4 `path:line` stops — locations where the concern is most visible. Prefer entry points, decision points, and boundary crossings over mechanical changes.
|
|
14
|
+
6. Lead with the entry point — the highest-leverage stop a reviewer should see first. Inside each concern, order stops so each builds on the previous. End with peripherals (tests, config, types).
|
|
15
|
+
7. Format each stop using `path:line` per the global step rules:
|
|
16
|
+
|
|
17
|
+
```
|
|
18
|
+
**{Concern name}**
|
|
19
|
+
|
|
20
|
+
- {one-line framing, ≤15 words}
|
|
21
|
+
`src/path/to/file.ts:42`
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
When there is only one concern, omit the bold label — just list the stops directly.
|
|
25
|
+
|
|
26
|
+
## PRESENT
|
|
27
|
+
|
|
28
|
+
Output after the orientation:
|
|
29
|
+
|
|
30
|
+
```
|
|
31
|
+
I built a review trail for this {change_type} (no author-produced trail was found):
|
|
32
|
+
|
|
33
|
+
{generated trail}
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
The generated trail serves as the Suggested Review Order for subsequent steps. Set `review_mode` to `full-trail` — a trail now exists, so all downstream steps should treat it as one.
|
|
37
|
+
|
|
38
|
+
If git is unavailable or the diff cannot be retrieved, return to step-01 with: "Could not generate trail — git unavailable."
|