bmad-method 6.0.0-alpha.4 → 6.0.0-alpha.6

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 (225) hide show
  1. package/.claude/agents/bmad-analysis/api-documenter.md +102 -0
  2. package/.claude/agents/bmad-analysis/codebase-analyzer.md +82 -0
  3. package/.claude/agents/bmad-analysis/data-analyst.md +101 -0
  4. package/.claude/agents/bmad-analysis/pattern-detector.md +84 -0
  5. package/.claude/agents/bmad-planning/dependency-mapper.md +83 -0
  6. package/.claude/agents/bmad-planning/epic-optimizer.md +81 -0
  7. package/.claude/agents/bmad-planning/requirements-analyst.md +61 -0
  8. package/.claude/agents/bmad-planning/technical-decisions-curator.md +168 -0
  9. package/.claude/agents/bmad-planning/trend-spotter.md +115 -0
  10. package/.claude/agents/bmad-planning/user-journey-mapper.md +123 -0
  11. package/.claude/agents/bmad-planning/user-researcher.md +72 -0
  12. package/.claude/agents/bmad-research/market-researcher.md +51 -0
  13. package/.claude/agents/bmad-research/tech-debt-auditor.md +106 -0
  14. package/.claude/agents/bmad-review/document-reviewer.md +102 -0
  15. package/.claude/agents/bmad-review/technical-evaluator.md +68 -0
  16. package/.claude/agents/bmad-review/test-coverage-analyzer.md +108 -0
  17. package/.claude/commands/bmad/bmm/agents/architect.md +0 -1
  18. package/.claude/commands/bmad/bmm/agents/sm.md +1 -1
  19. package/.claude/commands/bmad/bmm/agents/{paige.md → tech-writer.md} +3 -3
  20. package/.claude/commands/bmad/bmm/workflows/README.md +3 -3
  21. package/.claude/commands/bmad/bmm/workflows/epic-tech-context.md +15 -0
  22. package/.claude/commands/bmad/bmm/workflows/prd.md +1 -1
  23. package/.claude/commands/bmad/bmm/workflows/tech-spec.md +3 -3
  24. package/.claude/settings.local.json +3 -8
  25. package/CHANGELOG.md +305 -0
  26. package/CONTRIBUTING.md +1 -13
  27. package/README.md +88 -39
  28. package/bmad/_cfg/agent-manifest.csv +1 -6
  29. package/bmad/_cfg/files-manifest.csv +40 -114
  30. package/bmad/_cfg/ides/claude-code.yaml +4 -3
  31. package/bmad/_cfg/manifest.yaml +3 -4
  32. package/bmad/_cfg/task-manifest.csv +0 -1
  33. package/bmad/_cfg/workflow-manifest.csv +3 -7
  34. package/bmad/bmb/config.yaml +2 -2
  35. package/bmad/bmb/workflows/audit-workflow/instructions.md +1 -1
  36. package/bmad/bmm/README.md +79 -120
  37. package/bmad/bmm/agents/architect.md +0 -1
  38. package/bmad/bmm/agents/sm.md +1 -1
  39. package/bmad/bmm/agents/{paige.md → tech-writer.md} +3 -3
  40. package/bmad/bmm/config.yaml +4 -3
  41. package/bmad/bmm/tasks/daily-standup.xml +1 -1
  42. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/instructions.md +1 -19
  43. package/bmad/bmm/workflows/2-plan-workflows/prd/checklist.md +10 -9
  44. package/bmad/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/epics-template.md +23 -34
  45. package/bmad/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/instructions.md +105 -331
  46. package/bmad/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/workflow.yaml +23 -11
  47. package/bmad/bmm/workflows/2-plan-workflows/prd/instructions.md +23 -38
  48. package/bmad/bmm/workflows/2-plan-workflows/prd/workflow.yaml +1 -1
  49. package/bmad/bmm/workflows/2-plan-workflows/tech-spec/epics-template.md +38 -16
  50. package/bmad/bmm/workflows/2-plan-workflows/tech-spec/instructions.md +1 -19
  51. package/bmad/bmm/workflows/2-plan-workflows/tech-spec/user-story-template.md +35 -32
  52. package/bmad/bmm/workflows/2-plan-workflows/tech-spec/workflow.yaml +2 -2
  53. package/bmad/bmm/workflows/3-solutioning/architecture/instructions.md +7 -18
  54. package/bmad/bmm/workflows/3-solutioning/solutioning-gate-check/instructions.md +1 -18
  55. package/bmad/bmm/workflows/3-solutioning/solutioning-gate-check/workflow.yaml +6 -6
  56. package/bmad/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml +1 -1
  57. package/bmad/bmm/workflows/techdoc/documentation-standards.md +26 -2
  58. package/bmad/bmm/workflows/testarch/atdd/atdd-checklist-template.md +2 -2
  59. package/bmad/bmm/workflows/workflow-status/init/instructions.md +623 -242
  60. package/bmad/bmm/workflows/workflow-status/paths/enterprise-brownfield.yaml +120 -0
  61. package/bmad/bmm/workflows/workflow-status/paths/enterprise-greenfield.yaml +108 -0
  62. package/bmad/bmm/workflows/workflow-status/paths/{brownfield-level-3.yaml → method-brownfield.yaml} +33 -31
  63. package/{src/modules/bmm/workflows/workflow-status/paths/greenfield-level-2.yaml → bmad/bmm/workflows/workflow-status/paths/method-greenfield.yaml} +31 -21
  64. package/bmad/bmm/workflows/workflow-status/paths/{brownfield-level-1.yaml → quick-flow-brownfield.yaml} +18 -18
  65. package/bmad/bmm/workflows/workflow-status/paths/{greenfield-level-1.yaml → quick-flow-greenfield.yaml} +16 -18
  66. package/bmad/bmm/workflows/workflow-status/workflow-status-template.yaml +4 -4
  67. package/bmad/core/config.yaml +2 -2
  68. package/bmad/core/tasks/workflow.xml +1 -11
  69. package/package.json +1 -1
  70. package/src/core/tasks/workflow.xml +1 -11
  71. package/src/modules/bmb/workflows/audit-workflow/instructions.md +1 -1
  72. package/src/modules/bmm/README.md +1 -1
  73. package/src/modules/bmm/_module-installer/install-config.yaml +5 -0
  74. package/src/modules/bmm/agents/architect.agent.yaml +0 -4
  75. package/src/modules/bmm/agents/game-dev.agent.yaml +8 -12
  76. package/src/modules/bmm/agents/sm.agent.yaml +1 -1
  77. package/src/modules/bmm/agents/{paige.agent.yaml → tech-writer.agent.yaml} +4 -4
  78. package/src/modules/bmm/docs/README.md +19 -18
  79. package/src/modules/bmm/docs/agents-guide.md +47 -99
  80. package/src/modules/bmm/docs/brownfield-guide.md +216 -96
  81. package/src/modules/bmm/docs/enterprise-agentic-development.md +380 -740
  82. package/src/modules/bmm/docs/faq.md +16 -16
  83. package/src/modules/bmm/docs/glossary.md +44 -50
  84. package/src/modules/bmm/docs/party-mode.md +110 -1122
  85. package/src/modules/bmm/docs/quick-spec-flow.md +36 -36
  86. package/src/modules/bmm/docs/quick-start.md +34 -34
  87. package/src/modules/bmm/docs/scale-adaptive-system.md +304 -454
  88. package/{bmad/bmm/testarch/README.md → src/modules/bmm/docs/test-architecture.md} +56 -38
  89. package/src/modules/bmm/docs/troubleshooting.md +7 -7
  90. package/src/modules/bmm/docs/workflows-analysis.md +64 -28
  91. package/src/modules/bmm/docs/workflows-implementation.md +196 -1671
  92. package/src/modules/bmm/docs/workflows-planning.md +74 -35
  93. package/src/modules/bmm/docs/workflows-solutioning.md +47 -17
  94. package/src/modules/bmm/tasks/daily-standup.xml +1 -1
  95. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/instructions.md +1 -19
  96. package/src/modules/bmm/workflows/2-plan-workflows/prd/checklist.md +10 -9
  97. package/src/modules/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/epics-template.md +23 -34
  98. package/src/modules/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/instructions.md +105 -331
  99. package/src/modules/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/workflow.yaml +23 -11
  100. package/src/modules/bmm/workflows/2-plan-workflows/prd/instructions.md +23 -38
  101. package/src/modules/bmm/workflows/2-plan-workflows/prd/workflow.yaml +2 -2
  102. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/epics-template.md +38 -16
  103. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/instructions.md +1 -19
  104. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/user-story-template.md +35 -32
  105. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/workflow.yaml +2 -2
  106. package/src/modules/bmm/workflows/3-solutioning/architecture/instructions.md +7 -18
  107. package/src/modules/bmm/workflows/3-solutioning/solutioning-gate-check/instructions.md +1 -18
  108. package/src/modules/bmm/workflows/3-solutioning/solutioning-gate-check/workflow.yaml +6 -6
  109. package/src/modules/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml +1 -1
  110. package/src/modules/bmm/workflows/techdoc/documentation-standards.md +25 -2
  111. package/src/modules/bmm/workflows/testarch/atdd/atdd-checklist-template.md +2 -2
  112. package/src/modules/bmm/workflows/workflow-status/init/instructions.md +623 -242
  113. package/src/modules/bmm/workflows/workflow-status/paths/enterprise-brownfield.yaml +120 -0
  114. package/src/modules/bmm/workflows/workflow-status/paths/enterprise-greenfield.yaml +108 -0
  115. package/src/modules/bmm/workflows/workflow-status/paths/{brownfield-level-3.yaml → method-brownfield.yaml} +33 -31
  116. package/{bmad/bmm/workflows/workflow-status/paths/greenfield-level-2.yaml → src/modules/bmm/workflows/workflow-status/paths/method-greenfield.yaml} +31 -21
  117. package/src/modules/bmm/workflows/workflow-status/paths/{brownfield-level-1.yaml → quick-flow-brownfield.yaml} +18 -18
  118. package/src/modules/bmm/workflows/workflow-status/paths/{greenfield-level-1.yaml → quick-flow-greenfield.yaml} +16 -18
  119. package/src/modules/bmm/workflows/workflow-status/workflow-status-template.yaml +4 -4
  120. package/tools/cli/installers/lib/core/config-collector.js +39 -11
  121. package/tools/cli/installers/lib/core/ide-config-manager.js +3 -1
  122. package/tools/cli/installers/lib/core/installer.js +20 -9
  123. package/tools/cli/installers/lib/core/manifest-generator.js +3 -1
  124. package/tools/cli/installers/lib/core/manifest.js +6 -2
  125. package/tools/cli/installers/lib/modules/manager.js +6 -0
  126. package/tools/cli/lib/config.js +3 -1
  127. package/tools/cli/lib/ui.js +5 -5
  128. package/tools/cli/lib/yaml-format.js +2 -1
  129. package/tools/schema/agent.js +2 -0
  130. package/.claude/commands/bmad/bmm/workflows/tech-spec-sm.md +0 -15
  131. package/bmad/_cfg/agents/cis-brainstorming-coach.customize.yaml +0 -42
  132. package/bmad/_cfg/agents/cis-creative-problem-solver.customize.yaml +0 -42
  133. package/bmad/_cfg/agents/cis-design-thinking-coach.customize.yaml +0 -42
  134. package/bmad/_cfg/agents/cis-innovation-strategist.customize.yaml +0 -42
  135. package/bmad/_cfg/agents/cis-storyteller.customize.yaml +0 -42
  136. package/bmad/bmb/agents/bmad-builder.md.bak +0 -70
  137. package/bmad/bmb/workflows/audit-workflow/workflow.yaml.bak +0 -23
  138. package/bmad/bmb/workflows/create-module/workflow.yaml.bak +0 -42
  139. package/bmad/bmb/workflows/create-workflow/workflow-template/workflow.yaml.bak +0 -39
  140. package/bmad/bmb/workflows/create-workflow/workflow.yaml.bak +0 -40
  141. package/bmad/bmb/workflows/edit-agent/workflow.yaml.bak +0 -33
  142. package/bmad/bmb/workflows/edit-module/workflow.yaml.bak +0 -34
  143. package/bmad/bmb/workflows/edit-workflow/workflow.yaml.bak +0 -27
  144. package/bmad/bmb/workflows/module-brief/workflow.yaml.bak +0 -29
  145. package/bmad/bmb/workflows/redoc/workflow.yaml.bak +0 -32
  146. package/bmad/bmm/docs/brownfield-guide.md +0 -1260
  147. package/bmad/bmm/docs/quick-spec-flow.md +0 -645
  148. package/bmad/bmm/docs/quick-start.md +0 -341
  149. package/bmad/bmm/docs/scale-adaptive-system.md +0 -1045
  150. package/bmad/bmm/tasks/retrospective.xml +0 -104
  151. package/bmad/bmm/workflows/1-analysis/brainstorm-project/README.md +0 -113
  152. package/bmad/bmm/workflows/1-analysis/product-brief/README.md +0 -180
  153. package/bmad/bmm/workflows/1-analysis/research/README.md +0 -454
  154. package/bmad/bmm/workflows/2-plan-workflows/README.md +0 -258
  155. package/bmad/bmm/workflows/3-solutioning/README.md +0 -1
  156. package/bmad/bmm/workflows/3-solutioning/architecture/README.md +0 -318
  157. package/bmad/bmm/workflows/3-solutioning/solutioning-gate-check/README.md +0 -177
  158. package/bmad/bmm/workflows/4-implementation/README.md +0 -221
  159. package/bmad/bmm/workflows/4-implementation/code-review/README.md +0 -69
  160. package/bmad/bmm/workflows/4-implementation/correct-course/README.md +0 -73
  161. package/bmad/bmm/workflows/4-implementation/create-story/README.md +0 -146
  162. package/bmad/bmm/workflows/4-implementation/dev-story/README.md +0 -206
  163. package/bmad/bmm/workflows/4-implementation/epic-tech-context/README.md +0 -195
  164. package/bmad/bmm/workflows/4-implementation/retrospective/README.md +0 -77
  165. package/bmad/bmm/workflows/4-implementation/sprint-planning/README.md +0 -156
  166. package/bmad/bmm/workflows/4-implementation/story-context/README.md +0 -234
  167. package/bmad/bmm/workflows/README.md +0 -256
  168. package/bmad/bmm/workflows/document-project/README.md +0 -444
  169. package/bmad/bmm/workflows/document-project/templates/README.md +0 -38
  170. package/bmad/bmm/workflows/testarch/README.md +0 -26
  171. package/bmad/bmm/workflows/testarch/atdd/README.md +0 -672
  172. package/bmad/bmm/workflows/testarch/automate/README.md +0 -869
  173. package/bmad/bmm/workflows/testarch/ci/README.md +0 -493
  174. package/bmad/bmm/workflows/testarch/framework/README.md +0 -340
  175. package/bmad/bmm/workflows/testarch/nfr-assess/README.md +0 -469
  176. package/bmad/bmm/workflows/testarch/test-design/README.md +0 -493
  177. package/bmad/bmm/workflows/testarch/test-review/README.md +0 -775
  178. package/bmad/bmm/workflows/testarch/trace/README.md +0 -802
  179. package/bmad/bmm/workflows/workflow-status/README.md +0 -260
  180. package/bmad/bmm/workflows/workflow-status/paths/brownfield-level-0.yaml +0 -54
  181. package/bmad/bmm/workflows/workflow-status/paths/brownfield-level-2.yaml +0 -76
  182. package/bmad/bmm/workflows/workflow-status/paths/brownfield-level-4.yaml +0 -88
  183. package/bmad/bmm/workflows/workflow-status/paths/greenfield-level-0.yaml +0 -45
  184. package/bmad/bmm/workflows/workflow-status/paths/greenfield-level-3.yaml +0 -73
  185. package/bmad/bmm/workflows/workflow-status/paths/greenfield-level-4.yaml +0 -75
  186. package/bmad/cis/README.md +0 -153
  187. package/bmad/cis/agents/README.md +0 -104
  188. package/bmad/cis/agents/brainstorming-coach.md +0 -62
  189. package/bmad/cis/agents/creative-problem-solver.md +0 -62
  190. package/bmad/cis/agents/design-thinking-coach.md +0 -62
  191. package/bmad/cis/agents/innovation-strategist.md +0 -62
  192. package/bmad/cis/agents/storyteller.md +0 -59
  193. package/bmad/cis/config.yaml +0 -10
  194. package/bmad/cis/teams/creative-squad.yaml +0 -6
  195. package/bmad/cis/workflows/README.md +0 -139
  196. package/bmad/cis/workflows/design-thinking/README.md +0 -56
  197. package/bmad/cis/workflows/design-thinking/design-methods.csv +0 -31
  198. package/bmad/cis/workflows/design-thinking/instructions.md +0 -200
  199. package/bmad/cis/workflows/design-thinking/template.md +0 -111
  200. package/bmad/cis/workflows/design-thinking/workflow.yaml +0 -32
  201. package/bmad/cis/workflows/innovation-strategy/README.md +0 -56
  202. package/bmad/cis/workflows/innovation-strategy/innovation-frameworks.csv +0 -31
  203. package/bmad/cis/workflows/innovation-strategy/instructions.md +0 -274
  204. package/bmad/cis/workflows/innovation-strategy/template.md +0 -189
  205. package/bmad/cis/workflows/innovation-strategy/workflow.yaml +0 -32
  206. package/bmad/cis/workflows/problem-solving/README.md +0 -56
  207. package/bmad/cis/workflows/problem-solving/instructions.md +0 -250
  208. package/bmad/cis/workflows/problem-solving/solving-methods.csv +0 -31
  209. package/bmad/cis/workflows/problem-solving/template.md +0 -165
  210. package/bmad/cis/workflows/problem-solving/workflow.yaml +0 -32
  211. package/bmad/cis/workflows/storytelling/README.md +0 -58
  212. package/bmad/cis/workflows/storytelling/instructions.md +0 -291
  213. package/bmad/cis/workflows/storytelling/story-types.csv +0 -26
  214. package/bmad/cis/workflows/storytelling/template.md +0 -113
  215. package/bmad/cis/workflows/storytelling/workflow.yaml +0 -32
  216. package/bmad/core/agents/bmad-master.md.bak +0 -69
  217. package/src/modules/bmm/docs/brownfield-guide.md.backup +0 -1324
  218. package/src/modules/bmm/docs/workflows-testing.md +0 -1572
  219. package/src/modules/bmm/workflows/workflow-status/paths/brownfield-level-0.yaml +0 -54
  220. package/src/modules/bmm/workflows/workflow-status/paths/brownfield-level-2.yaml +0 -76
  221. package/src/modules/bmm/workflows/workflow-status/paths/brownfield-level-4.yaml +0 -88
  222. package/src/modules/bmm/workflows/workflow-status/paths/greenfield-level-0.yaml +0 -45
  223. package/src/modules/bmm/workflows/workflow-status/paths/greenfield-level-3.yaml +0 -73
  224. package/src/modules/bmm/workflows/workflow-status/paths/greenfield-level-4.yaml +0 -75
  225. /package/bmad/_cfg/agents/{bmm-paige.customize.yaml → bmm-tech-writer.customize.yaml} +0 -0
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://json.schemastore.org/package.json",
3
3
  "name": "bmad-method",
