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

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 (280) hide show
  1. package/.github/workflows/docs.yaml +72 -0
  2. package/.github/workflows/quality.yaml +0 -3
  3. package/CHANGELOG.md +125 -0
  4. package/CONTRIBUTING.md +1 -3
  5. package/README.md +8 -7
  6. package/docs/agent-customization-guide.md +3 -3
  7. package/docs/custom-content-installation.md +1 -1
  8. package/docs/document-sharding-guide.md +2 -2
  9. package/docs/getting-started/installation.md +76 -0
  10. package/docs/ide-info/index.md +24 -0
  11. package/docs/ide-info/rovo-dev.md +14 -380
  12. package/docs/index.md +36 -45
  13. package/eslint.config.mjs +7 -2
  14. package/package.json +14 -8
  15. package/{docs → samples}/sample-custom-modules/README.md +1 -1
  16. package/{docs → samples}/sample-custom-modules/sample-unitary-module/agents/toolsmith/toolsmith-sidecar/knowledge/installers.md +2 -2
  17. package/{docs → samples}/sample-custom-modules/sample-unitary-module/agents/toolsmith/toolsmith-sidecar/knowledge/modules.md +1 -1
  18. package/{docs → samples}/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-01-init.md +1 -1
  19. package/{docs → samples}/sample-custom-modules/sample-unitary-module/workflows/quiz-master/workflow.md +1 -1
  20. package/src/core/tasks/review-adversarial-general.xml +41 -0
  21. package/src/modules/bmb/README.md +25 -0
  22. package/src/modules/bmb/docs/agents/expert-agent-architecture.md +3 -3
  23. package/src/modules/bmb/docs/agents/index.md +9 -9
  24. package/src/modules/bmb/docs/agents/simple-agent-architecture.md +1 -1
  25. package/src/modules/bmb/docs/agents/understanding-agent-types.md +1 -1
  26. package/src/modules/bmb/docs/{README.md → index.md} +10 -12
  27. package/src/modules/bmb/docs/workflows/index.md +6 -6
  28. package/src/modules/bmb/docs/workflows/templates/step-01-init-continuable-template.md +7 -7
  29. package/src/modules/bmb/docs/workflows/templates/step-1b-template.md +1 -1
  30. package/src/modules/bmb/docs/workflows/templates/step-template.md +7 -7
  31. package/src/modules/bmb/docs/workflows/templates/workflow-template.md +1 -1
  32. package/src/modules/bmb/docs/workflows/templates/workflow.md +1 -1
  33. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/workflow.md +1 -1
  34. package/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/workflow.md +1 -1
  35. package/src/modules/bmb/workflows/create-agent/templates/expert-agent.template.md +3 -3
  36. package/src/modules/bmb/workflows/create-module/steps/step-04-structure.md +1 -1
  37. package/src/modules/bmb/workflows/create-module/steps/step-08-installer.md +5 -5
  38. package/src/modules/bmb/workflows/create-module/templates/agent.template.md +1 -1
  39. package/src/modules/bmb/workflows/create-module/validation.md +2 -2
  40. package/src/modules/bmb/workflows/create-module/workflow.md +1 -1
  41. package/src/modules/bmb/workflows/create-workflow/steps/step-07-build.md +2 -2
  42. package/src/modules/bmb/workflows/create-workflow/workflow.md +1 -1
  43. package/src/modules/bmb/workflows/edit-agent/workflow.md +1 -1
  44. package/src/modules/bmb/workflows/edit-workflow/workflow.md +1 -1
  45. package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-02-workflow-validation.md +1 -1
  46. package/src/modules/bmb/workflows/workflow-compliance-check/workflow.md +1 -1
  47. package/src/modules/bmb/workflows-legacy/edit-module/checklist.md +1 -1
  48. package/src/modules/bmb/workflows-legacy/edit-module/instructions.md +3 -3
  49. package/src/modules/bmb/workflows-legacy/module-brief/instructions.md +2 -2
  50. package/src/modules/bmgd/_module-installer/installer.js +2 -2
  51. package/src/modules/bmgd/agents/game-architect.agent.yaml +4 -0
  52. package/src/modules/bmgd/docs/{README.md → index.md} +2 -2
  53. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/instructions.md +4 -4
  54. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/steps/step-01-init.md +1 -1
  55. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/steps/step-04-complete.md +1 -1
  56. package/src/modules/bmgd/workflows/1-preproduction/game-brief/instructions.md +4 -4
  57. package/src/modules/bmgd/workflows/2-design/narrative/instructions-narrative.md +4 -4
  58. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-11-complete.md +1 -1
  59. package/src/modules/bmgd/workflows/3-technical/game-architecture/instructions.md +5 -5
  60. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-09-complete.md +60 -6
  61. package/src/modules/bmgd/workflows/3-technical/generate-project-context/project-context-template.md +20 -0
  62. package/src/modules/bmgd/workflows/3-technical/generate-project-context/steps/step-01-discover.md +201 -0
  63. package/src/modules/bmgd/workflows/3-technical/generate-project-context/steps/step-02-generate.md +373 -0
  64. package/src/modules/bmgd/workflows/3-technical/generate-project-context/steps/step-03-complete.md +279 -0
  65. package/src/modules/bmgd/workflows/3-technical/generate-project-context/workflow.md +48 -0
  66. package/src/modules/bmgd/workflows/4-production/code-review/workflow.yaml +3 -3
  67. package/src/modules/bmgd/workflows/4-production/correct-course/checklist.md +1 -1
  68. package/src/modules/bmgd/workflows/4-production/correct-course/instructions.md +2 -2
  69. package/src/modules/bmgd/workflows/4-production/correct-course/workflow.yaml +2 -2
  70. package/src/modules/bmgd/workflows/4-production/create-story/workflow.yaml +3 -3
  71. package/src/modules/bmgd/workflows/4-production/dev-story/workflow.yaml +4 -4
  72. package/src/modules/bmgd/workflows/4-production/retrospective/instructions.md +2 -2
  73. package/src/modules/bmgd/workflows/4-production/retrospective/workflow.yaml +5 -5
  74. package/src/modules/bmgd/workflows/4-production/sprint-planning/instructions.md +11 -2
  75. package/src/modules/bmgd/workflows/4-production/sprint-planning/workflow.yaml +4 -4
  76. package/src/modules/bmgd/workflows/4-production/sprint-status/instructions.md +2 -2
  77. package/src/modules/bmgd/workflows/4-production/sprint-status/workflow.yaml +3 -3
  78. package/src/modules/bmgd/workflows/bmgd-quick-flow/create-tech-spec/instructions.md +3 -3
  79. package/src/modules/bmgd/workflows/bmgd-quick-flow/create-tech-spec/workflow.yaml +1 -1
  80. package/src/modules/bmgd/workflows/bmgd-quick-flow/quick-dev/workflow.yaml +1 -1
  81. package/src/modules/bmgd/workflows/bmgd-quick-flow/quick-prototype/workflow.yaml +1 -1
  82. package/src/modules/bmgd/workflows/workflow-status/init/instructions.md +2 -2
  83. package/src/modules/bmgd/workflows/workflow-status/init/workflow.yaml +1 -1
  84. package/src/modules/bmgd/workflows/workflow-status/instructions.md +2 -2
  85. package/src/modules/bmm/README.md +5 -6
  86. package/src/modules/bmm/_module-installer/installer.js +2 -2
  87. package/src/modules/bmm/agents/analyst.agent.yaml +1 -1
  88. package/src/modules/bmm/agents/dev.agent.yaml +8 -4
  89. package/src/modules/bmm/agents/quick-flow-solo-dev.agent.yaml +8 -17
  90. package/src/modules/bmm/agents/sm.agent.yaml +6 -3
  91. package/src/modules/bmm/agents/tech-writer.agent.yaml +1 -1
  92. package/src/modules/bmm/agents/ux-designer.agent.yaml +6 -3
  93. package/src/modules/bmm/docs/agents-guide.md +83 -1026
  94. package/src/modules/bmm/docs/bmad-quick-flow.md +10 -32
  95. package/src/modules/bmm/docs/brownfield-guide.md +1 -1
  96. package/src/modules/bmm/docs/enterprise-agentic-development.md +1 -1
  97. package/src/modules/bmm/docs/{README.md → index.md} +7 -88
  98. package/src/modules/bmm/docs/quick-spec-flow.md +1 -1
  99. package/src/modules/bmm/docs/quick-start.md +7 -7
  100. package/src/modules/bmm/docs/scale-adaptive-system.md +1 -1
  101. package/src/modules/bmm/docs/test-architecture.md +13 -12
  102. package/src/modules/bmm/docs/workflows-solutioning.md +1 -1
  103. package/src/modules/bmm/module.yaml +11 -10
  104. package/src/modules/bmm/workflows/1-analysis/create-product-brief/product-brief.template.md +7 -5
  105. package/src/modules/bmm/workflows/1-analysis/create-product-brief/steps/step-01-init.md +2 -2
  106. package/src/modules/bmm/workflows/1-analysis/create-product-brief/steps/step-01b-continue.md +2 -4
  107. package/src/modules/bmm/workflows/1-analysis/create-product-brief/steps/step-02-vision.md +2 -2
  108. package/src/modules/bmm/workflows/1-analysis/create-product-brief/steps/step-03-users.md +2 -2
  109. package/src/modules/bmm/workflows/1-analysis/create-product-brief/steps/step-04-metrics.md +2 -2
  110. package/src/modules/bmm/workflows/1-analysis/create-product-brief/steps/step-05-scope.md +2 -2
  111. package/src/modules/bmm/workflows/1-analysis/create-product-brief/steps/step-06-complete.md +7 -10
  112. package/src/modules/bmm/workflows/1-analysis/create-product-brief/workflow.md +3 -3
  113. package/src/modules/bmm/workflows/1-analysis/research/research.template.md +14 -0
  114. package/src/modules/bmm/workflows/1-analysis/research/workflow.md +8 -39
  115. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-01-init.md +15 -15
  116. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-02-discovery.md +5 -25
  117. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-03-core-experience.md +5 -5
  118. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-04-emotional-response.md +5 -5
  119. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-05-inspiration.md +6 -6
  120. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-06-design-system.md +5 -5
  121. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-07-defining-experience.md +5 -5
  122. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-08-visual-foundation.md +5 -5
  123. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-09-design-directions.md +5 -5
  124. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-10-user-journeys.md +5 -5
  125. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-11-component-strategy.md +5 -5
  126. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-12-ux-patterns.md +5 -5
  127. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-13-responsive-accessibility.md +5 -5
  128. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-14-complete.md +2 -2
  129. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md +3 -5
  130. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-03-success.md +4 -4
  131. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-04-journeys.md +4 -4
  132. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-05-domain.md +4 -4
  133. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-06-innovation.md +4 -4
  134. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-07-project-type.md +4 -4
  135. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-08-scoping.md +4 -4
  136. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-09-functional.md +4 -4
  137. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-10-nonfunctional.md +4 -4
  138. package/src/modules/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-01-document-discovery.md +1 -1
  139. package/src/modules/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-02-prd-analysis.md +1 -1
  140. package/src/modules/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-03-epic-coverage-validation.md +1 -1
  141. package/src/modules/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-04-ux-alignment.md +1 -1
  142. package/src/modules/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-05-epic-quality-review.md +1 -1
  143. package/src/modules/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-06-final-assessment.md +1 -1
  144. package/src/modules/bmm/workflows/3-solutioning/check-implementation-readiness/workflow.md +2 -2
  145. package/src/modules/bmm/workflows/3-solutioning/create-architecture/architecture-decision-template.md +0 -1
  146. package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-01-init.md +9 -21
  147. package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-02-context.md +4 -4
  148. package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-03-starter.md +2 -2
  149. package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-04-decisions.md +4 -4
  150. package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-05-patterns.md +4 -4
  151. package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-06-structure.md +4 -4
  152. package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-07-validation.md +4 -4
  153. package/src/modules/bmm/workflows/3-solutioning/create-architecture/workflow.md +1 -1
  154. package/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-01-validate-prerequisites.md +8 -8
  155. package/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-02-design-epics.md +1 -1
  156. package/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-03-create-stories.md +1 -1
  157. package/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-04-final-validation.md +1 -1
  158. package/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md +2 -2
  159. package/src/modules/bmm/workflows/4-implementation/code-review/workflow.yaml +4 -4
  160. package/src/modules/bmm/workflows/4-implementation/correct-course/checklist.md +1 -1
  161. package/src/modules/bmm/workflows/4-implementation/correct-course/instructions.md +2 -2
  162. package/src/modules/bmm/workflows/4-implementation/correct-course/workflow.yaml +16 -14
  163. package/src/modules/bmm/workflows/4-implementation/create-story/instructions.xml +2 -12
  164. package/src/modules/bmm/workflows/4-implementation/create-story/workflow.yaml +4 -4
  165. package/src/modules/bmm/workflows/4-implementation/dev-story/instructions.xml +1 -1
  166. package/src/modules/bmm/workflows/4-implementation/dev-story/workflow.yaml +3 -3
  167. package/src/modules/bmm/workflows/4-implementation/retrospective/instructions.md +2 -2
  168. package/src/modules/bmm/workflows/4-implementation/retrospective/workflow.yaml +5 -5
  169. package/src/modules/bmm/workflows/4-implementation/sprint-planning/instructions.md +2 -2
  170. package/src/modules/bmm/workflows/4-implementation/sprint-planning/workflow.yaml +7 -6
  171. package/src/modules/bmm/workflows/4-implementation/sprint-status/instructions.md +2 -2
  172. package/src/modules/bmm/workflows/4-implementation/sprint-status/workflow.yaml +4 -3
  173. package/src/modules/bmm/workflows/bmad-quick-flow/create-tech-spec/instructions.md +4 -4
  174. package/src/modules/bmm/workflows/bmad-quick-flow/create-tech-spec/workflow.yaml +4 -2
  175. package/src/modules/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-01-mode-detection.md +156 -0
  176. package/src/modules/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-02-context-gathering.md +120 -0
  177. package/src/modules/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-03-execute.md +113 -0
  178. package/src/modules/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-04-self-check.md +113 -0
  179. package/src/modules/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-05-adversarial-review.md +106 -0
  180. package/src/modules/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-06-resolve-findings.md +140 -0
  181. package/src/modules/bmm/workflows/bmad-quick-flow/quick-dev/workflow.md +51 -0
  182. package/src/modules/bmm/workflows/document-project/instructions.md +27 -28
  183. package/src/modules/bmm/workflows/document-project/workflow.yaml +2 -3
  184. package/src/modules/bmm/workflows/generate-project-context/project-context-template.md +2 -1
  185. package/src/modules/bmm/workflows/generate-project-context/steps/step-01-discover.md +5 -15
  186. package/src/modules/bmm/workflows/generate-project-context/steps/step-02-generate.md +2 -2
  187. package/src/modules/bmm/workflows/testarch/atdd/atdd-checklist-template.md +8 -7
  188. package/src/modules/bmm/workflows/testarch/atdd/checklist.md +1 -0
  189. package/src/modules/bmm/workflows/testarch/atdd/instructions.md +1 -0
  190. package/src/modules/bmm/workflows/testarch/automate/checklist.md +2 -0
  191. package/src/modules/bmm/workflows/testarch/ci/checklist.md +2 -0
  192. package/src/modules/bmm/workflows/testarch/ci/instructions.md +2 -0
  193. package/src/modules/bmm/workflows/testarch/nfr-assess/checklist.md +2 -0
  194. package/src/modules/bmm/workflows/testarch/nfr-assess/nfr-report-template.md +2 -0
  195. package/src/modules/bmm/workflows/testarch/test-design/checklist.md +3 -2
  196. package/src/modules/bmm/workflows/testarch/test-design/instructions.md +1 -1
  197. package/src/modules/bmm/workflows/testarch/test-design/test-design-template.md +9 -0
  198. package/src/modules/bmm/workflows/testarch/test-review/checklist.md +2 -0
  199. package/src/modules/bmm/workflows/testarch/test-review/test-review-template.md +2 -0
  200. package/src/modules/bmm/workflows/testarch/trace/checklist.md +1 -0
  201. package/src/modules/bmm/workflows/testarch/trace/instructions.md +2 -0
  202. package/src/modules/bmm/workflows/testarch/trace/trace-template.md +2 -0
  203. package/src/modules/bmm/workflows/workflow-status/init/instructions.md +2 -2
  204. package/src/modules/bmm/workflows/workflow-status/init/workflow.yaml +1 -1
  205. package/src/modules/bmm/workflows/workflow-status/instructions.md +2 -2
  206. package/src/modules/bmm/workflows/workflow-status/workflow.yaml +3 -1
  207. package/src/modules/cis/{readme.md → docs/index.md} +2 -6
  208. package/src/modules/cis/workflows/design-thinking/instructions.md +2 -2
  209. package/src/modules/cis/workflows/innovation-strategy/instructions.md +2 -2
  210. package/src/modules/cis/workflows/problem-solving/instructions.md +2 -2
  211. package/test/fixtures/agent-schema/invalid/menu-triggers/compound-invalid-format.agent.yaml +24 -0
  212. package/test/fixtures/agent-schema/invalid/menu-triggers/compound-mismatched-kebab.agent.yaml +24 -0
  213. package/test/fixtures/agent-schema/invalid/menu-triggers/compound-wrong-shortcut.agent.yaml +24 -0
  214. package/test/fixtures/agent-schema/valid/menu-triggers/compound-triggers.agent.yaml +30 -0
  215. package/tools/build-docs.js +630 -0
  216. package/tools/cli/commands/install.js +11 -5
  217. package/tools/cli/installers/install-messages.yaml +52 -0
  218. package/tools/cli/installers/lib/core/config-collector.js +25 -30
  219. package/tools/cli/installers/lib/message-loader.js +85 -0
  220. package/tools/cli/lib/ui.js +221 -41
  221. package/tools/schema/agent.js +68 -5
  222. package/website/css/custom.css +52 -0
  223. package/website/docusaurus.config.js +179 -0
  224. package/website/sidebars.js +157 -0
  225. package/website/src/pages/downloads.md +81 -0
  226. package/website/src/pages/index.js +50 -0
  227. package/website/static/favicon.ico +0 -0
  228. package/website/static/img/logo.svg +4 -0
  229. package/website/static/robots.txt +37 -0
  230. package/docs/installers-bundlers/ide-injections.md +0 -186
  231. package/docs/installers-bundlers/installers-modules-platforms-reference.md +0 -389
  232. package/src/modules/bmgd/README.md +0 -209
  233. package/src/modules/bmm/workflows/bmad-quick-flow/quick-dev/checklist.md +0 -25
  234. package/src/modules/bmm/workflows/bmad-quick-flow/quick-dev/instructions.md +0 -202
  235. package/src/modules/bmm/workflows/bmad-quick-flow/quick-dev/workflow.yaml +0 -33
  236. package/tools/cli/commands/build.js +0 -283
  237. package/tools/cli/commands/list.js +0 -40
  238. package/tools/cli/commands/status.js +0 -47
  239. package/tools/cli/commands/uninstall.js +0 -44
  240. package/tools/cli/commands/update.js +0 -28
  241. package/tools/validate-bundles.js +0 -87
  242. /package/{docs → samples}/sample-custom-modules/sample-unitary-module/README.md +0 -0
  243. /package/{docs → samples}/sample-custom-modules/sample-unitary-module/agents/commit-poet/commit-poet.agent.yaml +0 -0
  244. /package/{docs → samples}/sample-custom-modules/sample-unitary-module/agents/toolsmith/toolsmith-sidecar/instructions.md +0 -0
  245. /package/{docs → samples}/sample-custom-modules/sample-unitary-module/agents/toolsmith/toolsmith-sidecar/knowledge/bundlers.md +0 -0
  246. /package/{docs → samples}/sample-custom-modules/sample-unitary-module/agents/toolsmith/toolsmith-sidecar/knowledge/deploy.md +0 -0
  247. /package/{docs → samples}/sample-custom-modules/sample-unitary-module/agents/toolsmith/toolsmith-sidecar/knowledge/docs.md +0 -0
  248. /package/{docs → samples}/sample-custom-modules/sample-unitary-module/agents/toolsmith/toolsmith-sidecar/knowledge/tests.md +0 -0
  249. /package/{docs → samples}/sample-custom-modules/sample-unitary-module/agents/toolsmith/toolsmith-sidecar/memories.md +0 -0
  250. /package/{docs → samples}/sample-custom-modules/sample-unitary-module/agents/toolsmith/toolsmith.agent.yaml +0 -0
  251. /package/{docs → samples}/sample-custom-modules/sample-unitary-module/module.yaml +0 -0
  252. /package/{docs → samples}/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-02-q1.md +0 -0
  253. /package/{docs → samples}/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-03-q2.md +0 -0
  254. /package/{docs → samples}/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-04-q3.md +0 -0
  255. /package/{docs → samples}/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-05-q4.md +0 -0
  256. /package/{docs → samples}/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-06-q5.md +0 -0
  257. /package/{docs → samples}/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-07-q6.md +0 -0
  258. /package/{docs → samples}/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-08-q7.md +0 -0
  259. /package/{docs → samples}/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-09-q8.md +0 -0
  260. /package/{docs → samples}/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-10-q9.md +0 -0
  261. /package/{docs → samples}/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-11-q10.md +0 -0
  262. /package/{docs → samples}/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-12-results.md +0 -0
  263. /package/{docs → samples}/sample-custom-modules/sample-unitary-module/workflows/quiz-master/templates/csv-headers.template +0 -0
  264. /package/{docs → samples}/sample-custom-modules/sample-unitary-module/workflows/wassup/workflow.md +0 -0
  265. /package/{docs → samples}/sample-custom-modules/sample-wellness-module/README.md +0 -0
  266. /package/{docs → samples}/sample-custom-modules/sample-wellness-module/agents/meditation-guide.agent.yaml +0 -0
  267. /package/{docs → samples}/sample-custom-modules/sample-wellness-module/agents/wellness-companion/foo.md +0 -0
  268. /package/{docs → samples}/sample-custom-modules/sample-wellness-module/agents/wellness-companion/wellness-companion-sidecar/addition1.md +0 -0
  269. /package/{docs → samples}/sample-custom-modules/sample-wellness-module/agents/wellness-companion/wellness-companion-sidecar/insights.md +0 -0
  270. /package/{docs → samples}/sample-custom-modules/sample-wellness-module/agents/wellness-companion/wellness-companion-sidecar/instructions.md +0 -0
  271. /package/{docs → samples}/sample-custom-modules/sample-wellness-module/agents/wellness-companion/wellness-companion-sidecar/memories.md +0 -0
  272. /package/{docs → samples}/sample-custom-modules/sample-wellness-module/agents/wellness-companion/wellness-companion-sidecar/patterns.md +0 -0
  273. /package/{docs → samples}/sample-custom-modules/sample-wellness-module/agents/wellness-companion/wellness-companion.agent.yaml +0 -0
  274. /package/{docs → samples}/sample-custom-modules/sample-wellness-module/module.yaml +0 -0
  275. /package/{docs → samples}/sample-custom-modules/sample-wellness-module/workflows/daily-checkin/README.md +0 -0
  276. /package/{docs → samples}/sample-custom-modules/sample-wellness-module/workflows/daily-checkin/workflow.md +0 -0
  277. /package/{docs → samples}/sample-custom-modules/sample-wellness-module/workflows/guided-meditation/README.md +0 -0
  278. /package/{docs → samples}/sample-custom-modules/sample-wellness-module/workflows/guided-meditation/workflow.md +0 -0
  279. /package/{docs → samples}/sample-custom-modules/sample-wellness-module/workflows/wellness-journal/README.md +0 -0
  280. /package/{docs → samples}/sample-custom-modules/sample-wellness-module/workflows/wellness-journal/workflow.md +0 -0
