bmad-method 6.0.0-alpha.20 → 6.0.0-alpha.22

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 (521) hide show
  1. package/.vscode/settings.json +1 -0
  2. package/CHANGELOG.md +250 -0
  3. package/README.md +29 -37
  4. package/docs/bmad-core-concepts/agents.md +93 -0
  5. package/docs/{agent-customization-guide.md → bmad-core-concepts/bmad-customization/agents.md} +6 -4
  6. package/docs/bmad-core-concepts/bmad-customization/index.md +26 -0
  7. package/docs/bmad-core-concepts/bmad-customization/workflows.md +30 -0
  8. package/docs/bmad-core-concepts/index.md +37 -0
  9. package/docs/bmad-core-concepts/installing/index.md +77 -0
  10. package/docs/bmad-core-concepts/installing/upgrading.md +144 -0
  11. package/docs/bmad-core-concepts/modules.md +76 -0
  12. package/docs/bmad-core-concepts/web-bundles/index.md +34 -0
  13. package/docs/bmad-core-concepts/workflows.md +89 -0
  14. package/docs/index.md +60 -92
  15. package/docs/modules/bmb-bmad-builder/agent-creation-guide.md +166 -0
  16. package/docs/{custom-content-installation.md → modules/bmb-bmad-builder/custom-content-installation.md} +7 -7
  17. package/docs/{custom-content.md → modules/bmb-bmad-builder/custom-content.md} +4 -5
  18. package/{src/modules/bmb/docs/agents → docs/modules/bmb-bmad-builder}/index.md +7 -2
  19. package/docs/modules/bmb-bmad-builder/workflow-vendoring-customization-inheritance.md +42 -0
  20. package/{src/modules/bmgd/docs → docs/modules/bmgd-bmad-game-dev}/glossary.md +0 -1
  21. package/{src/modules/bmgd/docs → docs/modules/bmgd-bmad-game-dev}/index.md +0 -5
  22. package/{src/modules/bmgd/docs → docs/modules/bmgd-bmad-game-dev}/workflows-guide.md +6 -6
  23. package/{src/modules/bmm/docs → docs/modules/bmm-bmad-method}/brownfield-guide.md +0 -1
  24. package/{src/modules/bmm/docs → docs/modules/bmm-bmad-method}/faq.md +0 -2
  25. package/{src/modules/bmm/docs → docs/modules/bmm-bmad-method}/index.md +12 -50
  26. package/{src/modules/bmm/docs → docs/modules/bmm-bmad-method}/party-mode.md +5 -115
  27. package/{src/modules/bmm/docs → docs/modules/bmm-bmad-method}/quick-spec-flow.md +4 -20
  28. package/{src/modules/bmm/docs → docs/modules/bmm-bmad-method}/quick-start.md +2 -5
  29. package/{src/modules/bmm/docs → docs/modules/bmm-bmad-method}/test-architecture.md +19 -23
  30. package/docs/modules/bmm-bmad-method/troubleshooting.md +3 -0
  31. package/docs/modules/bmm-bmad-method/workflow-document-project-reference.md +71 -0
  32. package/{src/modules/bmm/docs → docs/modules/bmm-bmad-method}/workflows-analysis.md +8 -75
  33. package/docs/modules/bmm-bmad-method/workflows-planning.md +89 -0
  34. package/{src/modules/bmm/docs → docs/modules/bmm-bmad-method}/workflows-solutioning.md +4 -4
  35. package/docs/modules/core/advanced-elicitation.md +105 -0
  36. package/docs/modules/core/brainstorming.md +100 -0
  37. package/docs/modules/core/core-tasks.md +64 -0
  38. package/docs/modules/core/core-workflows.md +30 -0
  39. package/docs/modules/core/document-sharding-guide.md +133 -0
  40. package/docs/modules/core/global-core-config.md +11 -0
  41. package/docs/modules/core/index.md +15 -0
  42. package/docs/modules/core/party-mode.md +50 -0
  43. package/package.json +2 -2
  44. package/samples/sample-custom-modules/README.md +1 -1
  45. package/samples/sample-custom-modules/sample-unitary-module/agents/commit-poet/commit-poet.agent.yaml +1 -1
  46. package/samples/sample-custom-modules/sample-unitary-module/agents/toolsmith/toolsmith-sidecar/knowledge/docs.md +0 -5
  47. package/samples/sample-custom-modules/sample-unitary-module/agents/toolsmith/toolsmith.agent.yaml +1 -1
  48. package/src/core/agents/bmad-master.agent.yaml +4 -8
  49. package/src/core/tasks/workflow.xml +1 -1
  50. package/src/core/{tasks/advanced-elicitation.xml → workflows/advanced-elicitation/workflow.xml} +3 -2
  51. package/src/core/workflows/brainstorming/steps/step-01-session-setup.md +1 -0
  52. package/src/core/workflows/brainstorming/steps/step-01b-continue.md +1 -0
  53. package/src/core/workflows/brainstorming/steps/step-02a-user-selected.md +1 -0
  54. package/src/core/workflows/brainstorming/steps/step-02b-ai-recommended.md +2 -1
  55. package/src/core/workflows/brainstorming/steps/step-02c-random-selection.md +1 -0
  56. package/src/core/workflows/brainstorming/steps/step-02d-progressive-flow.md +1 -0
  57. package/src/core/workflows/brainstorming/steps/step-03-technique-execution.md +1 -0
  58. package/src/core/workflows/brainstorming/steps/step-04-idea-organization.md +1 -0
  59. package/src/core/workflows/brainstorming/workflow.md +1 -1
  60. package/src/core/workflows/party-mode/steps/step-01-agent-loading.md +1 -0
  61. package/src/core/workflows/party-mode/steps/step-02-discussion-orchestration.md +1 -0
  62. package/src/core/workflows/party-mode/steps/step-03-graceful-exit.md +1 -0
  63. package/src/core/workflows/party-mode/workflow.md +1 -1
  64. package/src/modules/bmb/agents/agent-builder.agent.yaml +36 -0
  65. package/src/modules/bmb/agents/module-builder.agent.yaml +48 -0
  66. package/src/modules/bmb/agents/workflow-builder.agent.yaml +40 -0
  67. package/src/modules/bmb/docs/workflows/architecture.md +1 -1
  68. package/src/modules/bmb/docs/workflows/common-workflow-tools.csv +1 -1
  69. package/src/modules/bmb/docs/workflows/step-file-rules.md +469 -0
  70. package/src/modules/bmb/docs/workflows/templates/step-file.md +1 -1
  71. package/src/modules/bmb/docs/workflows/templates/step-template.md +1 -1
  72. package/src/modules/bmb/docs/workflows/terms.md +1 -1
  73. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-01-init.md +1 -0
  74. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-01b-continue.md +1 -0
  75. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-02-profile.md +2 -1
  76. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-03-assessment.md +2 -1
  77. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-04-strategy.md +3 -2
  78. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-05-shopping.md +3 -2
  79. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-06-prep-schedule.md +3 -2
  80. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/workflow.md +1 -0
  81. package/src/modules/bmb/workflows/agent/data/agent-compilation.md +273 -0
  82. package/src/modules/bmb/workflows/agent/data/agent-menu-patterns.md +233 -0
  83. package/src/modules/bmb/workflows/agent/data/agent-metadata.md +208 -0
  84. package/src/modules/bmb/workflows/{create-agent → agent}/data/brainstorm-context.md +3 -10
  85. package/src/modules/bmb/workflows/{create-agent → agent}/data/communication-presets.csv +1 -1
  86. package/src/modules/bmb/workflows/agent/data/critical-actions.md +120 -0
  87. package/src/modules/bmb/workflows/agent/data/expert-agent-architecture.md +236 -0
  88. package/src/modules/bmb/workflows/agent/data/expert-agent-validation.md +173 -0
  89. package/src/modules/bmb/workflows/agent/data/module-agent-validation.md +124 -0
  90. package/src/modules/bmb/workflows/agent/data/persona-properties.md +266 -0
  91. package/src/modules/bmb/workflows/agent/data/principles-crafting.md +292 -0
  92. package/src/modules/bmb/workflows/agent/data/reference/expert-examples/journal-keeper/journal-keeper-sidecar/entries/yy-mm-dd-entry-template.md +17 -0
  93. package/src/modules/bmb/{reference/agents → workflows/agent/data/reference}/expert-examples/journal-keeper/journal-keeper.agent.yaml +20 -19
  94. package/src/modules/bmb/workflows/agent/data/reference/module-examples/architect.agent.yaml +31 -0
  95. package/src/modules/bmb/workflows/agent/data/reference/module-examples/architect.md +68 -0
  96. package/src/modules/bmb/workflows/{create-agent/data/reference/agents → agent/data/reference}/module-examples/security-engineer.agent.yaml +8 -13
  97. package/src/modules/bmb/workflows/{create-agent/data/reference/agents → agent/data/reference}/module-examples/trend-analyst.agent.yaml +10 -14
  98. package/src/modules/bmb/workflows/{create-agent/data/reference/agents → agent/data/reference}/simple-examples/commit-poet.agent.yaml +15 -15
  99. package/src/modules/bmb/workflows/agent/data/simple-agent-architecture.md +204 -0
  100. package/src/modules/bmb/workflows/agent/data/simple-agent-validation.md +132 -0
  101. package/src/modules/bmb/workflows/agent/data/understanding-agent-types.md +222 -0
  102. package/src/modules/bmb/workflows/{create-agent/steps → agent/steps-c}/step-01-brainstorm.md +6 -25
  103. package/src/modules/bmb/workflows/agent/steps-c/step-02-discovery.md +168 -0
  104. package/src/modules/bmb/workflows/agent/steps-c/step-03-type-metadata.md +294 -0
  105. package/src/modules/bmb/workflows/agent/steps-c/step-04-persona.md +210 -0
  106. package/src/modules/bmb/workflows/agent/steps-c/step-05-commands-menu.md +176 -0
  107. package/src/modules/bmb/workflows/agent/steps-c/step-06-activation.md +275 -0
  108. package/src/modules/bmb/workflows/agent/steps-c/step-07a-build-simple.md +185 -0
  109. package/src/modules/bmb/workflows/agent/steps-c/step-07b-build-expert.md +201 -0
  110. package/src/modules/bmb/workflows/agent/steps-c/step-07c-build-module.md +258 -0
  111. package/src/modules/bmb/workflows/agent/steps-c/step-08a-plan-traceability.md +203 -0
  112. package/src/modules/bmb/workflows/agent/steps-c/step-08b-metadata-validation.md +135 -0
  113. package/src/modules/bmb/workflows/agent/steps-c/step-08c-persona-validation.md +161 -0
  114. package/src/modules/bmb/workflows/agent/steps-c/step-08d-menu-validation.md +158 -0
  115. package/src/modules/bmb/workflows/agent/steps-c/step-08e-structure-validation.md +306 -0
  116. package/src/modules/bmb/workflows/agent/steps-c/step-08f-sidecar-validation.md +462 -0
  117. package/src/modules/bmb/workflows/agent/steps-c/step-09-celebrate.md +244 -0
  118. package/src/modules/bmb/workflows/agent/steps-e/e-01-load-existing.md +214 -0
  119. package/src/modules/bmb/workflows/agent/steps-e/e-02-discover-edits.md +191 -0
  120. package/src/modules/bmb/workflows/agent/steps-e/e-03a-validate-metadata.md +78 -0
  121. package/src/modules/bmb/workflows/agent/steps-e/e-03b-validate-persona.md +76 -0
  122. package/src/modules/bmb/workflows/agent/steps-e/e-03c-validate-menu.md +75 -0
  123. package/src/modules/bmb/workflows/agent/steps-e/e-03d-validate-structure.md +75 -0
  124. package/src/modules/bmb/workflows/agent/steps-e/e-03e-validate-sidecar.md +78 -0
  125. package/src/modules/bmb/workflows/agent/steps-e/e-03f-validation-summary.md +119 -0
  126. package/src/modules/bmb/workflows/agent/steps-e/e-04-type-metadata.md +122 -0
  127. package/src/modules/bmb/workflows/agent/steps-e/e-05-persona.md +132 -0
  128. package/src/modules/bmb/workflows/agent/steps-e/e-06-commands-menu.md +120 -0
  129. package/src/modules/bmb/workflows/agent/steps-e/e-07-activation.md +122 -0
  130. package/src/modules/bmb/workflows/agent/steps-e/e-08a-edit-simple.md +134 -0
  131. package/src/modules/bmb/workflows/agent/steps-e/e-08b-edit-expert.md +117 -0
  132. package/src/modules/bmb/workflows/agent/steps-e/e-08c-edit-module.md +120 -0
  133. package/src/modules/bmb/workflows/agent/steps-e/e-09a-validate-metadata.md +70 -0
  134. package/src/modules/bmb/workflows/agent/steps-e/e-09b-validate-persona.md +70 -0
  135. package/src/modules/bmb/workflows/agent/steps-e/e-09c-validate-menu.md +69 -0
  136. package/src/modules/bmb/workflows/agent/steps-e/e-09d-validate-structure.md +69 -0
  137. package/src/modules/bmb/workflows/agent/steps-e/e-09e-validate-sidecar.md +70 -0
  138. package/src/modules/bmb/workflows/agent/steps-e/e-09f-validation-summary.md +111 -0
  139. package/src/modules/bmb/workflows/agent/steps-e/e-10-celebrate.md +150 -0
  140. package/src/modules/bmb/workflows/agent/steps-v/v-01-load-review.md +128 -0
  141. package/src/modules/bmb/workflows/agent/steps-v/v-02a-validate-metadata.md +73 -0
  142. package/src/modules/bmb/workflows/agent/steps-v/v-02b-validate-persona.md +72 -0
  143. package/src/modules/bmb/workflows/agent/steps-v/v-02c-validate-menu.md +71 -0
  144. package/src/modules/bmb/workflows/agent/steps-v/v-02d-validate-structure.md +71 -0
  145. package/src/modules/bmb/workflows/agent/steps-v/v-02e-validate-sidecar.md +76 -0
  146. package/src/modules/bmb/workflows/agent/steps-v/v-03-summary.md +100 -0
  147. package/src/modules/bmb/workflows/agent/templates/agent-plan.template.md +5 -0
  148. package/src/modules/bmb/workflows/agent/templates/expert-agent-template/expert-agent-sidecar/instructions.md.template +20 -0
  149. package/src/modules/bmb/workflows/agent/templates/expert-agent-template/expert-agent-sidecar/memories.md.template +18 -0
  150. package/src/modules/bmb/workflows/agent/templates/expert-agent-template/expert-agent.template.md +76 -0
  151. package/src/modules/bmb/workflows/agent/templates/simple-agent.template.md +71 -0
  152. package/src/modules/bmb/workflows/agent/workflow.md +123 -0
  153. package/src/modules/bmb/workflows/create-module/steps/step-01-init.md +2 -1
  154. package/src/modules/bmb/workflows/create-module/steps/step-01b-continue.md +2 -1
  155. package/src/modules/bmb/workflows/create-module/steps/step-02-concept.md +2 -1
  156. package/src/modules/bmb/workflows/create-module/steps/step-03-components.md +2 -1
  157. package/src/modules/bmb/workflows/create-module/steps/step-04-structure.md +2 -1
  158. package/src/modules/bmb/workflows/create-module/steps/step-05-config.md +2 -1
  159. package/src/modules/bmb/workflows/create-module/steps/step-06-agents.md +2 -1
  160. package/src/modules/bmb/workflows/create-module/steps/step-07-workflows.md +2 -1
  161. package/src/modules/bmb/workflows/create-module/steps/step-08-installer.md +2 -1
  162. package/src/modules/bmb/workflows/create-module/steps/step-09-documentation.md +2 -1
  163. package/src/modules/bmb/workflows/create-module/steps/step-10-roadmap.md +2 -1
  164. package/src/modules/bmb/workflows/create-module/steps/step-11-validate.md +3 -2
  165. package/src/modules/bmb/workflows/create-module/workflow.md +1 -0
  166. package/src/modules/bmb/workflows/{create-agent/data/reference/workflows → create-workflow/data/examples}/meal-prep-nutrition/steps/step-02-profile.md +1 -1
  167. package/src/modules/bmb/workflows/{create-agent/data/reference/workflows → create-workflow/data/examples}/meal-prep-nutrition/steps/step-03-assessment.md +1 -1
  168. package/src/modules/bmb/workflows/{create-agent/data/reference/workflows → create-workflow/data/examples}/meal-prep-nutrition/steps/step-04-strategy.md +2 -2
  169. package/src/modules/bmb/workflows/{create-agent/data/reference/workflows → create-workflow/data/examples}/meal-prep-nutrition/steps/step-05-shopping.md +2 -2
  170. package/src/modules/bmb/workflows/{create-agent/data/reference/workflows → create-workflow/data/examples}/meal-prep-nutrition/steps/step-06-prep-schedule.md +2 -2
  171. package/src/modules/bmb/workflows/create-workflow/steps/step-01-init.md +1 -0
  172. package/src/modules/bmb/workflows/create-workflow/steps/step-02-gather.md +2 -1
  173. package/src/modules/bmb/workflows/create-workflow/steps/step-03-tools-configuration.md +2 -1
  174. package/src/modules/bmb/workflows/create-workflow/steps/step-04-plan-review.md +2 -1
  175. package/src/modules/bmb/workflows/create-workflow/steps/step-05-output-format-design.md +2 -1
  176. package/src/modules/bmb/workflows/create-workflow/steps/step-06-design.md +4 -3
  177. package/src/modules/bmb/workflows/create-workflow/steps/step-07-build.md +16 -1
  178. package/src/modules/bmb/workflows/create-workflow/steps/step-08-review.md +2 -1
  179. package/src/modules/bmb/workflows/create-workflow/steps/step-09-complete.md +1 -0
  180. package/src/modules/bmb/workflows/create-workflow/workflow.md +1 -0
  181. package/src/modules/bmb/workflows/edit-workflow/steps/step-01-analyze.md +5 -5
  182. package/src/modules/bmb/workflows/edit-workflow/steps/step-02-discover.md +2 -1
  183. package/src/modules/bmb/workflows/edit-workflow/steps/step-03-improve.md +2 -1
  184. package/src/modules/bmb/workflows/edit-workflow/steps/step-04-validate.md +2 -1
  185. package/src/modules/bmb/workflows/edit-workflow/steps/step-05-compliance-check.md +1 -0
  186. package/src/modules/bmb/workflows/edit-workflow/workflow.md +2 -1
  187. package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-01-validate-goal.md +1 -0
  188. package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-02-workflow-validation.md +1 -0
  189. package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-03-step-validation.md +2 -1
  190. package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-04-file-validation.md +1 -0
  191. package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-05-intent-spectrum-validation.md +1 -0
  192. package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-06-web-subprocess-validation.md +1 -0
  193. package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-07-holistic-analysis.md +1 -0
  194. package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-08-generate-report.md +1 -0
  195. package/src/modules/bmb/workflows/workflow-compliance-check/workflow.md +1 -0
  196. package/src/modules/bmgd/agents/game-architect.agent.yaml +8 -17
  197. package/src/modules/bmgd/agents/game-designer.agent.yaml +21 -33
  198. package/src/modules/bmgd/agents/game-dev.agent.yaml +13 -17
  199. package/src/modules/bmgd/agents/game-qa.agent.yaml +17 -21
  200. package/src/modules/bmgd/agents/game-scrum-master.agent.yaml +17 -21
  201. package/src/modules/bmgd/agents/game-solo-dev.agent.yaml +15 -19
  202. package/src/modules/bmgd/module.yaml +1 -1
  203. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/steps/step-01-init.md +1 -0
  204. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/steps/step-02-context.md +1 -0
  205. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/steps/step-03-ideation.md +2 -1
  206. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/steps/step-04-complete.md +1 -0
  207. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/workflow.md +1 -0
  208. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-01-init.md +1 -0
  209. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-01b-continue.md +1 -0
  210. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-02-vision.md +2 -1
  211. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-03-market.md +2 -1
  212. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-04-fundamentals.md +2 -1
  213. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-05-scope.md +2 -1
  214. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-06-references.md +2 -1
  215. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-07-content.md +2 -1
  216. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-08-complete.md +1 -0
  217. package/src/modules/bmgd/workflows/1-preproduction/game-brief/workflow.md +1 -0
  218. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-01-init.md +1 -0
  219. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-01b-continue.md +1 -0
  220. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-02-context.md +2 -1
  221. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-03-platforms.md +2 -1
  222. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-04-vision.md +2 -1
  223. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-05-core-gameplay.md +2 -1
  224. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-06-mechanics.md +2 -1
  225. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-07-game-type.md +2 -1
  226. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-08-progression.md +2 -1
  227. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-09-levels.md +2 -1
  228. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-10-art-audio.md +2 -1
  229. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-11-technical.md +2 -1
  230. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-12-epics.md +2 -1
  231. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-13-metrics.md +2 -1
  232. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-14-complete.md +1 -0
  233. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-01-init.md +1 -0
  234. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-01b-continue.md +1 -0
  235. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-02-foundation.md +2 -1
  236. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-03-story.md +2 -1
  237. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-04-characters.md +2 -1
  238. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-05-world.md +2 -1
  239. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-06-dialogue.md +2 -1
  240. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-07-environmental.md +2 -1
  241. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-08-delivery.md +2 -1
  242. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-09-integration.md +2 -1
  243. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-10-production.md +2 -1
  244. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-11-complete.md +1 -0
  245. package/src/modules/bmgd/workflows/2-design/narrative/workflow.md +1 -0
  246. package/src/modules/bmgd/workflows/3-technical/game-architecture/instructions.md +1 -1
  247. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-01-init.md +1 -0
  248. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-01b-continue.md +1 -0
  249. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-02-context.md +2 -1
  250. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-03-starter.md +2 -1
  251. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-04-decisions.md +2 -1
  252. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-05-crosscutting.md +2 -1
  253. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-06-structure.md +4 -3
  254. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-07-patterns.md +2 -1
  255. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-08-validation.md +4 -3
  256. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-09-complete.md +1 -0
  257. package/src/modules/bmgd/workflows/3-technical/game-architecture/workflow.md +1 -0
  258. package/src/modules/bmgd/workflows/3-technical/generate-project-context/steps/step-01-discover.md +2 -1
  259. package/src/modules/bmgd/workflows/3-technical/generate-project-context/steps/step-02-generate.md +2 -1
  260. package/src/modules/bmgd/workflows/3-technical/generate-project-context/steps/step-03-complete.md +1 -0
  261. package/src/modules/bmgd/workflows/3-technical/generate-project-context/workflow.md +1 -0
  262. package/src/modules/bmgd/workflows/4-production/create-story/workflow.yaml +1 -1
  263. package/src/modules/bmgd/workflows/bmgd-quick-flow/create-tech-spec/workflow.yaml +1 -1
  264. package/src/modules/bmgd/workflows/bmgd-quick-flow/quick-dev/workflow.yaml +1 -1
  265. package/src/modules/bmgd/workflows/bmgd-quick-flow/quick-prototype/workflow.yaml +1 -1
  266. package/src/modules/bmm/_module-installer/installer.js +0 -34
  267. package/src/modules/bmm/agents/analyst.agent.yaml +10 -22
  268. package/src/modules/bmm/agents/architect.agent.yaml +6 -23
  269. package/src/modules/bmm/agents/dev.agent.yaml +2 -6
  270. package/src/modules/bmm/agents/pm.agent.yaml +15 -22
  271. package/src/modules/bmm/agents/quick-flow-solo-dev.agent.yaml +7 -3
  272. package/src/modules/bmm/agents/sm.agent.yaml +12 -24
  273. package/src/modules/bmm/agents/tea.agent.yaml +20 -25
  274. package/src/modules/bmm/agents/tech-writer.agent.yaml +18 -31
  275. package/src/modules/bmm/agents/ux-designer.agent.yaml +8 -20
  276. package/src/modules/bmm/module.yaml +3 -3
  277. package/src/modules/bmm/workflows/1-analysis/create-product-brief/steps/step-01-init.md +22 -32
  278. package/src/modules/bmm/workflows/1-analysis/create-product-brief/steps/step-01b-continue.md +1 -0
  279. package/src/modules/bmm/workflows/1-analysis/create-product-brief/steps/step-02-vision.md +2 -1
  280. package/src/modules/bmm/workflows/1-analysis/create-product-brief/steps/step-03-users.md +2 -1
  281. package/src/modules/bmm/workflows/1-analysis/create-product-brief/steps/step-04-metrics.md +2 -1
  282. package/src/modules/bmm/workflows/1-analysis/create-product-brief/steps/step-05-scope.md +2 -1
  283. package/src/modules/bmm/workflows/1-analysis/create-product-brief/steps/step-06-complete.md +1 -0
  284. package/src/modules/bmm/workflows/1-analysis/research/domain-steps/step-01-init.md +1 -0
  285. package/src/modules/bmm/workflows/1-analysis/research/domain-steps/step-02-domain-analysis.md +1 -0
  286. package/src/modules/bmm/workflows/1-analysis/research/domain-steps/step-03-competitive-landscape.md +1 -0
  287. package/src/modules/bmm/workflows/1-analysis/research/domain-steps/step-04-regulatory-focus.md +1 -0
  288. package/src/modules/bmm/workflows/1-analysis/research/domain-steps/step-05-technical-trends.md +1 -0
  289. package/src/modules/bmm/workflows/1-analysis/research/domain-steps/step-06-research-synthesis.md +1 -0
  290. package/src/modules/bmm/workflows/1-analysis/research/market-steps/step-01-init.md +1 -0
  291. package/src/modules/bmm/workflows/1-analysis/research/market-steps/step-02-customer-behavior.md +1 -0
  292. package/src/modules/bmm/workflows/1-analysis/research/market-steps/step-02-customer-insights.md +1 -0
  293. package/src/modules/bmm/workflows/1-analysis/research/market-steps/step-03-customer-pain-points.md +1 -0
  294. package/src/modules/bmm/workflows/1-analysis/research/market-steps/step-04-customer-decisions.md +1 -0
  295. package/src/modules/bmm/workflows/1-analysis/research/market-steps/step-05-competitive-analysis.md +1 -0
  296. package/src/modules/bmm/workflows/1-analysis/research/market-steps/step-06-research-completion.md +1 -0
  297. package/src/modules/bmm/workflows/1-analysis/research/technical-steps/step-01-init.md +1 -0
  298. package/src/modules/bmm/workflows/1-analysis/research/technical-steps/step-02-technical-overview.md +1 -0
  299. package/src/modules/bmm/workflows/1-analysis/research/technical-steps/step-03-integration-patterns.md +1 -0
  300. package/src/modules/bmm/workflows/1-analysis/research/technical-steps/step-04-architectural-patterns.md +1 -0
  301. package/src/modules/bmm/workflows/1-analysis/research/technical-steps/step-05-implementation-research.md +1 -0
  302. package/src/modules/bmm/workflows/1-analysis/research/technical-steps/step-06-research-synthesis.md +1 -0
  303. package/src/modules/bmm/workflows/1-analysis/research/workflow.md +1 -1
  304. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-01-init.md +20 -44
  305. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-01b-continue.md +1 -0
  306. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-02-discovery.md +3 -2
  307. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-03-core-experience.md +5 -4
  308. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-04-emotional-response.md +5 -4
  309. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-05-inspiration.md +5 -4
  310. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-06-design-system.md +5 -4
  311. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-07-defining-experience.md +5 -4
  312. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-08-visual-foundation.md +5 -4
  313. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-09-design-directions.md +6 -5
  314. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-10-user-journeys.md +5 -4
  315. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-11-component-strategy.md +5 -4
  316. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-12-ux-patterns.md +5 -4
  317. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-13-responsive-accessibility.md +5 -4
  318. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-14-complete.md +6 -4
  319. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md +2 -16
  320. package/src/modules/bmm/workflows/2-plan-workflows/prd/prd-template.md +0 -5
  321. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-01-init.md +23 -69
  322. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-01b-continue.md +3 -2
  323. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-02-discovery.md +5 -4
  324. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-03-success.md +7 -6
  325. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-04-journeys.md +7 -6
  326. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-05-domain.md +7 -6
  327. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-06-innovation.md +7 -6
  328. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-07-project-type.md +7 -6
  329. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-08-scoping.md +7 -6
  330. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-09-functional.md +7 -6
  331. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-10-nonfunctional.md +7 -6
  332. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-11-complete.md +6 -43
  333. package/src/modules/bmm/workflows/2-plan-workflows/prd/workflow.md +3 -1
  334. package/src/modules/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-01-document-discovery.md +9 -8
  335. package/src/modules/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-02-prd-analysis.md +2 -1
  336. package/src/modules/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-03-epic-coverage-validation.md +1 -0
  337. package/src/modules/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-04-ux-alignment.md +3 -2
  338. package/src/modules/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-05-epic-quality-review.md +1 -0
  339. package/src/modules/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-06-final-assessment.md +1 -0
  340. package/src/modules/bmm/workflows/3-solutioning/check-implementation-readiness/workflow.md +1 -0
  341. package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-01-init.md +25 -54
  342. package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-01b-continue.md +1 -0
  343. package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-02-context.md +4 -3
  344. package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-03-starter.md +4 -3
  345. package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-04-decisions.md +4 -3
  346. package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-05-patterns.md +4 -3
  347. package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-06-structure.md +4 -3
  348. package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-07-validation.md +4 -3
  349. package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-08-complete.md +7 -6
  350. package/src/modules/bmm/workflows/3-solutioning/create-architecture/workflow.md +1 -0
  351. package/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-01-validate-prerequisites.md +4 -3
  352. package/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-02-design-epics.md +2 -1
  353. package/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-03-create-stories.md +2 -1
  354. package/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-04-final-validation.md +2 -1
  355. package/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md +1 -0
  356. package/src/modules/bmm/workflows/4-implementation/code-review/workflow.yaml +9 -12
  357. package/src/modules/bmm/workflows/4-implementation/create-story/workflow.yaml +13 -12
  358. package/src/modules/bmm/workflows/4-implementation/retrospective/instructions.md +3 -3
  359. package/src/modules/bmm/workflows/4-implementation/retrospective/workflow.yaml +11 -10
  360. package/src/modules/bmm/workflows/bmad-quick-flow/create-tech-spec/steps/step-01-understand.md +189 -0
  361. package/src/modules/bmm/workflows/bmad-quick-flow/create-tech-spec/steps/step-02-investigate.md +144 -0
  362. package/src/modules/bmm/workflows/bmad-quick-flow/create-tech-spec/steps/step-03-generate.md +128 -0
  363. package/src/modules/bmm/workflows/bmad-quick-flow/create-tech-spec/steps/step-04-review.md +173 -0
  364. package/src/modules/bmm/workflows/bmad-quick-flow/create-tech-spec/tech-spec-template.md +74 -0
  365. package/src/modules/bmm/workflows/bmad-quick-flow/create-tech-spec/workflow.md +79 -0
  366. package/src/modules/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-01-mode-detection.md +1 -1
  367. package/src/modules/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-05-adversarial-review.md +1 -1
  368. package/src/modules/bmm/workflows/bmad-quick-flow/quick-dev/workflow.md +3 -2
  369. package/src/modules/bmm/workflows/document-project/checklist.md +2 -2
  370. package/src/modules/bmm/workflows/generate-project-context/steps/step-01-discover.md +1 -0
  371. package/src/modules/bmm/workflows/generate-project-context/steps/step-02-generate.md +2 -1
  372. package/src/modules/bmm/workflows/generate-project-context/steps/step-03-complete.md +1 -0
  373. package/src/modules/bmm/workflows/generate-project-context/workflow.md +1 -0
  374. package/src/modules/bmm/workflows/workflow-status/init/instructions.md +6 -6
  375. package/src/modules/bmm/workflows/workflow-status/init/workflow.yaml +2 -1
  376. package/src/modules/bmm/workflows/workflow-status/instructions.md +4 -4
  377. package/src/modules/bmm/workflows/workflow-status/paths/enterprise-brownfield.yaml +44 -63
  378. package/src/modules/bmm/workflows/workflow-status/paths/enterprise-greenfield.yaml +44 -54
  379. package/src/modules/bmm/workflows/workflow-status/paths/method-brownfield.yaml +38 -41
  380. package/src/modules/bmm/workflows/workflow-status/paths/method-greenfield.yaml +26 -22
  381. package/src/modules/cis/agents/brainstorming-coach.agent.yaml +2 -11
  382. package/src/modules/cis/agents/creative-problem-solver.agent.yaml +2 -11
  383. package/src/modules/cis/agents/design-thinking-coach.agent.yaml +2 -11
  384. package/src/modules/cis/agents/innovation-strategist.agent.yaml +2 -11
  385. package/src/modules/cis/agents/presentation-master.agent.yaml +14 -23
  386. package/src/modules/cis/agents/storyteller/storyteller.agent.yaml +2 -11
  387. package/test/fixtures/agent-schema/invalid/menu-triggers/compound-mismatched-kebab.agent.yaml +6 -6
  388. package/test/fixtures/agent-schema/valid/menu-triggers/compound-triggers.agent.yaml +8 -8
  389. package/test/fixtures/agent-schema/{invalid → valid}/metadata/core-agent-with-module.agent.yaml +4 -7
  390. package/test/fixtures/agent-schema/valid/metadata/module-agent-missing-module.agent.yaml +22 -0
  391. package/test/fixtures/agent-schema/valid/metadata/wrong-module-value.agent.yaml +23 -0
  392. package/test/test-installation-components.js +1 -1
  393. package/tools/cli/bmad-cli.js +18 -0
  394. package/tools/cli/commands/install.js +8 -12
  395. package/tools/cli/installers/install-messages.yaml +14 -8
  396. package/tools/cli/installers/lib/core/config-collector.js +1 -1
  397. package/tools/cli/installers/lib/core/detector.js +5 -115
  398. package/tools/cli/installers/lib/core/installer.js +49 -80
  399. package/tools/cli/installers/lib/ide/antigravity.js +3 -3
  400. package/tools/cli/installers/lib/ide/claude-code.js +3 -3
  401. package/tools/cli/installers/lib/ide/codex.js +1 -1
  402. package/tools/cli/installers/lib/ide/github-copilot.js +1 -1
  403. package/tools/cli/lib/agent/compiler.js +4 -7
  404. package/tools/cli/lib/ui.js +1 -1
  405. package/tools/docs/index.md +2 -0
  406. package/tools/platform-codes.yaml +13 -1
  407. package/tools/schema/agent.js +30 -52
  408. package/website/sidebars.js +1 -19
  409. package/website/src/pages/downloads.md +0 -15
  410. package/docs/document-sharding-guide.md +0 -449
  411. package/docs/getting-started/installation.md +0 -76
  412. package/docs/ide-info/auggie.md +0 -31
  413. package/docs/ide-info/claude-code.md +0 -25
  414. package/docs/ide-info/cline.md +0 -31
  415. package/docs/ide-info/codex.md +0 -21
  416. package/docs/ide-info/crush.md +0 -30
  417. package/docs/ide-info/cursor.md +0 -25
  418. package/docs/ide-info/gemini.md +0 -25
  419. package/docs/ide-info/github-copilot.md +0 -26
  420. package/docs/ide-info/iflow.md +0 -33
  421. package/docs/ide-info/index.md +0 -24
  422. package/docs/ide-info/kilo.md +0 -24
  423. package/docs/ide-info/opencode.md +0 -24
  424. package/docs/ide-info/qwen.md +0 -25
  425. package/docs/ide-info/roo.md +0 -27
  426. package/docs/ide-info/rovo-dev.md +0 -22
  427. package/docs/ide-info/trae.md +0 -25
  428. package/docs/ide-info/windsurf.md +0 -22
  429. package/docs/v4-to-v6-upgrade.md +0 -227
  430. package/docs/web-bundles-gemini-gpt-guide.md +0 -21
  431. package/src/modules/bmb/agents/bmad-builder.agent.yaml +0 -94
  432. package/src/modules/bmb/docs/agents/agent-compilation.md +0 -340
  433. package/src/modules/bmb/docs/agents/agent-menu-patterns.md +0 -523
  434. package/src/modules/bmb/docs/agents/expert-agent-architecture.md +0 -363
  435. package/src/modules/bmb/docs/agents/kb.csv +0 -0
  436. package/src/modules/bmb/docs/agents/simple-agent-architecture.md +0 -257
  437. package/src/modules/bmb/docs/agents/understanding-agent-types.md +0 -184
  438. package/src/modules/bmb/docs/index.md +0 -247
  439. package/src/modules/bmb/docs/workflows/index.md +0 -45
  440. package/src/modules/bmb/docs/workflows/kb.csv +0 -0
  441. package/src/modules/bmb/reference/agents/expert-examples/journal-keeper/README.md +0 -242
  442. package/src/modules/bmb/reference/agents/module-examples/README.md +0 -49
  443. package/src/modules/bmb/reference/agents/module-examples/security-engineer.agent.yaml +0 -53
  444. package/src/modules/bmb/reference/agents/module-examples/trend-analyst.agent.yaml +0 -57
  445. package/src/modules/bmb/reference/agents/simple-examples/commit-poet.agent.yaml +0 -126
  446. package/src/modules/bmb/workflows/create-agent/data/agent-validation-checklist.md +0 -174
  447. package/src/modules/bmb/workflows/create-agent/data/info-and-installation-guide.md +0 -29
  448. package/src/modules/bmb/workflows/create-agent/data/reference/README.md +0 -3
  449. package/src/modules/bmb/workflows/create-agent/data/reference/agents/expert-examples/journal-keeper/README.md +0 -242
  450. package/src/modules/bmb/workflows/create-agent/data/reference/agents/expert-examples/journal-keeper/journal-keeper-sidecar/breakthroughs.md +0 -24
  451. package/src/modules/bmb/workflows/create-agent/data/reference/agents/expert-examples/journal-keeper/journal-keeper-sidecar/instructions.md +0 -108
  452. package/src/modules/bmb/workflows/create-agent/data/reference/agents/expert-examples/journal-keeper/journal-keeper-sidecar/memories.md +0 -46
  453. package/src/modules/bmb/workflows/create-agent/data/reference/agents/expert-examples/journal-keeper/journal-keeper-sidecar/mood-patterns.md +0 -39
  454. package/src/modules/bmb/workflows/create-agent/data/reference/agents/expert-examples/journal-keeper/journal-keeper.agent.yaml +0 -152
  455. package/src/modules/bmb/workflows/create-agent/data/reference/agents/module-examples/README.md +0 -48
  456. package/src/modules/bmb/workflows/create-agent/data/reference/agents/simple-examples/README.md +0 -223
  457. package/src/modules/bmb/workflows/create-agent/data/validation-complete.md +0 -305
  458. package/src/modules/bmb/workflows/create-agent/steps/step-02-discover.md +0 -206
  459. package/src/modules/bmb/workflows/create-agent/steps/step-03-persona.md +0 -260
  460. package/src/modules/bmb/workflows/create-agent/steps/step-04-commands.md +0 -237
  461. package/src/modules/bmb/workflows/create-agent/steps/step-05-name.md +0 -232
  462. package/src/modules/bmb/workflows/create-agent/steps/step-06-build.md +0 -186
  463. package/src/modules/bmb/workflows/create-agent/steps/step-07-validate.md +0 -234
  464. package/src/modules/bmb/workflows/create-agent/steps/step-08-celebrate.md +0 -218
  465. package/src/modules/bmb/workflows/create-agent/templates/agent-plan.template.md +0 -3
  466. package/src/modules/bmb/workflows/create-agent/templates/expert-agent.template.md +0 -364
  467. package/src/modules/bmb/workflows/create-agent/templates/simple-agent.template.md +0 -257
  468. package/src/modules/bmb/workflows/create-agent/workflow.md +0 -58
  469. package/src/modules/bmb/workflows/edit-agent/steps/step-01-discover-intent.md +0 -134
  470. package/src/modules/bmb/workflows/edit-agent/steps/step-02-analyze-agent.md +0 -202
  471. package/src/modules/bmb/workflows/edit-agent/steps/step-03-propose-changes.md +0 -157
  472. package/src/modules/bmb/workflows/edit-agent/steps/step-04-apply-changes.md +0 -150
  473. package/src/modules/bmb/workflows/edit-agent/steps/step-05-validate.md +0 -150
  474. package/src/modules/bmb/workflows/edit-agent/workflow.md +0 -58
  475. package/src/modules/bmm/README.md +0 -127
  476. package/src/modules/bmm/docs/enterprise-agentic-development.md +0 -686
  477. package/src/modules/bmm/docs/scale-adaptive-system.md +0 -618
  478. package/src/modules/bmm/docs/troubleshooting.md +0 -661
  479. package/src/modules/bmm/docs/workflow-architecture-reference.md +0 -366
  480. package/src/modules/bmm/docs/workflow-document-project-reference.md +0 -489
  481. package/src/modules/bmm/docs/workflows-planning.md +0 -451
  482. package/src/modules/bmm/workflows/bmad-quick-flow/create-tech-spec/instructions.md +0 -115
  483. package/src/modules/bmm/workflows/bmad-quick-flow/create-tech-spec/workflow.yaml +0 -28
  484. package/test/fixtures/agent-schema/invalid/menu-triggers/compound-wrong-shortcut.agent.yaml +0 -24
  485. package/test/fixtures/agent-schema/invalid/metadata/module-agent-missing-module.agent.yaml +0 -25
  486. package/test/fixtures/agent-schema/invalid/metadata/wrong-module-value.agent.yaml +0 -26
  487. /package/{src/modules/bmgd/docs → docs/modules/bmgd-bmad-game-dev}/agents-guide.md +0 -0
  488. /package/{src/modules/bmgd/docs → docs/modules/bmgd-bmad-game-dev}/game-types-guide.md +0 -0
  489. /package/{src/modules/bmgd/docs → docs/modules/bmgd-bmad-game-dev}/quick-flow-guide.md +0 -0
  490. /package/{src/modules/bmgd/docs → docs/modules/bmgd-bmad-game-dev}/quick-start.md +0 -0
  491. /package/{src/modules/bmgd/docs → docs/modules/bmgd-bmad-game-dev}/troubleshooting.md +0 -0
  492. /package/{src/modules/bmgd/docs → docs/modules/bmgd-bmad-game-dev}/workflow-overview.jpg +0 -0
  493. /package/{src/modules/bmm/docs → docs/modules/bmm-bmad-method}/agents-guide.md +0 -0
  494. /package/{src/modules/bmm/docs → docs/modules/bmm-bmad-method}/bmad-quick-flow.md +0 -0
  495. /package/{src/modules/bmm/docs → docs/modules/bmm-bmad-method}/glossary.md +0 -0
  496. /package/{src/modules/bmm/docs → docs/modules/bmm-bmad-method}/images/README.md +0 -0
  497. /package/{src/modules/bmm/docs → docs/modules/bmm-bmad-method}/images/workflow-method-greenfield.excalidraw +0 -0
  498. /package/{src/modules/bmm/docs → docs/modules/bmm-bmad-method}/images/workflow-method-greenfield.svg +0 -0
  499. /package/{src/modules/bmm/docs → docs/modules/bmm-bmad-method}/quick-flow-solo-dev.md +0 -0
  500. /package/{src/modules/bmm/docs → docs/modules/bmm-bmad-method}/workflows-implementation.md +0 -0
  501. /package/{src/modules/cis/docs → docs/modules/cis-creative-intelligence-suite}/index.md +0 -0
  502. /package/src/core/{tools → tasks}/shard-doc.xml +0 -0
  503. /package/src/core/{tasks/advanced-elicitation-methods.csv → workflows/advanced-elicitation/methods.csv} +0 -0
  504. /package/src/modules/bmb/reference/{README.md → readme.md} +0 -0
  505. /package/src/modules/bmb/{reference/agents → workflows/agent/data/reference}/expert-examples/journal-keeper/journal-keeper-sidecar/breakthroughs.md +0 -0
  506. /package/src/modules/bmb/{reference/agents → workflows/agent/data/reference}/expert-examples/journal-keeper/journal-keeper-sidecar/instructions.md +0 -0
  507. /package/src/modules/bmb/{reference/agents → workflows/agent/data/reference}/expert-examples/journal-keeper/journal-keeper-sidecar/memories.md +0 -0
  508. /package/src/modules/bmb/{reference/agents → workflows/agent/data/reference}/expert-examples/journal-keeper/journal-keeper-sidecar/mood-patterns.md +0 -0
  509. /package/src/modules/bmb/workflows/{create-agent/data/reference/workflows → create-workflow/data/examples}/meal-prep-nutrition/data/dietary-restrictions.csv +0 -0
  510. /package/src/modules/bmb/workflows/{create-agent/data/reference/workflows → create-workflow/data/examples}/meal-prep-nutrition/data/macro-calculator.csv +0 -0
  511. /package/src/modules/bmb/workflows/{create-agent/data/reference/workflows → create-workflow/data/examples}/meal-prep-nutrition/data/recipe-database.csv +0 -0
  512. /package/src/modules/bmb/workflows/{create-agent/data/reference/workflows → create-workflow/data/examples}/meal-prep-nutrition/steps/step-01-init.md +0 -0
  513. /package/src/modules/bmb/workflows/{create-agent/data/reference/workflows → create-workflow/data/examples}/meal-prep-nutrition/steps/step-01b-continue.md +0 -0
  514. /package/src/modules/bmb/workflows/{create-agent/data/reference/workflows → create-workflow/data/examples}/meal-prep-nutrition/templates/assessment-section.md +0 -0
  515. /package/src/modules/bmb/workflows/{create-agent/data/reference/workflows → create-workflow/data/examples}/meal-prep-nutrition/templates/nutrition-plan.md +0 -0
  516. /package/src/modules/bmb/workflows/{create-agent/data/reference/workflows → create-workflow/data/examples}/meal-prep-nutrition/templates/prep-schedule-section.md +0 -0
  517. /package/src/modules/bmb/workflows/{create-agent/data/reference/workflows → create-workflow/data/examples}/meal-prep-nutrition/templates/profile-section.md +0 -0
  518. /package/src/modules/bmb/workflows/{create-agent/data/reference/workflows → create-workflow/data/examples}/meal-prep-nutrition/templates/shopping-section.md +0 -0
  519. /package/src/modules/bmb/workflows/{create-agent/data/reference/workflows → create-workflow/data/examples}/meal-prep-nutrition/templates/strategy-section.md +0 -0
  520. /package/src/modules/bmb/workflows/{create-agent/data/reference/workflows → create-workflow/data/examples}/meal-prep-nutrition/workflow.md +0 -0
  521. /package/{docs → tools/docs}/BUNDLE_DISTRIBUTION_SETUP.md +0 -0
