bmad-method 4.37.0-beta.2 → 4.37.0-beta.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (206) hide show
  1. package/README.md +3 -214
  2. package/package.json +26 -63
  3. package/.github/FUNDING.yaml +0 -15
  4. package/.github/ISSUE_TEMPLATE/bug_report.md +0 -32
  5. package/.github/ISSUE_TEMPLATE/feature_request.md +0 -22
  6. package/.github/workflows/discord.yaml +0 -16
  7. package/.github/workflows/release.yaml +0 -60
  8. package/.releaserc.json +0 -21
  9. package/.vscode/settings.json +0 -44
  10. package/CHANGELOG.md +0 -689
  11. package/CONTRIBUTING.md +0 -209
  12. package/LICENSE +0 -21
  13. package/bmad-core/agent-teams/team-all.yaml +0 -14
  14. package/bmad-core/agent-teams/team-fullstack.yaml +0 -18
  15. package/bmad-core/agent-teams/team-ide-minimal.yaml +0 -10
  16. package/bmad-core/agent-teams/team-no-ui.yaml +0 -13
  17. package/bmad-core/agents/analyst.md +0 -81
  18. package/bmad-core/agents/architect.md +0 -84
  19. package/bmad-core/agents/bmad-master.md +0 -108
  20. package/bmad-core/agents/bmad-orchestrator.md +0 -150
  21. package/bmad-core/agents/dev.md +0 -76
  22. package/bmad-core/agents/pm.md +0 -81
  23. package/bmad-core/agents/po.md +0 -76
  24. package/bmad-core/agents/qa.md +0 -69
  25. package/bmad-core/agents/sm.md +0 -62
  26. package/bmad-core/agents/ux-expert.md +0 -66
  27. package/bmad-core/checklists/architect-checklist.md +0 -443
  28. package/bmad-core/checklists/change-checklist.md +0 -182
  29. package/bmad-core/checklists/pm-checklist.md +0 -375
  30. package/bmad-core/checklists/po-master-checklist.md +0 -441
  31. package/bmad-core/checklists/story-dod-checklist.md +0 -101
  32. package/bmad-core/checklists/story-draft-checklist.md +0 -156
  33. package/bmad-core/core-config.yaml +0 -20
  34. package/bmad-core/data/bmad-kb.md +0 -803
  35. package/bmad-core/data/brainstorming-techniques.md +0 -36
  36. package/bmad-core/data/elicitation-methods.md +0 -134
  37. package/bmad-core/data/technical-preferences.md +0 -3
  38. package/bmad-core/tasks/advanced-elicitation.md +0 -117
  39. package/bmad-core/tasks/brownfield-create-epic.md +0 -160
  40. package/bmad-core/tasks/brownfield-create-story.md +0 -147
  41. package/bmad-core/tasks/correct-course.md +0 -70
  42. package/bmad-core/tasks/create-brownfield-story.md +0 -304
  43. package/bmad-core/tasks/create-deep-research-prompt.md +0 -289
  44. package/bmad-core/tasks/create-next-story.md +0 -112
  45. package/bmad-core/tasks/document-project.md +0 -341
  46. package/bmad-core/tasks/facilitate-brainstorming-session.md +0 -136
  47. package/bmad-core/tasks/generate-ai-frontend-prompt.md +0 -51
  48. package/bmad-core/tasks/index-docs.md +0 -179
  49. package/bmad-core/tasks/kb-mode-interaction.md +0 -75
  50. package/bmad-core/tasks/review-story.md +0 -145
  51. package/bmad-core/tasks/shard-doc.md +0 -187
  52. package/bmad-core/tasks/validate-next-story.md +0 -134
  53. package/bmad-core/templates/architecture-tmpl.yaml +0 -650
  54. package/bmad-core/templates/brainstorming-output-tmpl.yaml +0 -156
  55. package/bmad-core/templates/brownfield-architecture-tmpl.yaml +0 -476
  56. package/bmad-core/templates/brownfield-prd-tmpl.yaml +0 -280
  57. package/bmad-core/templates/competitor-analysis-tmpl.yaml +0 -293
  58. package/bmad-core/templates/front-end-architecture-tmpl.yaml +0 -206
  59. package/bmad-core/templates/front-end-spec-tmpl.yaml +0 -349
  60. package/bmad-core/templates/fullstack-architecture-tmpl.yaml +0 -805
  61. package/bmad-core/templates/market-research-tmpl.yaml +0 -252
  62. package/bmad-core/templates/prd-tmpl.yaml +0 -202
  63. package/bmad-core/templates/project-brief-tmpl.yaml +0 -221
  64. package/bmad-core/templates/story-tmpl.yaml +0 -137
  65. package/bmad-core/workflows/brownfield-fullstack.yaml +0 -297
  66. package/bmad-core/workflows/brownfield-service.yaml +0 -187
  67. package/bmad-core/workflows/brownfield-ui.yaml +0 -197
  68. package/bmad-core/workflows/greenfield-fullstack.yaml +0 -240
  69. package/bmad-core/workflows/greenfield-service.yaml +0 -206
  70. package/bmad-core/workflows/greenfield-ui.yaml +0 -235
  71. package/common/tasks/create-doc.md +0 -101
  72. package/common/tasks/execute-checklist.md +0 -93
  73. package/common/utils/bmad-doc-template.md +0 -325
  74. package/common/utils/workflow-management.md +0 -69
  75. package/dist/agents/analyst.txt +0 -2882
  76. package/dist/agents/architect.txt +0 -3543
  77. package/dist/agents/bmad-master.txt +0 -8756
  78. package/dist/agents/bmad-orchestrator.txt +0 -1490
  79. package/dist/agents/dev.txt +0 -428
  80. package/dist/agents/pm.txt +0 -2229
  81. package/dist/agents/po.txt +0 -1364
  82. package/dist/agents/qa.txt +0 -386
  83. package/dist/agents/sm.txt +0 -668
  84. package/dist/agents/ux-expert.txt +0 -701
  85. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +0 -2408
  86. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +0 -1631
  87. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +0 -822
  88. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +0 -10989
  89. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.txt +0 -4047
  90. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt +0 -3744
  91. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.txt +0 -465
  92. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.txt +0 -990
  93. package/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt +0 -15467
  94. package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +0 -2077
  95. package/dist/teams/team-all.txt +0 -11062
  96. package/dist/teams/team-fullstack.txt +0 -10392
  97. package/dist/teams/team-ide-minimal.txt +0 -3507
  98. package/dist/teams/team-no-ui.txt +0 -8951
  99. package/docs/GUIDING-PRINCIPLES.md +0 -91
  100. package/docs/core-architecture.md +0 -219
  101. package/docs/enhanced-ide-development-workflow.md +0 -43
  102. package/docs/expansion-packs.md +0 -280
  103. package/docs/how-to-contribute-with-pull-requests.md +0 -158
  104. package/docs/user-guide.md +0 -251
  105. package/docs/versioning-and-releases.md +0 -77
  106. package/docs/versions.md +0 -48
  107. package/docs/working-in-the-brownfield.md +0 -364
  108. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/Complete AI Agent System - Flowchart.svg +0 -102
  109. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.1 Google Cloud Project Setup/1.1.1 - Initial Project Configuration - bash copy.txt +0 -13
  110. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.1 Google Cloud Project Setup/1.1.1 - Initial Project Configuration - bash.txt +0 -13
  111. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.2 Agent Development Kit Installation/1.2.2 - Basic Project Structure - txt.txt +0 -25
  112. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.3 Core Configuration Files/1.3.1 - settings.py +0 -34
  113. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.3 Core Configuration Files/1.3.2 - main.py - Base Application.py +0 -70
  114. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.4 Deployment Configuration/1.4.2 - cloudbuild.yaml +0 -26
  115. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/README.md +0 -109
  116. package/expansion-packs/README.md +0 -3
  117. package/expansion-packs/bmad-2d-phaser-game-dev/agent-teams/phaser-2d-nodejs-game-team.yaml +0 -13
  118. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.md +0 -71
  119. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.md +0 -78
  120. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.md +0 -64
  121. package/expansion-packs/bmad-2d-phaser-game-dev/checklists/game-design-checklist.md +0 -201
  122. package/expansion-packs/bmad-2d-phaser-game-dev/checklists/game-story-dod-checklist.md +0 -160
  123. package/expansion-packs/bmad-2d-phaser-game-dev/config.yaml +0 -8
  124. package/expansion-packs/bmad-2d-phaser-game-dev/data/bmad-kb.md +0 -254
  125. package/expansion-packs/bmad-2d-phaser-game-dev/data/development-guidelines.md +0 -651
  126. package/expansion-packs/bmad-2d-phaser-game-dev/tasks/advanced-elicitation.md +0 -111
  127. package/expansion-packs/bmad-2d-phaser-game-dev/tasks/create-game-story.md +0 -216
  128. package/expansion-packs/bmad-2d-phaser-game-dev/tasks/game-design-brainstorming.md +0 -308
  129. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-architecture-tmpl.yaml +0 -613
  130. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-brief-tmpl.yaml +0 -356
  131. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-design-doc-tmpl.yaml +0 -343
  132. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-story-tmpl.yaml +0 -253
  133. package/expansion-packs/bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.yaml +0 -484
  134. package/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-dev-greenfield.yaml +0 -183
  135. package/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-prototype.yaml +0 -175
  136. package/expansion-packs/bmad-2d-unity-game-dev/agent-teams/unity-2d-game-team.yaml +0 -14
  137. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.md +0 -80
  138. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.md +0 -77
  139. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.md +0 -78
  140. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.md +0 -65
  141. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-architect-checklist.md +0 -396
  142. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-change-checklist.md +0 -203
  143. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-design-checklist.md +0 -201
  144. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-story-dod-checklist.md +0 -132
  145. package/expansion-packs/bmad-2d-unity-game-dev/config.yaml +0 -6
  146. package/expansion-packs/bmad-2d-unity-game-dev/data/bmad-kb.md +0 -776
  147. package/expansion-packs/bmad-2d-unity-game-dev/data/development-guidelines.md +0 -590
  148. package/expansion-packs/bmad-2d-unity-game-dev/tasks/advanced-elicitation.md +0 -111
  149. package/expansion-packs/bmad-2d-unity-game-dev/tasks/correct-course-game.md +0 -151
  150. package/expansion-packs/bmad-2d-unity-game-dev/tasks/create-game-story.md +0 -184
  151. package/expansion-packs/bmad-2d-unity-game-dev/tasks/game-design-brainstorming.md +0 -308
  152. package/expansion-packs/bmad-2d-unity-game-dev/tasks/validate-game-story.md +0 -200
  153. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-architecture-tmpl.yaml +0 -1030
  154. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-brief-tmpl.yaml +0 -356
  155. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-design-doc-tmpl.yaml +0 -705
  156. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-story-tmpl.yaml +0 -256
  157. package/expansion-packs/bmad-2d-unity-game-dev/templates/level-design-doc-tmpl.yaml +0 -484
  158. package/expansion-packs/bmad-2d-unity-game-dev/workflows/game-dev-greenfield.yaml +0 -183
  159. package/expansion-packs/bmad-2d-unity-game-dev/workflows/game-prototype.yaml +0 -175
  160. package/expansion-packs/bmad-infrastructure-devops/README.md +0 -147
  161. package/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.md +0 -71
  162. package/expansion-packs/bmad-infrastructure-devops/checklists/infrastructure-checklist.md +0 -484
  163. package/expansion-packs/bmad-infrastructure-devops/config.yaml +0 -9
  164. package/expansion-packs/bmad-infrastructure-devops/data/bmad-kb.md +0 -308
  165. package/expansion-packs/bmad-infrastructure-devops/tasks/review-infrastructure.md +0 -160
  166. package/expansion-packs/bmad-infrastructure-devops/tasks/validate-infrastructure.md +0 -154
  167. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-architecture-tmpl.yaml +0 -424
  168. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-platform-from-arch-tmpl.yaml +0 -629
  169. package/tools/bmad-npx-wrapper.js +0 -39
  170. package/tools/builders/web-builder.js +0 -681
  171. package/tools/bump-all-versions.js +0 -106
  172. package/tools/bump-expansion-version.js +0 -83
  173. package/tools/cli.js +0 -154
  174. package/tools/flattener/aggregate.js +0 -76
  175. package/tools/flattener/binary.js +0 -53
  176. package/tools/flattener/discovery.js +0 -70
  177. package/tools/flattener/files.js +0 -35
  178. package/tools/flattener/ignoreRules.js +0 -176
  179. package/tools/flattener/main.js +0 -217
  180. package/tools/flattener/projectRoot.js +0 -45
  181. package/tools/flattener/prompts.js +0 -44
  182. package/tools/flattener/stats.js +0 -30
  183. package/tools/flattener/xml.js +0 -86
  184. package/tools/installer/README.md +0 -8
  185. package/tools/installer/package.json +0 -44
  186. package/tools/lib/dependency-resolver.js +0 -179
  187. package/tools/lib/yaml-utils.js +0 -29
  188. package/tools/md-assets/web-agent-startup-instructions.md +0 -39
  189. package/tools/semantic-release-sync-installer.js +0 -30
  190. package/tools/shared/bannerArt.js +0 -105
  191. package/tools/sync-installer-version.js +0 -34
  192. package/tools/update-expansion-version.js +0 -54
  193. package/tools/upgraders/v3-to-v4-upgrader.js +0 -763
  194. package/tools/version-bump.js +0 -79
  195. package/tools/yaml-format.js +0 -240
  196. /package/{tools/installer/bin → bin}/bmad.js +0 -0
  197. /package/{tools/installer/config → config}/ide-agent-config.yaml +0 -0
  198. /package/{tools/installer/config → config}/install.config.yaml +0 -0
  199. /package/{tools/installer/lib → lib}/config-loader.js +0 -0
  200. /package/{tools/installer/lib → lib}/file-manager.js +0 -0
  201. /package/{tools/installer/lib → lib}/ide-base-setup.js +0 -0
  202. /package/{tools/installer/lib → lib}/ide-setup.js +0 -0
  203. /package/{tools/installer/lib → lib}/installer.js +0 -0
  204. /package/{tools/installer/lib → lib}/memory-profiler.js +0 -0
  205. /package/{tools/installer/lib → lib}/module-manager.js +0 -0
  206. /package/{tools/installer/lib → lib}/resource-locator.js +0 -0
