bmad-method 6.0.0-alpha.21 → 6.0.0-alpha.23

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 (812) hide show
  1. package/.coderabbit.yaml +2 -2
  2. package/.github/workflows/docs.yaml +3 -12
  3. package/.vscode/settings.json +1 -0
  4. package/CHANGELOG.md +309 -0
  5. package/CNAME +1 -0
  6. package/CONTRIBUTING.md +9 -7
  7. package/README.md +41 -207
  8. package/docs/404.md +9 -0
  9. package/{src/modules/bmm/docs/images/README.md → docs/_README_WORKFLOW_DIAGRAMS.md} +4 -1
  10. package/docs/_STYLE_GUIDE.md +347 -0
  11. package/docs/_archive/getting-started-bmadv4.md +247 -0
  12. package/{website/src/pages → docs}/downloads.md +17 -26
  13. package/{src/modules/bmm/docs/quick-flow-solo-dev.md → docs/explanation/agents/barry-quick-flow.md} +18 -15
  14. package/docs/explanation/agents/index.md +28 -0
  15. package/docs/explanation/architecture/four-phases.md +126 -0
  16. package/docs/explanation/architecture/preventing-agent-conflicts.md +138 -0
  17. package/docs/explanation/architecture/why-solutioning-matters.md +91 -0
  18. package/docs/{custom-content.md → explanation/bmad-builder/custom-content-types.md} +19 -21
  19. package/docs/explanation/bmad-builder/index.md +66 -0
  20. package/docs/explanation/bmm/index.md +135 -0
  21. package/docs/explanation/core/index.md +18 -0
  22. package/docs/explanation/core-concepts/agent-roles.md +204 -0
  23. package/docs/explanation/core-concepts/index.md +40 -0
  24. package/docs/explanation/core-concepts/what-are-agents.md +96 -0
  25. package/docs/explanation/core-concepts/what-are-modules.md +79 -0
  26. package/docs/explanation/core-concepts/what-are-workflows.md +217 -0
  27. package/{src/modules/cis/docs → docs/explanation/creative-intelligence}/index.md +26 -54
  28. package/docs/explanation/faq/brownfield-faq.md +73 -0
  29. package/docs/explanation/faq/getting-started-faq.md +62 -0
  30. package/docs/explanation/faq/implementation-faq.md +52 -0
  31. package/docs/explanation/faq/index.md +16 -0
  32. package/docs/explanation/faq/levels-and-tracks-faq.md +52 -0
  33. package/docs/explanation/faq/planning-faq.md +41 -0
  34. package/docs/explanation/faq/tools-faq.md +253 -0
  35. package/docs/explanation/faq/workflows-faq.md +61 -0
  36. package/docs/explanation/features/advanced-elicitation.md +108 -0
  37. package/docs/explanation/features/brainstorming-techniques.md +103 -0
  38. package/{src/modules/bmm/docs → docs/explanation/features}/party-mode.md +11 -123
  39. package/docs/explanation/features/quick-flow.md +169 -0
  40. package/{src/modules/bmm/docs/test-architecture.md → docs/explanation/features/tea-overview.md} +160 -118
  41. package/docs/explanation/features/web-bundles.md +35 -0
  42. package/{src/modules/bmgd/docs/agents-guide.md → docs/explanation/game-dev/agents.md} +8 -5
  43. package/docs/explanation/game-dev/bmgd-vs-bmm.md +150 -0
  44. package/{src/modules/bmgd/docs/game-types-guide.md → docs/explanation/game-dev/game-types.md} +7 -4
  45. package/docs/explanation/game-dev/index.md +85 -0
  46. package/docs/explanation/philosophy/facilitation-over-generation.md +121 -0
  47. package/docs/explanation/philosophy/testing-as-engineering.md +119 -0
  48. package/docs/how-to/brownfield/add-feature-to-existing.md +91 -0
  49. package/docs/how-to/brownfield/document-existing-project.md +84 -0
  50. package/docs/how-to/brownfield/index.md +102 -0
  51. package/docs/how-to/brownfield/quick-fix-in-brownfield.md +94 -0
  52. package/docs/{agent-customization-guide.md → how-to/customization/customize-agents.md} +10 -10
  53. package/docs/how-to/customization/customize-workflows.md +33 -0
  54. package/docs/how-to/customization/index.md +27 -0
  55. package/docs/how-to/customization/shard-large-documents.md +125 -0
  56. package/docs/how-to/customization/vendor-workflows.md +45 -0
  57. package/docs/how-to/get-answers-about-bmad.md +98 -0
  58. package/docs/how-to/installation/index.md +15 -0
  59. package/docs/how-to/installation/install-bmad.md +138 -0
  60. package/docs/{custom-content-installation.md → how-to/installation/install-custom-modules.md} +17 -14
  61. package/docs/how-to/installation/upgrade-to-v6.md +147 -0
  62. package/{src/modules/bmgd/docs/troubleshooting.md → docs/how-to/troubleshooting/bmgd-troubleshooting.md} +7 -5
  63. package/{src/modules/bmgd/docs/quick-flow-guide.md → docs/how-to/workflows/bmgd-quick-flow.md} +8 -5
  64. package/docs/how-to/workflows/conduct-research.md +130 -0
  65. package/docs/how-to/workflows/create-architecture.md +147 -0
  66. package/docs/how-to/workflows/create-epics-and-stories.md +136 -0
  67. package/docs/how-to/workflows/create-prd.md +130 -0
  68. package/docs/how-to/workflows/create-product-brief.md +117 -0
  69. package/docs/how-to/workflows/create-story.md +119 -0
  70. package/docs/how-to/workflows/create-ux-design.md +117 -0
  71. package/docs/how-to/workflows/implement-story.md +127 -0
  72. package/docs/how-to/workflows/quick-spec.md +159 -0
  73. package/docs/how-to/workflows/run-brainstorming-session.md +94 -0
  74. package/docs/how-to/workflows/run-code-review.md +141 -0
  75. package/docs/how-to/workflows/run-implementation-readiness.md +162 -0
  76. package/docs/how-to/workflows/run-sprint-planning.md +111 -0
  77. package/docs/how-to/workflows/run-test-design.md +128 -0
  78. package/docs/how-to/workflows/setup-party-mode.md +117 -0
  79. package/docs/how-to/workflows/setup-test-framework.md +113 -0
  80. package/docs/index.md +33 -113
  81. package/{src/modules/bmm/docs/agents-guide.md → docs/reference/agents/index.md} +36 -39
  82. package/docs/reference/configuration/core-tasks.md +67 -0
  83. package/docs/reference/configuration/global-config.md +14 -0
  84. package/{src/modules/bmm/docs/glossary.md → docs/reference/glossary/index.md} +90 -24
  85. package/{src/modules/bmgd/docs/workflows-guide.md → docs/reference/workflows/bmgd-workflows.md} +11 -8
  86. package/docs/reference/workflows/core-workflows.md +33 -0
  87. package/docs/reference/workflows/document-project.md +74 -0
  88. package/docs/reference/workflows/index.md +16 -0
  89. package/docs/tutorials/advanced/create-custom-agent.md +171 -0
  90. package/docs/tutorials/getting-started/getting-started-bmadv6.md +246 -0
  91. package/docs/tutorials/getting-started/quick-start-bmgd.md +260 -0
  92. package/docs/tutorials/getting-started/workflow-overview.jpg +0 -0
  93. package/eslint.config.mjs +2 -2
  94. package/package.json +10 -10
  95. package/samples/sample-custom-modules/README.md +1 -1
  96. package/samples/sample-custom-modules/sample-unitary-module/agents/commit-poet/commit-poet.agent.yaml +1 -0
  97. package/samples/sample-custom-modules/sample-unitary-module/agents/toolsmith/toolsmith-sidecar/knowledge/docs.md +0 -5
  98. package/samples/sample-custom-modules/sample-unitary-module/agents/toolsmith/toolsmith-sidecar/knowledge/installers.md +1 -1
  99. package/samples/sample-custom-modules/sample-unitary-module/agents/toolsmith/toolsmith-sidecar/knowledge/modules.md +1 -1
  100. package/samples/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-01-init.md +3 -3
  101. package/samples/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-02-q1.md +3 -3
  102. package/samples/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-03-q2.md +3 -3
  103. package/samples/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-04-q3.md +3 -3
  104. package/samples/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-05-q4.md +3 -3
  105. package/samples/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-06-q5.md +3 -3
  106. package/samples/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-07-q6.md +3 -3
  107. package/samples/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-08-q7.md +3 -3
  108. package/samples/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-09-q8.md +3 -3
  109. package/samples/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-10-q9.md +3 -3
  110. package/samples/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-11-q10.md +3 -3
  111. package/samples/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-12-results.md +2 -2
  112. package/samples/sample-custom-modules/sample-unitary-module/workflows/quiz-master/workflow.md +1 -1
  113. package/samples/sample-custom-modules/sample-wellness-module/agents/meditation-guide.agent.yaml +1 -0
  114. package/src/core/agents/bmad-master.agent.yaml +1 -0
  115. package/src/core/{tools → tasks}/shard-doc.xml +2 -2
  116. package/src/core/tasks/workflow.xml +1 -1
  117. package/src/core/{tasks/advanced-elicitation.xml → workflows/advanced-elicitation/workflow.xml} +3 -2
  118. package/src/core/workflows/brainstorming/steps/step-01-session-setup.md +1 -0
  119. package/src/core/workflows/brainstorming/steps/step-01b-continue.md +1 -0
  120. package/src/core/workflows/brainstorming/steps/step-02a-user-selected.md +1 -0
  121. package/src/core/workflows/brainstorming/steps/step-02b-ai-recommended.md +1 -0
  122. package/src/core/workflows/brainstorming/steps/step-02c-random-selection.md +1 -0
  123. package/src/core/workflows/brainstorming/steps/step-02d-progressive-flow.md +1 -0
  124. package/src/core/workflows/brainstorming/steps/step-03-technique-execution.md +69 -9
  125. package/src/core/workflows/brainstorming/steps/step-04-idea-organization.md +1 -0
  126. package/src/core/workflows/brainstorming/workflow.md +8 -1
  127. package/src/core/workflows/party-mode/steps/step-01-agent-loading.md +1 -0
  128. package/src/core/workflows/party-mode/steps/step-02-discussion-orchestration.md +1 -0
  129. package/src/core/workflows/party-mode/steps/step-03-graceful-exit.md +1 -0
  130. package/src/core/workflows/party-mode/workflow.md +1 -1
  131. package/src/modules/bmb/agents/agent-builder.agent.yaml +7 -2
  132. package/src/modules/bmb/agents/module-builder.agent.yaml +5 -8
  133. package/src/modules/bmb/agents/workflow-builder.agent.yaml +16 -7
  134. package/src/modules/bmb/workflows/agent/data/agent-compilation.md +273 -0
  135. package/src/modules/bmb/workflows/agent/data/agent-menu-patterns.md +233 -0
  136. package/src/modules/bmb/workflows/agent/data/agent-metadata.md +208 -0
  137. package/src/modules/bmb/workflows/{create-agent → agent}/data/brainstorm-context.md +3 -10
  138. package/src/modules/bmb/workflows/{create-agent → agent}/data/communication-presets.csv +1 -1
  139. package/src/modules/bmb/workflows/agent/data/critical-actions.md +120 -0
  140. package/src/modules/bmb/workflows/agent/data/expert-agent-architecture.md +236 -0
  141. package/src/modules/bmb/workflows/agent/data/expert-agent-validation.md +174 -0
  142. package/src/modules/bmb/workflows/agent/data/module-agent-validation.md +126 -0
  143. package/src/modules/bmb/workflows/agent/data/persona-properties.md +266 -0
  144. package/src/modules/bmb/workflows/agent/data/principles-crafting.md +292 -0
  145. package/src/modules/bmb/workflows/agent/data/reference/expert-examples/journal-keeper/journal-keeper-sidecar/entries/yy-mm-dd-entry-template.md +17 -0
  146. package/src/modules/bmb/workflows/{create-agent/data/reference/agents → agent/data/reference}/expert-examples/journal-keeper/journal-keeper.agent.yaml +26 -25
  147. package/src/modules/bmb/workflows/agent/data/reference/module-examples/architect.agent.yaml +32 -0
  148. package/src/modules/bmb/workflows/agent/data/reference/module-examples/architect.md +68 -0
  149. package/src/modules/bmb/workflows/{create-agent/data/reference/agents → agent/data/reference}/module-examples/security-engineer.agent.yaml +1 -0
  150. package/src/modules/bmb/workflows/{create-agent/data/reference/agents → agent/data/reference}/module-examples/trend-analyst.agent.yaml +1 -0
  151. package/src/modules/bmb/workflows/{create-agent/data/reference/agents → agent/data/reference}/simple-examples/commit-poet.agent.yaml +15 -14
  152. package/src/modules/bmb/workflows/agent/data/simple-agent-architecture.md +204 -0
  153. package/src/modules/bmb/workflows/agent/data/simple-agent-validation.md +133 -0
  154. package/src/modules/bmb/workflows/agent/data/understanding-agent-types.md +222 -0
  155. package/src/modules/bmb/workflows/{create-agent/steps → agent/steps-c}/step-01-brainstorm.md +9 -26
  156. package/src/modules/bmb/workflows/agent/steps-c/step-02-discovery.md +170 -0
  157. package/src/modules/bmb/workflows/agent/steps-c/step-03-type-metadata.md +296 -0
  158. package/src/modules/bmb/workflows/agent/steps-c/step-04-persona.md +212 -0
  159. package/src/modules/bmb/workflows/agent/steps-c/step-05-commands-menu.md +178 -0
  160. package/src/modules/bmb/workflows/agent/steps-c/step-06-activation.md +279 -0
  161. package/src/modules/bmb/workflows/agent/steps-c/step-07a-build-simple.md +187 -0
  162. package/src/modules/bmb/workflows/agent/steps-c/step-07b-build-expert.md +201 -0
  163. package/src/modules/bmb/workflows/agent/steps-c/step-07c-build-module.md +258 -0
  164. package/src/modules/bmb/workflows/agent/steps-c/step-08-celebrate.md +249 -0
  165. package/src/modules/bmb/workflows/agent/steps-e/e-01-load-existing.md +221 -0
  166. package/src/modules/bmb/workflows/agent/steps-e/e-02-discover-edits.md +193 -0
  167. package/src/modules/bmb/workflows/agent/steps-e/e-03-placeholder.md +1 -0
  168. package/src/modules/bmb/workflows/agent/steps-e/e-04-type-metadata.md +124 -0
  169. package/src/modules/bmb/workflows/agent/steps-e/e-05-persona.md +134 -0
  170. package/src/modules/bmb/workflows/agent/steps-e/e-06-commands-menu.md +122 -0
  171. package/src/modules/bmb/workflows/agent/steps-e/e-07-activation.md +125 -0
  172. package/src/modules/bmb/workflows/agent/steps-e/e-08a-edit-simple.md +137 -0
  173. package/src/modules/bmb/workflows/agent/steps-e/e-08b-edit-expert.md +119 -0
  174. package/src/modules/bmb/workflows/agent/steps-e/e-08c-edit-module.md +123 -0
  175. package/src/modules/bmb/workflows/agent/steps-e/e-09-celebrate.md +155 -0
  176. package/src/modules/bmb/workflows/agent/steps-v/v-01-load-review.md +136 -0
  177. package/src/modules/bmb/workflows/agent/steps-v/v-02a-validate-metadata.md +116 -0
  178. package/src/modules/bmb/workflows/agent/steps-v/v-02b-validate-persona.md +124 -0
  179. package/src/modules/bmb/workflows/agent/steps-v/v-02c-validate-menu.md +145 -0
  180. package/src/modules/bmb/workflows/agent/steps-v/v-02d-validate-structure.md +136 -0
  181. package/src/modules/bmb/workflows/agent/steps-v/v-02e-validate-sidecar.md +136 -0
  182. package/src/modules/bmb/workflows/agent/steps-v/v-03-summary.md +104 -0
  183. package/src/modules/bmb/workflows/agent/templates/agent-plan.template.md +5 -0
  184. package/src/modules/bmb/workflows/agent/templates/expert-agent-template/expert-agent-sidecar/instructions.md.template +20 -0
  185. package/src/modules/bmb/workflows/agent/templates/expert-agent-template/expert-agent-sidecar/memories.md.template +18 -0
  186. package/src/modules/bmb/workflows/agent/templates/expert-agent-template/expert-agent.template.md +77 -0
  187. package/src/modules/bmb/workflows/agent/templates/simple-agent.template.md +72 -0
  188. package/src/modules/bmb/workflows/agent/workflow.md +123 -0
  189. package/src/modules/bmb/workflows/module/data/agent-architecture.md +179 -0
  190. package/src/modules/bmb/workflows/module/data/agent-spec-template.md +79 -0
  191. package/src/modules/bmb/workflows/module/data/module-installer-standards.md +348 -0
  192. package/src/modules/bmb/workflows/module/data/module-standards.md +280 -0
  193. package/src/modules/bmb/workflows/module/data/module-yaml-conventions.md +392 -0
  194. package/src/modules/bmb/workflows/module/steps-b/step-01-welcome.md +147 -0
  195. package/src/modules/bmb/workflows/module/steps-b/step-02-spark.md +140 -0
  196. package/src/modules/bmb/workflows/module/steps-b/step-03-module-type.md +148 -0
  197. package/src/modules/bmb/workflows/module/steps-b/step-04-vision.md +82 -0
  198. package/src/modules/bmb/workflows/module/steps-b/step-05-identity.md +96 -0
  199. package/src/modules/bmb/workflows/module/steps-b/step-06-users.md +85 -0
  200. package/src/modules/bmb/workflows/module/steps-b/step-07-value.md +75 -0
  201. package/src/modules/bmb/workflows/module/steps-b/step-08-agents.md +96 -0
  202. package/src/modules/bmb/workflows/module/steps-b/step-09-workflows.md +82 -0
  203. package/src/modules/bmb/workflows/module/steps-b/step-10-tools.md +90 -0
  204. package/src/modules/bmb/workflows/module/steps-b/step-11-scenarios.md +83 -0
  205. package/src/modules/bmb/workflows/module/steps-b/step-12-creative.md +94 -0
  206. package/src/modules/bmb/workflows/module/steps-b/step-13-review.md +104 -0
  207. package/src/modules/bmb/workflows/module/steps-b/step-14-finalize.md +117 -0
  208. package/src/modules/bmb/workflows/module/steps-c/step-01-load-brief.md +178 -0
  209. package/src/modules/bmb/workflows/module/steps-c/step-01b-continue.md +83 -0
  210. package/src/modules/bmb/workflows/module/steps-c/step-02-structure.md +109 -0
  211. package/src/modules/bmb/workflows/module/steps-c/step-03-config.md +118 -0
  212. package/src/modules/bmb/workflows/module/steps-c/step-04-installer.md +160 -0
  213. package/src/modules/bmb/workflows/module/steps-c/step-05-agents.md +167 -0
  214. package/src/modules/bmb/workflows/module/steps-c/step-06-workflows.md +183 -0
  215. package/src/modules/bmb/workflows/module/steps-c/step-07-docs.md +402 -0
  216. package/src/modules/bmb/workflows/module/steps-c/step-08-complete.md +123 -0
  217. package/src/modules/bmb/workflows/module/steps-e/step-01-load-target.md +81 -0
  218. package/src/modules/bmb/workflows/module/steps-e/step-02-select-edit.md +77 -0
  219. package/src/modules/bmb/workflows/module/steps-e/step-03-apply-edit.md +77 -0
  220. package/src/modules/bmb/workflows/module/steps-e/step-04-review.md +80 -0
  221. package/src/modules/bmb/workflows/module/steps-e/step-05-confirm.md +75 -0
  222. package/src/modules/bmb/workflows/module/steps-v/step-01-load-target.md +96 -0
  223. package/src/modules/bmb/workflows/module/steps-v/step-02-file-structure.md +94 -0
  224. package/src/modules/bmb/workflows/module/steps-v/step-03-module-yaml.md +99 -0
  225. package/src/modules/bmb/workflows/module/steps-v/step-04-agent-specs.md +152 -0
  226. package/src/modules/bmb/workflows/module/steps-v/step-05-workflow-specs.md +152 -0
  227. package/src/modules/bmb/workflows/module/steps-v/step-06-documentation.md +143 -0
  228. package/src/modules/bmb/workflows/module/steps-v/step-07-installation.md +113 -0
  229. package/src/modules/bmb/workflows/module/steps-v/step-08-report.md +197 -0
  230. package/src/modules/bmb/workflows/module/templates/brief-template.md +154 -0
  231. package/src/modules/bmb/workflows/module/templates/workflow-spec-template.md +96 -0
  232. package/src/modules/bmb/workflows/module/workflow.md +100 -0
  233. package/src/modules/bmb/workflows/workflow/data/architecture.md +152 -0
  234. package/src/modules/bmb/{docs/workflows → workflows/workflow/data}/common-workflow-tools.csv +1 -1
  235. package/src/modules/bmb/workflows/workflow/data/csv-data-file-standards.md +81 -0
  236. package/src/modules/bmb/workflows/workflow/data/frontmatter-standards.md +225 -0
  237. package/src/modules/bmb/workflows/workflow/data/input-discovery-standards.md +269 -0
  238. package/src/modules/bmb/workflows/workflow/data/intent-vs-prescriptive-spectrum.md +50 -0
  239. package/src/modules/bmb/workflows/workflow/data/menu-handling-standards.md +167 -0
  240. package/src/modules/bmb/workflows/workflow/data/output-format-standards.md +188 -0
  241. package/src/modules/bmb/workflows/workflow/data/step-file-rules.md +235 -0
  242. package/src/modules/bmb/workflows/workflow/data/step-type-patterns.md +311 -0
  243. package/src/modules/bmb/workflows/workflow/data/subprocess-optimization-patterns.md +386 -0
  244. package/src/modules/bmb/workflows/workflow/data/trimodal-workflow-structure.md +209 -0
  245. package/src/modules/bmb/workflows/workflow/data/workflow-chaining-standards.md +271 -0
  246. package/src/modules/bmb/workflows/workflow/data/workflow-examples.md +276 -0
  247. package/src/modules/bmb/workflows/workflow/data/workflow-type-criteria.md +172 -0
  248. package/src/modules/bmb/workflows/workflow/steps-c/step-00-conversion.md +262 -0
  249. package/src/modules/bmb/workflows/workflow/steps-c/step-01-discovery.md +194 -0
  250. package/src/modules/bmb/workflows/workflow/steps-c/step-01b-continuation.md +3 -0
  251. package/src/modules/bmb/workflows/workflow/steps-c/step-02-classification.md +269 -0
  252. package/src/modules/bmb/workflows/workflow/steps-c/step-03-requirements.md +282 -0
  253. package/src/modules/bmb/workflows/workflow/steps-c/step-04-tools.md +281 -0
  254. package/src/modules/bmb/workflows/workflow/steps-c/step-05-plan-review.md +242 -0
  255. package/src/modules/bmb/workflows/{create-workflow/steps → workflow/steps-c}/step-06-design.md +96 -38
  256. package/src/modules/bmb/workflows/workflow/steps-c/step-07-foundation.md +238 -0
  257. package/src/modules/bmb/workflows/workflow/steps-c/step-08-build-step-01.md +377 -0
  258. package/src/modules/bmb/workflows/workflow/steps-c/step-09-build-next-step.md +350 -0
  259. package/src/modules/bmb/workflows/workflow/steps-c/step-10-confirmation.md +320 -0
  260. package/src/modules/bmb/workflows/workflow/steps-c/step-11-completion.md +191 -0
  261. package/src/modules/bmb/workflows/workflow/steps-e/step-e-01-assess-workflow.md +237 -0
  262. package/src/modules/bmb/workflows/workflow/steps-e/step-e-02-discover-edits.md +248 -0
  263. package/src/modules/bmb/workflows/workflow/steps-e/step-e-03-fix-validation.md +252 -0
  264. package/src/modules/bmb/workflows/workflow/steps-e/step-e-04-direct-edit.md +275 -0
  265. package/src/modules/bmb/workflows/workflow/steps-e/step-e-05-apply-edit.md +154 -0
  266. package/src/modules/bmb/workflows/workflow/steps-e/step-e-06-validate-after.md +190 -0
  267. package/src/modules/bmb/workflows/workflow/steps-e/step-e-07-complete.md +206 -0
  268. package/src/modules/bmb/workflows/workflow/steps-v/step-01-validate-max-mode.md +109 -0
  269. package/src/modules/bmb/workflows/workflow/steps-v/step-01-validate.md +221 -0
  270. package/src/modules/bmb/workflows/workflow/steps-v/step-01b-structure.md +152 -0
  271. package/src/modules/bmb/workflows/workflow/steps-v/step-02-frontmatter-validation.md +199 -0
  272. package/src/modules/bmb/workflows/workflow/steps-v/step-02b-path-violations.md +265 -0
  273. package/src/modules/bmb/workflows/workflow/steps-v/step-03-menu-validation.md +164 -0
  274. package/src/modules/bmb/workflows/workflow/steps-v/step-04-step-type-validation.md +211 -0
  275. package/src/modules/bmb/workflows/workflow/steps-v/step-05-output-format-validation.md +200 -0
  276. package/src/modules/bmb/workflows/workflow/steps-v/step-06-validation-design-check.md +195 -0
  277. package/src/modules/bmb/workflows/workflow/steps-v/step-07-instruction-style-check.md +209 -0
  278. package/src/modules/bmb/workflows/workflow/steps-v/step-08-collaborative-experience-check.md +199 -0
  279. package/src/modules/bmb/workflows/workflow/steps-v/step-08b-subprocess-optimization.md +179 -0
  280. package/src/modules/bmb/workflows/workflow/steps-v/step-09-cohesive-review.md +186 -0
  281. package/src/modules/bmb/workflows/workflow/steps-v/step-10-report-complete.md +154 -0
  282. package/src/modules/bmb/workflows/workflow/steps-v/step-11-plan-validation.md +237 -0
  283. package/src/modules/bmb/workflows/workflow/templates/minimal-output-template.md +11 -0
  284. package/src/modules/bmb/{docs/workflows → workflows/workflow}/templates/step-01-init-continuable-template.md +3 -3
  285. package/src/modules/bmb/{docs/workflows → workflows/workflow}/templates/step-1b-template.md +1 -1
  286. package/src/modules/bmb/{docs/workflows → workflows/workflow}/templates/step-template.md +15 -15
  287. package/src/modules/bmb/{docs/workflows → workflows/workflow}/templates/workflow-template.md +2 -4
  288. package/src/modules/bmb/workflows/workflow/workflow.md +109 -0
  289. package/src/modules/bmgd/agents/game-architect.agent.yaml +1 -0
  290. package/src/modules/bmgd/agents/game-designer.agent.yaml +1 -0
  291. package/src/modules/bmgd/agents/game-dev.agent.yaml +2 -1
  292. package/src/modules/bmgd/agents/game-qa.agent.yaml +2 -1
  293. package/src/modules/bmgd/agents/game-scrum-master.agent.yaml +2 -1
  294. package/src/modules/bmgd/agents/game-solo-dev.agent.yaml +3 -2
  295. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/instructions.md +1 -1
  296. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/steps/step-01-init.md +5 -3
  297. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/steps/step-02-context.md +4 -3
  298. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/steps/step-03-ideation.md +52 -46
  299. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/steps/step-04-complete.md +2 -1
  300. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/workflow.md +5 -1
  301. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/workflow.yaml +3 -3
  302. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-01-init.md +4 -3
  303. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-01b-continue.md +2 -1
  304. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-02-vision.md +4 -3
  305. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-03-market.md +4 -3
  306. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-04-fundamentals.md +4 -3
  307. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-05-scope.md +4 -3
  308. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-06-references.md +4 -3
  309. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-07-content.md +4 -3
  310. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-08-complete.md +2 -1
  311. package/src/modules/bmgd/workflows/1-preproduction/game-brief/workflow.md +1 -0
  312. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-01-init.md +4 -3
  313. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-01b-continue.md +2 -1
  314. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-02-context.md +4 -3
  315. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-03-platforms.md +4 -3
  316. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-04-vision.md +4 -3
  317. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-05-core-gameplay.md +4 -3
  318. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-06-mechanics.md +4 -3
  319. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-07-game-type.md +4 -3
  320. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-08-progression.md +4 -3
  321. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-09-levels.md +4 -3
  322. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-10-art-audio.md +4 -3
  323. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-11-technical.md +4 -3
  324. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-12-epics.md +4 -3
  325. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-13-metrics.md +4 -3
  326. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-14-complete.md +2 -1
  327. package/src/modules/bmgd/workflows/2-design/narrative/instructions-narrative.md +1 -1
  328. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-01-init.md +4 -3
  329. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-01b-continue.md +12 -11
  330. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-02-foundation.md +4 -3
  331. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-03-story.md +4 -3
  332. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-04-characters.md +4 -3
  333. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-05-world.md +4 -3
  334. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-06-dialogue.md +4 -3
  335. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-07-environmental.md +4 -3
  336. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-08-delivery.md +4 -3
  337. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-09-integration.md +4 -3
  338. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-10-production.md +4 -3
  339. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-11-complete.md +2 -1
  340. package/src/modules/bmgd/workflows/2-design/narrative/workflow.md +2 -1
  341. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-01-init.md +4 -3
  342. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-01b-continue.md +10 -9
  343. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-02-context.md +4 -3
  344. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-03-starter.md +4 -3
  345. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-04-decisions.md +4 -3
  346. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-05-crosscutting.md +4 -3
  347. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-06-structure.md +6 -5
  348. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-07-patterns.md +4 -3
  349. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-08-validation.md +6 -5
  350. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-09-complete.md +2 -1
  351. package/src/modules/bmgd/workflows/3-technical/game-architecture/workflow.md +2 -1
  352. package/src/modules/bmgd/workflows/3-technical/generate-project-context/steps/step-01-discover.md +1 -0
  353. package/src/modules/bmgd/workflows/3-technical/generate-project-context/steps/step-02-generate.md +2 -1
  354. package/src/modules/bmgd/workflows/3-technical/generate-project-context/steps/step-03-complete.md +1 -0
  355. package/src/modules/bmgd/workflows/3-technical/generate-project-context/workflow.md +1 -0
  356. package/src/modules/bmgd/workflows/4-production/code-review/instructions.xml +1 -0
  357. package/src/modules/bmgd/workflows/4-production/code-review/workflow.yaml +1 -1
  358. package/src/modules/bmgd/workflows/4-production/correct-course/workflow.yaml +1 -1
  359. package/src/modules/bmgd/workflows/4-production/create-story/checklist.md +2 -2
  360. package/src/modules/bmgd/workflows/4-production/create-story/workflow.yaml +1 -1
  361. package/src/modules/bmgd/workflows/4-production/dev-story/workflow.yaml +1 -1
  362. package/src/modules/bmgd/workflows/4-production/retrospective/workflow.yaml +1 -1
  363. package/src/modules/bmgd/workflows/4-production/sprint-status/workflow.yaml +2 -2
  364. package/src/modules/bmgd/workflows/bmgd-quick-flow/quick-dev/workflow.yaml +1 -1
  365. package/src/modules/bmgd/workflows/bmgd-quick-flow/quick-prototype/workflow.yaml +1 -1
  366. package/src/modules/bmgd/workflows/bmgd-quick-flow/{create-tech-spec → quick-spec}/workflow.yaml +3 -3
  367. package/src/modules/bmgd/workflows/workflow-status/paths/quickflow-brownfield.yaml +2 -2
  368. package/src/modules/bmm/agents/analyst.agent.yaml +3 -2
  369. package/src/modules/bmm/agents/architect.agent.yaml +3 -1
  370. package/src/modules/bmm/agents/dev.agent.yaml +4 -3
  371. package/src/modules/bmm/agents/pm.agent.yaml +16 -5
  372. package/src/modules/bmm/agents/quick-flow-solo-dev.agent.yaml +3 -2
  373. package/src/modules/bmm/agents/sm.agent.yaml +1 -0
  374. package/src/modules/bmm/agents/tea.agent.yaml +6 -3
  375. package/src/modules/bmm/agents/tech-writer.agent.yaml +1 -0
  376. package/src/modules/bmm/agents/ux-designer.agent.yaml +1 -0
  377. package/src/modules/bmm/module.yaml +1 -1
  378. package/src/modules/bmm/testarch/knowledge/api-request.md +155 -16
  379. package/src/modules/bmm/testarch/knowledge/api-testing-patterns.md +843 -0
  380. package/src/modules/bmm/testarch/knowledge/auth-session.md +197 -1
  381. package/src/modules/bmm/testarch/knowledge/file-utils.md +257 -54
  382. package/src/modules/bmm/testarch/knowledge/intercept-network-call.md +159 -9
  383. package/src/modules/bmm/testarch/knowledge/log.md +170 -35
  384. package/src/modules/bmm/testarch/knowledge/network-error-monitor.md +228 -95
  385. package/src/modules/bmm/testarch/knowledge/network-recorder.md +314 -52
  386. package/src/modules/bmm/testarch/knowledge/overview.md +15 -12
  387. package/src/modules/bmm/testarch/knowledge/recurse.md +173 -48
  388. package/src/modules/bmm/testarch/tea-index.csv +19 -18
  389. package/src/modules/bmm/workflows/1-analysis/create-product-brief/steps/step-01-init.md +4 -8
  390. package/src/modules/bmm/workflows/1-analysis/create-product-brief/steps/step-01b-continue.md +1 -5
  391. package/src/modules/bmm/workflows/1-analysis/create-product-brief/steps/step-02-vision.md +3 -7
  392. package/src/modules/bmm/workflows/1-analysis/create-product-brief/steps/step-03-users.md +3 -7
  393. package/src/modules/bmm/workflows/1-analysis/create-product-brief/steps/step-04-metrics.md +3 -7
  394. package/src/modules/bmm/workflows/1-analysis/create-product-brief/steps/step-05-scope.md +3 -7
  395. package/src/modules/bmm/workflows/1-analysis/create-product-brief/steps/step-06-complete.md +1 -5
  396. package/src/modules/bmm/workflows/1-analysis/research/domain-steps/step-01-init.md +1 -0
  397. package/src/modules/bmm/workflows/1-analysis/research/domain-steps/step-02-domain-analysis.md +1 -0
  398. package/src/modules/bmm/workflows/1-analysis/research/domain-steps/step-03-competitive-landscape.md +1 -0
  399. package/src/modules/bmm/workflows/1-analysis/research/domain-steps/step-04-regulatory-focus.md +1 -0
  400. package/src/modules/bmm/workflows/1-analysis/research/domain-steps/step-05-technical-trends.md +1 -0
  401. package/src/modules/bmm/workflows/1-analysis/research/domain-steps/step-06-research-synthesis.md +1 -0
  402. package/src/modules/bmm/workflows/1-analysis/research/market-steps/step-01-init.md +1 -0
  403. package/src/modules/bmm/workflows/1-analysis/research/market-steps/step-02-customer-behavior.md +1 -0
  404. package/src/modules/bmm/workflows/1-analysis/research/market-steps/step-02-customer-insights.md +1 -0
  405. package/src/modules/bmm/workflows/1-analysis/research/market-steps/step-03-customer-pain-points.md +1 -0
  406. package/src/modules/bmm/workflows/1-analysis/research/market-steps/step-04-customer-decisions.md +1 -0
  407. package/src/modules/bmm/workflows/1-analysis/research/market-steps/step-05-competitive-analysis.md +1 -0
  408. package/src/modules/bmm/workflows/1-analysis/research/market-steps/step-06-research-completion.md +1 -0
  409. package/src/modules/bmm/workflows/1-analysis/research/technical-steps/step-01-init.md +1 -0
  410. package/src/modules/bmm/workflows/1-analysis/research/technical-steps/step-02-technical-overview.md +1 -0
  411. package/src/modules/bmm/workflows/1-analysis/research/technical-steps/step-03-integration-patterns.md +1 -0
  412. package/src/modules/bmm/workflows/1-analysis/research/technical-steps/step-04-architectural-patterns.md +1 -0
  413. package/src/modules/bmm/workflows/1-analysis/research/technical-steps/step-05-implementation-research.md +1 -0
  414. package/src/modules/bmm/workflows/1-analysis/research/technical-steps/step-06-research-synthesis.md +1 -0
  415. package/src/modules/bmm/workflows/1-analysis/research/workflow.md +1 -1
  416. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-01-init.md +1 -0
  417. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-01b-continue.md +1 -0
  418. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-02-discovery.md +2 -1
  419. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-03-core-experience.md +3 -2
  420. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-04-emotional-response.md +3 -2
  421. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-05-inspiration.md +3 -2
  422. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-06-design-system.md +3 -2
  423. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-07-defining-experience.md +3 -2
  424. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-08-visual-foundation.md +3 -2
  425. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-09-design-directions.md +3 -2
  426. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-10-user-journeys.md +3 -2
  427. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-11-component-strategy.md +3 -2
  428. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-12-ux-patterns.md +3 -2
  429. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-13-responsive-accessibility.md +3 -2
  430. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-14-complete.md +1 -0
  431. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md +2 -1
  432. package/src/modules/bmm/workflows/2-plan-workflows/prd/data/prd-purpose.md +197 -0
  433. package/src/modules/bmm/workflows/2-plan-workflows/prd/{steps → steps-c}/step-01-init.md +8 -13
  434. package/src/modules/bmm/workflows/2-plan-workflows/prd/{steps → steps-c}/step-01b-continue.md +37 -49
  435. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps-c/step-02-discovery.md +224 -0
  436. package/src/modules/bmm/workflows/2-plan-workflows/prd/{steps → steps-c}/step-03-success.md +52 -115
  437. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps-c/step-04-journeys.md +213 -0
  438. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps-c/step-05-domain.md +207 -0
  439. package/src/modules/bmm/workflows/2-plan-workflows/prd/{steps → steps-c}/step-06-innovation.md +45 -80
  440. package/src/modules/bmm/workflows/2-plan-workflows/prd/{steps → steps-c}/step-07-project-type.md +39 -59
  441. package/src/modules/bmm/workflows/2-plan-workflows/prd/{steps → steps-c}/step-08-scoping.md +45 -115
  442. package/src/modules/bmm/workflows/2-plan-workflows/prd/{steps → steps-c}/step-09-functional.md +23 -61
  443. package/src/modules/bmm/workflows/2-plan-workflows/prd/{steps → steps-c}/step-10-nonfunctional.md +34 -85
  444. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps-c/step-11-polish.md +217 -0
  445. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps-c/step-12-complete.md +180 -0
  446. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps-e/step-e-01-discovery.md +247 -0
  447. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps-e/step-e-01b-legacy-conversion.md +208 -0
  448. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps-e/step-e-02-review.md +249 -0
  449. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps-e/step-e-03-edit.md +253 -0
  450. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps-e/step-e-04-complete.md +168 -0
  451. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-01-discovery.md +218 -0
  452. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-02-format-detection.md +191 -0
  453. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-02b-parity-check.md +209 -0
  454. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-03-density-validation.md +174 -0
  455. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-04-brief-coverage-validation.md +214 -0
  456. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-05-measurability-validation.md +228 -0
  457. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-06-traceability-validation.md +217 -0
  458. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-07-implementation-leakage-validation.md +205 -0
  459. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-08-domain-compliance-validation.md +243 -0
  460. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-09-project-type-validation.md +263 -0
  461. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-10-smart-validation.md +209 -0
  462. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-11-holistic-quality-validation.md +264 -0
  463. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-12-completeness-validation.md +242 -0
  464. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-13-report-complete.md +232 -0
  465. package/src/modules/bmm/workflows/2-plan-workflows/prd/{prd-template.md → templates/prd-template.md} +0 -1
  466. package/src/modules/bmm/workflows/2-plan-workflows/prd/validation-report-prd-workflow.md +433 -0
  467. package/src/modules/bmm/workflows/2-plan-workflows/prd/workflow.md +97 -8
  468. package/src/modules/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-01-document-discovery.md +3 -2
  469. package/src/modules/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-02-prd-analysis.md +3 -2
  470. package/src/modules/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-03-epic-coverage-validation.md +3 -2
  471. package/src/modules/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-04-ux-alignment.md +3 -2
  472. package/src/modules/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-05-epic-quality-review.md +3 -2
  473. package/src/modules/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-06-final-assessment.md +2 -1
  474. package/src/modules/bmm/workflows/3-solutioning/check-implementation-readiness/workflow.md +2 -1
  475. package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-01-init.md +1 -1
  476. package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-01b-continue.md +1 -0
  477. package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-02-context.md +3 -2
  478. package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-03-starter.md +3 -2
  479. package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-04-decisions.md +3 -2
  480. package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-05-patterns.md +3 -2
  481. package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-06-structure.md +3 -2
  482. package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-07-validation.md +3 -2
  483. package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-08-complete.md +1 -0
  484. package/src/modules/bmm/workflows/3-solutioning/create-architecture/workflow.md +1 -0
  485. package/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-01-validate-prerequisites.md +5 -4
  486. package/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-02-design-epics.md +4 -3
  487. package/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-03-create-stories.md +4 -3
  488. package/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-04-final-validation.md +3 -2
  489. package/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md +1 -0
  490. package/src/modules/bmm/workflows/4-implementation/code-review/instructions.xml +2 -0
  491. package/src/modules/bmm/workflows/4-implementation/code-review/workflow.yaml +9 -12
  492. package/src/modules/bmm/workflows/4-implementation/correct-course/workflow.yaml +1 -1
  493. package/src/modules/bmm/workflows/4-implementation/create-story/checklist.md +2 -2
  494. package/src/modules/bmm/workflows/4-implementation/create-story/instructions.xml +2 -1
  495. package/src/modules/bmm/workflows/4-implementation/create-story/workflow.yaml +13 -12
  496. package/src/modules/bmm/workflows/4-implementation/dev-story/instructions.xml +2 -1
  497. package/src/modules/bmm/workflows/4-implementation/retrospective/instructions.md +3 -3
  498. package/src/modules/bmm/workflows/4-implementation/retrospective/workflow.yaml +11 -10
  499. package/src/modules/bmm/workflows/4-implementation/sprint-status/workflow.yaml +2 -2
  500. package/src/modules/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-01-mode-detection.md +7 -7
  501. package/src/modules/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-02-context-gathering.md +2 -2
  502. package/src/modules/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-03-execute.md +2 -2
  503. package/src/modules/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-04-self-check.md +2 -2
  504. package/src/modules/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-05-adversarial-review.md +3 -3
  505. package/src/modules/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-06-resolve-findings.md +1 -1
  506. package/src/modules/bmm/workflows/bmad-quick-flow/quick-dev/workflow.md +4 -3
  507. package/src/modules/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-01-understand.md +189 -0
  508. package/src/modules/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-02-investigate.md +144 -0
  509. package/src/modules/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-03-generate.md +128 -0
  510. package/src/modules/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-04-review.md +173 -0
  511. package/src/modules/bmm/workflows/bmad-quick-flow/quick-spec/tech-spec-template.md +74 -0
  512. package/src/modules/bmm/workflows/bmad-quick-flow/quick-spec/workflow.md +79 -0
  513. package/src/modules/bmm/workflows/document-project/checklist.md +2 -2
  514. package/src/modules/bmm/workflows/excalidraw-diagrams/create-dataflow/instructions.md +1 -1
  515. package/src/modules/bmm/workflows/excalidraw-diagrams/create-diagram/instructions.md +1 -1
  516. package/src/modules/bmm/workflows/excalidraw-diagrams/create-flowchart/instructions.md +1 -1
  517. package/src/modules/bmm/workflows/excalidraw-diagrams/create-wireframe/instructions.md +1 -1
  518. package/src/modules/bmm/workflows/generate-project-context/steps/step-01-discover.md +1 -0
  519. package/src/modules/bmm/workflows/generate-project-context/steps/step-02-generate.md +2 -1
  520. package/src/modules/bmm/workflows/generate-project-context/steps/step-03-complete.md +1 -0
  521. package/src/modules/bmm/workflows/generate-project-context/workflow.md +1 -0
  522. package/src/modules/bmm/workflows/testarch/test-design/instructions.md +2 -2
  523. package/src/modules/bmm/workflows/workflow-status/init/instructions.md +6 -6
  524. package/src/modules/bmm/workflows/workflow-status/init/workflow.yaml +2 -1
  525. package/src/modules/bmm/workflows/workflow-status/instructions.md +8 -8
  526. package/src/modules/bmm/workflows/workflow-status/paths/enterprise-brownfield.yaml +44 -63
  527. package/src/modules/bmm/workflows/workflow-status/paths/enterprise-greenfield.yaml +44 -54
  528. package/src/modules/bmm/workflows/workflow-status/paths/method-brownfield.yaml +38 -41
  529. package/src/modules/bmm/workflows/workflow-status/paths/method-greenfield.yaml +26 -22
  530. package/src/modules/cis/agents/brainstorming-coach.agent.yaml +2 -1
  531. package/src/modules/cis/agents/creative-problem-solver.agent.yaml +1 -0
  532. package/src/modules/cis/agents/design-thinking-coach.agent.yaml +1 -0
  533. package/src/modules/cis/agents/innovation-strategist.agent.yaml +1 -0
  534. package/src/modules/cis/agents/presentation-master.agent.yaml +1 -0
  535. package/src/modules/cis/module.yaml +1 -0
  536. package/src/modules/cis/workflows/design-thinking/instructions.md +2 -2
  537. package/src/modules/cis/workflows/innovation-strategy/instructions.md +2 -2
  538. package/src/modules/cis/workflows/problem-solving/instructions.md +2 -2
  539. package/src/modules/cis/workflows/storytelling/instructions.md +2 -2
  540. package/test/fixtures/agent-schema/invalid/critical-actions/actions-as-string.agent.yaml +1 -0
  541. package/test/fixtures/agent-schema/invalid/critical-actions/empty-string-in-actions.agent.yaml +1 -0
  542. package/test/fixtures/agent-schema/invalid/menu/empty-menu.agent.yaml +1 -0
  543. package/test/fixtures/agent-schema/invalid/menu/missing-menu.agent.yaml +1 -0
  544. package/test/fixtures/agent-schema/invalid/menu-commands/empty-command-target.agent.yaml +1 -0
  545. package/test/fixtures/agent-schema/invalid/menu-commands/no-command-target.agent.yaml +1 -0
  546. package/test/fixtures/agent-schema/invalid/menu-triggers/camel-case.agent.yaml +1 -0
  547. package/test/fixtures/agent-schema/invalid/menu-triggers/compound-invalid-format.agent.yaml +1 -0
  548. package/test/fixtures/agent-schema/invalid/menu-triggers/compound-mismatched-kebab.agent.yaml +1 -0
  549. package/test/fixtures/agent-schema/invalid/menu-triggers/duplicate-triggers.agent.yaml +1 -0
  550. package/test/fixtures/agent-schema/invalid/menu-triggers/empty-trigger.agent.yaml +1 -0
  551. package/test/fixtures/agent-schema/invalid/menu-triggers/leading-asterisk.agent.yaml +1 -0
  552. package/test/fixtures/agent-schema/invalid/menu-triggers/snake-case.agent.yaml +1 -0
  553. package/test/fixtures/agent-schema/invalid/menu-triggers/trigger-with-spaces.agent.yaml +1 -0
  554. package/test/fixtures/agent-schema/invalid/metadata/extra-metadata-fields.agent.yaml +1 -0
  555. package/test/fixtures/agent-schema/invalid/persona/empty-principles-array.agent.yaml +1 -0
  556. package/test/fixtures/agent-schema/invalid/persona/empty-string-in-principles.agent.yaml +1 -0
  557. package/test/fixtures/agent-schema/invalid/persona/extra-persona-fields.agent.yaml +1 -0
  558. package/test/fixtures/agent-schema/invalid/persona/missing-role.agent.yaml +1 -0
  559. package/test/fixtures/agent-schema/invalid/prompts/empty-content.agent.yaml +1 -0
  560. package/test/fixtures/agent-schema/invalid/prompts/extra-prompt-fields.agent.yaml +1 -0
  561. package/test/fixtures/agent-schema/invalid/prompts/missing-content.agent.yaml +1 -0
  562. package/test/fixtures/agent-schema/invalid/prompts/missing-id.agent.yaml +1 -0
  563. package/test/fixtures/agent-schema/invalid/top-level/extra-top-level-keys.agent.yaml +1 -0
  564. package/test/fixtures/agent-schema/valid/critical-actions/empty-critical-actions.agent.yaml +1 -0
  565. package/test/fixtures/agent-schema/valid/critical-actions/no-critical-actions.agent.yaml +1 -0
  566. package/test/fixtures/agent-schema/valid/critical-actions/valid-critical-actions.agent.yaml +1 -0
  567. package/test/fixtures/agent-schema/valid/menu/multiple-menu-items.agent.yaml +1 -0
  568. package/test/fixtures/agent-schema/valid/menu/single-menu-item.agent.yaml +1 -0
  569. package/test/fixtures/agent-schema/valid/menu-commands/all-command-types.agent.yaml +1 -0
  570. package/test/fixtures/agent-schema/valid/menu-commands/multiple-commands.agent.yaml +1 -0
  571. package/test/fixtures/agent-schema/valid/menu-triggers/compound-triggers.agent.yaml +1 -0
  572. package/test/fixtures/agent-schema/valid/menu-triggers/kebab-case-triggers.agent.yaml +1 -0
  573. package/test/fixtures/agent-schema/valid/metadata/core-agent-with-module.agent.yaml +1 -0
  574. package/test/fixtures/agent-schema/valid/metadata/empty-module-name-in-path.agent.yaml +1 -0
  575. package/test/fixtures/agent-schema/valid/metadata/malformed-path-treated-as-core.agent.yaml +1 -0
  576. package/test/fixtures/agent-schema/valid/metadata/module-agent-correct.agent.yaml +1 -0
  577. package/test/fixtures/agent-schema/valid/metadata/module-agent-missing-module.agent.yaml +1 -0
  578. package/test/fixtures/agent-schema/valid/metadata/wrong-module-value.agent.yaml +1 -0
  579. package/test/fixtures/agent-schema/valid/persona/complete-persona.agent.yaml +1 -0
  580. package/test/fixtures/agent-schema/valid/prompts/empty-prompts.agent.yaml +1 -0
  581. package/test/fixtures/agent-schema/valid/prompts/no-prompts.agent.yaml +1 -0
  582. package/test/fixtures/agent-schema/valid/prompts/valid-prompts-minimal.agent.yaml +1 -0
  583. package/test/fixtures/agent-schema/valid/prompts/valid-prompts-with-description.agent.yaml +1 -0
  584. package/test/fixtures/agent-schema/valid/top-level/minimal-core-agent.agent.yaml +1 -0
  585. package/tools/build-docs.js +200 -271
  586. package/tools/cli/bmad-cli.js +18 -0
  587. package/tools/cli/commands/install.js +15 -13
  588. package/tools/cli/installers/install-messages.yaml +33 -27
  589. package/tools/cli/installers/lib/core/config-collector.js +11 -1
  590. package/tools/cli/installers/lib/core/detector.js +5 -115
  591. package/tools/cli/installers/lib/core/installer.js +48 -80
  592. package/tools/cli/installers/lib/core/manifest-generator.js +46 -2
  593. package/tools/cli/installers/lib/ide/antigravity.js +3 -3
  594. package/tools/cli/installers/lib/ide/claude-code.js +3 -3
  595. package/tools/cli/installers/lib/ide/codex.js +1 -1
  596. package/tools/cli/installers/lib/ide/cursor.js +57 -304
  597. package/tools/cli/installers/lib/ide/github-copilot.js +1 -1
  598. package/tools/cli/lib/agent/compiler.js +0 -4
  599. package/tools/cli/lib/ui.js +22 -1
  600. package/tools/docs/index.md +2 -0
  601. package/tools/fix-doc-links.js +288 -0
  602. package/tools/schema/agent.js +1 -0
  603. package/tools/validate-doc-links.js +363 -0
  604. package/website/README.md +76 -0
  605. package/website/astro.config.mjs +218 -0
  606. package/website/src/components/Banner.astro +59 -0
  607. package/website/src/components/Header.astro +121 -0
  608. package/website/src/components/MobileMenuFooter.astro +53 -0
  609. package/website/src/content/config.ts +6 -0
  610. package/website/src/lib/site-url.js +25 -0
  611. package/website/src/rehype-markdown-links.js +102 -0
  612. package/website/src/styles/custom.css +483 -0
  613. package/docs/document-sharding-guide.md +0 -449
  614. package/docs/getting-started/installation.md +0 -76
  615. package/docs/ide-info/auggie.md +0 -31
  616. package/docs/ide-info/claude-code.md +0 -25
  617. package/docs/ide-info/cline.md +0 -31
  618. package/docs/ide-info/codex.md +0 -21
  619. package/docs/ide-info/crush.md +0 -30
  620. package/docs/ide-info/cursor.md +0 -25
  621. package/docs/ide-info/gemini.md +0 -25
  622. package/docs/ide-info/github-copilot.md +0 -26
  623. package/docs/ide-info/iflow.md +0 -33
  624. package/docs/ide-info/index.md +0 -24
  625. package/docs/ide-info/kilo.md +0 -24
  626. package/docs/ide-info/opencode.md +0 -24
  627. package/docs/ide-info/qwen.md +0 -25
  628. package/docs/ide-info/roo.md +0 -27
  629. package/docs/ide-info/rovo-dev.md +0 -22
  630. package/docs/ide-info/trae.md +0 -25
  631. package/docs/ide-info/windsurf.md +0 -22
  632. package/docs/v4-to-v6-upgrade.md +0 -227
  633. package/docs/web-bundles-gemini-gpt-guide.md +0 -21
  634. package/src/core/tasks/validate-workflow.xml +0 -89
  635. package/src/modules/bmb/docs/agents/agent-compilation.md +0 -340
  636. package/src/modules/bmb/docs/agents/agent-menu-patterns.md +0 -523
  637. package/src/modules/bmb/docs/agents/expert-agent-architecture.md +0 -363
  638. package/src/modules/bmb/docs/agents/index.md +0 -55
  639. package/src/modules/bmb/docs/agents/kb.csv +0 -0
  640. package/src/modules/bmb/docs/agents/simple-agent-architecture.md +0 -257
  641. package/src/modules/bmb/docs/agents/understanding-agent-types.md +0 -184
  642. package/src/modules/bmb/docs/index.md +0 -247
  643. package/src/modules/bmb/docs/workflows/architecture.md +0 -220
  644. package/src/modules/bmb/docs/workflows/csv-data-file-standards.md +0 -206
  645. package/src/modules/bmb/docs/workflows/index.md +0 -45
  646. package/src/modules/bmb/docs/workflows/intent-vs-prescriptive-spectrum.md +0 -220
  647. package/src/modules/bmb/docs/workflows/kb.csv +0 -0
  648. package/src/modules/bmb/docs/workflows/templates/step-file.md +0 -139
  649. package/src/modules/bmb/docs/workflows/templates/workflow.md +0 -58
  650. package/src/modules/bmb/docs/workflows/terms.md +0 -97
  651. package/src/modules/bmb/reference/README.md +0 -3
  652. package/src/modules/bmb/reference/agents/simple-examples/README.md +0 -223
  653. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/data/dietary-restrictions.csv +0 -18
  654. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/data/macro-calculator.csv +0 -16
  655. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/data/recipe-database.csv +0 -28
  656. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-01-init.md +0 -176
  657. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-01b-continue.md +0 -120
  658. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-02-profile.md +0 -164
  659. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-03-assessment.md +0 -153
  660. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-04-strategy.md +0 -182
  661. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-05-shopping.md +0 -167
  662. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-06-prep-schedule.md +0 -194
  663. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/templates/assessment-section.md +0 -25
  664. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/templates/nutrition-plan.md +0 -68
  665. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/templates/prep-schedule-section.md +0 -29
  666. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/templates/profile-section.md +0 -47
  667. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/templates/shopping-section.md +0 -37
  668. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/templates/strategy-section.md +0 -18
  669. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/workflow.md +0 -58
  670. package/src/modules/bmb/workflows/create-agent/data/agent-validation-checklist.md +0 -174
  671. package/src/modules/bmb/workflows/create-agent/data/info-and-installation-guide.md +0 -29
  672. package/src/modules/bmb/workflows/create-agent/data/reference/README.md +0 -3
  673. package/src/modules/bmb/workflows/create-agent/data/reference/agents/expert-examples/journal-keeper/README.md +0 -242
  674. package/src/modules/bmb/workflows/create-agent/data/reference/agents/module-examples/README.md +0 -48
  675. package/src/modules/bmb/workflows/create-agent/data/reference/agents/simple-examples/README.md +0 -223
  676. package/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/data/dietary-restrictions.csv +0 -18
  677. package/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/data/macro-calculator.csv +0 -16
  678. package/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/data/recipe-database.csv +0 -28
  679. package/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-01-init.md +0 -177
  680. package/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-01b-continue.md +0 -150
  681. package/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-02-profile.md +0 -164
  682. package/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-03-assessment.md +0 -152
  683. package/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-04-strategy.md +0 -182
  684. package/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-05-shopping.md +0 -167
  685. package/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-06-prep-schedule.md +0 -194
  686. package/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/templates/assessment-section.md +0 -25
  687. package/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/templates/nutrition-plan.md +0 -68
  688. package/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/templates/prep-schedule-section.md +0 -29
  689. package/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/templates/profile-section.md +0 -47
  690. package/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/templates/shopping-section.md +0 -37
  691. package/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/templates/strategy-section.md +0 -18
  692. package/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/workflow.md +0 -58
  693. package/src/modules/bmb/workflows/create-agent/data/validation-complete.md +0 -305
  694. package/src/modules/bmb/workflows/create-agent/steps/step-02-discover.md +0 -206
  695. package/src/modules/bmb/workflows/create-agent/steps/step-03-persona.md +0 -260
  696. package/src/modules/bmb/workflows/create-agent/steps/step-04-commands.md +0 -237
  697. package/src/modules/bmb/workflows/create-agent/steps/step-05-name.md +0 -232
  698. package/src/modules/bmb/workflows/create-agent/steps/step-06-build.md +0 -186
  699. package/src/modules/bmb/workflows/create-agent/steps/step-07-validate.md +0 -234
  700. package/src/modules/bmb/workflows/create-agent/steps/step-08-celebrate.md +0 -218
  701. package/src/modules/bmb/workflows/create-agent/templates/agent-plan.template.md +0 -3
  702. package/src/modules/bmb/workflows/create-agent/templates/expert-agent.template.md +0 -364
  703. package/src/modules/bmb/workflows/create-agent/templates/simple-agent.template.md +0 -257
  704. package/src/modules/bmb/workflows/create-agent/workflow.md +0 -58
  705. package/src/modules/bmb/workflows/create-module/steps/step-01-init.md +0 -155
  706. package/src/modules/bmb/workflows/create-module/steps/step-01b-continue.md +0 -169
  707. package/src/modules/bmb/workflows/create-module/steps/step-02-concept.md +0 -217
  708. package/src/modules/bmb/workflows/create-module/steps/step-03-components.md +0 -267
  709. package/src/modules/bmb/workflows/create-module/steps/step-04-structure.md +0 -228
  710. package/src/modules/bmb/workflows/create-module/steps/step-05-config.md +0 -233
  711. package/src/modules/bmb/workflows/create-module/steps/step-06-agents.md +0 -296
  712. package/src/modules/bmb/workflows/create-module/steps/step-07-workflows.md +0 -228
  713. package/src/modules/bmb/workflows/create-module/steps/step-08-installer.md +0 -186
  714. package/src/modules/bmb/workflows/create-module/steps/step-09-documentation.md +0 -309
  715. package/src/modules/bmb/workflows/create-module/steps/step-10-roadmap.md +0 -337
  716. package/src/modules/bmb/workflows/create-module/steps/step-11-validate.md +0 -335
  717. package/src/modules/bmb/workflows/create-module/templates/agent.template.md +0 -313
  718. package/src/modules/bmb/workflows/create-module/templates/installer.template.js +0 -47
  719. package/src/modules/bmb/workflows/create-module/templates/module-plan.template.md +0 -5
  720. package/src/modules/bmb/workflows/create-module/templates/module.template.yaml +0 -53
  721. package/src/modules/bmb/workflows/create-module/templates/workflow-plan-template.md +0 -23
  722. package/src/modules/bmb/workflows/create-module/validation.md +0 -126
  723. package/src/modules/bmb/workflows/create-module/workflow.md +0 -55
  724. package/src/modules/bmb/workflows/create-workflow/steps/step-01-init.md +0 -157
  725. package/src/modules/bmb/workflows/create-workflow/steps/step-02-gather.md +0 -211
  726. package/src/modules/bmb/workflows/create-workflow/steps/step-03-tools-configuration.md +0 -250
  727. package/src/modules/bmb/workflows/create-workflow/steps/step-04-plan-review.md +0 -216
  728. package/src/modules/bmb/workflows/create-workflow/steps/step-05-output-format-design.md +0 -289
  729. package/src/modules/bmb/workflows/create-workflow/steps/step-07-build.md +0 -308
  730. package/src/modules/bmb/workflows/create-workflow/steps/step-08-review.md +0 -284
  731. package/src/modules/bmb/workflows/create-workflow/steps/step-09-complete.md +0 -187
  732. package/src/modules/bmb/workflows/create-workflow/workflow.md +0 -58
  733. package/src/modules/bmb/workflows/edit-agent/steps/step-01-discover-intent.md +0 -134
  734. package/src/modules/bmb/workflows/edit-agent/steps/step-02-analyze-agent.md +0 -202
  735. package/src/modules/bmb/workflows/edit-agent/steps/step-03-propose-changes.md +0 -157
  736. package/src/modules/bmb/workflows/edit-agent/steps/step-04-apply-changes.md +0 -150
  737. package/src/modules/bmb/workflows/edit-agent/steps/step-05-validate.md +0 -150
  738. package/src/modules/bmb/workflows/edit-agent/workflow.md +0 -58
  739. package/src/modules/bmb/workflows/edit-workflow/steps/step-01-analyze.md +0 -217
  740. package/src/modules/bmb/workflows/edit-workflow/steps/step-02-discover.md +0 -253
  741. package/src/modules/bmb/workflows/edit-workflow/steps/step-03-improve.md +0 -217
  742. package/src/modules/bmb/workflows/edit-workflow/steps/step-04-validate.md +0 -193
  743. package/src/modules/bmb/workflows/edit-workflow/steps/step-05-compliance-check.md +0 -245
  744. package/src/modules/bmb/workflows/edit-workflow/templates/completion-summary.md +0 -75
  745. package/src/modules/bmb/workflows/edit-workflow/templates/improvement-goals.md +0 -68
  746. package/src/modules/bmb/workflows/edit-workflow/templates/improvement-log.md +0 -40
  747. package/src/modules/bmb/workflows/edit-workflow/templates/validation-results.md +0 -51
  748. package/src/modules/bmb/workflows/edit-workflow/templates/workflow-analysis.md +0 -56
  749. package/src/modules/bmb/workflows/edit-workflow/workflow.md +0 -58
  750. package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-01-validate-goal.md +0 -152
  751. package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-02-workflow-validation.md +0 -243
  752. package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-03-step-validation.md +0 -274
  753. package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-04-file-validation.md +0 -295
  754. package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-05-intent-spectrum-validation.md +0 -264
  755. package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-06-web-subprocess-validation.md +0 -360
  756. package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-07-holistic-analysis.md +0 -258
  757. package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-08-generate-report.md +0 -301
  758. package/src/modules/bmb/workflows/workflow-compliance-check/templates/compliance-report.md +0 -140
  759. package/src/modules/bmb/workflows/workflow-compliance-check/workflow.md +0 -58
  760. package/src/modules/bmb/workflows-legacy/edit-module/README.md +0 -171
  761. package/src/modules/bmb/workflows-legacy/edit-module/checklist.md +0 -163
  762. package/src/modules/bmb/workflows-legacy/edit-module/instructions.md +0 -340
  763. package/src/modules/bmb/workflows-legacy/edit-module/workflow.yaml +0 -34
  764. package/src/modules/bmb/workflows-legacy/module-brief/README.md +0 -264
  765. package/src/modules/bmb/workflows-legacy/module-brief/checklist.md +0 -116
  766. package/src/modules/bmb/workflows-legacy/module-brief/instructions.md +0 -268
  767. package/src/modules/bmb/workflows-legacy/module-brief/template.md +0 -275
  768. package/src/modules/bmb/workflows-legacy/module-brief/workflow.yaml +0 -36
  769. package/src/modules/bmgd/docs/glossary.md +0 -294
  770. package/src/modules/bmgd/docs/index.md +0 -180
  771. package/src/modules/bmgd/docs/quick-start.md +0 -250
  772. package/src/modules/bmm/README.md +0 -127
  773. package/src/modules/bmm/docs/bmad-quick-flow.md +0 -506
  774. package/src/modules/bmm/docs/brownfield-guide.md +0 -748
  775. package/src/modules/bmm/docs/enterprise-agentic-development.md +0 -686
  776. package/src/modules/bmm/docs/faq.md +0 -542
  777. package/src/modules/bmm/docs/index.md +0 -168
  778. package/src/modules/bmm/docs/quick-spec-flow.md +0 -638
  779. package/src/modules/bmm/docs/quick-start.md +0 -366
  780. package/src/modules/bmm/docs/scale-adaptive-system.md +0 -618
  781. package/src/modules/bmm/docs/troubleshooting.md +0 -661
  782. package/src/modules/bmm/docs/workflow-architecture-reference.md +0 -366
  783. package/src/modules/bmm/docs/workflow-document-project-reference.md +0 -489
  784. package/src/modules/bmm/docs/workflows-analysis.md +0 -266
  785. package/src/modules/bmm/docs/workflows-implementation.md +0 -210
  786. package/src/modules/bmm/docs/workflows-planning.md +0 -451
  787. package/src/modules/bmm/docs/workflows-solutioning.md +0 -509
  788. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-02-discovery.md +0 -420
  789. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-04-journeys.md +0 -290
  790. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-05-domain.md +0 -270
  791. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-11-complete.md +0 -185
  792. package/src/modules/bmm/workflows/bmad-quick-flow/create-tech-spec/instructions.md +0 -115
  793. package/src/modules/bmm/workflows/bmad-quick-flow/create-tech-spec/workflow.yaml +0 -28
  794. package/website/css/custom.css +0 -52
  795. package/website/docusaurus.config.js +0 -179
  796. package/website/sidebars.js +0 -157
  797. package/website/src/pages/index.js +0 -50
  798. /package/{src/modules/bmm/docs → docs/tutorials/getting-started}/images/workflow-method-greenfield.excalidraw +0 -0
  799. /package/{src/modules/bmm/docs → docs/tutorials/getting-started}/images/workflow-method-greenfield.svg +0 -0
  800. /package/{src/modules/bmgd/docs → docs/tutorials/getting-started/images}/workflow-overview.jpg +0 -0
  801. /package/src/core/{tasks/advanced-elicitation-methods.csv → workflows/advanced-elicitation/methods.csv} +0 -0
  802. /package/src/modules/bmb/workflows/{create-agent/data/reference/agents → agent/data/reference}/expert-examples/journal-keeper/journal-keeper-sidecar/breakthroughs.md +0 -0
  803. /package/src/modules/bmb/workflows/{create-agent/data/reference/agents → agent/data/reference}/expert-examples/journal-keeper/journal-keeper-sidecar/instructions.md +0 -0
  804. /package/src/modules/bmb/workflows/{create-agent/data/reference/agents → agent/data/reference}/expert-examples/journal-keeper/journal-keeper-sidecar/memories.md +0 -0
  805. /package/src/modules/bmb/workflows/{create-agent/data/reference/agents → agent/data/reference}/expert-examples/journal-keeper/journal-keeper-sidecar/mood-patterns.md +0 -0
  806. /package/src/modules/bmgd/workflows/bmgd-quick-flow/{create-tech-spec → quick-spec}/instructions.md +0 -0
  807. /package/src/modules/bmm/workflows/2-plan-workflows/prd/{domain-complexity.csv → data/domain-complexity.csv} +0 -0
  808. /package/src/modules/bmm/workflows/2-plan-workflows/prd/{project-types.csv → data/project-types.csv} +0 -0
  809. /package/{docs → tools/docs}/BUNDLE_DISTRIBUTION_SETUP.md +0 -0
  810. /package/website/{static → public}/favicon.ico +0 -0
  811. /package/website/{static → public}/img/logo.svg +0 -0
  812. /package/website/{static → public}/robots.txt +0 -0