@@ -7,7 +7,7 @@ description: Orchestrates group discussions between all installed BMAD agents, e
7
7
 
8
8
  **Goal:** Orchestrates group discussions between all installed BMAD agents, enabling natural multi-agent conversations
9
9
 
10
- **Your Role:** You are a party mode facilitator and multi-agent conversation orchestrator. You bring together diverse BMAD agents for collaborative discussions, managing the flow of conversation while maintaining each agent's unique personality and expertise.
10
+ **Your Role:** You are a party mode facilitator and multi-agent conversation orchestrator. You bring together diverse BMAD agents for collaborative discussions, managing the flow of conversation while maintaining each agent's unique personality and expertise - while still utilizing the configured {communication_language}.
11
11
 
12
12
  ---
13
13
 
@@ -0,0 +1,36 @@
1
+ # Agent Building Expert Agent Definition
2
+ # Specialized in creating, editing, and validating BMAD agents with best practices
3
+
4
+ agent:
5
+ webskip: true
6
+ metadata:
7
+ id: "_bmad/bmb/agents/agent-building-expert.md"
8
+ name: Bond
9
+ title: Agent Building Expert
10
+ icon: 🤖
11
+ module: bmb
12
+
13
+ persona:
14
+ role: Agent Architecture Specialist + BMAD Compliance Expert
15
+ identity: Master agent architect with deep expertise in agent design patterns, persona development, and BMAD Core compliance. Specializes in creating robust, maintainable agents that follow best practices.
16
+ communication_style: "Precise and technical, like a senior software architect reviewing code. Focuses on structure, compliance, and long-term maintainability. Uses agent-specific terminology and framework references."
17
+ principles: |
18
+ - Every agent must follow BMAD Core standards and best practices
19
+ - Personas drive agent behavior - make them specific and authentic
20
+ - Menu structure must be consistent across all agents
21
+ - Validate compliance before finalizing any agent
22
+ - Load resources at runtime, never pre-load
23
+ - Focus on practical implementation and real-world usage
24
+
25
+ discussion: true
26
+ conversational_knowledge:
27
+ - agents: "{project-root}/_bmad/bmb/docs/agents/kb.csv"
28
+
29
+ menu:
30
+ - trigger: CA or fuzzy match on create-agent
31
+ exec: "{project-root}/_bmad/bmb/workflows/agent/workflow.md"
32
+ description: "[CA] Create a new BMAD agent with best practices and compliance"
33
+
34
+ - trigger: EA or fuzzy match on edit-agent
35
+ exec: "{project-root}/_bmad/bmb/workflows/agent/workflow.md"
36
+ description: "[EA] Edit existing BMAD agents while maintaining compliance"
@@ -0,0 +1,48 @@
1
+ # Module Creation Master Agent Definition
2
+ # Specialized in creating, editing, and validating complete BMAD modules with best practices
3
+
4
+ agent:
5
+ webskip: true
6
+ metadata:
7
+ id: "_bmad/bmb/agents/module-creation-master.md"
8
+ name: Morgan
9
+ title: Module Creation Master
10
+ icon: 🏗️
11
+ module: bmb
12
+
13
+ persona:
14
+ role: Module Architecture Specialist + Full-Stack Systems Designer
15
+ identity: Expert module architect with comprehensive knowledge of BMAD Core systems, integration patterns, and end-to-end module development. Specializes in creating cohesive, scalable modules that deliver complete functionality.
16
+ communication_style: "Strategic and holistic, like a systems architect planning complex integrations. Focuses on modularity, reusability, and system-wide impact. Thinks in terms of ecosystems, dependencies, and long-term maintainability."
17
+ principles: |
18
+ - Modules must be self-contained yet integrate seamlessly
19
+ - Every module should solve specific business problems effectively
20
+ - Documentation and examples are as important as code
21
+ - Plan for growth and evolution from day one
22
+ - Balance innovation with proven patterns
23
+ - Consider the entire module lifecycle from creation to maintenance
24
+
25
+ discussion: true
26
+ conversational_knowledge:
27
+ - modules: "{project-root}/_bmad/bmb/docs/modules/kb.csv"
28
+
29
+ menu:
30
+ - trigger: BM or fuzzy match on brainstorm-module
31
+ exec: "{project-root}/_bmad/bmb/workflows/brainstorm-module/workflow.md"
32
+ description: "[BM] Brainstorm and conceptualize new BMAD modules"
33
+
34
+ - trigger: PB or fuzzy match on product-brief
35
+ exec: "{project-root}/_bmad/bmb/workflows/product-brief-module/workflow.md"
36
+ description: "[PB] Create product brief for BMAD module development"
37
+
38
+ - trigger: CM or fuzzy match on create-module
39
+ exec: "{project-root}/_bmad/bmb/workflows/create-module/workflow.md"
40
+ description: "[CM] Create a complete BMAD module with agents, workflows, and infrastructure"
41
+
42
+ - trigger: EM or fuzzy match on edit-module
43
+ exec: "{project-root}/_bmad/bmb/workflows/edit-module/workflow.md"
44
+ description: "[EM] Edit existing BMAD modules while maintaining coherence"
45
+
46
+ - trigger: VM or fuzzy match on validate-module
47
+ exec: "{project-root}/_bmad/bmb/workflows/module-compliance-check/workflow.md"
48
+ description: "[VM] Run compliance check on BMAD modules against best practices"
@@ -0,0 +1,40 @@
1
+ # Workflow Building Master Agent Definition
2
+ # Specialized in creating, editing, and validating BMAD workflows with best practices
3
+
4
+ agent:
5
+ webskip: true
6
+ metadata:
7
+ id: "_bmad/bmb/agents/workflow-building-master.md"
8
+ name: Wendy
9
+ title: Workflow Building Master
10
+ icon: 🔄
11
+ module: bmb
12
+
13
+ persona:
14
+ role: Workflow Architecture Specialist + Process Design Expert
15
+ identity: Master workflow architect with expertise in process design, state management, and workflow optimization. Specializes in creating efficient, scalable workflows that integrate seamlessly with BMAD systems.
16
+ communication_style: "Methodical and process-oriented, like a systems engineer. Focuses on flow, efficiency, and error handling. Uses workflow-specific terminology and thinks in terms of states, transitions, and data flow."
17
+ principles: |
18
+ - Workflows must be efficient, reliable, and maintainable
19
+ - Every workflow should have clear entry and exit points
20
+ - Error handling and edge cases are critical for robust workflows
21
+ - Workflow documentation must be comprehensive and clear
22
+ - Test workflows thoroughly before deployment
23
+ - Optimize for both performance and user experience
24
+
25
+ discussion: true
26
+ conversational_knowledge:
27
+ - workflows: "{project-root}/_bmad/bmb/docs/workflows/kb.csv"
28
+
29
+ menu:
30
+ - trigger: CW or fuzzy match on create-workflow
31
+ exec: "{project-root}/_bmad/bmb/workflows/create-workflow/workflow.md"
32
+ description: "[CW] Create a new BMAD workflow with proper structure and best practices"
33
+
34
+ # - trigger: EW or fuzzy match on edit-workflow
35
+ # exec: "{project-root}/_bmad/bmb/workflows/edit-workflow/workflow.md"
36
+ # description: "[EW] Edit existing BMAD workflows while maintaining integrity"
37
+
38
+ # - trigger: VW or fuzzy match on validate-workflow
39
+ # exec: "{project-root}/_bmad/bmb/workflows/workflow-compliance-check/workflow.md"
40
+ # description: "[VW] Run compliance check on BMAD workflows against best practices"
@@ -6,7 +6,7 @@ This document describes the architecture of the standalone workflow builder syst
6
6
 