@@ -30,7 +30,7 @@
30
30
  ### IDE Manager & Base
31
31
 
32
32
  - @/tools/cli/installers/lib/ide/manager.js - IdeManager class (dynamic handler loading)
33
- - @/tools/cli/installers/lib/ide/\_base-ide.js - BaseIdeSetup class (all handlers extend this)
33
+ - @/tools/cli/installers/lib/ide/_base-ide.js - BaseIdeSetup class (all handlers extend this)
34
34
 
35
35
  ### Shared Utilities
36
36
 
@@ -117,7 +117,7 @@ Contains:
117
117
 
118
118
  - Add new IDE handler: Create file in /tools/cli/installers/lib/ide/, extend BaseIdeSetup
119
119
  - Fix installer bug: Check installer.js (94KB - main logic)
120
- - Add module installer: Create \_module-installer/installer.js if custom installer logic needed
120
+ - Add module installer: Create _module-installer/installer.js if custom installer logic needed
121
121
  - Update shared generators: Modify files in /shared/ directory
122
122
 
123
123
  ## Relationships
@@ -142,7 +142,7 @@ Defined in @/tools/cli/lib/platform-codes.js
142
142
 
143
143
  ## Common Tasks
144
144
 
145
- - Create new module installer: Add \_module-installer/installer.js
145
+ - Create new module installer: Add _module-installer/installer.js
146
146
  - Add IDE sub-module: Create sub-modules/{ide-name}/ with config