4
- "version": "6.0.0-alpha.4",
4
+ "version": "6.0.0-alpha.6",
5
5
  "description": "Breakthrough Method of Agile AI-driven Development",
6
6
  "keywords": [
7
7
  "agile",
@@ -13,8 +13,7 @@
13
13
  <rule n="1">Steps execute in exact numerical order (1, 2, 3...)</rule>
14
14
  <rule n="2">Optional steps: Ask user unless #yolo mode active</rule>
15
15
  <rule n="3">Template-output tags: Save content → Show user → Get approval before continuing</rule>
16
- <rule n="4">Elicit tags: Execute immediately unless #yolo mode (which skips ALL elicitation)</rule>
17
- <rule n="5">User must approve each major section before continuing UNLESS #yolo mode active</rule>
16
+ <rule n="4">User must approve each major section before continuing UNLESS #yolo mode active</rule>
18
17
  </WORKFLOW-RULES>
19
18
 
20
19
  <flow>
@@ -75,14 +74,6 @@
75
74
  <action>Display generated content</action>
76
75
  <ask>Continue [c] or Edit [e]? WAIT for response</ask>
77
76
  </if>
78
-
79
- <if tag="elicit-required">
80
- <mandate critical="true">YOU MUST READ the file at {project-root}/bmad/core/tasks/adv-elicit.xml using Read tool BEFORE presenting
81
- any elicitation menu</mandate>
82
- <action>Load and run task {project-root}/bmad/core/tasks/adv-elicit.xml with current context</action>
83
- <action>Show elicitation menu 5 relevant options (list 1-5 options, Continue [c] or Reshuffle [r])</action>
84
- <mandate>HALT and WAIT for user selection</mandate>
85
- </if>
86
77
  </substep>
87
78
 
88
79
  <substep n="2d" title="Step Completion">
@@ -123,7 +114,6 @@
123
114
  </execution>
124
115
  <output>
125
116
  <tag>template-output - Save content checkpoint</tag>
126
- <tag>elicit-required - Trigger enhancement</tag>
127
117
  <tag>critical - Cannot be skipped</tag>
128
118
  <tag>example - Show example output</tag>
129
119
  </output>
@@ -161,7 +161,7 @@
161
161
  <action if="condition met">Do something</action>
162
162
  ```
163
163
 
164
- <action>Scan instructions.md for nested tag references using pattern: &lt;(action|ask|check|template-output|invoke-workflow|goto|step|elicit-required)&gt; within text content</action>
164
+ <action>Scan instructions.md for nested tag references using pattern: &lt;(action|ask|check|template-output|invoke-workflow|invoke-task|goto|step)&gt; within text content</action>
165
165
  <action>Record any instances of nested tag references with line numbers</action>
166
166
  <action>Scan instructions.md for conditional execution antipattern: self-closing check tags</action>
167
167
  <action>Detect pattern: `&lt;check&gt;.*&lt;/check&gt;` on single line (self-closing check)</action>
@@ -34,7 +34,7 @@ bmm/
34
34
 
35
35
  ### Agent Roster
36
36
 
37
- **Core Development:** PM, Analyst, Architect, SM, DEV, TEA, UX Designer, Paige
37
+ **Core Development:** PM, Analyst, Architect, SM, DEV, TEA, UX Designer, Technical Writer
38
38
  **Game Development:** Game Designer, Game Developer, Game Architect
39
39
  **Orchestration:** BMad Master (from Core)
40
40
 
@@ -49,6 +49,11 @@ dev_story_location:
49
49
  default: "docs/stories"
50
50
  result: "{project-root}/{value}"
51
51
 
52
+ install_user_docs:
53
+ prompt: "Install user documentation to project directory?"
54
+ default: true
55
+ result: "{value}"
56
+
52
57
  # TEA Agent Configuration
53
58
  tea_use_mcp_enhancements:
54
59
  prompt: "Enable Playwright MCP capabilities (healing, exploratory, verification)?"
@@ -22,10 +22,6 @@ agent:
22
22
  workflow: "{project-root}/bmad/bmm/workflows/workflow-status/workflow.yaml"
23
23
  description: Check workflow status and get recommendations
24
24
 
25
- - trigger: correct-course
26
- workflow: "{project-root}/bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml"
27
- description: Course Correction Analysis
28
-
29
25
  - trigger: create-architecture
30
26
  workflow: "{project-root}/bmad/bmm/workflows/3-solutioning/architecture/workflow.yaml"
31
27
  description: Produce a Scale Adaptive Architecture
@@ -20,20 +20,16 @@ agent:
20
20
  menu:
21
21
  - trigger: workflow-status
22
22
  workflow: "{project-root}/bmad/bmm/workflows/workflow-status/workflow.yaml"
23
- description: Check workflow status and get recommendations
23
+ description: "Check workflow status and get recommendations"
24
24
 
25
- - trigger: create-story
26
- workflow: "{project-root}/bmad/bmm/workflows/4-implementation/create-story/workflow.yaml"
27
- description: Create Development Story
28
-
29
- - trigger: dev-story
25
+ - trigger: develop-story
30
26
  workflow: "{project-root}/bmad/bmm/workflows/4-implementation/dev-story/workflow.yaml"
31
- description: Implement Story with Context
27
+ description: "Execute Dev Story workflow, implementing tasks and tests, or performing updates to the story"
28
+
29
+ - trigger: story-done
30
+ workflow: "{project-root}/bmad/bmm/workflows/4-implementation/story-done/workflow.yaml"
31
+ description: "Mark story done after DoD complete"
32
32
 
33
33
  - trigger: code-review
34
34
  workflow: "{project-root}/bmad/bmm/workflows/4-implementation/code-review/workflow.yaml"
35
- description: Review Story Implementation
36
-
37
- - trigger: retro
38
- workflow: "{project-root}/bmad/bmm/workflows/4-implementation/retrospective/workflow.yaml"
39
- description: Sprint Retrospective
35
+ description: "Perform a thorough clean context QA code review on a story flagged Ready for Review"
@@ -31,7 +31,7 @@ agent:
31
31
 
32
32
  - trigger: epic-tech-context
33
33
  workflow: "{project-root}/bmad/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml"
34
- description: (Optional) Use the PRD and Architecture to create a Tech-Spec for a specific epic
34
+ description: (Optional) Use the PRD and Architecture to create a Epic-Tech-Spec for a specific epic
35
35
 
36
36
  - trigger: validate-epic-tech-context
37
37
  validate-workflow: "{project-root}/bmad/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml"
@@ -1,10 +1,10 @@
1
- # Paige - Documentation Guide Agent Definition
1
+ # Technical Writer - Documentation Guide Agent Definition
2
2
 
3
3
  agent:
4
4
  metadata:
5
- id: bmad/bmm/agents/paige.md
6
- name: Paige
7
- title: Documentation Guide
5
+ id: bmad/bmm/agents/tech-writer.md
6
+ name: paige
7
+ title: Technical Writer
8
8
  icon: 📚
9
9
  module: bmm
10
10
 
@@ -23,12 +23,12 @@ Complete guides for the BMad Method Module (BMM) - AI-powered agile development
23
23
  Understanding how BMM adapts to your needs:
24
24
 
25
25
  - **[Scale Adaptive System](./scale-adaptive-system.md)** - How BMM adapts to project size and complexity (42 min read)
26
- - The five complexity levels (0-4)
27
- - Automatic level detection
28
- - Documentation requirements per level
26
+ - Three planning tracks (Quick Flow, BMad Method, Enterprise Method)
27
+ - Automatic track recommendation
28
+ - Documentation requirements per track
29
29
  - Planning workflow routing
30
30
 
31
- - **[Quick Spec Flow](./quick-spec-flow.md)** - Fast-track workflow for Level 0-1 projects (26 min read)
31
+ - **[Quick Spec Flow](./quick-spec-flow.md)** - Fast-track workflow for Quick Flow track (26 min read)
32
32
  - Bug fixes and small features
33
33
  - Rapid prototyping approach
34
34
  - Auto-detection of stack and patterns
@@ -36,7 +36,7 @@ Understanding how BMM adapts to your needs:
36
36
 
37
37
  ---
38
38
 
39
- ## 🤖 Agents & Collaboration
39
+ ## 🤖 Agents and Collaboration
40
40
 
41
41
  Complete guide to BMM's AI agent team:
42
42
 
@@ -62,7 +62,7 @@ Comprehensive guide for brownfield development:
62
62
 
63
63
  - **[Brownfield Development Guide](./brownfield-guide.md)** - Complete guide for existing codebases (53 min read)
64
64
  - Documentation phase strategies
65
- - Level detection for brownfield
65
+ - Track selection for brownfield
66
66
  - Integration with existing patterns
67
67
  - Phase-by-phase workflow guidance
68
68
  - Common scenarios and troubleshooting
@@ -86,7 +86,7 @@ Essential reference materials:
86
86
 
87
87
  **Build something new (greenfield)**
88
88
  → Start with [Quick Start Guide](./quick-start.md)
89
- → Then review [Scale Adaptive System](./scale-adaptive-system.md) to understand levels
89
+ → Then review [Scale Adaptive System](./scale-adaptive-system.md) to understand tracks
90
90
 
91
91
  **Fix a bug or add small feature**
92
92
  → Go directly to [Quick Spec Flow](./quick-spec-flow.md)
@@ -95,7 +95,7 @@ Essential reference materials:
95
95
  → Read [Brownfield Development Guide](./brownfield-guide.md)
96
96
  → Pay special attention to Phase 0 documentation requirements
97
97
 
98
- **Understand project complexity levels**
98
+ **Understand planning tracks and methodology**
99
99
  → See [Scale Adaptive System](./scale-adaptive-system.md)
100
100
 
101
101
  **Find specific commands or answers**
@@ -114,12 +114,12 @@ Comprehensive documentation for all BMM workflows organized by phase:
114
114
 
115
115
  - **[Phase 2: Planning Workflows](./workflows-planning.md)** - Scale-adaptive planning (967 lines)
116
116
  - prd, tech-spec, gdd, narrative, ux
117
- - Level 0-4 planning approach
117
+ - Track-based planning approach (Quick Flow, BMad Method, Enterprise Method)
118
118
  - Which planning workflow to use
119
119
 
120
120
  - **[Phase 3: Solutioning Workflows](./workflows-solutioning.md)** - Architecture and validation (638 lines)
121
121
  - architecture, solutioning-gate-check
122
- - Required for Level 3-4 projects
122
+ - Required for BMad Method and Enterprise Method tracks
123
123
  - Preventing agent conflicts
124
124
 
125
125
  - **[Phase 4: Implementation Workflows](./workflows-implementation.md)** - Sprint-based development (1,634 lines)
@@ -127,7 +127,7 @@ Comprehensive documentation for all BMM workflows organized by phase:
127
127
  - Complete story lifecycle
128
128
  - One-story-at-a-time discipline
129
129
 
130
- - **[Testing & QA Workflows](./workflows-testing.md)** - Comprehensive quality assurance (1,420 lines)
130
+ - **[Testing & QA Workflows](./test-architecture.md)** - Comprehensive quality assurance (1,420 lines)
131
131
  - Test strategy, automation, quality gates
132
132
  - TEA agent and test healing
133
133
  - BMad-integrated vs standalone modes
@@ -152,15 +152,16 @@ For detailed technical documentation on specific complex workflows:
152
152
 
153
153
  ---
154
154
 
155
- ## 🧪 Testing & Quality
155
+ ## 🧪 Testing and Quality
156
156
 
157
157
  Quality assurance guidance:
158
158
 
159
- - **[Test Architect Guide](../testarch/README.md)** - Comprehensive testing strategy
160
- - Test design workflows
161
- - Quality gates
162
- - Risk assessment
163
- - NFR validation
159
+ <!-- Test Architect documentation to be added -->
160
+
161
+ - Test design workflows
162
+ - Quality gates
163
+ - Risk assessment
164
+ - NFR validation
164
165
 
165
166
  ---
166
167
 
@@ -178,7 +179,7 @@ Understanding BMM components:
178
179
 
179
180
  ## 🌐 External Resources
180
181
 
181
- ### Community & Support
182
+ ### Community and Support
182
183
 
183
184
  - **[Discord Community](https://discord.gg/gk8jAdXWmj)** - Get help from the community (#general-dev, #bugs-issues)
184
185
  - **[GitHub Issues](https://github.com/bmad-code-org/BMAD-METHOD/issues)** - Report bugs or request features
@@ -37,7 +37,7 @@ The BMad Method Module (BMM) provides a comprehensive team of specialized AI age
37
37
  - DEV (Developer)
38
38
  - TEA (Test Architect)
39
39
  - UX Designer
40
- - Paige (Documentation Guide)
40
+ - Technical Writer
41
41
 
42
42
  **Game Development (3 agents):**
43
43
 
@@ -144,14 +144,9 @@ The BMad Method Module (BMM) provides a comprehensive team of specialized AI age
144
144
  **Workflows:**
145
145
 
146
146
  - `workflow-status` - Check what to do next
147
- - `create-architecture` - Decision-focused architecture with:
148
- - Starter template intelligence
149
- - Novel pattern design
150
- - Implementation patterns for agent consistency
151
- - Adaptive facilitation (beginner/expert)
147
+ - `create-architecture` - Produce a Scale Adaptive Architecture
152
148
  - `validate-architecture` - Validate architecture document
153
149
  - `solutioning-gate-check` - Validate readiness for Phase 4
154
- - `correct-course` - Handle technical changes
155
150
 
156
151
  **Communication Style:** Comprehensive yet pragmatic. Uses architectural metaphors. Balances technical depth with accessibility. Connects decisions to business value.
157
152
 
@@ -177,7 +172,7 @@ The BMad Method Module (BMM) provides a comprehensive team of specialized AI age
177
172
  - Sprint planning and tracking initialization
178
173
  - Creating user stories
179
174
  - Assembling dynamic story context
180
- - Epic-level technical specifications (optional)
175
+ - Epic-level technical context (optional)
181
176
  - Marking stories ready for development
182
177
  - Sprint retrospectives
183
178
 
@@ -187,8 +182,8 @@ The BMad Method Module (BMM) provides a comprehensive team of specialized AI age
187
182
 
188
183
  - `workflow-status` - Check what to do next
189
184
  - `sprint-planning` - Initialize `sprint-status.yaml` tracking
190
- - `epic-tech-context` - Optional epic-specific tech specs
191
- - `validate-epic-tech-context` - Validate epic tech spec
185
+ - `epic-tech-context` - Optional epic-specific technical context
186
+ - `validate-epic-tech-context` - Validate epic technical context
192
187
  - `create-story` - Draft next story from epic
193
188
  - `validate-create-story` - Independent story validation
194
189
  - `story-context` - Assemble dynamic technical context XML
@@ -231,7 +226,7 @@ The BMad Method Module (BMM) provides a comprehensive team of specialized AI age
231
226
  - Strict file boundary enforcement
232
227
  - `code-review` - Senior developer-level review with:
233
228
  - Story context awareness
234
- - Epic tech-spec alignment
229
+ - Epic-tech-context alignment
235
230
  - Repository docs reference
236
231
  - MCP server best practices
237
232
  - Web search fallback
@@ -300,12 +295,13 @@ The BMad Method Module (BMM) provides a comprehensive team of specialized AI age
300
295
  - Testing is feature work, not overhead
301
296
  - Prioritize unit/integration over E2E
302
297
  - Flakiness is critical technical debt
298
+ - ATDD tests first, AI implements, suite validates
303
299
 
304
300
  **Special Capabilities:**
305
301
 
306
- - **Test Healing:** Pattern-based + MCP-enhanced test fixing
307
- - **Dual Mode:** BMad-integrated (uses epic/story context) or standalone
308
- - **Knowledge Base:** Comprehensive testing best practices
302
+ - **Knowledge Base Access:** Consults comprehensive testing best practices from `testarch/knowledge/` directory
303
+ - **Framework Selection:** Smart framework selection (Playwright vs Cypress) with fixture architecture
304
+ - **Cross-Platform Testing:** Supports testing across web, mobile, and API layers
309
305
 
310
306
  ---
311
307
 
@@ -345,7 +341,7 @@ The BMad Method Module (BMM) provides a comprehensive team of specialized AI age
345
341
 
346
342
  ---
347
343
 
348
- ### Paige (Documentation Guide) - Paige 📚
344
+ ### Technical Writer - Paige 📚
349
345
 
350
346
  **Role:** Technical Documentation Specialist + Knowledge Curator
351
347
 
@@ -461,10 +457,9 @@ The BMad Method Module (BMM) provides a comprehensive team of specialized AI age
461
457
  **Workflows:**
462
458
 
463
459
  - `workflow-status` - Check what to do next
464
- - `create-story` - Create development story
465
- - `dev-story` - Implement story with tests
466
- - `code-review` - Review game implementation
467
- - `retro` - Sprint retrospective
460
+ - `develop-story` - Execute Dev Story workflow, implementing tasks and tests
461
+ - `story-done` - Mark story done after DoD complete
462
+ - `code-review` - Perform thorough clean context QA code review on a story
468
463
 
469
464
  **Communication Style:** Direct and energetic. Execution-focused. Breaks down complex game challenges into actionable steps. Celebrates performance wins.
470
465
 
@@ -555,71 +550,24 @@ The BMad Method Module (BMM) provides a comprehensive team of specialized AI age
555
550
 
556
551
  ## Party Mode: Multi-Agent Collaboration
557
552
 
558
- Party mode brings **all your installed agents together** for group discussions. Instead of working with one agent at a time, you engage with a dynamic team (19+ agents from BMM, CIS, BMB, and custom modules) that collaborates in real-time.
559
-
560
- ### Quick Overview
561
-
562
- **How to Start:**
563
-
564
- 1. Load BMad Master
565
- 2. Run `*party-mode`
566
- 3. Introduce your topic
567
-
568
- **What Happens:**
553
+ Get all your installed agents in one conversation for multi-perspective discussions, retrospectives, and collaborative decision-making.
569
554
 
570
- - BMad Master loads ALL agents (with customizations)
571
- - For each message, 2-3 most relevant agents respond
572
- - Agents cross-talk, debate, and build on each other's ideas
573
- - BMad Master moderates and keeps discussion productive
574
-
575
- **Best For:**
576
-
577
- - Strategic decisions with trade-offs
578
- - Creative brainstorming sessions
579
- - Cross-functional alignment meetings
580
- - Complex problem-solving
581
- - Epic kickoff discussions
555
+ **Quick Start:**
582
556
 
583
- **Example Parties:**
584
-
585
- - **Product Strategy:** PM + Innovation Strategist + Analyst
586
- - **Technical Design:** Architect + Game Architect + Creative Problem Solver
587
- - **User Experience:** UX Designer + Design Thinking Coach + Storyteller
588
- - **Quality & Testing:** TEA + Architect + DEV
589
- - **Full Team:** PM + Architect + SM + DEV
590
-
591
- ### Why Party Mode is Powerful
592
-
593
- **Diverse Perspectives:**
594
-
595
- - Technical agents ground ideas in reality
596
- - Creative agents (CIS) push for innovation
597
- - Strategic agents ensure market fit
598
-
599
- **Emergent Insights:**
600
-
601
- - Cross-pollination across domains
602
- - Novel solutions from unexpected combinations
603
- - Deeper exploration through debate
557
+ ```bash
558
+ /bmad:core:workflows:party-mode
559
+ # OR from any agent: *party-mode
560
+ ```
604
561
 
605
- **Natural Collaboration:**
562
+ **What happens:** BMad Master orchestrates 2-3 relevant agents per message. They discuss, debate, and collaborate in real-time.
606
563
 
607
- - Agents can agree, disagree, or build on each other
608
- - Healthy debate leads to better decisions
609
- - Multiple expert perspectives in one session
564
+ **Best for:** Strategic decisions, creative brainstorming, post-mortems, sprint retrospectives, complex problem-solving.
610
565
 
611
- **For complete party mode documentation, see:**
566
+ **Current BMM uses:** Powers `epic-retrospective` workflow, sprint planning discussions.
612
567
 
613
- 👉 **[Party Mode Guide](./party-mode.md)** - Comprehensive 20-minute guide covering:
568
+ **Future:** Advanced elicitation workflows will officially leverage party mode.
614
569
 
615
- - How party mode works (step-by-step process)
616
- - When to use party mode (strategic, creative, cross-functional, complex)
617
- - Getting started (quick start guide)
618
- - Agent selection dynamics
619
- - Multi-module integration (19+ agents)
620
- - 8+ example party compositions
621
- - Agent customization in party mode
622
- - Best practices and troubleshooting
570
+ 👉 **[Party Mode Guide](./party-mode.md)** - Complete guide with fun examples, tips, and troubleshooting
623
571
 
624
572
  ---
625
573
 
@@ -650,7 +598,7 @@ Some workflows are available to multiple agents:
650
598
  | `workflow-status` | ALL agents | Check current state and get recommendations |
651
599
  | `workflow-init` | PM, Analyst, Game Designer | Initialize workflow tracking |
652
600
  | `correct-course` | PM, Architect, SM, Game Architect | Change management during implementation |
653
- | `document-project` | Analyst, Paige | Brownfield documentation |
601
+ | `document-project` | Analyst, Technical Writer | Brownfield documentation |
654
602
 
655
603
  ### Validation Actions
656
604
 
@@ -662,7 +610,7 @@ Many workflows have optional validation workflows that perform independent revie
662
610
  | `validate-tech-spec` | PM | Technical specification quality |
663
611
  | `validate-architecture` | Architect | Architecture document |
664
612
  | `validate-design` | UX Designer | UX specification and artifacts |
665
- | `validate-epic-tech-context` | SM | Epic technical specification |
613
+ | `validate-epic-tech-context` | SM | Epic technical context |
666
614
  | `validate-create-story` | SM | Story draft |
667
615
  | `validate-story-context` | SM | Story context XML |
668
616
 
@@ -846,12 +794,12 @@ Load the customized agent and verify the changes are reflected in its behavior a
846
794
  - **Phase 3 (Solutioning):** Architect, Game Architect
847
795
  - **Phase 4 (Implementation):** SM, DEV, Game Developer
848
796
  - **Testing:** TEA (all phases)
849
- - **Documentation:** Paige (all phases)
797
+ - **Documentation:** Technical Writer (all phases)
850
798
 
851
799
  **3. Use specialists**
852
800
 
853
801
  - **Testing:** TEA for comprehensive quality strategy
854
- - **Documentation:** Paige for technical writing
802
+ - **Documentation:** Technical Writer for technical writing
855
803
  - **Games:** Game Designer/Developer/Architect for game-specific needs
856
804
  - **UX:** UX Designer for user-centered design
857
805
 
@@ -907,7 +855,7 @@ Load the customized agent and verify the changes are reflected in its behavior a
907
855
  **Starting with Existing Code (Brownfield):**
908
856
 
909
857
  ```
910
- 1. Analyst or Paige: *document-project
858
+ 1. Analyst or Technical Writer: *document-project
911
859
  2. PM or Analyst: *workflow-init
912
860
  3. PM: *create-prd or *tech-spec
913
861
  4. Architect: *create-architecture (if needed)
@@ -990,20 +938,20 @@ TEA can be invoked at any phase:
990
938
 
991
939
  Quick reference for agent selection:
992
940
 
993
- | Agent | Icon | Primary Phase | Key Workflows | Best For |
994
- | ------------------ | ---- | ------------------ | --------------------------------------------- | ------------------------------------- |
995
- | **Analyst** | 📊 | 1 (Analysis) | brainstorm, brief, research, document-project | Discovery, requirements, brownfield |
996
- | **PM** | 📋 | 2 (Planning) | prd, tech-spec, epics-stories | Planning, requirements docs |
997
- | **UX Designer** | 🎨 | 2 (Planning) | create-design, validate-design | UX-heavy projects, design |
998
- | **Architect** | 🏗️ | 3 (Solutioning) | architecture, gate-check | Technical design, architecture |
999
- | **SM** | 🏃 | 4 (Implementation) | sprint-planning, create-story, story-context | Story management, sprint coordination |
1000
- | **DEV** | 💻 | 4 (Implementation) | develop-story, code-review, story-done | Implementation, coding |
1001
- | **TEA** | 🧪 | All Phases | framework, atdd, automate, trace, ci | Testing, quality assurance |
1002
- | **Paige** | 📚 | All Phases | document-project, diagrams, validation | Documentation, diagrams |
1003
- | **Game Designer** | 🎲 | 1-2 (Games) | brainstorm-game, gdd, narrative | Game design, creative vision |
1004
- | **Game Developer** | 🕹️ | 4 (Games) | dev-story, code-review | Game implementation |
1005
- | **Game Architect** | 🏛️ | 3 (Games) | architecture, gate-check | Game systems architecture |
1006
- | **BMad Master** | 🧙 | Meta | party-mode, list tasks/workflows | Orchestration, multi-agent |
941
+ | Agent | Icon | Primary Phase | Key Workflows | Best For |
942
+ | ----------------------- | ---- | ------------------ | --------------------------------------------- | ------------------------------------- |
943
+ | **Analyst** | 📊 | 1 (Analysis) | brainstorm, brief, research, document-project | Discovery, requirements, brownfield |
944
+ | **PM** | 📋 | 2 (Planning) | prd, tech-spec, epics-stories | Planning, requirements docs |
945
+ | **UX Designer** | 🎨 | 2 (Planning) | create-design, validate-design | UX-heavy projects, design |
946
+ | **Architect** | 🏗️ | 3 (Solutioning) | architecture, gate-check | Technical design, architecture |
947
+ | **SM** | 🏃 | 4 (Implementation) | sprint-planning, create-story, story-context | Story management, sprint coordination |
948
+ | **DEV** | 💻 | 4 (Implementation) | develop-story, code-review, story-done | Implementation, coding |
949
+ | **TEA** | 🧪 | All Phases | framework, atdd, automate, trace, ci | Testing, quality assurance |
950
+ | **Paige (Tech Writer)** | 📚 | All Phases | document-project, diagrams, validation | Documentation, diagrams |
951
+ | **Game Designer** | 🎲 | 1-2 (Games) | brainstorm-game, gdd, narrative | Game design, creative vision |
952
+ | **Game Developer** | 🕹️ | 4 (Games) | develop-story, story-done, code-review | Game implementation |
953
+ | **Game Architect** | 🏛️ | 3 (Games) | architecture, gate-check | Game systems architecture |
954
+ | **BMad Master** | 🧙 | Meta | party-mode, list tasks/workflows | Orchestration, multi-agent |
1007
955
 
1008
956
  ### Agent Capabilities Summary
1009
957
 
@@ -1032,7 +980,7 @@ Quick reference for agent selection:
1032
980
  **Support Agents (2):**
1033
981
 
1034
982
  - Analyst: Research and discovery
1035
- - Paige: Documentation and diagrams
983
+ - Technical Writer: Documentation and diagrams
1036
984
 
1037
985
  **Meta Agent (1):**
1038
986
 
@@ -1048,7 +996,7 @@ Quick reference for agent selection:
1048
996
  - [Phase 2: Planning Workflows](./workflows-planning.md)
1049
997
  - [Phase 3: Solutioning Workflows](./workflows-solutioning.md)
1050
998
  - [Phase 4: Implementation Workflows](./workflows-implementation.md)
1051
- - [Testing & QA Workflows](./workflows-testing.md)
999
+ <!-- Testing & QA Workflows documentation to be added -->
1052
1000
 
1053
1001
  **Advanced References:**
1054
1002
 
@@ -1083,7 +1031,7 @@ Quick reference for agent selection:
1083
1031
  **Starting a Project:**
1084
1032
 
1085
1033
  - [ ] Determine project type (greenfield vs brownfield)
1086
- - [ ] If brownfield: Run `*document-project` (Analyst or Paige)
1034
+ - [ ] If brownfield: Run `*document-project` (Analyst or Technical Writer)
1087
1035
  - [ ] Load PM or Analyst → `*workflow-init`
1088
1036
  - [ ] Follow phase-appropriate workflows
1089
1037
  - [ ] Try `*party-mode` for strategic decisions