7
7
  ### 1. Micro-File Design
8
8
 
9
- Each workflow consists of multiple focused, self-contained files:
9
+ Each workflow consists of multiple focused, self-contained files, driven from a workflow.md file that is initially loaded:
10
10
 
11
11
  ```
12
12
  workflow-folder/
@@ -1,6 +1,6 @@
1
1
  propose,type,tool_name,description,url,requires_install
2
2
  always,workflow,party-mode,"Enables collaborative idea generation by managing turn-taking, summarizing contributions, and synthesizing ideas from multiple AI personas in structured conversation sessions about workflow steps or work in progress.",{project-root}/_bmad/core/workflows/party-mode/workflow.md,no
3
- always,task,advanced-elicitation,"Employs diverse elicitation strategies such as Socratic questioning, role-playing, and counterfactual analysis to critically evaluate and enhance LLM outputs, forcing assessment from multiple perspectives and techniques.",{project-root}/_bmad/core/tasks/advanced-elicitation.xml,no
3
+ always,workflow,advanced-elicitation,"Employs diverse elicitation strategies such as Socratic questioning, role-playing, and counterfactual analysis to critically evaluate and enhance LLM outputs, forcing assessment from multiple perspectives and techniques.",{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml,no
4
4
  always,task,brainstorming,"Facilitates idea generation by prompting users with targeted questions, encouraging divergent thinking, and synthesizing concepts into actionable insights through collaborative creative exploration.",{project-root}/_bmad/core/tasks/brainstorming.xml,no
5
5
  always,llm-tool-feature,web-browsing,"Provides LLM with capabilities to perform real-time web searches, extract relevant data, and incorporate current information into responses when up-to-date information is required beyond training knowledge.",,no
6
6
  always,llm-tool-feature,file-io,"Enables LLM to manage file operations such as creating, reading, updating, and deleting files, facilitating seamless data handling, storage, and document management within user environments.",,no
@@ -0,0 +1,469 @@
1
+ # BMAD Step File Guidelines
2
+
3
+ **Version:** 1.0
4
+ **Module:** bmb (BMAD Builder)
5
+ **Purpose:** Definitive guide for creating BMAD workflow step files
6
+
7
+ ---
8
+
9
+ ## Overview
10
+
11
+ BMAD workflow step files follow a strict structure to ensure consistency, progressive disclosure, and mode-aware routing. Every step file MUST adhere to these guidelines.
12
+
13
+ ---
14
+
15
+ ## File Size Optimization
16
+
17
+ **CRITICAL:** Keep step files **LT 200 lines** (250 lines absolute maximum).
18
+
19
+ If a step exceeds this limit:
20
+ - Consider splitting into multiple steps
21
+ - Extract content to `/data/` reference files
22
+ - Optimize verbose explanations
23
+
24
+ ---
25
+
26
+ ## Required Frontmatter Structure
27
+
28
+ CRITICAL: Frontmatter should only have items that are used in the step file!
29
+
30
+ ```yaml
31
+ ---
32
+ name: 'step-2-foo.md'
33
+ description: 'Brief description of what this step accomplishes'
34
+
35
+ # File References ## CRITICAL: Frontmatter references or variables should only have items that are used in the step file!
36
+ outputFile: {bmb_creations_output_folder}/output-file-name.md
37
+ nextStepFile: './step-3-bar.md'
38
+
39
+ # Task References (as needed)
40
+ advancedElicitationTask: '{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml'
41
+ partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
42
+ # ... other task-specific references
43
+ ---
44
+ ```
45
+
46
+ ### Frontmatter Field Descriptions
47
+
48
+ | Field | Required | Description |
49
+ | --------------- | --------- | --------------------------------- |
50
+ | `name` | Yes | Step identifier (kebab-case) |
51
+ | `description` | Yes | One-line summary of step purpose |
52
+ | `outputFile` | Yes | Where results are documented |
53
+ | Task references | As needed | Paths to external workflows/tasks |
54
+
55
+ ---
56
+
57
+ ## Document Structure
58
+
59
+ ### 1. Title
60
+
61
+ ```markdown
62
+ # Step X: [Step Name]
63
+ ```
64
+
65
+ ### 2. STEP GOAL
66
+
67
+ ```markdown
68
+ ## STEP GOAL:
69
+
70
+ [Single sentence stating what this step accomplishes]
71
+ ```
72
+
73
+ ### 3. Role Reinforcement
74
+
75
+ ```markdown
76
+ ### Role Reinforcement:
77
+
78
+ - ✅ You are a [specific role] who [does what]
79
+ - ✅ If you already have been given a name, communication_style and identity, continue to use those while playing this new role
80
+ - ✅ We engage in collaborative dialogue, not command-response
81
+ - ✅ You bring [your expertise], user brings [their expertise], together we [achieve goal]
82
+ - ✅ Maintain [tone/approach] throughout
83
+ ```
84
+
85
+ ### 4. Language Preference
86
+
87
+ ```markdown
88
+ ### Language Preference:
89
+ The user has chosen to communicate in the **{language}** language.
90
+ You MUST respond in **{language}** throughout this step.
91
+ ```
92
+
93
+ **IMPORTANT:** Read `userPreferences.language` from tracking file (agentPlan, validationReport, etc.) and enforce it.
94
+
95
+ ### 5. Step-Specific Rules
96
+
97
+ ```markdown
98
+ ### Step-Specific Rules:
99
+
100
+ - 🎯 Focus only on [specific scope]
101
+ - 🚫 FORBIDDEN to [prohibited action]
102
+ - 💬 Approach: [how to engage]
103
+ - 📋 Ensure [specific outcome]
104
+ ```
105
+
106
+ ### 6. EXECUTION PROTOCOLS
107
+
108
+ ```markdown
109
+ ## EXECUTION PROTOCOLS:
110
+
111
+ - [What to do - use verbs]
112
+ - [Another action]
113
+ - 🚫 FORBIDDEN to [prohibited action]
114
+ ```
115
+
116
+ ### 7. CONTEXT BOUNDARIES
117
+
118
+ ```markdown
119
+ ## CONTEXT BOUNDARIES:
120
+
121
+ - Available context: [what's available]
122
+ - Focus: [what to focus on]
123
+ - Limits: [boundaries]
124
+ - Dependencies: [what this step depends on]
125
+ ```
126
+
127
+ ### 8. Sequence of Instructions
128
+
129
+ ```markdown
130
+ ## Sequence of Instructions:
131
+
132
+ ### 1. [First Action]
133
+
134
+ **[Action Description]**
135
+
136
+ ### 2. [Second Action]
137
+
138
+ ...
139
+ ```
140
+
141
+ ### 9. MENU OPTIONS
142
+
143
+ ```markdown
144
+ ### X. Present MENU OPTIONS
145
+
146
+ Display: "**Select:** [A] [menu item A] [P] [menu item P] [C] [menu item C]"
147
+
148
+ #### Menu Handling Logic:
149
+ - IF A: Execute {advancedElicitationTask}, and when finished redisplay the menu
150
+ - IF P: Execute {partyModeWorkflow}, and when finished redisplay the menu
151
+ - IF C: Save content to {outputFile}, update frontmatter, then load, read entire file, then execute {nextStepFile}
152
+ - IF Any other comments or queries: help user respond then [Redisplay Menu Options](#x-present-menu-options)
153
+
154
+ #### EXECUTION RULES:
155
+ - ALWAYS halt and wait for user input after presenting menu
156
+ - ONLY proceed to next step when user selects 'C'
157
+ - After other menu items execution, return to this menu
158
+ - User can chat or ask questions - always respond and then end with display again of the menu options
159
+
160
+ ## CRITICAL STEP COMPLETION NOTE
161
+ ONLY WHEN [C continue option] is selected and [completion conditions], will you then load and read fully `{nextStepFile}`...
162
+ ```
163
+
164
+ ### 10. SYSTEM SUCCESS/FAILURE METRICS
165
+
166
+ ```markdown
167
+ ## 🚨 SYSTEM SUCCESS/FAILURE METRICS
168
+
169
+ ### ✅ SUCCESS:
170
+ - [Success criterion 1]
171
+ - [Success criterion 2]
172
+ - ...
173
+
174
+ ### ❌ SYSTEM FAILURE:
175
+ - [Failure criterion 1]
176
+ - [Failure criterion 2]
177
+ - ...
178
+
179
+ **Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.
180
+ ```
181
+
182
+ ---
183
+
184
+ ## A/P/C Menu Convention
185
+
186
+ BMAD workflows use a fixed menu structure:
187
+
188
+ | Option | Meaning | Behavior |
189
+ | ------ | -------------------- | ---------------------------------------------------- |
190
+ | **A** | Advanced Elicitation | Execute advancedElicitationTask, then redisplay menu |
191
+ | **P** | Party Mode | Execute partyModeWorkflow, then redisplay menu |
192
+ | **C** | Continue/Accept | Save output, update frontmatter, load nextStepFile |
193
+ | Other | Custom | Defined per step (e.g., F = Fix, X = Exit) |
194
+
195
+ **Rules:**
196
+ - A and P MUST always be present
197
+ - C MUST be present except in final step (use X or similar for exit)
198
+ - After A/P → redisplay menu
199
+ - After C → proceed to next step
200
+ - Custom letters can be used for step-specific options
201
+
202
+ ---
203
+
204
+ ## Progressive Disclosure
205
+
206
+ **Core Principle:** Each step only knows about its immediate next step.
207
+
208
+ ### Implementation
209
+
210
+ 1. **Never pre-load future steps** - Only load `nextStepFile` when user selects [C]
211
+
212
+ 2. **Mode-aware routing** (for shared steps):
213
+ ```markdown
214
+ ## MODE-AWARE ROUTING:
215
+ ### If entered from CREATE mode:
216
+ Load ./s-next-step.md
217
+
218
+ ### If entered from EDIT mode:
219
+ Load ./e-next-step.md
220
+
221
+ ### If entered from VALIDATE mode:
222
+ Load ./v-next-step.md
223
+ ```
224
+
225
+ 3. **Read tracking file first** - Always read the tracking file (agentPlan, validationReport, etc.) to determine current mode and routing
226
+
227
+ ---
228
+
229
+ ## Mode-Aware Routing (Shared Steps)
230
+
231
+ Shared steps (`s-*.md`) must route based on the mode stored in the tracking file.
232
+
233
+ ### Tracking File Frontmatter
234
+
235
+ ```yaml
236
+ ---
237
+ mode: create # or edit | validate
238
+ stepsCompleted:
239
+ - c-01-brainstorm.md
240
+ - s-01-discovery.md
241
+ # ... other tracking fields
242
+ ---
243
+ ```
244
+
245
+ ### Routing Implementation
246
+
247
+ ```markdown
248
+ ## COMPLETION ROUTING:
249
+
250
+ 1. Append `./this-step-name.md` to {trackingFile}.stepsCompleted
251
+ 2. Save content to {trackingFile}
252
+ 3. Read {trackingFile}.mode
253
+ 4. Route based on mode:
254
+
255
+ ### IF mode == create:
256
+ Load ./s-next-create-step.md
257
+
258
+ ### IF mode == edit:
259
+ Load ./e-next-edit-step.md
260
+
261
+ ### IF mode == validate:
262
+ Load ./s-next-validate-step.md
263
+ ```
264
+
265
+ ---
266
+
267
+ ## File Naming Conventions
268
+
269
+ ### Tri-Modal Workflows
270
+
271
+ | Prefix | Meaning | Example |
272
+ | ------ | ------------------ | ---------------------- |
273
+ | `c-` | Create-specific | `c-01-brainstorm.md` |
274
+ | `e-` | Edit-specific | `e-01-load-analyze.md` |
275
+ | `v-` | Validate-specific | `v-01-load-review.md` |
276
+ | `s-` | Shared by 2+ modes | `s-05-activation.md` |
277
+
278
+ ### Numbering
279
+
280
+ - Within each prefix type, number sequentially
281
+ - Restart numbering for each prefix type (c-01, e-01, v-01, s-01)
282
+ - Use letters for sub-steps (s-06a, s-06b, s-06c)
283
+
284
+ ---
285
+
286
+ ## Language Preference Enforcement
287
+
288
+ **CRITICAL:** Every step MUST respect the user's chosen language.
289
+
290
+ ### Implementation
291
+
292
+ ```markdown
293
+ ### Language Preference:
294
+ The user has chosen to communicate in the **{language}** language.
295
+ You MUST respond in **{language}** throughout this step.
296
+ ```
297
+
298
+ ### Reading Language Preference
299
+
300
+ From tracking file frontmatter:
301
+ ```yaml
302
+ ---
303
+ userPreferences:
304
+ language: spanish # or any language
305
+ ---
306
+ ```
307
+
308
+ ### Rules
309
+
310
+ - **MUST** read language preference from tracking file at step start
311
+ - **MUST** respond in user's chosen language for ALL content
312
+ - **MUST** include menu options in user's chosen language
313
+ - **EXCEPTION:** Technical terms, file names, and code remain in English
314
+
315
+ ---
316
+
317
+ ## Data File References
318
+
319
+ When step content becomes too large (>200 lines), extract to `/data/` files:
320
+
321
+ ### When to Extract
322
+
323
+ - Step file exceeds 200 lines
324
+ - Content is reference material (rules, examples, patterns)
325
+ - Content is reused across multiple steps
326
+
327
+ ### How to Reference
328
+
329
+ ```markdown
330
+ ## Reference Material:
331
+
332
+ Load and reference: `../data/{data-file-name}.md`
333
+
334
+ Key points from that file:
335
+ - [Point 1]
336
+ - [Point 2]
337
+ ```
338
+
339
+ ### Data File Best Practices
340
+
341
+ - Keep data files focused on single topic
342
+ - Use clear, descriptive names
343
+ - Include examples and non-examples
344
+ - Optimize for LLM usage (concise, structured)
345
+
346
+ ---
347
+
348
+ ## Common Pitfalls to Avoid
349
+
350
+ ### ❌ DON'T:
351
+
352
+ - Pre-load future steps (violates progressive disclosure)
353
+ - Exceed 250 lines without splitting
354
+ - Forget to update `stepsCompleted` array
355
+ - Ignore user's language preference
356
+ - Skip mode checking in shared steps
357
+ - Use vague menu option letters (stick to A/P/C plus 1-2 custom)
358
+
359
+ ### ✅ DO:
360
+
361
+ - Keep files under 200 lines
362
+ - Read tracking file first thing
363
+ - Route based on `mode` field
364
+ - Include A/P in every menu
365
+ - Use descriptive step names
366
+ - Extract complex content to data files
367
+
368
+ ---
369
+
370
+ ## Template: New Step File
371
+
372
+ ```markdown
373
+ ---
374
+ name: 'step-name'
375
+ description: 'What this step does'
376
+
377
+ # File References
378
+ thisStepFile: ./step-name.md
379
+ workflowFile: ../workflow.md
380
+ outputFile: {bmb_creations_output_folder}/output.md
381
+
382
+ # Task References
383
+ advancedElicitationTask: '{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml'
384
+ partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
385
+ ---
386
+
387
+ # Step X: [Step Name]
388
+
389
+ ## STEP GOAL:
390
+
391
+ [Single sentence goal]
392
+
393
+ ### Role Reinforcement:
394
+
395
+ - ✅ You are a [role] who [does what]
396
+ - ✅ If you already have been given a name, communication_style and identity, continue to use those while playing this new role
397
+ - ✅ We engage in collaborative dialogue, not command-response
398
+ - ✅ You bring [expertise], user brings [expertise], together we [achieve]
399
+ - ✅ Maintain [tone] throughout
400
+
401
+ ### Language Preference:
402
+ The user has chosen to communicate in the **{language}** language.
403
+ You MUST respond in **{language}** throughout this step.
404
+
405
+ ### Step-Specific Rules:
406
+
407
+ - 🎯 Focus only on [scope]
408
+ - 🚫 FORBIDDEN to [prohibited action]
409
+ - 💬 Approach: [how to engage]
410
+ - 📋 Ensure [outcome]
411
+
412
+ ## EXECUTION PROTOCOLS:
413
+
414
+ - [Action 1]
415
+ - [Action 2]
416
+ - 🚫 FORBIDDEN to [prohibited action]
417
+
418
+ ## CONTEXT BOUNDARIES:
419
+
420
+ - Available context: [what's available]
421
+ - Focus: [what to focus on]
422
+ - Limits: [boundaries]
423
+ - Dependencies: [what depends on what]
424
+
425
+ ## Sequence of Instructions:
426
+
427
+ ### 1. [First Action]
428
+
429
+ **Description of first action**
430
+
431
+ ### 2. [Second Action]
432
+
433
+ **Description of second action**
434
+
435
+ ...
436
+
437
+ ### X. Present MENU OPTIONS
438
+
439
+ Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue"
440
+
441
+ #### Menu Handling Logic:
442
+ - IF A: Execute {advancedElicitationTask}, and when finished redisplay the menu
443
+ - IF P: Execute {partyModeWorkflow}, and when finished redisplay the menu
444
+ - IF C: Save content to {outputFile}, update frontmatter, then load, read entire file, then execute {nextStepFile}
445
+ - IF Any other comments or queries: help user respond then [Redisplay Menu Options](#x-present-menu-options)
446
+
447
+ #### EXECUTION RULES:
448
+ - ALWAYS halt and wait for user input after presenting menu
449
+ - ONLY proceed to next step when user selects 'C'
450
+ - After other menu items execution, return to this menu
451
+ - User can chat or ask questions - always respond and then end with display again of the menu options
452
+
453
+ ## CRITICAL STEP COMPLETION NOTE
454
+ ONLY WHEN [C continue option] is selected and [conditions], will you then load and read fully `{nextStepFile}`...
455
+
456
+ ## 🚨 SYSTEM SUCCESS/FAILURE METRICS
457
+
458
+ ### ✅ SUCCESS:
459
+ - [Success criteria]
460
+
461
+ ### ❌ SYSTEM FAILURE:
462
+ - [Failure criteria]
463
+
464
+ **Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.
465
+ ```
466
+
467
+ ---
468
+
469
+ **End of Guidelines**
@@ -16,7 +16,7 @@ outputFile: "{output_folder}/{{outputFileName}}-{project_name}.md"
16
16
  {{/hasOutput}}
17
17
 
18
18
  # Task References (list only if used in THIS step file instance and only the ones used, there might be others)
19
- advancedElicitationTask: "{project-root}/_bmad/core/tasks/advanced-elicitation.xml"
19
+ advancedElicitationTask: "{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml"
20
20
  partyModeWorkflow: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
21
21
 
22
22
  {{#hasTemplates}}
@@ -23,7 +23,7 @@ outputFile: '{output_folder}/[output-file-name]-{project_name}.md'
23
23
 
24
24
  # Task References (IF THE workflow uses and it makes sense in this step to have these )
25
25
 
26
- advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
26
+ advancedElicitationTask: '{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml'
27
27
  partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
28
28
 
29
29
  # Template References (if this step uses a specific templates)
@@ -21,7 +21,7 @@ An individual markdown file containing:
21
21
 
22
22
  - One discrete step of the workflow
23
23
  - All rules and context needed for that step
24
- - Execution guardrails and validation criteria
24
+ - common global rules get repeated and reinforced also in each step file, ensuring even in long workflows the agent remembers important rules and guidelines
25
25
  - Content generation guidance
26
26
 
27
27
  ### step-01-init.md
@@ -26,6 +26,7 @@ continueFile: '{workflow_path}/steps/step-01b-continue.md'
26
26
  - 📖 CRITICAL: Read the complete step file before taking any action
27
27
  - 🔄 CRITICAL: When loading next step with 'C', ensure entire file is read
28
28
  - 📋 YOU ARE A FACILITATOR, not a content generator
29
+ - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
29
30
 
30
31
  ### Role Reinforcement:
31
32
 
@@ -24,6 +24,7 @@ To resume the nutrition planning workflow from where it was left off, ensuring s
24
24
  - 📖 CRITICAL: Read the complete step file before taking any action
25
25
  - 🔄 CRITICAL: When loading next step with 'C', ensure entire file is read
26
26
  - 📋 YOU ARE A FACILITATOR, not a content generator
27
+ - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
27
28
 
28
29
  ### Role Reinforcement:
29
30
 
@@ -12,7 +12,7 @@ workflowFile: '{workflow_path}/workflow.md'
12
12
  outputFile: '{output_folder}/nutrition-plan-{project_name}.md'
13
13
 
14
14
  # Task References
15
- advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
15
+ advancedElicitationTask: '{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml'
16
16
  partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
17
17
 
18
18
  # Template References
@@ -33,6 +33,7 @@ To gather comprehensive user profile information through collaborative conversat
33
33
  - 📖 CRITICAL: Read the complete step file before taking any action
34
34
  - 🔄 CRITICAL: When loading next step with 'C', ensure entire file is read
35
35
  - 📋 YOU ARE A FACILITATOR, not a content generator
36
+ - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
36
37
 
37
38
  ### Role Reinforcement:
38
39