147
147
  - Add new IDE support: Create handler in installers/lib/ide/
148
148
  - Customize module installation: Modify module.yaml
@@ -66,7 +66,7 @@ To set up the quiz game by selecting game mode, choosing a category, and prepari
66
66
 
67
67
  ### 1. Welcome and Configuration Loading
68
68
 
69
- Load config from {project-root}/\_bmad/bmb/config.yaml to get user_name.
69
+ Load config from {project-root}/_bmad/bmb/config.yaml to get user_name.
70
70
 
71
71
  Present dramatic welcome:
72
72
  "🎺 _DRAMATIC MUSIC PLAYS_ 🎺
@@ -45,7 +45,7 @@ web_bundle: true
45
45
 
46
46
  ### 1. Module Configuration Loading
47
47
 
48
- Load and read full config from {project-root}/\_bmad/bmb/config.yaml and resolve:
48
+ Load and read full config from {project-root}/_bmad/bmb/config.yaml and resolve:
49
49
 
50
50
  - `user_name`, `output_folder`, `communication_language`, `document_output_language`
51
51
 
@@ -0,0 +1,41 @@
1
+ <!-- if possible, run this in a separate subagent or process with read access to the project,
2
+ but no context except the content to review -->
3
+
4
+ <task id="_bmad/core/tasks/review-adversarial-general.xml" name="Adversarial Review (General)">
5
+ <objective>Cynically review content and produce findings</objective>
6
+
7
+ <inputs>
8
+ <input name="content" desc="Content to review - diff, spec, story, doc, or any artifact" />
9
+ </inputs>
10
+
11
+ <llm critical="true">
12
+ <i>You are a cynical, jaded reviewer with zero patience for sloppy work</i>
13
+ <i>The content was submitted by a clueless weasel and you expect to find problems</i>
14
+ <i>Be skeptical of everything</i>
15
+ <i>Look for what's missing, not just what's wrong</i>
16
+ <i>Use a precise, professional tone - no profanity or personal attacks</i>
17
+ </llm>
18
+
19
+ <flow>
20
+ <step n="1" title="Receive Content">
21
+ <action>Load the content to review from provided input or context</action>
22
+ <action>If content to review is empty, ask for clarification and abort task</action>
23
+ <action>Identify content type (diff, branch, uncommitted changes, document, etc.)</action>
24
+ </step>
25
+
26
+ <step n="2" title="Adversarial Analysis" critical="true">
27
+ <mandate>Review with extreme skepticism - assume problems exist</mandate>
28
+ <action>Find at least ten issues to fix or improve in the provided content</action>
29
+ </step>
30
+
31
+ <step n="3" title="Present Findings">
32
+ <action>Output findings as a Markdown list (descriptions only)</action>
33
+ </step>
34
+ </flow>
35
+
36
+ <halt-conditions>
37
+ <condition>HALT if zero findings - this is suspicious, re-analyze or ask for guidance</condition>
38
+ <condition>HALT if content is empty or unreadable</condition>
39
+ </halt-conditions>
40
+
41
+ </task>
@@ -0,0 +1,25 @@
1
+ # BMB - BMad Builder Module
2
+
3
+ Specialized tools and workflows for creating, customizing, and extending BMad components including agents, workflows, and complete modules.
4
+
5
+ ## Overview
6
+
7
+ BMB provides a complete toolkit for extending BMad Method with disciplined, systematic approaches to agent and workflow development while maintaining framework consistency and power.
8
+
9
+ **1 Master Builder Agent** | **5 Creation Workflows** | **3 Agent Architectures**
10
+
11
+ ## Documentation
12
+
13
+ For complete documentation, architecture guides, and reference materials:
14
+
15
+ **[→ BMB Documentation](./docs/index.md)**
16
+
17
+ ## Quick Links
18
+
19
+ - [Agent Creation Guide](./docs/agents/index.md) - Build custom agents
20
+ - [Workflow Architecture](./docs/workflows/index.md) - Design workflows
21
+ - [Reference Examples](./reference/) - Working examples and templates
22
+
23
+ ---
24
+
25
+ Part of [BMad Method](https://github.com/bmadcode/bmad-method) v6.0
@@ -223,7 +223,7 @@ Same as simple agents, PLUS:
223
223
 
224
224
  ## Reference Example
225
225
 
226
- See: `bmb/reference/agents/expert-examples/journal-keeper/`
226
+ See: [journal-keeper/](https://github.com/bmad-code-org/BMAD-METHOD/tree/main/src/modules/bmb/reference/agents/expert-examples/journal-keeper)
227
227
 
228
228
  Features demonstrated:
229
229
 
@@ -355,8 +355,8 @@ identity: |
355
355
  - [ ] Sidecar folder structure created and populated
356
356
  - [ ] memories.md has clear section structure
357
357
  - [ ] instructions.md contains core directives
358
- - [ ] Menu actions reference \_bmad/\_memory correctly
359
- - [ ] File paths use \_bmad/\_memory/[agentname]-sidecar/ to reference sidecar content
358
+ - [ ] Menu actions reference _bmad/_memory correctly
359
+ - [ ] File paths use _bmad/_memory/[agentname]-sidecar/ to reference sidecar content
360
360
  - [ ] Install config personalizes sidecar references
361
361
  - [ ] Agent folder named consistently: `{agent-name}/`
362
362
  - [ ] YAML file named: `{agent-name}.agent.yaml`
@@ -9,7 +9,7 @@ Comprehensive guides for each agent type (choose based on use case):
9
9
  - [Understanding Agent Types](./understanding-agent-types.md) - **START HERE** - Architecture vs capability, "The Same Agent, Three Ways"
10
10
  - [Simple Agent Architecture](./simple-agent-architecture.md) - Self-contained, optimized, personality-driven
11
11
  - [Expert Agent Architecture](./expert-agent-architecture.md) - Memory, sidecar files, domain restrictions
12
- - [Module Agent Architecture](./module-agent-architecture.md) - Workflow integration, professional tools
12
+ - Module Agent Architecture _(TODO)_ - Workflow integration, professional tools
13
13
 
14
14
  ## Agent Design Patterns
15
15
 
@@ -18,20 +18,20 @@ Comprehensive guides for each agent type (choose based on use case):
18
18
 
19
19
  ## Reference Examples
20
20
 
21
- Production-ready examples in `/bmb/reference/agents/`:
21
+ Production-ready examples in [bmb/reference/agents/](https://github.com/bmad-code-org/BMAD-METHOD/tree/main/src/modules/bmb/reference/agents):
22
22
 
23
- **Simple Agents** (`simple-examples/`)
23
+ **Simple Agents** ([simple-examples/](https://github.com/bmad-code-org/BMAD-METHOD/tree/main/src/modules/bmb/reference/agents/simple-examples))
24
24
 
25
- - `commit-poet.agent.yaml` - Commit message artisan with style customization
25
+ - [commit-poet.agent.yaml](https://github.com/bmad-code-org/BMAD-METHOD/blob/main/src/modules/bmb/reference/agents/simple-examples/commit-poet.agent.yaml) - Commit message artisan with style customization
26
26
 
27
- **Expert Agents** (`expert-examples/`)
27
+ **Expert Agents** ([expert-examples/](https://github.com/bmad-code-org/BMAD-METHOD/tree/main/src/modules/bmb/reference/agents/expert-examples))
28
28
 
29
- - `journal-keeper/` - Personal journal companion with memory and pattern recognition
29
+ - [journal-keeper/](https://github.com/bmad-code-org/BMAD-METHOD/tree/main/src/modules/bmb/reference/agents/expert-examples/journal-keeper) - Personal journal companion with memory and pattern recognition
30
30
 
31
- **Module Agents** (`module-examples/`)
31
+ **Module Agents** ([module-examples/](https://github.com/bmad-code-org/BMAD-METHOD/tree/main/src/modules/bmb/reference/agents/module-examples))
32
32
 
33
- - `security-engineer.agent.yaml` - BMM security specialist with threat modeling
34
- - `trend-analyst.agent.yaml` - CIS trend intelligence expert
33
+ - [security-engineer.agent.yaml](https://github.com/bmad-code-org/BMAD-METHOD/blob/main/src/modules/bmb/reference/agents/module-examples/security-engineer.agent.yaml) - BMM security specialist with threat modeling
34
+ - [trend-analyst.agent.yaml](https://github.com/bmad-code-org/BMAD-METHOD/blob/main/src/modules/bmb/reference/agents/module-examples/trend-analyst.agent.yaml) - CIS trend intelligence expert
35
35
 
36
36
  ## Installation Guide
37
37
 
@@ -206,7 +206,7 @@ The `tools/cli/lib/agent/compiler.js` automatically adds:
206
206
 
207
207
  ## Reference Example
208
208
 
209
- See: `../../reference/agents/simple-examples/commit-poet.agent.yaml`
209
+ See: [commit-poet.agent.yaml](https://github.com/bmad-code-org/BMAD-METHOD/blob/main/src/modules/bmb/reference/agents/simple-examples/commit-poet.agent.yaml)
210
210
 
211
211
  Features demonstrated:
212
212
 
@@ -7,7 +7,7 @@ ALL agent types can:
7
7
  - ✓ Write to {output_folder}, {project-root}, or anywhere on system
8
8
  - ✓ Update artifacts and files
9
9
  - ✓ Execute bash commands
10
- - ✓ Use core variables (\_bmad, {output_folder}, etc.)
10
+ - ✓ Use core variables (_bmad, {output_folder}, etc.)
11
11
  - ✓ Have complex prompts and logic
12
12
  - ✓ Invoke external tools
13
13
 
@@ -20,8 +20,6 @@ Specialized tools and workflows for creating, customizing, and extending BMad co
20
20
 
21
21
  - Install Location: `_bmad/bmb/agents/bmad-builder.md`
22
22
 
23
- ### 📋 Workflows
24
-
25
23
  ### 📚 Documentation
26
24
 
27
25
  - Comprehensive guides for agents, workflows, and modules
@@ -46,33 +44,33 @@ Specialized tools and workflows for creating, customizing, and extending BMad co
46
44
 
47
45
  - **[Workflow Index](./workflows/index.md)** - Core workflow system overview
48
46
  - **[Architecture Guide](./workflows/architecture.md)** - Step-file design and JIT loading
49
- - **[Template System](./workflows/templates/step-template.md)** - Standard step file template
47
+ - **Template System** _(TODO)_ - Standard step file template
50
48
  - **[Intent vs Prescriptive](./workflows/intent-vs-prescriptive-spectrum.md)** - Design philosophy
51
49
 
52
50
  ## Reference Materials
53
51
 
54
52
  ### 🤖 Agent Examples
55
53
 
56
- - **[Simple Agent Example](../reference/agents/simple-examples/commit-poet.agent.yaml)** - Self-contained agent
57
- - **[Expert Agent Example](../reference/agents/expert-examples/journal-keeper/journal-keeper.agent.yaml)** - Agent with persistent memory
58
- - **[Module Add On Agent Examples](../reference/agents/module-examples/security-engineer.agent.yaml)** - Integration patterns (BMM, CIS)
54
+ - **[Simple Agent Example](https://github.com/bmad-code-org/BMAD-METHOD/blob/main/src/modules/bmb/reference/agents/simple-examples/commit-poet.agent.yaml)** - Self-contained agent
55
+ - **[Expert Agent Example](https://github.com/bmad-code-org/BMAD-METHOD/blob/main/src/modules/bmb/reference/agents/expert-examples/journal-keeper/journal-keeper.agent.yaml)** - Agent with persistent memory
56
+ - **[Module Add On Agent Examples](https://github.com/bmad-code-org/BMAD-METHOD/blob/main/src/modules/bmb/reference/agents/module-examples/security-engineer.agent.yaml)** - Integration patterns (BMM, CIS)
59
57
 
60
58
  ### 📋 Workflow Examples
61
59
 
62
- - **[Meal Prep & Nutrition](./reference/workflows/meal-prep-nutrition/)** - Complete step-file workflow demonstration
60
+ - **[Meal Prep & Nutrition](https://github.com/bmad-code-org/BMAD-METHOD/tree/main/src/modules/bmb/reference/workflows/meal-prep-nutrition)** - Complete step-file workflow demonstration
63
61
  - **Template patterns** for document generation and state management
64
62
 
65
63
  ## Core Workflows
66
64
 
67
65
  ### Creation Workflows (Step-File Architecture)
68
66
 
69
- **[create-agent](./workflows/create-agent/)** - Build BMad agents
67
+ **create-agent** _(TODO)_ - Build BMad agents
70
68
 
71
69
  - 11 guided steps from brainstorming to celebration
72
70
  - 18 reference data files with validation checklists
73
71
  - Template-based agent generation
74
72
 
75
- **[create-workflow](./workflows/create-workflow/)** - Design workflows
73
+ **create-workflow** _(TODO)_ - Design workflows
76
74
 
77
75
  - 12 structured steps from init to review
78
76
  - 9 template files for workflow creation
@@ -80,13 +78,13 @@ Specialized tools and workflows for creating, customizing, and extending BMad co
80
78
 
81
79
  ### Editing Workflows
82
80
 
83
- **[edit-agent](./workflows/edit-agent/)** - Modify existing agents
81
+ **edit-agent** _(TODO)_ - Modify existing agents
84
82
 
85
83
  - 5 steps: discovery → validation
86
84
  - Intent-driven analysis and updates
87
85
  - Best practice compliance
88
86
 
89
- **[edit-workflow](./workflows/edit-workflow/)** - Update workflows
87
+ **edit-workflow** _(TODO)_ - Update workflows
90
88
 
91
89
  - 5 steps: analyze → compliance check
92
90
  - Structure maintenance and validation
@@ -94,7 +92,7 @@ Specialized tools and workflows for creating, customizing, and extending BMad co
94
92
 
95
93
  ### Quality Assurance
96
94
 
97
- **[workflow-compliance-check](./workflows/workflow-compliance-check/)** - Validation
95
+ **workflow-compliance-check** _(TODO)_ - Validation
98
96
 
99
97
  - 8 systematic validation steps
100
98
  - Adversarial analysis approach
@@ -12,27 +12,27 @@ Essential terminology and concepts for understanding BMAD workflows.
12
12
 
13
13
  The micro-file architecture, JIT step loading, state management, and collaboration patterns that make BMAD workflows optimal for AI execution.
14
14
 
15
- ### [Writing Workflows](./writing-workflows.md)
15
+ ### Writing Workflows _(TODO)_
16
16
 
17
17
  Complete guide to creating workflows: workflow.md control files, step files, CSV data integration, and frontmatter design.
18
18
 
19
- ### [Step Files & Dialog Patterns](./step-files.md)
19
+ ### Step Files & Dialog Patterns _(TODO)_
20
20
 
21
21
  Crafting effective step files: structure, execution rules, prescriptive vs intent-based dialog, and validation patterns.
22
22
 
23
- ### [Templates & Content Generation](./templates.md)
23
+ ### Templates & Content Generation _(TODO)_
24
24
 
25
25
  Creating append-only templates, frontmatter design, conditional content, and dynamic content generation strategies.
26
26
 
27
- ### [Workflow Patterns](./patterns.md)
27
+ ### Workflow Patterns _(TODO)_
28
28
 
29
29
  Common workflow types: linear, conditional, protocol integration, multi-agent workflows, and real-world examples.
30
30
 
31
- ### [Migration Guide](./migration.md)
31
+ ### Migration Guide _(TODO)_
32
32
 
33
33
  Converting from XML-heavy workflows to the new pure markdown format, with before/after examples and checklist.
34
34
 
35
- ### [Best Practices & Reference](./best-practices.md)
35
+ ### Best Practices & Reference _(TODO)_
36
36
 
37
37
  Critical rules, anti-patterns, performance optimization, debugging, quick reference templates, and troubleshooting.
38
38
 
@@ -13,16 +13,16 @@ description: 'Initialize the [workflow-type] workflow by detecting continuation
13
13
 
14
14
  <!-- Path Definitions -->
15
15
 
16
- workflow\*path: '{project-root}/\_bmad/[module-path]/workflows/[workflow-name]'
16
+ workflow\*path: `{project-root}/_bmad/[module-path]/workflows/[workflow-name]`
17
17
 
18
18
  # File References (all use {variable} format in file)
19
19
 
20
- thisStepFile: '{workflow_path}/steps/step-01-init.md'
21
- nextStepFile: '{workflow_path}/steps/step-02-[step-name].md'
22
- workflowFile: '{workflow_path}/workflow.md'
23
- outputFile: '{output_folder}/[output-file-name]-{project_name}.md'
24
- continueFile: '{workflow_path}/steps/step-01b-continue.md'
25
- templateFile: '{workflow_path}/templates/[main-template].md'
20
+ thisStepFile: `{workflow_path}/steps/step-01-init.md`
21
+ nextStepFile: `{workflow_path}/steps/step-02-[step-name].md`
22
+ workflowFile: `{workflow_path}/workflow.md`
23
+ outputFile: `{output_folder}/[output-file-name]-{project_name}.md`
24
+ continueFile: `{workflow_path}/steps/step-01b-continue.md`
25
+ templateFile: `{workflow_path}/templates/[main-template].md`
26
26
 
27
27
  # Template References
28
28
 
@@ -13,7 +13,7 @@ description: 'Handle workflow continuation from previous session'
13
13
 
14
14
  <!-- Path Definitions -->
15
15
 
16
- workflow\*path: '{project-root}/\_bmad/[module-path]/workflows/[workflow-name]'
16
+ workflow\*path: '{project-root}/_bmad/[module-path]/workflows/[workflow-name]'
17
17
 
18
18
  # File References (all use {variable} format in file)
19
19
 
@@ -11,7 +11,7 @@ description: '[Brief description of what this step accomplishes]'
11
11
 
12
12
  <!-- Path Definitions -->
13
13
 
14
- workflow\*path: '{project-root}/\_bmad/[module]/reference/workflows/[workflow-name]' # the folder the workflow.md file is in
14
+ workflow\*path: '{project-root}/_bmad/[module]/reference/workflows/[workflow-name]' # the folder the workflow.md file is in
15
15
 
16
16
  # File References (all use {variable} format in file)
17
17
 
@@ -23,8 +23,8 @@ 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'
27
- partyModeWorkflow: '{project-root}/\_bmad/core/workflows/party-mode/workflow.md'
26
+ advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
27
+ partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
28
28
 
29
29
  # Template References (if this step uses a specific templates)
30
30
 
@@ -243,7 +243,7 @@ Display: "**Select an Option:** [A] [Continue to Step Foo] [A] [Continue to Step
243
243
 
244
244
  ### Initialization Step Example
245
245
 
246
- See [step-01-init.md](../reference/workflows/meal-prep-nutrition/steps/step-01-init.md) for an example of:
246
+ See [step-01-init.md](https://github.com/bmad-code-org/BMAD-METHOD/blob/main/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-01-init.md) for an example of:
247
247
 
248
248
  - Detecting existing workflow state and short circuit to 1b
249
249
  - Creating output documents from templates
@@ -252,7 +252,7 @@ See [step-01-init.md](../reference/workflows/meal-prep-nutrition/steps/step-01-i
252
252
 
253
253
  ### Continuation Step Example
254
254
 
255
- See [step-01b-continue.md](../reference/workflows/meal-prep-nutrition/steps/step-01b-continue.md) for an example of:
255
+ See [step-01b-continue.md](https://github.com/bmad-code-org/BMAD-METHOD/blob/main/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-01b-continue.md) for an example of:
256
256
 
257
257
  - Handling already-in-progress workflows
258
258
  - Detecting completion status
@@ -261,7 +261,7 @@ See [step-01b-continue.md](../reference/workflows/meal-prep-nutrition/steps/step
261
261
 
262
262
  ### Standard Step with Menu Example
263
263
 
264
- See [step-02-profile.md](../reference/workflows/meal-prep-nutrition/steps/step-02-profile.md) for an example of:
264
+ See [step-02-profile.md](https://github.com/bmad-code-org/BMAD-METHOD/blob/main/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-02-profile.md) for an example of:
265
265
 
266
266
  - Presenting a menu with A/P/C options
267
267
  - Forcing halt until user selects 'C' (Continue)
@@ -271,7 +271,7 @@ See [step-02-profile.md](../reference/workflows/meal-prep-nutrition/steps/step-0
271
271
 
272
272
  ### Final Step Example
273
273
 
274
- See [step-06-prep-schedule.md](../reference/workflows/meal-prep-nutrition/steps/step-06-prep-schedule.md) for an example of:
274
+ See [step-06-prep-schedule.md](https://github.com/bmad-code-org/BMAD-METHOD/blob/main/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-06-prep-schedule.md) for an example of:
275
275
 
276
276
  - Completing workflow deliverables
277
277
  - Marking workflow as complete in frontmatter
@@ -53,7 +53,7 @@ web_bundle: [true/false] # Set to true for inclusion in web bundle builds
53
53
 
54
54
  ### 1. Module Configuration Loading
55
55
 
56
- Load and read full config from {project-root}/\_bmad/[MODULE FOLDER]/config.yaml and resolve:
56
+ Load and read full config from {project-root}/_bmad/[MODULE FOLDER]/config.yaml and resolve:
57
57
 
58
58
  - `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`, [MODULE VARS]
59
59
 
@@ -49,7 +49,7 @@ This uses **step-file architecture** for disciplined execution:
49
49
 
50
50
  ### 1. Configuration Loading
51
51
 
52
- Load and read full config from {project-root}/\_bmad/{{targetModule}}/config.yaml and resolve:
52
+ Load and read full config from {project-root}/_bmad/{{targetModule}}/config.yaml and resolve:
53
53
 
54
54
  - `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`
55
55
 
@@ -49,7 +49,7 @@ This uses **step-file architecture** for disciplined execution:
49
49
 
50
50
  ### 1. Configuration Loading
51
51
 
52
- Load and read full config from {project-root}/\_bmad/core/config.yaml and resolve:
52
+ Load and read full config from {project-root}/_bmad/core/config.yaml and resolve:
53
53
 
54
54
  - `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`
55
55
 
@@ -49,7 +49,7 @@ This uses **step-file architecture** for disciplined execution:
49
49
 
50
50
  ### 1. Configuration Loading
51
51
 
52
- Load and read full config from {project-root}/\_bmad/bmm/config.yaml and resolve:
52
+ Load and read full config from {project-root}/_bmad/bmm/config.yaml and resolve:
53
53
 
54
54
  - `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`, `user_skill_level`
55
55
 
@@ -313,7 +313,7 @@ critical_actions:
313
313
 
314
314
  1. **Load sidecar files in critical_actions** - Must be explicit and MANDATORY
315
315
  2. **Enforce domain restrictions** - Clear boundaries prevent scope creep
316
- 3. **Use \_bmad/\_memory/[agentname]-sidcar/ paths** - For reference to any sidecar content
316
+ 3. **Use _bmad/_memory/[agentname]-sidcar/ paths** - For reference to any sidecar content
317
317
  4. **Design for memory growth** - Structure sidecar files for accumulation
318
318
  5. **Reference past naturally** - Don't dump memory, weave it into conversation
319
319
  6. **Separate concerns** - Memories, instructions, knowledge in distinct files
@@ -356,8 +356,8 @@ identity: |
356
356
  - [ ] Sidecar folder structure created and populated
357
357
  - [ ] memories.md has clear section structure
358
358
  - [ ] instructions.md contains core directives
359
- - [ ] Menu actions reference \_bmad/\_memory/[agentname]-sidcar/ correctly if needing sidecar content reference
360
- - [ ] File paths use \_bmad/\_memory/[agentname]-sidcar/ to reference where the file will be after sidecar content is installed
359
+ - [ ] Menu actions reference _bmad/_memory/[agentname]-sidcar/ correctly if needing sidecar content reference
360
+ - [ ] File paths use _bmad/_memory/[agentname]-sidcar/ to reference where the file will be after sidecar content is installed
361
361
  - [ ] Install config personalizes sidecar references
362
362
  - [ ] Agent folder named consistently: `{agent-name}/`
363
363
  - [ ] YAML file named: `{agent-name}.agent.yaml`
@@ -129,7 +129,7 @@ Create all directories in {bmb_creations_output_folder}/{module_name}/:
129
129
  3. **tasks/** - For task files (if tasks planned)
130
130
  4. **templates/** - For shared templates
131
131
  5. **data/** - For module data
132
- 6. **\_module-installer/** - For installation configuration
132
+ 6. **_module-installer/** - For installation configuration
133
133
 
134
134
  ### 4. Create Placeholder README
135
135
 
@@ -71,8 +71,8 @@ From step 5, we planned these configuration fields:
71
71
 
72
72
  ### 2. Create Installer Directory
73
73
 
74
- Ensure \_module-installer directory exists
75
- Directory: {bmb_creations_output_folder}/{module_name}/\_module-installer/
74
+ Ensure _module-installer directory exists
75
+ Directory: {bmb_creations_output_folder}/{module_name}/_module-installer/
76
76
 
77
77
  ### 3. Create module.yaml
78
78
 
@@ -95,7 +95,7 @@ Does your module need any special setup during installation? For example:
95
95
 
96
96
  "I'll create an installer.js file for custom logic."
97
97
 
98
- Create file: {bmb_creations_output_folder}/{module_name}/\_module-installer/installer.js from {installerTemplate}
98
+ Create file: {bmb_creations_output_folder}/{module_name}/_module-installer/installer.js from {installerTemplate}
99
99
 
100
100
  Update installer.js with module-specific logic
101
101
 
@@ -105,7 +105,7 @@ Update installer.js with module-specific logic
105
105
 
106
106
  If your module needs to copy files during installation (templates, examples, documentation), we can add them to the assets directory."
107
107
 
108
- Create directory: \_module-installer/assets/
108
+ Create directory: _module-installer/assets/
109
109
  Add note about what assets to include
110
110
 
111
111
  ### 6. Document Installer Setup
@@ -131,7 +131,7 @@ Update module-plan.md with installer section:
131
131
 
132
132
  1. User runs: `bmad install {module_name}`
133
133
  2. Installer asks: [list of questions]
134
- 3. Creates: \_bmad/{module_name}/
134
+ 3. Creates: _bmad/{module_name}/
135
135
  4. Generates: config.yaml with user settings
136
136
 
137
137
  ### Validation
@@ -264,7 +264,7 @@ Analyze the visual design with my signature dramatic flair
264
264
  menu: # Core interactions - multi: "[CH] Chat with Caravaggio or [SPM] Start Party Mode"
265
265
  triggers: - party-mode:
266
266
  input: SPM or fuzzy match start party mode
267
- route: "{project-root}/\_bmad/core/workflows/edit-agent/workflow.md"
267
+ route: "{project-root}/_bmad/core/workflows/edit-agent/workflow.md"
268
268
  data: what's being discussed, plus custom party agents if specified
269
269
  type: exec - expert-chat:
270
270
  input: CH or fuzzy match validate agent
@@ -11,11 +11,11 @@ This document provides the validation criteria used in step-11-validate.md to en
11
11
  - [ ] tasks/ - Task files (if needed)
12
12
  - [ ] templates/ - Shared templates
13
13
  - [ ] data/ - Module data
14
- - [ ] \_module-installer/ - Installation config
14
+ - [ ] _module-installer/ - Installation config
15
15
  - [ ] README.md - Module documentation
16
16
  - [ ] module.yaml - module config file
17
17
 
18
- ### Optional File in \_module-installer/
18
+ ### Optional File in _module-installer/
19
19
 
20
20
  - [ ] installer.js - Custom logic (if needed)
21
21
 
@@ -46,7 +46,7 @@ installed_path: '{project-root}/_bmad/bmb/workflows/create-module'
46
46
 
47
47
  ### 1. Module Configuration Loading
48
48
 
49
- Load and read full config from {project-root}/\_bmad/bmb/config.yaml and resolve:
49
+ Load and read full config from {project-root}/_bmad/bmb/config.yaml and resolve:
50
50
 
51
51
  - `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`, `bmb_creations_output_folder`
52
52
 
@@ -72,7 +72,7 @@ To generate all the workflow files (workflow.md, step files, templates, and supp
72
72
  - When building continuable step-01-init.md files, use template `{project-root}/_bmad/bmb/docs/workflows/templates/step-01-init-continuable-template.md`
73
73
  - When building continuation steps, use template `{project-root}/_bmad/bmb/docs/workflows/templates/step-1b-template.md`
74
74
  - When building the main workflow.md file, you must follow template `{project-root}/_bmad/bmb/docs/workflows/templates/workflow-template.md`
75
- - Example step files from {project-root}/\_bmad/bmb/reference/workflows/meal-prep-nutrition/workflow.md for patterns
75
+ - Example step files from {project-root}/_bmad/bmb/reference/workflows/meal-prep-nutrition/workflow.md for patterns
76
76
 
77
77
  ## FILE GENERATION SEQUENCE:
78
78
 
@@ -117,7 +117,7 @@ Load and follow {workflowTemplate}:
117
117
 
118
118
  - Create workflow.md using template structure
119
119
  - Insert workflow name and description
120
- - Configure all path variables ({project-root}, \_bmad, {workflow_path})
120
+ - Configure all path variables ({project-root}, _bmad, {workflow_path})
121
121
  - Set web_bundle flag to true unless user has indicated otherwise
122
122
  - Define role and goal
123
123
  - Include initialization path to step-01
@@ -49,7 +49,7 @@ This uses **step-file architecture** for disciplined execution:
49
49
 
50
50
  ### 1. Configuration Loading
51
51
 
52
- Load and read full config from {project-root}/\_bmad/bmb/config.yaml and resolve:
52
+ Load and read full config from {project-root}/_bmad/bmb/config.yaml and resolve:
53
53
 
54
54
  - `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`, `bmb_creations_output_folder`
55
55
 
@@ -49,7 +49,7 @@ This uses **step-file architecture** for disciplined execution:
49
49
 
50
50
  ### 1. Configuration Loading
51
51
 
52
- Load and read full config from {project-root}/\_bmad/bmb/config.yaml and resolve:
52
+ Load and read full config from {project-root}/_bmad/bmb/config.yaml and resolve:
53
53
 
54
54
  - `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`
55
55
 
@@ -49,7 +49,7 @@ This uses **step-file architecture** for disciplined execution:
49
49
 
50
50
  ### 1. Configuration Loading
51
51
 
52
- Load and read full config from {project-root}/\_bmad/bmb/config.yaml and resolve:
52
+ Load and read full config from {project-root}/_bmad/bmb/config.yaml and resolve:
53
53
 
54
54
  - `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`
55
55
 
@@ -135,7 +135,7 @@ For each deviation:
135
135
  - Configuration Loading uses correct path format: `{project-root}/_bmad/[module]/config.yaml` (variable substitution pattern)
136
136
  - First step follows pattern: `step-01-init.md` OR documented deviation
137
137
  - Required config variables properly listed
138
- - Variables use proper substitution pattern: {project-root}, \_bmad, {workflow_path}, etc.
138
+ - Variables use proper substitution pattern: {project-root}, _bmad, {workflow_path}, etc.
139
139
 
140
140
  For violations:
141
141
 
@@ -49,7 +49,7 @@ This uses **step-file architecture** for disciplined execution:
49
49
 
50
50
  ### 1. Configuration Loading
51
51
 
52
- Load and read full config from {project-root}/\_bmad/bmb/config.yaml and resolve:
52
+ Load and read full config from {project-root}/_bmad/bmb/config.yaml and resolve:
53
53
 
54
54
  - `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`
55
55
 
@@ -126,7 +126,7 @@ Use this checklist to validate module edits meet BMAD Core standards.
126
126
 
127
127
  - [ ] Web bundles configured in workflow.yaml files
128
128
  - [ ] All referenced files included in web_bundle_files
129
- - [ ] Paths are \_bmad/-relative (not project-root)
129
+ - [ ] Paths are _bmad/-relative (not project-root)
130
130
  - [ ] No config_source references in web bundles
131
131
  - [ ] Invoked workflows included in dependencies
132
132