@@ -9,9 +9,15 @@ const ui = new UI();
9
9
  module.exports = {
10
10
  command: 'install',
11
11
  description: 'Install BMAD Core agents and tools',
12
- options: [],
12
+ options: [['-d, --debug', 'Enable debug output for manifest generation']],
13
13
  action: async (options) => {
14
14
  try {
15
+ // Set debug flag as environment variable for all components
16
+ if (options.debug) {
17
+ process.env.BMAD_DEBUG_MANIFEST = 'true';
18
+ console.log(chalk.cyan('Debug mode enabled\n'));
19
+ }
20
+
15
21
  const config = await ui.promptInstall();
16
22
 
17
23
  // Handle cancel
@@ -65,18 +71,14 @@ module.exports = {
65
71
  console.log(chalk.dim(' • ElevenLabs AI (150+ premium voices)'));
66
72
  console.log(chalk.dim(' • Piper TTS (50+ free voices)\n'));
67
73
 
68
- const readline = require('node:readline');
69
- const rl = readline.createInterface({
70
- input: process.stdin,
71
- output: process.stdout,
72
- });
73
-
74
- await new Promise((resolve) => {
75
- rl.question(chalk.green('Press Enter to start AgentVibes installer...'), () => {
76
- rl.close();
77
- resolve();
78
- });
79
- });
74
+ const { default: inquirer } = await import('inquirer');
75
+ await inquirer.prompt([
76
+ {
77
+ type: 'input',
78
+ name: 'continue',
79
+ message: chalk.green('Press Enter to start AgentVibes installer...'),
80
+ },
81
+ ]);
80
82
 
81
83
  console.log('');
82
84
 
@@ -6,26 +6,24 @@
6
6
  startMessage: |
7
7
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
8
8
 
9
- 🎉🎉 Happy Holidays and New Year 🍾🍾
9
+ IMPORTANT: Version Alpha.23 Changes
10
10
 
11
- IMPORTANT Changes with Version Alpha.20 - PLEASE READ THIS if upgrading from earlier Alpha Versions:
11
+ If your current version is older than Alpha.21, you'll need a fresh install:
12
+ - Remove .bmad folder and reinstall
13
+ - Only needed during final push to beta (ETA January 18th)
12
14
 
13
- 1. The BMad Core default output folder has changed from docs to `_bmad-output`. `docs` is meant for long-term artifacts, which you can always decide to move content to.
15
+ 📚 New Docs Site: http://docs.bmad-method.org/
16
+ - Tons of guides and articles coming soon!
17
+ - Everything is free. No paywalls. No gated content.
18
+ - Knowledge should be shared, not sold.
14
19
 
15
- 2. If utilizing the BMad Method Module (BMM) please be aware of the following important recent changes:
20
+ 📺 YouTube Master Class & Podcast launching February 1st!
16
21
 
17
- - Phases 1-3 (Analysis, Planning, Solutioning) will now default output to _bmad-output/planning-artifacts
18
- - Phase 4 (Implementation) will now default output to _bmad-output/implementation-artifacts
19
- - Long term project knowledge (research, docs, references, document-project output) will now default to docs/
22
+ 💡 Love BMad? Please star us on GitHub & subscribe on YouTube!
23
+ - GitHub: https://github.com/bmad-code-org/BMAD-METHOD/
24
+ - YouTube: https://www.youtube.com/@BMadCode
20
25
 
21
- IT IS STRONGLY SUGGESTED to align with these folder conventions instead of dumping all to docs/ - if you are upgrading from a prior
22
- version where all output was going to docs or docs/sprint-artifacts, it is suggested to reset configs to these new values.
23
-
24
- If you have anything in progress, you can move what was in sprint-artifacts to _bmad-output/implementation-artifacts, and if you had brainstorming
25
- content, a PRD, UX or Architecture, you can move the content to _bmad-output/planning-artifacts.
26
-
27
- Read the latest updates before continuing:
28
- https://github.com/bmad-code-org/BMAD-METHOD/blob/main/CHANGELOG.md
26
+ Latest updates: https://github.com/bmad-code-org/BMAD-METHOD/blob/main/CHANGELOG.md
29
27
 
30
28
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
31
29
 
@@ -33,20 +31,28 @@ startMessage: |
33
31
  endMessage: |
34
32
  ════════════════════════════════════════════════════════════════════════════════
35
33
 
36
- ✨ BMAD IS READY TO USE!
34
+ ✨ BMAD IS READY! Beta is just days away! Thank you for your support!
35
+
36
+ 🌟 BMad is 100% free and open source.
37
+ - No gated Discord. No paywalls.
38
+ - We believe in empowering everyone, not just those who can pay.
39
+
40
+ 🙏 SUPPORT BMAD DEVELOPMENT:
41
+ - Donate: https://buymeacoffee.com/bmad
42
+ - Corporate Sponsorship available - DM on Discord
37
43
 
38
- ONE FINAL NOTE WITH VERSION Alpha.20: Phase 4 (Implementation) is still in the process of being migrated to the improved workflow progressive disclosure system.
39
- Along with this, the full conversion to the new path locations for content being searched may possibly be incomplete. If you run a workflow that relies on finding input documents automatically, and you notice they are not being found / looking in the wrong location, either:
40
- 1. Manually specify the correct input location when prompted
41
- 2. Open an issue on GitHub so we can address the problem quickly if you think its a bug.
42
- 3. Ensure your content is in the new locations for best results:
43
- - Planning Artifacts (Phases 1-3): _bmad-output/planning-artifacts
44
- - Implementation Artifacts (Phase 4): _bmad-output/implementation-artifacts
45
- - Long Term Project Knowledge (docs, research, references): docs/
44
+ 🎤 SPEAKING & MEDIA:
45
+ - Available for conferences, podcasts, and media appearances
46
+ - Topics: AI-Native Transformation, Spec and Context Engineering, BMad Method
47
+ - For speaking inquiries or interviews, reach out to BMad on Discord!
46
48
 
47
- Thank you for helping test the early release version of the new BMad Core and BMad Method!
48
- Stable Beta coming soon - please read the full README.md and linked documentation to get started.
49
+ 📚 RESOURCES:
50
+ - Docs: http://docs.bmad-method.org/ (bookmark it!)
51
+ - Changelog: https://github.com/bmad-code-org/BMAD-METHOD/blob/main/CHANGELOG.md
49
52
 
50
- And again, here is the Change Log with all the details of recent updates: https://github.com/bmad-code-org/BMAD-METHOD/blob/main/CHANGELOG.md
53
+ ⭐⭐⭐ HELP US GROW:
54
+ - Star us on GitHub: https://github.com/bmad-code-org/BMAD-METHOD/
55
+ - Subscribe on YouTube: https://www.youtube.com/@BMadCode
56
+ - Every star & sub helps us reach more developers!
51
57
 
52
58
  ════════════════════════════════════════════════════════════════════════════════
@@ -2,10 +2,18 @@ const path = require('node:path');
2
2
  const fs = require('fs-extra');
3
3
  const yaml = require('yaml');
4
4
  const chalk = require('chalk');
5
- const inquirer = require('inquirer').default || require('inquirer');
6
5
  const { getProjectRoot, getModulePath } = require('../../../lib/project-root');
7
6
  const { CLIUtils } = require('../../../lib/cli-utils');
8
7
 
8
+ // Lazy-load inquirer (ESM module) to avoid ERR_REQUIRE_ESM
9
+ let _inquirer = null;
10
+ async function getInquirer() {
11
+ if (!_inquirer) {
12
+ _inquirer = (await import('inquirer')).default;
13
+ }
14
+ return _inquirer;
15
+ }
16
+
9
17
  class ConfigCollector {
10
18
  constructor() {
11
19
  this.collectedConfig = {};
@@ -175,6 +183,7 @@ class ConfigCollector {
175
183
  * @returns {boolean} True if new fields were prompted, false if all fields existed
176
184
  */
177
185
  async collectModuleConfigQuick(moduleName, projectDir, silentMode = true) {
186
+ const inquirer = await getInquirer();
178
187
  this.currentProjectDir = projectDir;
179
188
 
180
189
  // Load existing config if not already loaded
@@ -493,6 +502,7 @@ class ConfigCollector {
493
502
  * @param {boolean} skipCompletion - Skip showing completion message (for early core collection)
494
503
  */
495
504
  async collectModuleConfig(moduleName, projectDir, skipLoadExisting = false, skipCompletion = false) {
505
+ const inquirer = await getInquirer();
496
506
  this.currentProjectDir = projectDir;
497
507
  // Load existing config if needed and not already loaded
498
508
  if (!skipLoadExisting && !this.existingConfig) {
@@ -203,127 +203,17 @@ class Detector {
203
203
  }
204
204
 
205
205
  /**
206
- * Detect legacy BMAD v4 footprints (case-sensitive path checks)
207
- * V4 used _bmad-method as default folder name
208
- * V6+ uses configurable folder names and ALWAYS has _config/manifest.yaml with installation.version
206
+ * Detect legacy BMAD v4 .bmad-method folder
209
207
  * @param {string} projectDir - Project directory to check
210
208
  * @returns {{ hasLegacyV4: boolean, offenders: string[] }}
211
209
  */
212
210
  async detectLegacyV4(projectDir) {
213
- // Helper: check existence of a nested path with case-sensitive segment matching
214
- const existsCaseSensitive = async (baseDir, segments) => {
215
- let dir = baseDir;
216
- for (let i = 0; i < segments.length; i++) {
217
- const seg = segments[i];
218
- let entries;
219
- try {
220
- entries = await fs.readdir(dir, { withFileTypes: true });
221
- } catch {
222
- return false;
223
- }
224
- const hit = entries.find((e) => e.name === seg);
225
- if (!hit) return false;
226
- // Parents must be directories; the last segment may be a file or directory
227
- if (i < segments.length - 1 && !hit.isDirectory()) return false;
228
- dir = path.join(dir, hit.name);
229
- }
230
- return true;
231
- };
232
-
233
- // Helper: check if a directory is a V6+ installation
234
- const isV6Installation = async (dirPath) => {
235
- const manifestPath = path.join(dirPath, '_config', 'manifest.yaml');
236
- if (!(await fs.pathExists(manifestPath))) {
237
- return false;
238
- }
239
- try {
240
- const yaml = require('yaml');
241
- const manifestContent = await fs.readFile(manifestPath, 'utf8');
242
- const manifest = yaml.parse(manifestContent);
243
- // V6+ manifest has installation.version
244
- return manifest && manifest.installation && manifest.installation.version;
245
- } catch {
246
- return false;
247
- }
248
- };
249
-
250
211
  const offenders = [];
251
212
 
252
- // Strategy:
253
- // 1. First scan for ANY V6+ installation (_config/manifest.yaml)
254
- // 2. If V6+ found → don't flag anything (user is already on V6+)
255
- // 3. If NO V6+ found → flag folders with "bmad" in name as potential V4 legacy
256
-
257
- let hasV6Installation = false;
258
- const potentialV4Folders = [];
259
-
260
- try {
261
- const entries = await fs.readdir(projectDir, { withFileTypes: true });
262
-
263
- for (const entry of entries) {
264
- if (entry.isDirectory()) {
265
- const name = entry.name;
266
- const fullPath = path.join(projectDir, entry.name);
267
-
268
- // Check if directory is empty (skip empty leftover folders)
269
- const dirContents = await fs.readdir(fullPath);
270
- if (dirContents.length === 0) {
271
- continue; // Skip empty folders
272
- }
273
-
274
- // Check if it's a V6+ installation by looking for _config/manifest.yaml
275
- // This works for ANY folder name (not just bmad-prefixed)
276
- const isV6 = await isV6Installation(fullPath);
277
-
278
- if (isV6) {
279
- // Found a V6+ installation - user is already on V6+
280
- hasV6Installation = true;
281
- // Don't break - continue scanning to be thorough
282
- } else {
283
- // Not V6+, check if this is the exact V4 folder name "bmad-method"
284
- if (name === 'bmad-method') {
285
- // This is the V4 default folder - flag it as legacy
286
- potentialV4Folders.push(fullPath);
287
- }
288
- }
289
- }
290
- }
291
- } catch {
292
- // Ignore errors reading directory
293
- }
294
-
295
- // Only flag V4 folders if NO V6+ installation was found
296
- if (!hasV6Installation && potentialV4Folders.length > 0) {
297
- offenders.push(...potentialV4Folders);
298
- }
299
-
300
- // Check inside various IDE command folders for legacy bmad folders
301
- // V4 used folders like 'bmad-method' or custom names in IDE commands
302
- // V6+ uses 'bmad' in IDE commands (hardcoded in IDE handlers)
303
- // Legacy V4 IDE command folders won't have a corresponding V6+ installation
304
- const ideConfigFolders = ['.opencode', '.claude', '.crush', '.continue', '.cursor', '.windsurf', '.cline', '.roo-cline'];
305
-
306
- for (const ideFolder of ideConfigFolders) {
307
- const commandsDirName = ideFolder === '.opencode' ? 'command' : 'commands';
308
- const commandsPath = path.join(projectDir, ideFolder, commandsDirName);
309
- if (await fs.pathExists(commandsPath)) {
310
- try {
311
- const commandEntries = await fs.readdir(commandsPath, { withFileTypes: true });
312
- for (const entry of commandEntries) {
313
- if (entry.isDirectory()) {
314
- const name = entry.name;
315
- // V4 used 'bmad-method' or similar in IDE commands folders
316
- // V6+ uses 'bmad' (hardcoded)
317
- // So anything that's NOT 'bmad' but starts with bmad/Bmad is likely V4
318
- if ((name.startsWith('bmad') || name.startsWith('Bmad') || name === 'BMad') && name !== 'bmad') {
319
- offenders.push(path.join(commandsPath, entry.name));
320
- }
321
- }
322
- }
323
- } catch {
324
- // Ignore errors reading commands directory
325
- }
326
- }
213
+ // Check for .bmad-method folder
214
+ const bmadMethodPath = path.join(projectDir, '.bmad-method');
215
+ if (await fs.pathExists(bmadMethodPath)) {
216
+ offenders.push(bmadMethodPath);
327
217
  }
328
218
 
329
219
  return { hasLegacyV4: offenders.length > 0, offenders };
@@ -2,7 +2,6 @@ const path = require('node:path');
2
2
  const fs = require('fs-extra');
3
3
  const chalk = require('chalk');
4
4
  const ora = require('ora');
5
- const inquirer = require('inquirer').default || require('inquirer');
6
5
  const { Detector } = require('./detector');
7
6
  const { Manifest } = require('./manifest');
8
7
  const { ModuleManager } = require('../modules/manager');
@@ -2140,7 +2139,7 @@ class Installer {
2140
2139
  * Private: Prompt for update action
2141
2140
  */
2142
2141
  async promptUpdateAction() {
2143
- const inquirer = require('inquirer').default || require('inquirer');
2142
+ const { default: inquirer } = await import('inquirer');
2144
2143
  return await inquirer.prompt([
2145
2144
  {
2146
2145
  type: 'list',
@@ -2152,90 +2151,59 @@ class Installer {
2152
2151
  }
2153
2152
 
2154
2153
  /**
2155
- * Handle legacy BMAD v4 migration with automatic backup
2156
- * @param {string} projectDir - Project directory
2157
- * @param {Object} legacyV4 - Legacy V4 detection result with offenders array
2154
+ * Handle legacy BMAD v4 detection with simple warning
2155
+ * @param {string} _projectDir - Project directory (unused in simplified version)
2156
+ * @param {Object} _legacyV4 - Legacy V4 detection result (unused in simplified version)
2158
2157
  */
2159
- async handleLegacyV4Migration(projectDir, legacyV4) {
2160
- console.log(chalk.yellow.bold('\n⚠️ Legacy BMAD v4 detected'));
2161
- console.log(chalk.dim('The installer found legacy artefacts in your project.\n'));
2162
-
2163
- // Separate _bmad* folders (auto-backup) from other offending paths (manual cleanup)
2164
- const bmadFolders = legacyV4.offenders.filter((p) => {
2165
- const name = path.basename(p);
2166
- return name.startsWith('_bmad'); // Only dot-prefixed folders get auto-backed up
2167
- });
2168
- const otherOffenders = legacyV4.offenders.filter((p) => {
2169
- const name = path.basename(p);
2170
- return !name.startsWith('_bmad'); // Everything else is manual cleanup
2171
- });
2172
-
2173
- const inquirer = require('inquirer').default || require('inquirer');
2174
-
2175
- // Show warning for other offending paths FIRST
2176
- if (otherOffenders.length > 0) {
2177
- console.log(chalk.yellow('⚠️ Recommended cleanup:'));
2178
- console.log(chalk.dim('It is recommended to remove the following items before proceeding:\n'));
2179
- for (const p of otherOffenders) console.log(chalk.dim(` - ${p}`));
2180
-
2181
- console.log(chalk.cyan('\nCleanup commands you can copy/paste:'));
2182
- console.log(chalk.dim('macOS/Linux:'));
2183
- for (const p of otherOffenders) console.log(chalk.dim(` rm -rf '${p}'`));
2184
- console.log(chalk.dim('Windows:'));
2185
- for (const p of otherOffenders) console.log(chalk.dim(` rmdir /S /Q "${p}"`));
2186
-
2187
- const { cleanedUp } = await inquirer.prompt([
2188
- {
2189
- type: 'confirm',
2190
- name: 'cleanedUp',
2191
- message: 'Have you completed the recommended cleanup? (You can proceed without it, but it is recommended)',
2192
- default: false,
2193
- },
2194
- ]);
2158
+ async handleLegacyV4Migration(_projectDir, _legacyV4) {
2159
+ const { default: inquirer } = await import('inquirer');
2195
2160
 
2196
- if (cleanedUp) {
2197
- console.log(chalk.green(' Cleanup acknowledged\n'));
2198
- } else {
2199
- console.log(chalk.yellow('⚠️ Proceeding without recommended cleanup\n'));
2200
- }
2201
- }
2202
-
2203
- // Handle _bmad* folders with automatic backup
2204
- if (bmadFolders.length > 0) {
2205
- console.log(chalk.cyan('The following legacy folders will be moved to v4-backup:'));
2206
- for (const p of bmadFolders) console.log(chalk.dim(` - ${p}`));
2207
-
2208
- const { proceed } = await inquirer.prompt([
2209
- {
2210
- type: 'confirm',
2211
- name: 'proceed',
2212
- message: 'Proceed with backing up legacy v4 folders?',
2213
- default: true,
2214
- },
2215
- ]);
2161
+ console.log('');
2162
+ console.log(chalk.yellow.bold('⚠️ Legacy BMAD v4 detected'));
2163
+ console.log(chalk.yellow('─'.repeat(80)));
2164
+ console.log(chalk.yellow('Found .bmad-method folder from BMAD v4 installation.'));
2165
+ console.log('');
2216
2166
 
2217
- if (proceed) {
2218
- const backupDir = path.join(projectDir, 'v4-backup');
2219
- await fs.ensureDir(backupDir);
2167
+ console.log(chalk.dim('Before continuing with installation, we recommend:'));
2168
+ console.log(chalk.dim(' 1. Remove the .bmad-method folder, OR'));
2169
+ console.log(chalk.dim(' 2. Back it up by renaming it to another name (e.g., bmad-method-backup)'));
2170
+ console.log('');
2220
2171
 
2221
- for (const folder of bmadFolders) {
2222
- const folderName = path.basename(folder);
2223
- const backupPath = path.join(backupDir, folderName);
2172
+ console.log(chalk.dim('If your v4 installation set up rules or commands, you should remove those as well.'));
2173
+ console.log('');
2224
2174
 
2225
- // If backup already exists, add timestamp
2226
- let finalBackupPath = backupPath;
2227
- if (await fs.pathExists(backupPath)) {
2228
- const timestamp = new Date().toISOString().replaceAll(/[:.]/g, '-').split('T')[0];
2229
- finalBackupPath = path.join(backupDir, `${folderName}-${timestamp}`);
2230
- }
2175
+ const { proceed } = await inquirer.prompt([
2176
+ {
2177
+ type: 'list',
2178
+ name: 'proceed',
2179
+ message: 'What would you like to do?',
2180
+ choices: [
2181
+ {
2182
+ name: 'Exit and clean up manually (recommended)',
2183
+ value: 'exit',
2184
+ short: 'Exit installation',
2185
+ },
2186
+ {
2187
+ name: 'Continue with installation anyway',
2188
+ value: 'continue',
2189
+ short: 'Continue',
2190
+ },
2191
+ ],
2192
+ default: 'exit',
2193
+ },
2194
+ ]);
2231
2195
 
2232
- await fs.move(folder, finalBackupPath, { overwrite: false });
2233
- console.log(chalk.green(`✓ Moved ${folderName} to ${path.relative(projectDir, finalBackupPath)}`));
2234
- }
2235
- } else {
2236
- throw new Error('Installation cancelled by user');
2237
- }
2196
+ if (proceed === 'exit') {
2197
+ console.log('');
2198
+ console.log(chalk.cyan('Please remove the .bmad-method folder and any v4 rules/commands,'));
2199
+ console.log(chalk.cyan('then run the installer again.'));
2200
+ console.log('');
2201
+ process.exit(0);
2238
2202
  }
2203
+
2204
+ console.log('');
2205
+ console.log(chalk.yellow('⚠️ Proceeding with installation despite legacy v4 folder'));
2206
+ console.log('');
2239
2207
  }
2240
2208
 
2241
2209
  /**
@@ -2469,7 +2437,7 @@ class Installer {
2469
2437
 
2470
2438
  console.log(chalk.yellow(`\n⚠️ Found ${customModulesWithMissingSources.length} custom module(s) with missing sources:`));
2471
2439
 
2472
- const inquirer = require('inquirer').default || require('inquirer');
2440
+ const { default: inquirer } = await import('inquirer');
2473
2441
  let keptCount = 0;
2474
2442
  let updatedCount = 0;
2475
2443
  let removedCount = 0;
@@ -121,8 +121,16 @@ class ManifestGenerator {
121
121
  async getWorkflowsFromPath(basePath, moduleName) {
122
122
  const workflows = [];
123
123
  const workflowsPath = path.join(basePath, 'workflows');
124
+ const debug = process.env.BMAD_DEBUG_MANIFEST === 'true';
125
+
126
+ if (debug) {
127
+ console.log(`[DEBUG] Scanning workflows in: ${workflowsPath}`);
128
+ }
124
129
 
125
130
  if (!(await fs.pathExists(workflowsPath))) {
131
+ if (debug) {
132
+ console.log(`[DEBUG] Workflows path does not exist: ${workflowsPath}`);
133
+ }
126
134
  return workflows;
127
135
  }
128
136
 
@@ -139,8 +147,13 @@ class ManifestGenerator {
139
147
  await findWorkflows(fullPath, newRelativePath);
140
148
  } else if (entry.name === 'workflow.yaml' || entry.name === 'workflow.md') {
141
149
  // Parse workflow file (both YAML and MD formats)
150
+ if (debug) {
151
+ console.log(`[DEBUG] Found workflow file: ${fullPath}`);
152
+ }
142
153
  try {
143
- const content = await fs.readFile(fullPath, 'utf8');
154
+ // Read and normalize line endings (fix Windows CRLF issues)
155
+ const rawContent = await fs.readFile(fullPath, 'utf8');
156
+ const content = rawContent.replaceAll('\r\n', '\n').replaceAll('\r', '\n');
144
157
 
145
158
  let workflow;
146
159
  if (entry.name === 'workflow.yaml') {
@@ -150,13 +163,31 @@ class ManifestGenerator {
150
163
  // Parse MD workflow with YAML frontmatter
151
164
  const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
152
165
  if (!frontmatterMatch) {
166
+ if (debug) {
167
+ console.log(`[DEBUG] Skipped (no frontmatter): ${fullPath}`);
168
+ }
153
169
  continue; // Skip MD files without frontmatter
154
170
  }
155
171
  workflow = yaml.parse(frontmatterMatch[1]);
156
172
  }
157
173
 
174
+ if (debug) {
175
+ console.log(`[DEBUG] Parsed: name="${workflow.name}", description=${workflow.description ? 'OK' : 'MISSING'}`);
176
+ }
177
+
158
178
  // Skip template workflows (those with placeholder values)
159
179
  if (workflow.name && workflow.name.includes('{') && workflow.name.includes('}')) {
180
+ if (debug) {
181
+ console.log(`[DEBUG] Skipped (template placeholder): ${workflow.name}`);
182
+ }
183
+ continue;
184
+ }
185
+
186
+ // Skip workflows marked as non-standalone (reference/example workflows)
187
+ if (workflow.standalone === false) {
188
+ if (debug) {
189
+ console.log(`[DEBUG] Skipped (standalone=false): ${workflow.name}`);
190
+ }
160
191
  continue;
161
192
  }
162
193
 
@@ -167,7 +198,7 @@ class ManifestGenerator {
167
198
  ? `${this.bmadFolderName}/core/workflows/${relativePath}/${entry.name}`
168
199
  : `${this.bmadFolderName}/${moduleName}/workflows/${relativePath}/${entry.name}`;
169
200
 
170
- // ALL workflows now generate commands - no standalone property needed
201
+ // Workflows with standalone: false are filtered out above
171
202
  workflows.push({
172
203
  name: workflow.name,
173
204
  description: workflow.description.replaceAll('"', '""'), // Escape quotes for CSV
@@ -182,6 +213,14 @@ class ManifestGenerator {
182
213
  module: moduleName,
183
214
  path: installPath,
184
215
  });
216
+
217
+ if (debug) {
218
+ console.log(`[DEBUG] ✓ Added workflow: ${workflow.name} (${moduleName})`);
219
+ }
220
+ } else {
221
+ if (debug) {
222
+ console.log(`[DEBUG] Skipped (missing name or description): ${fullPath}`);
223
+ }
185
224
  }
186
225
  } catch (error) {
187
226
  console.warn(`Warning: Failed to parse workflow at ${fullPath}: ${error.message}`);
@@ -191,6 +230,11 @@ class ManifestGenerator {
191
230
  };
192
231
 
193
232
  await findWorkflows(workflowsPath);
233
+
234
+ if (debug) {
235
+ console.log(`[DEBUG] Total workflows found in ${moduleName}: ${workflows.length}`);
236
+ }
237
+
194
238
  return workflows;
195
239
  }
196
240
 
@@ -58,7 +58,7 @@ class AntigravitySetup extends BaseIdeSetup {
58
58
 
59
59
  if (config.subagentChoices.install !== 'none') {
60
60
  // Ask for installation location
61
- const inquirer = require('inquirer').default || require('inquirer');
61
+ const { default: inquirer } = await import('inquirer');
62
62
  const locationAnswer = await inquirer.prompt([
63
63
  {
64
64
  type: 'list',
@@ -297,7 +297,7 @@ class AntigravitySetup extends BaseIdeSetup {
297
297
  choices = await this.promptSubagentInstallation(config.subagents);
298
298
 
299
299
  if (choices.install !== 'none') {
300
- const inquirer = require('inquirer').default || require('inquirer');
300
+ const { default: inquirer } = await import('inquirer');
301
301
  const locationAnswer = await inquirer.prompt([
302
302
  {
303
303
  type: 'list',
@@ -334,7 +334,7 @@ class AntigravitySetup extends BaseIdeSetup {
334
334
  * Prompt user for subagent installation preferences
335
335
  */
336
336
  async promptSubagentInstallation(subagentConfig) {
337
- const inquirer = require('inquirer').default || require('inquirer');
337
+ const { default: inquirer } = await import('inquirer');
338
338
 
339
339
  // First ask if they want to install subagents
340
340
  const { install } = await inquirer.prompt([
@@ -57,7 +57,7 @@ class ClaudeCodeSetup extends BaseIdeSetup {
57
57
 
58
58
  if (config.subagentChoices.install !== 'none') {
59
59
  // Ask for installation location
60
- const inquirer = require('inquirer').default || require('inquirer');
60
+ const { default: inquirer } = await import('inquirer');
61
61
  const locationAnswer = await inquirer.prompt([
62
62
  {
63
63
  type: 'list',
@@ -305,7 +305,7 @@ class ClaudeCodeSetup extends BaseIdeSetup {
305
305
  choices = await this.promptSubagentInstallation(config.subagents);
306
306
 
307
307
  if (choices.install !== 'none') {
308
- const inquirer = require('inquirer').default || require('inquirer');
308
+ const { default: inquirer } = await import('inquirer');
309
309
  const locationAnswer = await inquirer.prompt([
310
310
  {
311
311
  type: 'list',
@@ -342,7 +342,7 @@ class ClaudeCodeSetup extends BaseIdeSetup {
342
342
  * Prompt user for subagent installation preferences
343
343
  */
344
344
  async promptSubagentInstallation(subagentConfig) {
345
- const inquirer = require('inquirer').default || require('inquirer');
345
+ const { default: inquirer } = await import('inquirer');
346
346
 
347
347
  // First ask if they want to install subagents
348
348
  const { install } = await inquirer.prompt([
@@ -21,7 +21,7 @@ class CodexSetup extends BaseIdeSetup {
21
21
  * @returns {Object} Collected configuration
22
22
  */
23
23
  async collectConfiguration(options = {}) {
24
- const inquirer = require('inquirer').default || require('inquirer');
24
+ const { default: inquirer } = await import('inquirer');
25
25
 
26
26
  let confirmed = false;
27
27
  let installLocation = 'global';