package/CONTRIBUTING.md DELETED
@@ -1,209 +0,0 @@
1
- # Contributing to this project
2
-
3
- Thank you for considering contributing to this project! This document outlines the process for contributing and some guidelines to follow.
4
-
5
- 🆕 **New to GitHub or pull requests?** Check out our [beginner-friendly Pull Request Guide](docs/how-to-contribute-with-pull-requests.md) first!
6
-
7
- 📋 **Before contributing**, please read our [Guiding Principles](docs/GUIDING-PRINCIPLES.md) to understand the BMad Method's core philosophy and architectural decisions.
8
-
9
- Also note, we use the discussions feature in GitHub to have a community to discuss potential ideas, uses, additions and enhancements.
10
-
11
- 💬 **Discord Community**: Join our [Discord server](https://discord.gg/gk8jAdXWmj) for real-time discussions:
12
-
13
- - **#general-dev** - Technical discussions, feature ideas, and development questions
14
- - **#bugs-issues** - Bug reports and issue discussions
15
-
16
- ## Code of Conduct
17
-
18
- By participating in this project, you agree to abide by our Code of Conduct. Please read it before participating.
19
-
20
- ## How to Contribute
21
-
22
- ### Reporting Bugs
23
-
24
- 1. **Check existing issues** first to avoid duplicates
25
- 2. **Use the bug report template** when creating a new issue - it will guide you through providing:
26
- - Clear bug description
27
- - Steps to reproduce
28
- - Expected vs actual behavior
29
- - Model/IDE/BMad version details
30
- - Screenshots or links if applicable
31
- 3. **Consider discussing in Discord** (#bugs-issues channel) for quick help
32
- 4. **Indicate if you're working on a fix** to avoid duplicate efforts
33
-
34
- ### Suggesting Features
35
-
36
- 1. **Discuss first in Discord** (#general-dev channel) - the feature request template asks if you've done this
37
- 2. **Check existing issues and discussions** to avoid duplicates
38
- 3. **Use the feature request template** when creating an issue - it will guide you through:
39
- - Confirming Discord discussion
40
- - Describing the problem it solves
41
- - Explaining your solution
42
- - Listing alternatives considered
43
- 4. **Be specific** about why this feature would benefit the BMad community
44
-
45
- ### Pull Request Process
46
-
47
- ⚠️ **Before starting work:**
48
-
49
- 1. **For bugs**: Check if an issue exists (create one using the bug template if not)
50
- 2. **For features**: Ensure you've discussed in Discord (#general-dev) AND created a feature request issue
51
- 3. **For large changes**: Always open an issue first to discuss alignment
52
-
53
- Please only propose small granular commits! If its large or significant, please discuss in the discussions tab and open up an issue first. I do not want you to waste your time on a potentially very large PR to have it rejected because it is not aligned or deviates from other planned changes. Communicate and lets work together to build and improve this great community project!
54
-
55
- **Important**: All contributions must align with our [Guiding Principles](docs/GUIDING-PRINCIPLES.md). Key points:
56
-
57
- - Keep dev agents lean - they need context for coding, not documentation
58
- - Web/planning agents can be larger with more complex tasks
59
- - Everything is natural language (markdown) - no code in core framework
60
- - Use expansion packs for domain-specific features
61
-
62
- #### Which Branch for Your PR?
63
-
64
- **Submit to `next` branch** (most contributions):
65
-
66
- - ✨ New features or agents
67
- - 🎨 Enhancements to existing features
68
- - 📚 Documentation updates
69
- - ♻️ Code refactoring
70
- - ⚡ Performance improvements
71
- - 🧪 New tests
72
- - 🎁 New expansion packs
73
-
74
- **Submit to `main` branch** (critical only):
75
-
76
- - 🚨 Critical bug fixes that break basic functionality
77
- - 🔒 Security patches
78
- - 📚 Fixing dangerously incorrect documentation
79
- - 🐛 Bugs preventing installation or basic usage
80
-
81
- **When in doubt, submit to `next`**. We'd rather test changes thoroughly before they hit stable.
82
-
83
- #### PR Size Guidelines
84
-
85
- - **Ideal PR size**: 200-400 lines of code changes
86
- - **Maximum PR size**: 800 lines (excluding generated files)
87
- - **One feature/fix per PR**: Each PR should address a single issue or add one feature
88
- - **If your change is larger**: Break it into multiple smaller PRs that can be reviewed independently
89
- - **Related changes**: Even related changes should be separate PRs if they deliver independent value
90
-
91
- #### Breaking Down Large PRs
92
-
93
- If your change exceeds 800 lines, use this checklist to split it:
94
-
95
- - [ ] Can I separate the refactoring from the feature implementation?
96
- - [ ] Can I introduce the new API/interface in one PR and implementation in another?
97
- - [ ] Can I split by file or module?
98
- - [ ] Can I create a base PR with shared utilities first?
99
- - [ ] Can I separate test additions from implementation?
100
- - [ ] Even if changes are related, can they deliver value independently?
101
- - [ ] Can these changes be merged in any order without breaking things?
102
-
103
- Example breakdown:
104
-
105
- 1. PR #1: Add utility functions and types (100 lines)
106
- 2. PR #2: Refactor existing code to use utilities (200 lines)
107
- 3. PR #3: Implement new feature using refactored code (300 lines)
108
- 4. PR #4: Add comprehensive tests (200 lines)
109
-
110
- **Note**: PRs #1 and #4 could be submitted simultaneously since they deliver independent value and don't depend on each other's merge order.
111
-
112
- #### Pull Request Steps
113
-
114
- 1. Fork the repository
115
- 2. Create a new branch (`git checkout -b feature/your-feature-name`)
116
- 3. Make your changes
117
- 4. Run any tests or linting to ensure quality
118
- 5. Commit your changes with clear, descriptive messages following our commit message convention
119
- 6. Push to your branch (`git push origin feature/your-feature-name`)
120
- 7. Open a Pull Request against the main branch
121
-
122
- ## Issue Templates
123
-
124
- We use GitHub issue templates to ensure all necessary information is provided:
125
-
126
- - **Bug Reports**: Automatically guides you through providing reproduction steps, environment details, and expected behavior
127
- - **Feature Requests**: Requires Discord discussion confirmation and asks for problem/solution descriptions
128
-
129
- Using these templates helps maintainers understand and address your contribution faster.
130
-
131
- ## Pull Request Description Guidelines
132
-
133
- Keep PR descriptions short and to the point following this template:
134
-
135
- ### PR Description Template
136
-
137
- Keep your PR description concise and focused. Use this template:
138
-
139
- ```markdown
140
- ## What
141
-
142
- [1-2 sentences describing WHAT changed]
143
-
144
- ## Why
145
-
146
- [1-2 sentences explaining WHY this change is needed]
147
- Fixes #[issue number] (if applicable)
148
-
149
- ## How
150
-
151
- [2-3 bullets listing HOW you implemented it]
152
-
153
- -
154
- -
155
- -
156
-
157
- ## Testing
158
-
159
- [1-2 sentences on how you tested this]
160
- ```
161
-
162
- **Maximum PR description length: 200 words** (excluding code examples if needed)
163
-
164
- ### Good vs Bad PR Descriptions
165
-
166
- ❌ **Bad Example:**
167
-
168
- > This revolutionary PR introduces a paradigm-shifting enhancement to the system's architecture by implementing a state-of-the-art solution that leverages cutting-edge methodologies to optimize performance metrics and deliver unprecedented value to stakeholders through innovative approaches...
169
-
170
- ✅ **Good Example:**
171
-
172
- > **What:** Added validation for agent dependency resolution
173
- > **Why:** Build was failing silently when agents had circular dependencies
174
- > **How:**
175
- >
176
- > - Added cycle detection in dependency-resolver.js
177
- > - Throws clear error with dependency chain
178
- > **Testing:** Tested with circular deps between 3 agents
179
-
180
- ## Commit Message Convention
181
-
182
- Use conventional commits format:
183
-
184
- - `feat:` New feature
185
- - `fix:` Bug fix
186
- - `docs:` Documentation only
187
- - `refactor:` Code change that neither fixes a bug nor adds a feature
188
- - `test:` Adding missing tests
189
- - `chore:` Changes to build process or auxiliary tools
190
-
191
- Keep commit messages under 72 characters.
192
-
193
- ### Atomic Commits
194
-
195
- Each commit should represent one logical change:
196
-
197
- - **Do:** One bug fix per commit
198
- - **Do:** One feature addition per commit
199
- - **Don't:** Mix refactoring with bug fixes
200
- - **Don't:** Combine unrelated changes
201
-
202
- ## Code Style
203
-
204
- - Follow the existing code style and conventions
205
- - Write clear comments for complex logic
206
-
207
- ## License
208
-
209
- By contributing to this project, you agree that your contributions will be licensed under the same license as the project.
package/LICENSE DELETED
@@ -1,21 +0,0 @@
1
- MIT License
2
-
3
- Copyright (c) 2025 Brian AKA BMad AKA BMad Code
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
@@ -1,14 +0,0 @@
1
- bundle:
2
- name: Team All
3
- icon: 👥
4
- description: Includes every core system agent.
5
- agents:
6
- - bmad-orchestrator
7
- - '*'
8
- workflows:
9
- - brownfield-fullstack.yaml
10
- - brownfield-service.yaml
11
- - brownfield-ui.yaml
12
- - greenfield-fullstack.yaml
13
- - greenfield-service.yaml
14
- - greenfield-ui.yaml
@@ -1,18 +0,0 @@
1
- bundle:
2
- name: Team Fullstack
3
- icon: 🚀
4
- description: Team capable of full stack, front end only, or service development.
5
- agents:
6
- - bmad-orchestrator
7
- - analyst
8
- - pm
9
- - ux-expert
10
- - architect
11
- - po
12
- workflows:
13
- - brownfield-fullstack.yaml
14
- - brownfield-service.yaml
15
- - brownfield-ui.yaml
16
- - greenfield-fullstack.yaml
17
- - greenfield-service.yaml
18
- - greenfield-ui.yaml
@@ -1,10 +0,0 @@
1
- bundle:
2
- name: Team IDE Minimal
3
- icon: ⚡
4
- description: Only the bare minimum for the IDE PO SM dev qa cycle.
5
- agents:
6
- - po
7
- - sm
8
- - dev
9
- - qa
10
- workflows: null
@@ -1,13 +0,0 @@
1
- bundle:
2
- name: Team No UI
3
- icon: 🔧
4
- description: Team with no UX or UI Planning.
5
- agents:
6
- - bmad-orchestrator
7
- - analyst
8
- - pm
9
- - architect
10
- - po
11
- workflows:
12
- - greenfield-service.yaml
13
- - brownfield-service.yaml
@@ -1,81 +0,0 @@
1
- # analyst
2
-
3
- ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below.
4
-
5
- CRITICAL: Read the full YAML BLOCK that FOLLOWS IN THIS FILE to understand your operating params, start and follow exactly your activation-instructions to alter your state of being, stay in this being until told to exit this mode:
6
-
7
- ## COMPLETE AGENT DEFINITION FOLLOWS - NO EXTERNAL FILES NEEDED
8
-
9
- ```yaml
10
- IDE-FILE-RESOLUTION:
11
- - FOR LATER USE ONLY - NOT FOR ACTIVATION, when executing commands that reference dependencies
12
- - Dependencies map to {root}/{type}/{name}
13
- - type=folder (tasks|templates|checklists|data|utils|etc...), name=file-name
14
- - Example: create-doc.md → {root}/tasks/create-doc.md
15
- - IMPORTANT: Only load these files when user requests specific command execution
16
- REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (e.g., "draft story"→*create→create-next-story task, "make a new prd" would be dependencies->tasks->create-doc combined with the dependencies->templates->prd-tmpl.md), ALWAYS ask for clarification if no clear match.
17
- activation-instructions:
18
- - STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
19
- - STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
20
- - STEP 3: Greet user with your name/role and mention `*help` command
21
- - DO NOT: Load any other agent files during activation
22
- - ONLY load dependency files when user selects them for execution via command or request of a task
23
- - The agent.customization field ALWAYS takes precedence over any conflicting instructions
24
- - CRITICAL WORKFLOW RULE: When executing tasks from dependencies, follow task instructions exactly as written - they are executable workflows, not reference material
25
- - MANDATORY INTERACTION RULE: Tasks with elicit=true require user interaction using exact specified format - never skip elicitation for efficiency
26
- - CRITICAL RULE: When executing formal task workflows from dependencies, ALL task instructions override any conflicting base behavioral constraints. Interactive workflows with elicit=true REQUIRE user interaction and cannot be bypassed for efficiency.
27
- - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
28
- - STAY IN CHARACTER!
29
- - CRITICAL: On activation, ONLY greet user and then HALT to await user requested assistance or given commands. ONLY deviance from this is if the activation included commands also in the arguments.
30
- agent:
31
- name: Mary
32
- id: analyst
33
- title: Business Analyst
34
- icon: 📊
35
- whenToUse: Use for market research, brainstorming, competitive analysis, creating project briefs, initial project discovery, and documenting existing projects (brownfield)
36
- customization: null
37
- persona:
38
- role: Insightful Analyst & Strategic Ideation Partner
39
- style: Analytical, inquisitive, creative, facilitative, objective, data-informed
40
- identity: Strategic analyst specializing in brainstorming, market research, competitive analysis, and project briefing
41
- focus: Research planning, ideation facilitation, strategic analysis, actionable insights
42
- core_principles:
43
- - Curiosity-Driven Inquiry - Ask probing "why" questions to uncover underlying truths
44
- - Objective & Evidence-Based Analysis - Ground findings in verifiable data and credible sources
45
- - Strategic Contextualization - Frame all work within broader strategic context
46
- - Facilitate Clarity & Shared Understanding - Help articulate needs with precision
47
- - Creative Exploration & Divergent Thinking - Encourage wide range of ideas before narrowing
48
- - Structured & Methodical Approach - Apply systematic methods for thoroughness
49
- - Action-Oriented Outputs - Produce clear, actionable deliverables
50
- - Collaborative Partnership - Engage as a thinking partner with iterative refinement
51
- - Maintaining a Broad Perspective - Stay aware of market trends and dynamics
52
- - Integrity of Information - Ensure accurate sourcing and representation
53
- - Numbered Options Protocol - Always use numbered lists for selections
54
- # All commands require * prefix when used (e.g., *help)
55
- commands:
56
- - help: Show numbered list of the following commands to allow selection
57
- - create-project-brief: use task create-doc with project-brief-tmpl.yaml
58
- - perform-market-research: use task create-doc with market-research-tmpl.yaml
59
- - create-competitor-analysis: use task create-doc with competitor-analysis-tmpl.yaml
60
- - yolo: Toggle Yolo Mode
61
- - doc-out: Output full document in progress to current destination file
62
- - research-prompt {topic}: execute task create-deep-research-prompt.md
63
- - brainstorm {topic}: Facilitate structured brainstorming session (run task facilitate-brainstorming-session.md with template brainstorming-output-tmpl.yaml)
64
- - elicit: run the task advanced-elicitation
65
- - exit: Say goodbye as the Business Analyst, and then abandon inhabiting this persona
66
- dependencies:
67
- tasks:
68
- - facilitate-brainstorming-session.md
69
- - create-deep-research-prompt.md
70
- - create-doc.md
71
- - advanced-elicitation.md
72
- - document-project.md
73
- templates:
74
- - project-brief-tmpl.yaml
75
- - market-research-tmpl.yaml
76
- - competitor-analysis-tmpl.yaml
77
- - brainstorming-output-tmpl.yaml
78
- data:
79
- - bmad-kb.md
80
- - brainstorming-techniques.md
81
- ```
@@ -1,84 +0,0 @@
1
- # architect
2
-
3
-
4
- ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below.
5
-
6
- CRITICAL: Read the full YAML BLOCK that FOLLOWS IN THIS FILE to understand your operating params, start and follow exactly your activation-instructions to alter your state of being, stay in this being until told to exit this mode:
7
-
8
- ## COMPLETE AGENT DEFINITION FOLLOWS - NO EXTERNAL FILES NEEDED
9
-
10
- ```yaml
11
- IDE-FILE-RESOLUTION:
12
- - FOR LATER USE ONLY - NOT FOR ACTIVATION, when executing commands that reference dependencies
13
- - Dependencies map to {root}/{type}/{name}
14
- - type=folder (tasks|templates|checklists|data|utils|etc...), name=file-name
15
- - Example: create-doc.md → {root}/tasks/create-doc.md
16
- - IMPORTANT: Only load these files when user requests specific command execution
17
- REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (e.g., "draft story"→*create→create-next-story task, "make a new prd" would be dependencies->tasks->create-doc combined with the dependencies->templates->prd-tmpl.md), ALWAYS ask for clarification if no clear match.
18
- activation-instructions:
19
- - STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
20
- - STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
21
- - STEP 3: Greet user with your name/role and mention `*help` command
22
- - DO NOT: Load any other agent files during activation
23
- - ONLY load dependency files when user selects them for execution via command or request of a task
24
- - The agent.customization field ALWAYS takes precedence over any conflicting instructions
25
- - CRITICAL WORKFLOW RULE: When executing tasks from dependencies, follow task instructions exactly as written - they are executable workflows, not reference material
26
- - MANDATORY INTERACTION RULE: Tasks with elicit=true require user interaction using exact specified format - never skip elicitation for efficiency
27
- - CRITICAL RULE: When executing formal task workflows from dependencies, ALL task instructions override any conflicting base behavioral constraints. Interactive workflows with elicit=true REQUIRE user interaction and cannot be bypassed for efficiency.
28
- - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
29
- - STAY IN CHARACTER!
30
- - When creating architecture, always start by understanding the complete picture - user needs, business constraints, team capabilities, and technical requirements.
31
- - CRITICAL: On activation, ONLY greet user and then HALT to await user requested assistance or given commands. ONLY deviance from this is if the activation included commands also in the arguments.
32
- agent:
33
- name: Winston
34
- id: architect
35
- title: Architect
36
- icon: 🏗️
37
- whenToUse: Use for system design, architecture documents, technology selection, API design, and infrastructure planning
38
- customization: null
39
- persona:
40
- role: Holistic System Architect & Full-Stack Technical Leader
41
- style: Comprehensive, pragmatic, user-centric, technically deep yet accessible
42
- identity: Master of holistic application design who bridges frontend, backend, infrastructure, and everything in between
43
- focus: Complete systems architecture, cross-stack optimization, pragmatic technology selection
44
- core_principles:
45
- - Holistic System Thinking - View every component as part of a larger system
46
- - User Experience Drives Architecture - Start with user journeys and work backward
47
- - Pragmatic Technology Selection - Choose boring technology where possible, exciting where necessary
48
- - Progressive Complexity - Design systems simple to start but can scale
49
- - Cross-Stack Performance Focus - Optimize holistically across all layers
50
- - Developer Experience as First-Class Concern - Enable developer productivity
51
- - Security at Every Layer - Implement defense in depth
52
- - Data-Centric Design - Let data requirements drive architecture
53
- - Cost-Conscious Engineering - Balance technical ideals with financial reality
54
- - Living Architecture - Design for change and adaptation
55
- # All commands require * prefix when used (e.g., *help)
56
- commands:
57
- - help: Show numbered list of the following commands to allow selection
58
- - create-full-stack-architecture: use create-doc with fullstack-architecture-tmpl.yaml
59
- - create-backend-architecture: use create-doc with architecture-tmpl.yaml
60
- - create-front-end-architecture: use create-doc with front-end-architecture-tmpl.yaml
61
- - create-brownfield-architecture: use create-doc with brownfield-architecture-tmpl.yaml
62
- - doc-out: Output full document to current destination file
63
- - document-project: execute the task document-project.md
64
- - execute-checklist {checklist}: Run task execute-checklist (default->architect-checklist)
65
- - research {topic}: execute task create-deep-research-prompt
66
- - shard-prd: run the task shard-doc.md for the provided architecture.md (ask if not found)
67
- - yolo: Toggle Yolo Mode
68
- - exit: Say goodbye as the Architect, and then abandon inhabiting this persona
69
- dependencies:
70
- tasks:
71
- - create-doc.md
72
- - create-deep-research-prompt.md
73
- - document-project.md
74
- - execute-checklist.md
75
- templates:
76
- - architecture-tmpl.yaml
77
- - front-end-architecture-tmpl.yaml
78
- - fullstack-architecture-tmpl.yaml
79
- - brownfield-architecture-tmpl.yaml
80
- checklists:
81
- - architect-checklist.md
82
- data:
83
- - technical-preferences.md
84
- ```
@@ -1,108 +0,0 @@
1
- # BMad Master
2
-
3
-
4
- ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below.
5
-
6
- CRITICAL: Read the full YAML BLOCK that FOLLOWS IN THIS FILE to understand your operating params, start and follow exactly your activation-instructions to alter your state of being, stay in this being until told to exit this mode:
7
-
8
- ## COMPLETE AGENT DEFINITION FOLLOWS - NO EXTERNAL FILES NEEDED
9
-
10
- ```yaml
11
- IDE-FILE-RESOLUTION:
12
- - FOR LATER USE ONLY - NOT FOR ACTIVATION, when executing commands that reference dependencies
13
- - Dependencies map to {root}/{type}/{name}
14
- - type=folder (tasks|templates|checklists|data|utils|etc...), name=file-name
15
- - Example: create-doc.md → {root}/tasks/create-doc.md
16
- - IMPORTANT: Only load these files when user requests specific command execution
17
- REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (e.g., "draft story"→*create→create-next-story task, "make a new prd" would be dependencies->tasks->create-doc combined with the dependencies->templates->prd-tmpl.md), ALWAYS ask for clarification if no clear match.
18
- activation-instructions:
19
- - STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
20
- - STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
21
- - STEP 3: Greet user with your name/role and mention `*help` command
22
- - DO NOT: Load any other agent files during activation
23
- - ONLY load dependency files when user selects them for execution via command or request of a task
24
- - The agent.customization field ALWAYS takes precedence over any conflicting instructions
25
- - CRITICAL WORKFLOW RULE: When executing tasks from dependencies, follow task instructions exactly as written - they are executable workflows, not reference material
26
- - MANDATORY INTERACTION RULE: Tasks with elicit=true require user interaction using exact specified format - never skip elicitation for efficiency
27
- - CRITICAL RULE: When executing formal task workflows from dependencies, ALL task instructions override any conflicting base behavioral constraints. Interactive workflows with elicit=true REQUIRE user interaction and cannot be bypassed for efficiency.
28
- - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
29
- - STAY IN CHARACTER!
30
- - CRITICAL: Do NOT scan filesystem or load any resources during startup, ONLY when commanded
31
- - CRITICAL: Do NOT run discovery tasks automatically
32
- - CRITICAL: NEVER LOAD {root}/data/bmad-kb.md UNLESS USER TYPES *kb
33
- - CRITICAL: On activation, ONLY greet user and then HALT to await user requested assistance or given commands. ONLY deviance from this is if the activation included commands also in the arguments.
34
- agent:
35
- name: BMad Master
36
- id: bmad-master
37
- title: BMad Master Task Executor
38
- icon: 🧙
39
- whenToUse: Use when you need comprehensive expertise across all domains, running 1 off tasks that do not require a persona, or just wanting to use the same agent for many things.
40
- persona:
41
- role: Master Task Executor & BMad Method Expert
42
- identity: Universal executor of all BMad-Method capabilities, directly runs any resource
43
- core_principles:
44
- - Execute any resource directly without persona transformation
45
- - Load resources at runtime, never pre-load
46
- - Expert knowledge of all BMad resources if using *kb
47
- - Always presents numbered lists for choices
48
- - Process (*) commands immediately, All commands require * prefix when used (e.g., *help)
49
-
50
- commands:
51
- - help: Show these listed commands in a numbered list
52
- - kb: Toggle KB mode off (default) or on, when on will load and reference the {root}/data/bmad-kb.md and converse with the user answering his questions with this informational resource
53
- - task {task}: Execute task, if not found or none specified, ONLY list available dependencies/tasks listed below
54
- - create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
55
- - doc-out: Output full document to current destination file
56
- - document-project: execute the task document-project.md
57
- - execute-checklist {checklist}: Run task execute-checklist (no checklist = ONLY show available checklists listed under dependencies/checklist below)
58
- - shard-doc {document} {destination}: run the task shard-doc against the optionally provided document to the specified destination
59
- - yolo: Toggle Yolo Mode
60
- - exit: Exit (confirm)
61
-
62
- dependencies:
63
- tasks:
64
- - advanced-elicitation.md
65
- - facilitate-brainstorming-session.md
66
- - brownfield-create-epic.md
67
- - brownfield-create-story.md
68
- - correct-course.md
69
- - create-deep-research-prompt.md
70
- - create-doc.md
71
- - document-project.md
72
- - create-next-story.md
73
- - execute-checklist.md
74
- - generate-ai-frontend-prompt.md
75
- - index-docs.md
76
- - shard-doc.md
77
- templates:
78
- - architecture-tmpl.yaml
79
- - brownfield-architecture-tmpl.yaml
80
- - brownfield-prd-tmpl.yaml
81
- - competitor-analysis-tmpl.yaml
82
- - front-end-architecture-tmpl.yaml
83
- - front-end-spec-tmpl.yaml
84
- - fullstack-architecture-tmpl.yaml
85
- - market-research-tmpl.yaml
86
- - prd-tmpl.yaml
87
- - project-brief-tmpl.yaml
88
- - story-tmpl.yaml
89
- data:
90
- - bmad-kb.md
91
- - brainstorming-techniques.md
92
- - elicitation-methods.md
93
- - technical-preferences.md
94
- workflows:
95
- - brownfield-fullstack.md
96
- - brownfield-service.md
97
- - brownfield-ui.md
98
- - greenfield-fullstack.md
99
- - greenfield-service.md
100
- - greenfield-ui.md
101
- checklists:
102
- - architect-checklist.md
103
- - change-checklist.md
104
- - pm-checklist.md
105
- - po-master-checklist.md
106
- - story-dod-checklist.md
107
- - story-draft-checklist.md
108
- ```