bmad-fh 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 (626) hide show
  1. package/.coderabbit.yaml +40 -0
  2. package/.githooks/post-checkout +129 -0
  3. package/.githooks/pre-commit +63 -0
  4. package/.githooks/pre-push +135 -0
  5. package/.github/CODE_OF_CONDUCT.md +128 -0
  6. package/.github/FUNDING.yaml +15 -0
  7. package/.github/ISSUE_TEMPLATE/config.yaml +8 -0
  8. package/.github/ISSUE_TEMPLATE/feature_request.md +22 -0
  9. package/.github/ISSUE_TEMPLATE/issue.md +32 -0
  10. package/.github/scripts/discord-helpers.sh +34 -0
  11. package/.github/workflows/bundle-latest.yaml +330 -0
  12. package/.github/workflows/discord.yaml +90 -0
  13. package/.github/workflows/docs.yaml +63 -0
  14. package/.github/workflows/manual-release.yaml +190 -0
  15. package/.github/workflows/publish-multi-artifact.yaml +50 -0
  16. package/.github/workflows/quality.yaml +115 -0
  17. package/.husky/pre-commit +20 -0
  18. package/.markdownlint-cli2.yaml +41 -0
  19. package/.nvmrc +1 -0
  20. package/.prettierignore +9 -0
  21. package/.vscode/settings.json +97 -0
  22. package/CHANGELOG.md +1394 -0
  23. package/CNAME +1 -0
  24. package/CONTRIBUTING.md +306 -0
  25. package/CONTRIBUTORS.md +32 -0
  26. package/LICENSE +30 -0
  27. package/README.md +126 -0
  28. package/SECURITY.md +85 -0
  29. package/TRADEMARK.md +55 -0
  30. package/Wordmark.png +0 -0
  31. package/banner-bmad-method.png +0 -0
  32. package/docs/404.md +9 -0
  33. package/docs/_README_WORKFLOW_DIAGRAMS.md +40 -0
  34. package/docs/_STYLE_GUIDE.md +367 -0
  35. package/docs/_archive/customize-workflows.md +30 -0
  36. package/docs/_archive/getting-started-bmadv4.md +247 -0
  37. package/docs/_archive/vendor-workflows.md +52 -0
  38. package/docs/downloads.md +72 -0
  39. package/docs/explanation/agents/barry-quick-flow.md +328 -0
  40. package/docs/explanation/agents/index.md +19 -0
  41. package/docs/explanation/architecture/four-phases.md +107 -0
  42. package/docs/explanation/architecture/preventing-agent-conflicts.md +111 -0
  43. package/docs/explanation/architecture/why-solutioning-matters.md +75 -0
  44. package/docs/explanation/bmm/index.md +131 -0
  45. package/docs/explanation/core/index.md +18 -0
  46. package/docs/explanation/core-concepts/agent-roles.md +179 -0
  47. package/docs/explanation/core-concepts/index.md +35 -0
  48. package/docs/explanation/core-concepts/what-are-agents.md +97 -0
  49. package/docs/explanation/core-concepts/what-are-modules.md +85 -0
  50. package/docs/explanation/core-concepts/what-are-workflows.md +204 -0
  51. package/docs/explanation/faq/brownfield-faq.md +73 -0
  52. package/docs/explanation/faq/getting-started-faq.md +67 -0
  53. package/docs/explanation/faq/implementation-faq.md +52 -0
  54. package/docs/explanation/faq/index.md +16 -0
  55. package/docs/explanation/faq/levels-and-tracks-faq.md +52 -0
  56. package/docs/explanation/faq/planning-faq.md +41 -0
  57. package/docs/explanation/faq/tools-faq.md +277 -0
  58. package/docs/explanation/faq/workflows-faq.md +61 -0
  59. package/docs/explanation/features/advanced-elicitation.md +95 -0
  60. package/docs/explanation/features/brainstorming-techniques.md +92 -0
  61. package/docs/explanation/features/party-mode.md +95 -0
  62. package/docs/explanation/features/quick-flow.md +149 -0
  63. package/docs/explanation/features/tea-overview.md +410 -0
  64. package/docs/explanation/features/web-bundles.md +34 -0
  65. package/docs/explanation/philosophy/facilitation-over-generation.md +333 -0
  66. package/docs/explanation/philosophy/testing-as-engineering.md +112 -0
  67. package/docs/explanation/tea/engagement-models.md +710 -0
  68. package/docs/explanation/tea/fixture-architecture.md +457 -0
  69. package/docs/explanation/tea/knowledge-base-system.md +554 -0
  70. package/docs/explanation/tea/network-first-patterns.md +853 -0
  71. package/docs/explanation/tea/risk-based-testing.md +586 -0
  72. package/docs/explanation/tea/test-quality-standards.md +907 -0
  73. package/docs/how-to/brownfield/add-feature-to-existing.md +74 -0
  74. package/docs/how-to/brownfield/document-existing-project.md +66 -0
  75. package/docs/how-to/brownfield/index.md +84 -0
  76. package/docs/how-to/brownfield/quick-fix-in-brownfield.md +77 -0
  77. package/docs/how-to/brownfield/use-tea-for-enterprise.md +526 -0
  78. package/docs/how-to/brownfield/use-tea-with-existing-tests.md +577 -0
  79. package/docs/how-to/customization/customize-agents.md +212 -0
  80. package/docs/how-to/customization/enable-tea-mcp-enhancements.md +424 -0
  81. package/docs/how-to/customization/index.md +23 -0
  82. package/docs/how-to/customization/integrate-playwright-utils.md +813 -0
  83. package/docs/how-to/customization/shard-large-documents.md +101 -0
  84. package/docs/how-to/get-answers-about-bmad.md +102 -0
  85. package/docs/how-to/installation/index.md +12 -0
  86. package/docs/how-to/installation/install-bmad.md +111 -0
  87. package/docs/how-to/installation/install-custom-modules.md +118 -0
  88. package/docs/how-to/installation/upgrade-to-v6.md +131 -0
  89. package/docs/how-to/workflows/bmgd-quick-flow.md +156 -0
  90. package/docs/how-to/workflows/conduct-research.md +97 -0
  91. package/docs/how-to/workflows/create-architecture.md +119 -0
  92. package/docs/how-to/workflows/create-epics-and-stories.md +109 -0
  93. package/docs/how-to/workflows/create-prd.md +91 -0
  94. package/docs/how-to/workflows/create-product-brief.md +94 -0
  95. package/docs/how-to/workflows/create-story.md +102 -0
  96. package/docs/how-to/workflows/create-ux-design.md +100 -0
  97. package/docs/how-to/workflows/implement-story.md +97 -0
  98. package/docs/how-to/workflows/quick-spec.md +122 -0
  99. package/docs/how-to/workflows/run-atdd.md +436 -0
  100. package/docs/how-to/workflows/run-automate.md +653 -0
  101. package/docs/how-to/workflows/run-brainstorming-session.md +73 -0
  102. package/docs/how-to/workflows/run-code-review.md +89 -0
  103. package/docs/how-to/workflows/run-implementation-readiness.md +125 -0
  104. package/docs/how-to/workflows/run-nfr-assess.md +679 -0
  105. package/docs/how-to/workflows/run-sprint-planning.md +94 -0
  106. package/docs/how-to/workflows/run-test-design.md +98 -0
  107. package/docs/how-to/workflows/run-test-review.md +605 -0
  108. package/docs/how-to/workflows/run-trace.md +883 -0
  109. package/docs/how-to/workflows/setup-ci.md +712 -0
  110. package/docs/how-to/workflows/setup-party-mode.md +89 -0
  111. package/docs/how-to/workflows/setup-test-framework.md +98 -0
  112. package/docs/index.md +63 -0
  113. package/docs/migration-guide.md +365 -0
  114. package/docs/multi-scope-guide.md +379 -0
  115. package/docs/plans/multi-scope-parallel-artifacts-plan.md +695 -0
  116. package/docs/reference/agents/index.md +109 -0
  117. package/docs/reference/configuration/core-tasks.md +67 -0
  118. package/docs/reference/configuration/global-config.md +28 -0
  119. package/docs/reference/glossary/index.md +159 -0
  120. package/docs/reference/tea/commands.md +254 -0
  121. package/docs/reference/tea/configuration.md +678 -0
  122. package/docs/reference/tea/knowledge-base.md +340 -0
  123. package/docs/reference/workflows/core-workflows.md +32 -0
  124. package/docs/reference/workflows/document-project.md +73 -0
  125. package/docs/reference/workflows/index.md +12 -0
  126. package/docs/tutorials/getting-started/getting-started-bmadv6.md +246 -0
  127. package/docs/tutorials/getting-started/images/workflow-method-greenfield.excalidraw +5034 -0
  128. package/docs/tutorials/getting-started/images/workflow-method-greenfield.svg +4 -0
  129. package/docs/tutorials/getting-started/images/workflow-overview.jpg +0 -0
  130. package/docs/tutorials/getting-started/tea-lite-quickstart.md +444 -0
  131. package/docs/tutorials/getting-started/workflow-overview.jpg +0 -0
  132. package/eslint.config.mjs +152 -0
  133. package/package.json +117 -0
  134. package/prettier.config.mjs +32 -0
  135. package/src/bmm/_module-installer/installer.js +48 -0
  136. package/src/bmm/_module-installer/platform-specifics/claude-code.js +35 -0
  137. package/src/bmm/_module-installer/platform-specifics/windsurf.js +32 -0
  138. package/src/bmm/agents/analyst.agent.yaml +41 -0
  139. package/src/bmm/agents/architect.agent.yaml +33 -0
  140. package/src/bmm/agents/dev.agent.yaml +38 -0
  141. package/src/bmm/agents/pm.agent.yaml +51 -0
  142. package/src/bmm/agents/quick-flow-solo-dev.agent.yaml +32 -0
  143. package/src/bmm/agents/sm.agent.yaml +47 -0
  144. package/src/bmm/agents/tea.agent.yaml +68 -0
  145. package/src/bmm/agents/tech-writer/tech-writer-sidecar/documentation-standards.md +224 -0
  146. package/src/bmm/agents/tech-writer/tech-writer.agent.yaml +49 -0
  147. package/src/bmm/agents/ux-designer.agent.yaml +30 -0
  148. package/src/bmm/data/README.md +29 -0
  149. package/src/bmm/data/project-context-template.md +40 -0
  150. package/src/bmm/module.yaml +64 -0
  151. package/src/bmm/sub-modules/claude-code/config.yaml +4 -0
  152. package/src/bmm/sub-modules/claude-code/injections.yaml +242 -0
  153. package/src/bmm/sub-modules/claude-code/readme.md +87 -0
  154. package/src/bmm/teams/default-party.csv +21 -0
  155. package/src/bmm/teams/team-fullstack.yaml +12 -0
  156. package/src/bmm/testarch/knowledge/api-request.md +442 -0
  157. package/src/bmm/testarch/knowledge/api-testing-patterns.md +843 -0
  158. package/src/bmm/testarch/knowledge/auth-session.md +552 -0
  159. package/src/bmm/testarch/knowledge/burn-in.md +273 -0
  160. package/src/bmm/testarch/knowledge/ci-burn-in.md +675 -0
  161. package/src/bmm/testarch/knowledge/component-tdd.md +486 -0
  162. package/src/bmm/testarch/knowledge/contract-testing.md +957 -0
  163. package/src/bmm/testarch/knowledge/data-factories.md +500 -0
  164. package/src/bmm/testarch/knowledge/email-auth.md +721 -0
  165. package/src/bmm/testarch/knowledge/error-handling.md +725 -0
  166. package/src/bmm/testarch/knowledge/feature-flags.md +750 -0
  167. package/src/bmm/testarch/knowledge/file-utils.md +463 -0
  168. package/src/bmm/testarch/knowledge/fixture-architecture.md +401 -0
  169. package/src/bmm/testarch/knowledge/fixtures-composition.md +382 -0
  170. package/src/bmm/testarch/knowledge/intercept-network-call.md +430 -0
  171. package/src/bmm/testarch/knowledge/log.md +429 -0
  172. package/src/bmm/testarch/knowledge/network-error-monitor.md +405 -0
  173. package/src/bmm/testarch/knowledge/network-first.md +486 -0
  174. package/src/bmm/testarch/knowledge/network-recorder.md +527 -0
  175. package/src/bmm/testarch/knowledge/nfr-criteria.md +670 -0
  176. package/src/bmm/testarch/knowledge/overview.md +286 -0
  177. package/src/bmm/testarch/knowledge/playwright-config.md +730 -0
  178. package/src/bmm/testarch/knowledge/probability-impact.md +601 -0
  179. package/src/bmm/testarch/knowledge/recurse.md +421 -0
  180. package/src/bmm/testarch/knowledge/risk-governance.md +615 -0
  181. package/src/bmm/testarch/knowledge/selective-testing.md +732 -0
  182. package/src/bmm/testarch/knowledge/selector-resilience.md +527 -0
  183. package/src/bmm/testarch/knowledge/test-healing-patterns.md +644 -0
  184. package/src/bmm/testarch/knowledge/test-levels-framework.md +473 -0
  185. package/src/bmm/testarch/knowledge/test-priorities-matrix.md +373 -0
  186. package/src/bmm/testarch/knowledge/test-quality.md +664 -0
  187. package/src/bmm/testarch/knowledge/timing-debugging.md +372 -0
  188. package/src/bmm/testarch/knowledge/visual-debugging.md +524 -0
  189. package/src/bmm/testarch/tea-index.csv +34 -0
  190. package/src/bmm/workflows/1-analysis/create-product-brief/product-brief.template.md +10 -0
  191. package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-01-init.md +177 -0
  192. package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-01b-continue.md +161 -0
  193. package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-02-vision.md +199 -0
  194. package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-03-users.md +202 -0
  195. package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-04-metrics.md +205 -0
  196. package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-05-scope.md +219 -0
  197. package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-06-complete.md +194 -0
  198. package/src/bmm/workflows/1-analysis/create-product-brief/workflow.md +58 -0
  199. package/src/bmm/workflows/1-analysis/research/domain-steps/step-01-init.md +137 -0
  200. package/src/bmm/workflows/1-analysis/research/domain-steps/step-02-domain-analysis.md +229 -0
  201. package/src/bmm/workflows/1-analysis/research/domain-steps/step-03-competitive-landscape.md +238 -0
  202. package/src/bmm/workflows/1-analysis/research/domain-steps/step-04-regulatory-focus.md +206 -0
  203. package/src/bmm/workflows/1-analysis/research/domain-steps/step-05-technical-trends.md +234 -0
  204. package/src/bmm/workflows/1-analysis/research/domain-steps/step-06-research-synthesis.md +443 -0
  205. package/src/bmm/workflows/1-analysis/research/market-steps/step-01-init.md +182 -0
  206. package/src/bmm/workflows/1-analysis/research/market-steps/step-02-customer-behavior.md +237 -0
  207. package/src/bmm/workflows/1-analysis/research/market-steps/step-02-customer-insights.md +200 -0
  208. package/src/bmm/workflows/1-analysis/research/market-steps/step-03-customer-pain-points.md +249 -0
  209. package/src/bmm/workflows/1-analysis/research/market-steps/step-04-customer-decisions.md +259 -0
  210. package/src/bmm/workflows/1-analysis/research/market-steps/step-05-competitive-analysis.md +177 -0
  211. package/src/bmm/workflows/1-analysis/research/market-steps/step-06-research-completion.md +475 -0
  212. package/src/bmm/workflows/1-analysis/research/research.template.md +29 -0
  213. package/src/bmm/workflows/1-analysis/research/technical-steps/step-01-init.md +137 -0
  214. package/src/bmm/workflows/1-analysis/research/technical-steps/step-02-technical-overview.md +239 -0
  215. package/src/bmm/workflows/1-analysis/research/technical-steps/step-03-integration-patterns.md +248 -0
  216. package/src/bmm/workflows/1-analysis/research/technical-steps/step-04-architectural-patterns.md +202 -0
  217. package/src/bmm/workflows/1-analysis/research/technical-steps/step-05-implementation-research.md +239 -0
  218. package/src/bmm/workflows/1-analysis/research/technical-steps/step-06-research-synthesis.md +486 -0
  219. package/src/bmm/workflows/1-analysis/research/workflow.md +173 -0
  220. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-01-init.md +135 -0
  221. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-01b-continue.md +127 -0
  222. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-02-discovery.md +190 -0
  223. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-03-core-experience.md +216 -0
  224. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-04-emotional-response.md +219 -0
  225. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-05-inspiration.md +234 -0
  226. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-06-design-system.md +252 -0
  227. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-07-defining-experience.md +254 -0
  228. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-08-visual-foundation.md +224 -0
  229. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-09-design-directions.md +224 -0
  230. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-10-user-journeys.md +241 -0
  231. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-11-component-strategy.md +248 -0
  232. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-12-ux-patterns.md +237 -0
  233. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-13-responsive-accessibility.md +264 -0
  234. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-14-complete.md +228 -0
  235. package/src/bmm/workflows/2-plan-workflows/create-ux-design/ux-design-template.md +13 -0
  236. package/src/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md +43 -0
  237. package/src/bmm/workflows/2-plan-workflows/prd/data/domain-complexity.csv +13 -0
  238. package/src/bmm/workflows/2-plan-workflows/prd/data/prd-purpose.md +197 -0
  239. package/src/bmm/workflows/2-plan-workflows/prd/data/project-types.csv +11 -0
  240. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-01-init.md +191 -0
  241. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-01b-continue.md +153 -0
  242. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-02-discovery.md +224 -0
  243. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-03-success.md +226 -0
  244. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-04-journeys.md +213 -0
  245. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-05-domain.md +207 -0
  246. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-06-innovation.md +226 -0
  247. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-07-project-type.md +237 -0
  248. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-08-scoping.md +228 -0
  249. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-09-functional.md +231 -0
  250. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-10-nonfunctional.md +242 -0
  251. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-11-polish.md +217 -0
  252. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-12-complete.md +180 -0
  253. package/src/bmm/workflows/2-plan-workflows/prd/steps-e/step-e-01-discovery.md +247 -0
  254. package/src/bmm/workflows/2-plan-workflows/prd/steps-e/step-e-01b-legacy-conversion.md +208 -0
  255. package/src/bmm/workflows/2-plan-workflows/prd/steps-e/step-e-02-review.md +249 -0
  256. package/src/bmm/workflows/2-plan-workflows/prd/steps-e/step-e-03-edit.md +253 -0
  257. package/src/bmm/workflows/2-plan-workflows/prd/steps-e/step-e-04-complete.md +168 -0
  258. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-01-discovery.md +218 -0
  259. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-02-format-detection.md +191 -0
  260. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-02b-parity-check.md +209 -0
  261. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-03-density-validation.md +174 -0
  262. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-04-brief-coverage-validation.md +214 -0
  263. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-05-measurability-validation.md +228 -0
  264. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-06-traceability-validation.md +217 -0
  265. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-07-implementation-leakage-validation.md +205 -0
  266. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-08-domain-compliance-validation.md +243 -0
  267. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-09-project-type-validation.md +263 -0
  268. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-10-smart-validation.md +209 -0
  269. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-11-holistic-quality-validation.md +264 -0
  270. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-12-completeness-validation.md +242 -0
  271. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-13-report-complete.md +232 -0
  272. package/src/bmm/workflows/2-plan-workflows/prd/templates/prd-template.md +10 -0
  273. package/src/bmm/workflows/2-plan-workflows/prd/validation-report-prd-workflow.md +433 -0
  274. package/src/bmm/workflows/2-plan-workflows/prd/workflow.md +150 -0
  275. package/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-01-document-discovery.md +190 -0
  276. package/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-02-prd-analysis.md +178 -0
  277. package/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-03-epic-coverage-validation.md +179 -0
  278. package/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-04-ux-alignment.md +139 -0
  279. package/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-05-epic-quality-review.md +252 -0
  280. package/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-06-final-assessment.md +133 -0
  281. package/src/bmm/workflows/3-solutioning/check-implementation-readiness/templates/readiness-report-template.md +4 -0
  282. package/src/bmm/workflows/3-solutioning/check-implementation-readiness/workflow.md +55 -0
  283. package/src/bmm/workflows/3-solutioning/create-architecture/architecture-decision-template.md +12 -0
  284. package/src/bmm/workflows/3-solutioning/create-architecture/data/domain-complexity.csv +11 -0
  285. package/src/bmm/workflows/3-solutioning/create-architecture/data/project-types.csv +7 -0
  286. package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-01-init.md +153 -0
  287. package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-01b-continue.md +164 -0
  288. package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-02-context.md +224 -0
  289. package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-03-starter.md +331 -0
  290. package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-04-decisions.md +318 -0
  291. package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-05-patterns.md +359 -0
  292. package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-06-structure.md +379 -0
  293. package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-07-validation.md +359 -0
  294. package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-08-complete.md +352 -0
  295. package/src/bmm/workflows/3-solutioning/create-architecture/workflow.md +50 -0
  296. package/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-01-validate-prerequisites.md +259 -0
  297. package/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-02-design-epics.md +233 -0
  298. package/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-03-create-stories.md +272 -0
  299. package/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-04-final-validation.md +145 -0
  300. package/src/bmm/workflows/3-solutioning/create-epics-and-stories/templates/epics-template.md +57 -0
  301. package/src/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md +59 -0
  302. package/src/bmm/workflows/4-implementation/code-review/checklist.md +23 -0
  303. package/src/bmm/workflows/4-implementation/code-review/instructions.xml +227 -0
  304. package/src/bmm/workflows/4-implementation/code-review/workflow.yaml +51 -0
  305. package/src/bmm/workflows/4-implementation/correct-course/checklist.md +288 -0
  306. package/src/bmm/workflows/4-implementation/correct-course/instructions.md +206 -0
  307. package/src/bmm/workflows/4-implementation/correct-course/workflow.yaml +60 -0
  308. package/src/bmm/workflows/4-implementation/create-story/checklist.md +358 -0
  309. package/src/bmm/workflows/4-implementation/create-story/instructions.xml +345 -0
  310. package/src/bmm/workflows/4-implementation/create-story/template.md +49 -0
  311. package/src/bmm/workflows/4-implementation/create-story/workflow.yaml +61 -0
  312. package/src/bmm/workflows/4-implementation/dev-story/checklist.md +80 -0
  313. package/src/bmm/workflows/4-implementation/dev-story/instructions.xml +410 -0
  314. package/src/bmm/workflows/4-implementation/dev-story/workflow.yaml +27 -0
  315. package/src/bmm/workflows/4-implementation/retrospective/instructions.md +1443 -0
  316. package/src/bmm/workflows/4-implementation/retrospective/workflow.yaml +58 -0
  317. package/src/bmm/workflows/4-implementation/sprint-planning/checklist.md +33 -0
  318. package/src/bmm/workflows/4-implementation/sprint-planning/instructions.md +225 -0
  319. package/src/bmm/workflows/4-implementation/sprint-planning/sprint-status-template.yaml +55 -0
  320. package/src/bmm/workflows/4-implementation/sprint-planning/workflow.yaml +54 -0
  321. package/src/bmm/workflows/4-implementation/sprint-status/instructions.md +229 -0
  322. package/src/bmm/workflows/4-implementation/sprint-status/workflow.yaml +36 -0
  323. package/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-01-mode-detection.md +156 -0
  324. package/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-02-context-gathering.md +120 -0
  325. package/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-03-execute.md +113 -0
  326. package/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-04-self-check.md +113 -0
  327. package/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-05-adversarial-review.md +106 -0
  328. package/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-06-resolve-findings.md +140 -0
  329. package/src/bmm/workflows/bmad-quick-flow/quick-dev/workflow.md +52 -0
  330. package/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-01-understand.md +189 -0
  331. package/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-02-investigate.md +144 -0
  332. package/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-03-generate.md +128 -0
  333. package/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-04-review.md +191 -0
  334. package/src/bmm/workflows/bmad-quick-flow/quick-spec/tech-spec-template.md +74 -0
  335. package/src/bmm/workflows/bmad-quick-flow/quick-spec/workflow.md +79 -0
  336. package/src/bmm/workflows/document-project/checklist.md +245 -0
  337. package/src/bmm/workflows/document-project/documentation-requirements.csv +12 -0
  338. package/src/bmm/workflows/document-project/instructions.md +221 -0
  339. package/src/bmm/workflows/document-project/templates/deep-dive-template.md +345 -0
  340. package/src/bmm/workflows/document-project/templates/index-template.md +169 -0
  341. package/src/bmm/workflows/document-project/templates/project-overview-template.md +103 -0
  342. package/src/bmm/workflows/document-project/templates/project-scan-report-schema.json +160 -0
  343. package/src/bmm/workflows/document-project/templates/source-tree-template.md +135 -0
  344. package/src/bmm/workflows/document-project/workflow.yaml +30 -0
  345. package/src/bmm/workflows/document-project/workflows/deep-dive-instructions.md +298 -0
  346. package/src/bmm/workflows/document-project/workflows/deep-dive.yaml +31 -0
  347. package/src/bmm/workflows/document-project/workflows/full-scan-instructions.md +1106 -0
  348. package/src/bmm/workflows/document-project/workflows/full-scan.yaml +31 -0
  349. package/src/bmm/workflows/excalidraw-diagrams/_shared/excalidraw-library.json +90 -0
  350. package/src/bmm/workflows/excalidraw-diagrams/_shared/excalidraw-templates.yaml +127 -0
  351. package/src/bmm/workflows/excalidraw-diagrams/create-dataflow/checklist.md +39 -0
  352. package/src/bmm/workflows/excalidraw-diagrams/create-dataflow/instructions.md +130 -0
  353. package/src/bmm/workflows/excalidraw-diagrams/create-dataflow/workflow.yaml +27 -0
  354. package/src/bmm/workflows/excalidraw-diagrams/create-diagram/checklist.md +43 -0
  355. package/src/bmm/workflows/excalidraw-diagrams/create-diagram/instructions.md +141 -0
  356. package/src/bmm/workflows/excalidraw-diagrams/create-diagram/workflow.yaml +27 -0
  357. package/src/bmm/workflows/excalidraw-diagrams/create-flowchart/checklist.md +49 -0
  358. package/src/bmm/workflows/excalidraw-diagrams/create-flowchart/instructions.md +241 -0
  359. package/src/bmm/workflows/excalidraw-diagrams/create-flowchart/workflow.yaml +27 -0
  360. package/src/bmm/workflows/excalidraw-diagrams/create-wireframe/checklist.md +38 -0
  361. package/src/bmm/workflows/excalidraw-diagrams/create-wireframe/instructions.md +133 -0
  362. package/src/bmm/workflows/excalidraw-diagrams/create-wireframe/workflow.yaml +27 -0
  363. package/src/bmm/workflows/generate-project-context/project-context-template.md +21 -0
  364. package/src/bmm/workflows/generate-project-context/steps/step-01-discover.md +184 -0
  365. package/src/bmm/workflows/generate-project-context/steps/step-02-generate.md +318 -0
  366. package/src/bmm/workflows/generate-project-context/steps/step-03-complete.md +278 -0
  367. package/src/bmm/workflows/generate-project-context/workflow.md +49 -0
  368. package/src/bmm/workflows/testarch/atdd/atdd-checklist-template.md +364 -0
  369. package/src/bmm/workflows/testarch/atdd/checklist.md +374 -0
  370. package/src/bmm/workflows/testarch/atdd/instructions.md +806 -0
  371. package/src/bmm/workflows/testarch/atdd/workflow.yaml +47 -0
  372. package/src/bmm/workflows/testarch/automate/checklist.md +582 -0
  373. package/src/bmm/workflows/testarch/automate/instructions.md +1324 -0
  374. package/src/bmm/workflows/testarch/automate/workflow.yaml +54 -0
  375. package/src/bmm/workflows/testarch/ci/checklist.md +248 -0
  376. package/src/bmm/workflows/testarch/ci/github-actions-template.yaml +198 -0
  377. package/src/bmm/workflows/testarch/ci/gitlab-ci-template.yaml +149 -0
  378. package/src/bmm/workflows/testarch/ci/instructions.md +536 -0
  379. package/src/bmm/workflows/testarch/ci/workflow.yaml +47 -0
  380. package/src/bmm/workflows/testarch/framework/checklist.md +321 -0
  381. package/src/bmm/workflows/testarch/framework/instructions.md +481 -0
  382. package/src/bmm/workflows/testarch/framework/workflow.yaml +49 -0
  383. package/src/bmm/workflows/testarch/nfr-assess/checklist.md +407 -0
  384. package/src/bmm/workflows/testarch/nfr-assess/instructions.md +722 -0
  385. package/src/bmm/workflows/testarch/nfr-assess/nfr-report-template.md +445 -0
  386. package/src/bmm/workflows/testarch/nfr-assess/workflow.yaml +49 -0
  387. package/src/bmm/workflows/testarch/test-design/checklist.md +235 -0
  388. package/src/bmm/workflows/testarch/test-design/instructions.md +788 -0
  389. package/src/bmm/workflows/testarch/test-design/test-design-template.md +294 -0
  390. package/src/bmm/workflows/testarch/test-design/workflow.yaml +56 -0
  391. package/src/bmm/workflows/testarch/test-review/checklist.md +472 -0
  392. package/src/bmm/workflows/testarch/test-review/instructions.md +628 -0
  393. package/src/bmm/workflows/testarch/test-review/test-review-template.md +390 -0
  394. package/src/bmm/workflows/testarch/test-review/workflow.yaml +48 -0
  395. package/src/bmm/workflows/testarch/trace/checklist.md +655 -0
  396. package/src/bmm/workflows/testarch/trace/instructions.md +1047 -0
  397. package/src/bmm/workflows/testarch/trace/trace-template.md +675 -0
  398. package/src/bmm/workflows/testarch/trace/workflow.yaml +57 -0
  399. package/src/bmm/workflows/workflow-status/init/instructions.md +346 -0
  400. package/src/bmm/workflows/workflow-status/init/workflow.yaml +30 -0
  401. package/src/bmm/workflows/workflow-status/instructions.md +397 -0
  402. package/src/bmm/workflows/workflow-status/paths/enterprise-brownfield.yaml +103 -0
  403. package/src/bmm/workflows/workflow-status/paths/enterprise-greenfield.yaml +100 -0
  404. package/src/bmm/workflows/workflow-status/paths/method-brownfield.yaml +103 -0
  405. package/src/bmm/workflows/workflow-status/paths/method-greenfield.yaml +100 -0
  406. package/src/bmm/workflows/workflow-status/project-levels.yaml +59 -0
  407. package/src/bmm/workflows/workflow-status/workflow-status-template.yaml +24 -0
  408. package/src/bmm/workflows/workflow-status/workflow.yaml +32 -0
  409. package/src/core/_module-installer/installer.js +60 -0
  410. package/src/core/agents/bmad-master.agent.yaml +30 -0
  411. package/src/core/lib/scope/artifact-resolver.js +298 -0
  412. package/src/core/lib/scope/event-logger.js +411 -0
  413. package/src/core/lib/scope/index.js +30 -0
  414. package/src/core/lib/scope/scope-context.js +307 -0
  415. package/src/core/lib/scope/scope-initializer.js +458 -0
  416. package/src/core/lib/scope/scope-manager.js +512 -0
  417. package/src/core/lib/scope/scope-migrator.js +442 -0
  418. package/src/core/lib/scope/scope-sync.js +489 -0
  419. package/src/core/lib/scope/scope-validator.js +299 -0
  420. package/src/core/lib/scope/state-lock.js +342 -0
  421. package/src/core/module.yaml +53 -0
  422. package/src/core/resources/excalidraw/README.md +160 -0
  423. package/src/core/resources/excalidraw/excalidraw-helpers.md +127 -0
  424. package/src/core/resources/excalidraw/library-loader.md +50 -0
  425. package/src/core/resources/excalidraw/validate-json-instructions.md +79 -0
  426. package/src/core/tasks/editorial-review-prose.xml +91 -0
  427. package/src/core/tasks/editorial-review-structure.xml +198 -0
  428. package/src/core/tasks/index-docs.xml +65 -0
  429. package/src/core/tasks/review-adversarial-general.xml +46 -0
  430. package/src/core/tasks/shard-doc.xml +109 -0
  431. package/src/core/tasks/workflow.xml +277 -0
  432. package/src/core/workflows/advanced-elicitation/methods.csv +51 -0
  433. package/src/core/workflows/advanced-elicitation/workflow.xml +117 -0
  434. package/src/core/workflows/brainstorming/brain-methods.csv +62 -0
  435. package/src/core/workflows/brainstorming/steps/step-01-session-setup.md +197 -0
  436. package/src/core/workflows/brainstorming/steps/step-01b-continue.md +122 -0
  437. package/src/core/workflows/brainstorming/steps/step-02a-user-selected.md +225 -0
  438. package/src/core/workflows/brainstorming/steps/step-02b-ai-recommended.md +237 -0
  439. package/src/core/workflows/brainstorming/steps/step-02c-random-selection.md +209 -0
  440. package/src/core/workflows/brainstorming/steps/step-02d-progressive-flow.md +264 -0
  441. package/src/core/workflows/brainstorming/steps/step-03-technique-execution.md +399 -0
  442. package/src/core/workflows/brainstorming/steps/step-04-idea-organization.md +303 -0
  443. package/src/core/workflows/brainstorming/template.md +15 -0
  444. package/src/core/workflows/brainstorming/workflow.md +58 -0
  445. package/src/core/workflows/party-mode/steps/step-01-agent-loading.md +138 -0
  446. package/src/core/workflows/party-mode/steps/step-02-discussion-orchestration.md +187 -0
  447. package/src/core/workflows/party-mode/steps/step-03-graceful-exit.md +157 -0
  448. package/src/core/workflows/party-mode/workflow.md +194 -0
  449. package/src/utility/agent-components/activation-rules.txt +6 -0
  450. package/src/utility/agent-components/activation-steps.txt +28 -0
  451. package/src/utility/agent-components/agent-command-header.md +1 -0
  452. package/src/utility/agent-components/agent.customize.template.yaml +41 -0
  453. package/src/utility/agent-components/handler-action.txt +4 -0
  454. package/src/utility/agent-components/handler-data.txt +5 -0
  455. package/src/utility/agent-components/handler-exec.txt +19 -0
  456. package/src/utility/agent-components/handler-multi.txt +14 -0
  457. package/src/utility/agent-components/handler-tmpl.txt +5 -0
  458. package/src/utility/agent-components/handler-validate-workflow.txt +7 -0
  459. package/src/utility/agent-components/handler-workflow.txt +10 -0
  460. package/src/utility/agent-components/menu-handlers.txt +6 -0
  461. package/test/README.md +295 -0
  462. package/test/fixtures/agent-schema/invalid/critical-actions/actions-as-string.agent.yaml +27 -0
  463. package/test/fixtures/agent-schema/invalid/critical-actions/empty-string-in-actions.agent.yaml +30 -0
  464. package/test/fixtures/agent-schema/invalid/menu/empty-menu.agent.yaml +22 -0
  465. package/test/fixtures/agent-schema/invalid/menu/missing-menu.agent.yaml +20 -0
  466. package/test/fixtures/agent-schema/invalid/menu-commands/empty-command-target.agent.yaml +25 -0
  467. package/test/fixtures/agent-schema/invalid/menu-commands/no-command-target.agent.yaml +24 -0
  468. package/test/fixtures/agent-schema/invalid/menu-triggers/camel-case.agent.yaml +25 -0
  469. package/test/fixtures/agent-schema/invalid/menu-triggers/compound-invalid-format.agent.yaml +25 -0
  470. package/test/fixtures/agent-schema/invalid/menu-triggers/compound-mismatched-kebab.agent.yaml +25 -0
  471. package/test/fixtures/agent-schema/invalid/menu-triggers/duplicate-triggers.agent.yaml +31 -0
  472. package/test/fixtures/agent-schema/invalid/menu-triggers/empty-trigger.agent.yaml +25 -0
  473. package/test/fixtures/agent-schema/invalid/menu-triggers/leading-asterisk.agent.yaml +25 -0
  474. package/test/fixtures/agent-schema/invalid/menu-triggers/snake-case.agent.yaml +25 -0
  475. package/test/fixtures/agent-schema/invalid/menu-triggers/trigger-with-spaces.agent.yaml +25 -0
  476. package/test/fixtures/agent-schema/invalid/metadata/empty-module-string.agent.yaml +26 -0
  477. package/test/fixtures/agent-schema/invalid/metadata/empty-name.agent.yaml +24 -0
  478. package/test/fixtures/agent-schema/invalid/metadata/extra-metadata-fields.agent.yaml +27 -0
  479. package/test/fixtures/agent-schema/invalid/metadata/missing-id.agent.yaml +23 -0
  480. package/test/fixtures/agent-schema/invalid/persona/empty-principles-array.agent.yaml +24 -0
  481. package/test/fixtures/agent-schema/invalid/persona/empty-string-in-principles.agent.yaml +27 -0
  482. package/test/fixtures/agent-schema/invalid/persona/extra-persona-fields.agent.yaml +27 -0
  483. package/test/fixtures/agent-schema/invalid/persona/missing-role.agent.yaml +24 -0
  484. package/test/fixtures/agent-schema/invalid/prompts/empty-content.agent.yaml +29 -0
  485. package/test/fixtures/agent-schema/invalid/prompts/extra-prompt-fields.agent.yaml +31 -0
  486. package/test/fixtures/agent-schema/invalid/prompts/missing-content.agent.yaml +28 -0
  487. package/test/fixtures/agent-schema/invalid/prompts/missing-id.agent.yaml +28 -0
  488. package/test/fixtures/agent-schema/invalid/top-level/empty-file.agent.yaml +5 -0
  489. package/test/fixtures/agent-schema/invalid/top-level/extra-top-level-keys.agent.yaml +28 -0
  490. package/test/fixtures/agent-schema/invalid/top-level/missing-agent-key.agent.yaml +11 -0
  491. package/test/fixtures/agent-schema/invalid/yaml-errors/invalid-indentation.agent.yaml +19 -0
  492. package/test/fixtures/agent-schema/invalid/yaml-errors/malformed-yaml.agent.yaml +18 -0
  493. package/test/fixtures/agent-schema/valid/critical-actions/empty-critical-actions.agent.yaml +24 -0
  494. package/test/fixtures/agent-schema/valid/critical-actions/no-critical-actions.agent.yaml +22 -0
  495. package/test/fixtures/agent-schema/valid/critical-actions/valid-critical-actions.agent.yaml +27 -0
  496. package/test/fixtures/agent-schema/valid/menu/multiple-menu-items.agent.yaml +31 -0
  497. package/test/fixtures/agent-schema/valid/menu/single-menu-item.agent.yaml +22 -0
  498. package/test/fixtures/agent-schema/valid/menu-commands/all-command-types.agent.yaml +38 -0
  499. package/test/fixtures/agent-schema/valid/menu-commands/multiple-commands.agent.yaml +24 -0
  500. package/test/fixtures/agent-schema/valid/menu-triggers/compound-triggers.agent.yaml +31 -0
  501. package/test/fixtures/agent-schema/valid/menu-triggers/kebab-case-triggers.agent.yaml +34 -0
  502. package/test/fixtures/agent-schema/valid/metadata/core-agent-with-module.agent.yaml +24 -0
  503. package/test/fixtures/agent-schema/valid/metadata/empty-module-name-in-path.agent.yaml +24 -0
  504. package/test/fixtures/agent-schema/valid/metadata/malformed-path-treated-as-core.agent.yaml +24 -0
  505. package/test/fixtures/agent-schema/valid/metadata/module-agent-correct.agent.yaml +24 -0
  506. package/test/fixtures/agent-schema/valid/metadata/module-agent-missing-module.agent.yaml +23 -0
  507. package/test/fixtures/agent-schema/valid/metadata/wrong-module-value.agent.yaml +24 -0
  508. package/test/fixtures/agent-schema/valid/persona/complete-persona.agent.yaml +24 -0
  509. package/test/fixtures/agent-schema/valid/prompts/empty-prompts.agent.yaml +24 -0
  510. package/test/fixtures/agent-schema/valid/prompts/no-prompts.agent.yaml +22 -0
  511. package/test/fixtures/agent-schema/valid/prompts/valid-prompts-minimal.agent.yaml +28 -0
  512. package/test/fixtures/agent-schema/valid/prompts/valid-prompts-with-description.agent.yaml +30 -0
  513. package/test/fixtures/agent-schema/valid/top-level/minimal-core-agent.agent.yaml +24 -0
  514. package/test/test-agent-schema.js +387 -0
  515. package/test/test-cli-integration.sh +159 -0
  516. package/test/test-installation-components.js +214 -0
  517. package/test/test-scope-e2e.js +450 -0
  518. package/test/test-scope-system.js +787 -0
  519. package/test/unit-test-schema.js +133 -0
  520. package/tools/bmad-npx-wrapper.js +38 -0
  521. package/tools/build-docs.js +577 -0
  522. package/tools/cli/README.md +7 -0
  523. package/tools/cli/bmad-cli.js +58 -0
  524. package/tools/cli/commands/install.js +87 -0
  525. package/tools/cli/commands/scope.js +474 -0
  526. package/tools/cli/external-official-modules.yaml +41 -0
  527. package/tools/cli/installers/install-messages.yaml +58 -0
  528. package/tools/cli/installers/lib/core/config-collector.js +1079 -0
  529. package/tools/cli/installers/lib/core/custom-module-cache.js +259 -0
  530. package/tools/cli/installers/lib/core/dependency-resolver.js +739 -0
  531. package/tools/cli/installers/lib/core/detector.js +223 -0
  532. package/tools/cli/installers/lib/core/ide-config-manager.js +156 -0
  533. package/tools/cli/installers/lib/core/installer.js +2585 -0
  534. package/tools/cli/installers/lib/core/manifest-generator.js +963 -0
  535. package/tools/cli/installers/lib/core/manifest.js +590 -0
  536. package/tools/cli/installers/lib/custom/handler.js +363 -0
  537. package/tools/cli/installers/lib/ide/_base-ide.js +654 -0
  538. package/tools/cli/installers/lib/ide/antigravity.js +486 -0
  539. package/tools/cli/installers/lib/ide/auggie.js +244 -0
  540. package/tools/cli/installers/lib/ide/claude-code.js +487 -0
  541. package/tools/cli/installers/lib/ide/cline.js +269 -0
  542. package/tools/cli/installers/lib/ide/codex.js +375 -0
  543. package/tools/cli/installers/lib/ide/crush.js +300 -0
  544. package/tools/cli/installers/lib/ide/cursor.js +169 -0
  545. package/tools/cli/installers/lib/ide/gemini.js +301 -0
  546. package/tools/cli/installers/lib/ide/github-copilot.js +383 -0
  547. package/tools/cli/installers/lib/ide/iflow.js +191 -0
  548. package/tools/cli/installers/lib/ide/kilo.js +250 -0
  549. package/tools/cli/installers/lib/ide/kiro-cli.js +326 -0
  550. package/tools/cli/installers/lib/ide/manager.js +244 -0
  551. package/tools/cli/installers/lib/ide/opencode.js +257 -0
  552. package/tools/cli/installers/lib/ide/qwen.js +372 -0
  553. package/tools/cli/installers/lib/ide/roo.js +270 -0
  554. package/tools/cli/installers/lib/ide/rovo-dev.js +290 -0
  555. package/tools/cli/installers/lib/ide/shared/agent-command-generator.js +96 -0
  556. package/tools/cli/installers/lib/ide/shared/bmad-artifacts.js +158 -0
  557. package/tools/cli/installers/lib/ide/shared/module-injections.js +136 -0
  558. package/tools/cli/installers/lib/ide/shared/task-tool-command-generator.js +119 -0
  559. package/tools/cli/installers/lib/ide/shared/workflow-command-generator.js +242 -0
  560. package/tools/cli/installers/lib/ide/templates/agent-command-template.md +29 -0
  561. package/tools/cli/installers/lib/ide/templates/gemini-agent-command.toml +14 -0
  562. package/tools/cli/installers/lib/ide/templates/gemini-task-command.toml +12 -0
  563. package/tools/cli/installers/lib/ide/templates/workflow-command-template.md +30 -0
  564. package/tools/cli/installers/lib/ide/templates/workflow-commander.md +45 -0
  565. package/tools/cli/installers/lib/ide/trae.js +313 -0
  566. package/tools/cli/installers/lib/ide/windsurf.js +258 -0
  567. package/tools/cli/installers/lib/message-loader.js +85 -0
  568. package/tools/cli/installers/lib/modules/external-manager.js +133 -0
  569. package/tools/cli/installers/lib/modules/manager.js +1362 -0
  570. package/tools/cli/lib/activation-builder.js +163 -0
  571. package/tools/cli/lib/agent/compiler.js +522 -0
  572. package/tools/cli/lib/agent/installer.js +716 -0
  573. package/tools/cli/lib/agent/template-engine.js +152 -0
  574. package/tools/cli/lib/agent-analyzer.js +109 -0
  575. package/tools/cli/lib/agent-party-generator.js +194 -0
  576. package/tools/cli/lib/cli-utils.js +227 -0
  577. package/tools/cli/lib/config.js +213 -0
  578. package/tools/cli/lib/file-ops.js +204 -0
  579. package/tools/cli/lib/platform-codes.js +116 -0
  580. package/tools/cli/lib/project-root.js +77 -0
  581. package/tools/cli/lib/prompts.js +433 -0
  582. package/tools/cli/lib/ui.js +1591 -0
  583. package/tools/cli/lib/xml-handler.js +177 -0
  584. package/tools/cli/lib/xml-to-markdown.js +82 -0
  585. package/tools/cli/lib/yaml-format.js +245 -0
  586. package/tools/cli/lib/yaml-xml-builder.js +587 -0
  587. package/tools/cli/scripts/migrate-workflows.js +281 -0
  588. package/tools/docs/BUNDLE_DISTRIBUTION_SETUP.md +95 -0
  589. package/tools/docs/index.md +2 -0
  590. package/tools/fix-doc-links.js +288 -0
  591. package/tools/flattener/aggregate.js +76 -0
  592. package/tools/flattener/binary.js +80 -0
  593. package/tools/flattener/discovery.js +71 -0
  594. package/tools/flattener/files.js +35 -0
  595. package/tools/flattener/ignoreRules.js +172 -0
  596. package/tools/flattener/main.js +483 -0
  597. package/tools/flattener/projectRoot.js +201 -0
  598. package/tools/flattener/prompts.js +44 -0
  599. package/tools/flattener/stats.helpers.js +368 -0
  600. package/tools/flattener/stats.js +75 -0
  601. package/tools/flattener/test-matrix.js +409 -0
  602. package/tools/flattener/xml.js +82 -0
  603. package/tools/format-workflow-md.js +263 -0
  604. package/tools/lib/xml-utils.js +13 -0
  605. package/tools/maintainer/review-pr-README.md +55 -0
  606. package/tools/maintainer/review-pr.md +242 -0
  607. package/tools/migrate-custom-module-paths.js +124 -0
  608. package/tools/platform-codes.yaml +157 -0
  609. package/tools/schema/agent.js +493 -0
  610. package/tools/validate-agent-schema.js +110 -0
  611. package/tools/validate-doc-links.js +363 -0
  612. package/tools/validate-svg-changes.sh +356 -0
  613. package/website/README.md +76 -0
  614. package/website/astro.config.mjs +228 -0
  615. package/website/public/favicon.ico +0 -0
  616. package/website/public/img/bmad-dark.png +0 -0
  617. package/website/public/img/bmad-light.png +0 -0
  618. package/website/public/img/logo.svg +4 -0
  619. package/website/public/robots.txt +37 -0
  620. package/website/src/components/Banner.astro +59 -0
  621. package/website/src/components/Header.astro +121 -0
  622. package/website/src/components/MobileMenuFooter.astro +53 -0
  623. package/website/src/content/config.ts +6 -0
  624. package/website/src/lib/site-url.js +25 -0
  625. package/website/src/rehype-markdown-links.js +102 -0
  626. package/website/src/styles/custom.css +485 -0
@@ -0,0 +1,226 @@
1
+ ---
2
+ name: 'step-06-innovation'
3
+ description: 'Detect and explore innovative aspects of the product (optional step)'
4
+
5
+ # File References
6
+ nextStepFile: './step-07-project-type.md'
7
+ outputFile: '{planning_artifacts}/prd.md'
8
+
9
+ # Data Files
10
+ projectTypesCSV: '../data/project-types.csv'
11
+
12
+ # Task References
13
+ advancedElicitationTask: '{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml'
14
+ partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
15
+ ---
16
+
17
+ # Step 6: Innovation Discovery
18
+
19
+ **Progress: Step 6 of 11** - Next: Project Type Analysis
20
+
21
+ ## MANDATORY EXECUTION RULES (READ FIRST):
22
+
23
+ - 🛑 NEVER generate content without user input
24
+
25
+ - 📖 CRITICAL: ALWAYS read the complete step file before taking any action - partial understanding leads to incomplete decisions
26
+ - 🔄 CRITICAL: When loading next step with 'C', ensure the entire file is read and understood before proceeding
27
+ - ✅ ALWAYS treat this as collaborative discovery between PM peers
28
+ - 📋 YOU ARE A FACILITATOR, not a content generator
29
+ - 💬 FOCUS on detecting and exploring innovative aspects of the product
30
+ - 🎯 OPTIONAL STEP: Only proceed if innovation signals are detected
31
+ - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
32
+
33
+ ## EXECUTION PROTOCOLS:
34
+
35
+ - 🎯 Show your analysis before taking any action
36
+ - ⚠️ Present A/P/C menu after generating innovation content
37
+ - 💾 ONLY save when user chooses C (Continue)
38
+ - 📖 Update output file frontmatter, adding this step name to the end of the list of stepsCompleted
39
+ - 🚫 FORBIDDEN to load next step until C is selected
40
+
41
+ ## CONTEXT BOUNDARIES:
42
+
43
+ - Current document and frontmatter from previous steps are available
44
+ - Project type from step-02 is available for innovation signal matching
45
+ - Project-type CSV data will be loaded in this step
46
+ - Focus on detecting genuine innovation, not forced creativity
47
+
48
+ ## OPTIONAL STEP CHECK:
49
+
50
+ Before proceeding with this step, scan for innovation signals:
51
+
52
+ - Listen for language like "nothing like this exists", "rethinking how X works"
53
+ - Check for project-type innovation signals from CSV
54
+ - Look for novel approaches or unique combinations
55
+ - If no innovation detected, skip this step
56
+
57
+ ## YOUR TASK:
58
+
59
+ Detect and explore innovation patterns in the product, focusing on what makes it truly novel and how to validate the innovative aspects.
60
+
61
+ ## INNOVATION DISCOVERY SEQUENCE:
62
+
63
+ ### 1. Load Project-Type Innovation Data
64
+
65
+ Load innovation signals specific to this project type:
66
+
67
+ - Load `{projectTypesCSV}` completely
68
+ - Find the row where `project_type` matches detected type from step-02
69
+ - Extract `innovation_signals` (semicolon-separated list)
70
+ - Extract `web_search_triggers` for potential innovation research
71
+
72
+ ### 2. Listen for Innovation Indicators
73
+
74
+ Monitor conversation for both general and project-type-specific innovation signals:
75
+
76
+ #### General Innovation Language:
77
+
78
+ - "Nothing like this exists"
79
+ - "We're rethinking how [X] works"
80
+ - "Combining [A] with [B] for the first time"
81
+ - "Novel approach to [problem]"
82
+ - "No one has done [concept] before"
83
+
84
+ #### Project-Type-Specific Signals (from CSV):
85
+
86
+ Match user descriptions against innovation_signals for their project_type:
87
+
88
+ - **api_backend**: "API composition;New protocol"
89
+ - **mobile_app**: "Gesture innovation;AR/VR features"
90
+ - **saas_b2b**: "Workflow automation;AI agents"
91
+ - **developer_tool**: "New paradigm;DSL creation"
92
+
93
+ ### 3. Initial Innovation Screening
94
+
95
+ Ask targeted innovation discovery questions:
96
+ - Guide exploration of what makes the product innovative
97
+ - Explore if they're challenging existing assumptions
98
+ - Ask about novel combinations of technologies/approaches
99
+ - Identify what hasn't been done before
100
+ - Understand which aspects feel most innovative
101
+
102
+ ### 4. Deep Innovation Exploration (If Detected)
103
+
104
+ If innovation signals are found, explore deeply:
105
+
106
+ #### Innovation Discovery Questions:
107
+ - What makes it unique compared to existing solutions?
108
+ - What assumption are you challenging?
109
+ - How do we validate it works?
110
+ - What's the fallback if it doesn't?
111
+ - Has anyone tried this before?
112
+
113
+ #### Market Context Research:
114
+
115
+ If relevant innovation detected, consider web search for context:
116
+ Use `web_search_triggers` from project-type CSV:
117
+ `[web_search_triggers] {concept} innovations {date}`
118
+
119
+ ### 5. Generate Innovation Content (If Innovation Detected)
120
+
121
+ Prepare the content to append to the document:
122
+
123
+ #### Content Structure:
124
+
125
+ When saving to document, append these Level 2 and Level 3 sections:
126
+
127
+ ```markdown
128
+ ## Innovation & Novel Patterns
129
+
130
+ ### Detected Innovation Areas
131
+
132
+ [Innovation patterns identified based on conversation]
133
+
134
+ ### Market Context & Competitive Landscape
135
+
136
+ [Market context and research based on conversation]
137
+
138
+ ### Validation Approach
139
+
140
+ [Validation methodology based on conversation]
141
+
142
+ ### Risk Mitigation
143
+
144
+ [Innovation risks and fallbacks based on conversation]
145
+ ```
146
+
147
+ ### 6. Present MENU OPTIONS (Only if Innovation Detected)
148
+
149
+ Present the innovation content for review, then display menu:
150
+ - Show identified innovative aspects (using structure from section 5)
151
+ - Highlight differentiation from existing solutions
152
+ - Ask if they'd like to refine further, get other perspectives, or proceed
153
+ - Present menu options naturally as part of conversation
154
+
155
+ Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Project Type Analysis (Step 7 of 11)"
156
+
157
+ #### Menu Handling Logic:
158
+ - IF A: Execute {advancedElicitationTask} with the current innovation content, process the enhanced innovation insights that come back, ask user "Accept these improvements to the innovation analysis? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
159
+ - IF P: Execute {partyModeWorkflow} with the current innovation content, process the collaborative innovation exploration and ideation, ask user "Accept these changes to the innovation analysis? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
160
+ - IF C: Append the final content to {outputFile}, update frontmatter by adding this step name to the end of the stepsCompleted array, then load, read entire file, then execute {nextStepFile}
161
+ - IF Any other: help user respond, then redisplay menu
162
+
163
+ #### EXECUTION RULES:
164
+ - ALWAYS halt and wait for user input after presenting menu
165
+ - ONLY proceed to next step when user selects 'C'
166
+ - After other menu items execution, return to this menu
167
+
168
+ ## NO INNOVATION DETECTED:
169
+
170
+ If no genuine innovation signals are found after exploration:
171
+ - Acknowledge that no clear innovation signals were found
172
+ - Note this is fine - many successful products are excellent executions of existing concepts
173
+ - Ask if they'd like to try finding innovative angles or proceed
174
+
175
+ Display: "**Select:** [A] Advanced Elicitation - Let's try to find innovative angles [C] Continue - Skip innovation section and move to Project Type Analysis (Step 7 of 11)"
176
+
177
+ ### Menu Handling Logic:
178
+ - IF A: Proceed with content generation anyway, then return to menu
179
+ - IF C: Skip this step, then load, read entire file, then execute {nextStepFile}
180
+
181
+ ### EXECUTION RULES:
182
+ - ALWAYS halt and wait for user input after presenting menu
183
+ - ONLY proceed to next step when user selects 'C'
184
+
185
+ ## APPEND TO DOCUMENT:
186
+
187
+ When user selects 'C', append the content directly to the document using the structure from step 5.
188
+
189
+ ## SUCCESS METRICS:
190
+
191
+ ✅ Innovation signals properly detected from user conversation
192
+ ✅ Project-type innovation signals used to guide discovery
193
+ ✅ Genuine innovation explored (not forced creativity)
194
+ ✅ Validation approach clearly defined for innovative aspects
195
+ ✅ Risk mitigation strategies identified
196
+ ✅ A/P/C menu presented and handled correctly
197
+ ✅ Content properly appended to document when C selected
198
+
199
+ ## FAILURE MODES:
200
+
201
+ ❌ Forced innovation when none genuinely exists
202
+ ❌ Not using project-type innovation signals from CSV
203
+ ❌ Missing market context research for novel concepts
204
+ ❌ Not addressing validation approach for innovative features
205
+ ❌ Creating innovation theater without real innovative aspects
206
+ ❌ Not presenting A/P/C menu after content generation
207
+ ❌ Appending content without user selecting 'C'
208
+
209
+ ❌ **CRITICAL**: Reading only partial step file - leads to incomplete understanding and poor decisions
210
+ ❌ **CRITICAL**: Proceeding with 'C' without fully reading and understanding the next step file
211
+ ❌ **CRITICAL**: Making decisions without complete understanding of step requirements and protocols
212
+
213
+ ## SKIP CONDITIONS:
214
+
215
+ Skip this step and load `{nextStepFile}` if:
216
+
217
+ - No innovation signals detected in conversation
218
+ - Product is incremental improvement rather than breakthrough
219
+ - User confirms innovation exploration is not needed
220
+ - Project-type CSV has no innovation signals for this type
221
+
222
+ ## NEXT STEP:
223
+
224
+ After user selects 'C' and content is saved to document (or step is skipped), load `{nextStepFile}`.
225
+
226
+ Remember: Do NOT proceed to step-07 until user explicitly selects 'C' from the A/P/C menu (or confirms step skip)!
@@ -0,0 +1,237 @@
1
+ ---
2
+ name: 'step-07-project-type'
3
+ description: 'Conduct project-type specific discovery using CSV-driven guidance'
4
+
5
+ # File References
6
+ nextStepFile: './step-08-scoping.md'
7
+ outputFile: '{planning_artifacts}/prd.md'
8
+
9
+ # Data Files
10
+ projectTypesCSV: '../data/project-types.csv'
11
+
12
+ # Task References
13
+ advancedElicitationTask: '{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml'
14
+ partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
15
+ ---
16
+
17
+ # Step 7: Project-Type Deep Dive
18
+
19
+ **Progress: Step 7 of 11** - Next: Scoping
20
+
21
+ ## MANDATORY EXECUTION RULES (READ FIRST):
22
+
23
+ - 🛑 NEVER generate content without user input
24
+
25
+ - 📖 CRITICAL: ALWAYS read the complete step file before taking any action - partial understanding leads to incomplete decisions
26
+ - 🔄 CRITICAL: When loading next step with 'C', ensure the entire file is read and understood before proceeding
27
+ - ✅ ALWAYS treat this as collaborative discovery between PM peers
28
+ - 📋 YOU ARE A FACILITATOR, not a content generator
29
+ - 💬 FOCUS on project-type specific requirements and technical considerations
30
+ - 🎯 DATA-DRIVEN: Use CSV configuration to guide discovery
31
+ - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
32
+
33
+ ## EXECUTION PROTOCOLS:
34
+
35
+ - 🎯 Show your analysis before taking any action
36
+ - ⚠️ Present A/P/C menu after generating project-type content
37
+ - 💾 ONLY save when user chooses C (Continue)
38
+ - 📖 Update output file frontmatter, adding this step name to the end of the list of stepsCompleted
39
+ - 🚫 FORBIDDEN to load next step until C is selected
40
+
41
+ ## CONTEXT BOUNDARIES:
42
+
43
+ - Current document and frontmatter from previous steps are available
44
+ - Project type from step-02 is available for configuration loading
45
+ - Project-type CSV data will be loaded in this step
46
+ - Focus on technical and functional requirements specific to this project type
47
+
48
+ ## YOUR TASK:
49
+
50
+ Conduct project-type specific discovery using CSV-driven guidance to define technical requirements.
51
+
52
+ ## PROJECT-TYPE DISCOVERY SEQUENCE:
53
+
54
+ ### 1. Load Project-Type Configuration Data
55
+
56
+ **Attempt subprocess data lookup:**
57
+
58
+ "Your task: Lookup data in {projectTypesCSV}
59
+
60
+ **Search criteria:**
61
+ - Find row where project_type matches {{projectTypeFromStep02}}
62
+
63
+ **Return format:**
64
+ Return ONLY the matching row as a YAML-formatted object with these fields:
65
+ project_type, key_questions, required_sections, skip_sections, innovation_signals
66
+
67
+ **Do NOT return the entire CSV - only the matching row.**"
68
+
69
+ **Graceful degradation (if Task tool unavailable):**
70
+ - Load the CSV file directly
71
+ - Find the matching row manually
72
+ - Extract required fields:
73
+ - `key_questions` (semicolon-separated list of discovery questions)
74
+ - `required_sections` (semicolon-separated list of sections to document)
75
+ - `skip_sections` (semicolon-separated list of sections to skip)
76
+ - `innovation_signals` (already explored in step-6)
77
+
78
+ ### 2. Conduct Guided Discovery Using Key Questions
79
+
80
+ Parse `key_questions` from CSV and explore each:
81
+
82
+ #### Question-Based Discovery:
83
+
84
+ For each question in `key_questions` from CSV:
85
+
86
+ - Ask the user naturally in conversational style
87
+ - Listen for their response and ask clarifying follow-ups
88
+ - Connect answers to product value proposition
89
+
90
+ **Example Flow:**
91
+ If key_questions = "Endpoints needed?;Authentication method?;Data formats?;Rate limits?;Versioning?;SDK needed?"
92
+
93
+ Ask naturally:
94
+
95
+ - "What are the main endpoints your API needs to expose?"
96
+ - "How will you handle authentication and authorization?"
97
+ - "What data formats will you support for requests and responses?"
98
+
99
+ ### 3. Document Project-Type Specific Requirements
100
+
101
+ Based on user answers to key_questions, synthesize comprehensive requirements:
102
+
103
+ #### Requirement Categories:
104
+
105
+ Cover the areas indicated by `required_sections` from CSV:
106
+
107
+ - Synthesize what was discovered for each required section
108
+ - Document specific requirements, constraints, and decisions
109
+ - Connect to product differentiator when relevant
110
+
111
+ #### Skip Irrelevant Sections:
112
+
113
+ Skip areas indicated by `skip_sections` from CSV to avoid wasting time on irrelevant aspects.
114
+
115
+ ### 4. Generate Dynamic Content Sections
116
+
117
+ Parse `required_sections` list from the matched CSV row. For each section name, generate corresponding content:
118
+
119
+ #### Common CSV Section Mappings:
120
+
121
+ - "endpoint_specs" or "endpoint_specification" → API endpoints documentation
122
+ - "auth_model" or "authentication_model" → Authentication approach
123
+ - "platform_reqs" or "platform_requirements" → Platform support needs
124
+ - "device_permissions" or "device_features" → Device capabilities
125
+ - "tenant_model" → Multi-tenancy approach
126
+ - "rbac_matrix" or "permission_matrix" → Permission structure
127
+
128
+ #### Template Variable Strategy:
129
+
130
+ - For sections matching common template variables: generate specific content
131
+ - For sections without template matches: include in main project_type_requirements
132
+ - Hybrid approach balances template structure with CSV-driven flexibility
133
+
134
+ ### 5. Generate Project-Type Content
135
+
136
+ Prepare the content to append to the document:
137
+
138
+ #### Content Structure:
139
+
140
+ When saving to document, append these Level 2 and Level 3 sections:
141
+
142
+ ```markdown
143
+ ## [Project Type] Specific Requirements
144
+
145
+ ### Project-Type Overview
146
+
147
+ [Project type summary based on conversation]
148
+
149
+ ### Technical Architecture Considerations
150
+
151
+ [Technical architecture requirements based on conversation]
152
+
153
+ [Dynamic sections based on CSV and conversation]
154
+
155
+ ### Implementation Considerations
156
+
157
+ [Implementation specific requirements based on conversation]
158
+ ```
159
+
160
+ ### 6. Present MENU OPTIONS
161
+
162
+ Present the project-type content for review, then display menu:
163
+
164
+ "Based on our conversation and best practices for this product type, I've documented the {project_type}-specific requirements for {{project_name}}.
165
+
166
+ **Here's what I'll add to the document:**
167
+
168
+ [Show the complete markdown content from section 5]
169
+
170
+ **What would you like to do?**"
171
+
172
+ Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Scoping (Step 8 of 11)"
173
+
174
+ #### Menu Handling Logic:
175
+ - IF A: Execute {advancedElicitationTask} with the current project-type content, process the enhanced technical insights that come back, ask user "Accept these improvements to the technical requirements? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
176
+ - IF P: Execute {partyModeWorkflow} with the current project-type requirements, process the collaborative technical expertise and validation, ask user "Accept these changes to the technical requirements? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
177
+ - IF C: Append the final content to {outputFile}, update frontmatter by adding this step name to the end of the stepsCompleted array, then load, read entire file, then execute {nextStepFile}
178
+ - IF Any other: help user respond, then redisplay menu
179
+
180
+ #### EXECUTION RULES:
181
+ - ALWAYS halt and wait for user input after presenting menu
182
+ - ONLY proceed to next step when user selects 'C'
183
+ - After other menu items execution, return to this menu
184
+
185
+ ## APPEND TO DOCUMENT:
186
+
187
+ When user selects 'C', append the content directly to the document using the structure from previous steps.
188
+
189
+ ## SUCCESS METRICS:
190
+
191
+ ✅ Project-type configuration loaded and used effectively
192
+ ✅ All key questions from CSV explored with user input
193
+ ✅ Required sections generated per CSV configuration
194
+ ✅ Skip sections properly avoided to save time
195
+ ✅ Technical requirements connected to product value
196
+ ✅ A/P/C menu presented and handled correctly
197
+ ✅ Content properly appended to document when C selected
198
+
199
+ ## FAILURE MODES:
200
+
201
+ ❌ Not loading or using project-type CSV configuration
202
+ ❌ Missing key questions from CSV in discovery process
203
+ ❌ Not generating required sections per CSV configuration
204
+ ❌ Documenting sections that should be skipped per CSV
205
+ ❌ Creating generic content without project-type specificity
206
+ ❌ Not presenting A/P/C menu after content generation
207
+ ❌ Appending content without user selecting 'C'
208
+
209
+ ❌ **CRITICAL**: Reading only partial step file - leads to incomplete understanding and poor decisions
210
+ ❌ **CRITICAL**: Proceeding with 'C' without fully reading and understanding the next step file
211
+ ❌ **CRITICAL**: Making decisions without complete understanding of step requirements and protocols
212
+
213
+ ## PROJECT-TYPE EXAMPLES:
214
+
215
+ **For api_backend:**
216
+
217
+ - Focus on endpoints, authentication, data schemas, rate limiting
218
+ - Skip visual design and user journey sections
219
+ - Generate API specification documentation
220
+
221
+ **For mobile_app:**
222
+
223
+ - Focus on platform requirements, device permissions, offline mode
224
+ - Skip API endpoint documentation unless needed
225
+ - Generate mobile-specific technical requirements
226
+
227
+ **For saas_b2b:**
228
+
229
+ - Focus on multi-tenancy, permissions, integrations
230
+ - Skip mobile-first considerations unless relevant
231
+ - Generate enterprise-specific requirements
232
+
233
+ ## NEXT STEP:
234
+
235
+ After user selects 'C' and content is saved to document, load `{nextStepFile}` to define project scope.
236
+
237
+ Remember: Do NOT proceed to step-08 (Scoping) until user explicitly selects 'C' from the A/P/C menu and content is saved!
@@ -0,0 +1,228 @@
1
+ ---
2
+ name: 'step-08-scoping'
3
+ description: 'Define MVP boundaries and prioritize features across development phases'
4
+
5
+ # File References
6
+ nextStepFile: './step-09-functional.md'
7
+ outputFile: '{planning_artifacts}/prd.md'
8
+
9
+ # Task References
10
+ advancedElicitationTask: '{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml'
11
+ partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
12
+ ---
13
+
14
+ # Step 8: Scoping Exercise - MVP & Future Features
15
+
16
+ **Progress: Step 8 of 11** - Next: Functional Requirements
17
+
18
+ ## MANDATORY EXECUTION RULES (READ FIRST):
19
+
20
+ - 🛑 NEVER generate content without user input
21
+
22
+ - 📖 CRITICAL: ALWAYS read the complete step file before taking any action - partial understanding leads to incomplete decisions
23
+ - 🔄 CRITICAL: When loading next step with 'C', ensure the entire file is read and understood before proceeding
24
+ - ✅ ALWAYS treat this as collaborative discovery between PM peers
25
+ - 📋 YOU ARE A FACILITATOR, not a content generator
26
+ - 💬 FOCUS on strategic scope decisions that keep projects viable
27
+ - 🎯 EMPHASIZE lean MVP thinking while preserving long-term vision
28
+ - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
29
+
30
+ ## EXECUTION PROTOCOLS:
31
+
32
+ - 🎯 Show your analysis before taking any action
33
+ - 📚 Review the complete PRD document built so far
34
+ - ⚠️ Present A/P/C menu after generating scoping decisions
35
+ - 💾 ONLY save when user chooses C (Continue)
36
+ - 📖 Update output file frontmatter, adding this step name to the end of the list of stepsCompleted
37
+ - 🚫 FORBIDDEN to load next step until C is selected
38
+
39
+
40
+ ## CONTEXT BOUNDARIES:
41
+
42
+ - Complete PRD document built so far is available for review
43
+ - User journeys, success criteria, and domain requirements are documented
44
+ - Focus on strategic scope decisions, not feature details
45
+ - Balance between user value and implementation feasibility
46
+
47
+ ## YOUR TASK:
48
+
49
+ Conduct comprehensive scoping exercise to define MVP boundaries and prioritize features across development phases.
50
+
51
+ ## SCOPING SEQUENCE:
52
+
53
+ ### 1. Review Current PRD State
54
+
55
+ Analyze everything documented so far:
56
+ - Present synthesis of established vision, success criteria, journeys
57
+ - Assess domain and innovation focus
58
+ - Evaluate scope implications: simple MVP, medium, or complex project
59
+ - Ask if initial assessment feels right or if they see it differently
60
+
61
+ ### 2. Define MVP Strategy
62
+
63
+ Facilitate strategic MVP decisions:
64
+ - Explore MVP philosophy options: problem-solving, experience, platform, or revenue MVP
65
+ - Ask critical questions:
66
+ - What's the minimum that would make users say 'this is useful'?
67
+ - What would make investors/partners say 'this has potential'?
68
+ - What's the fastest path to validated learning?
69
+ - Guide toward appropriate MVP approach for their product
70
+
71
+ ### 3. Scoping Decision Framework
72
+
73
+ Use structured decision-making for scope:
74
+
75
+ **Must-Have Analysis:**
76
+ - Guide identification of absolute MVP necessities
77
+ - For each journey and success criterion, ask:
78
+ - Without this, does the product fail?
79
+ - Can this be manual initially?
80
+ - Is this a deal-breaker for early adopters?
81
+ - Analyze journeys for MVP essentials
82
+
83
+ **Nice-to-Have Analysis:**
84
+ - Identify what could be added later:
85
+ - Features that enhance but aren't essential
86
+ - User types that can be added later
87
+ - Advanced functionality that builds on MVP
88
+ - Ask what features could be added in versions 2, 3, etc.
89
+
90
+ ### 4. Progressive Feature Roadmap
91
+
92
+ Create phased development approach:
93
+ - Guide mapping of features across development phases
94
+ - Structure as Phase 1 (MVP), Phase 2 (Growth), Phase 3 (Vision)
95
+ - Ensure clear progression and dependencies
96
+
97
+ - Core user value delivery
98
+ - Essential user journeys
99
+ - Basic functionality that works reliably
100
+
101
+ **Phase 2: Growth**
102
+
103
+ - Additional user types
104
+ - Enhanced features
105
+ - Scale improvements
106
+
107
+ **Phase 3: Expansion**
108
+
109
+ - Advanced capabilities
110
+ - Platform features
111
+ - New markets or use cases
112
+
113
+ **Where does your current vision fit in this development sequence?**"
114
+
115
+ ### 5. Risk-Based Scoping
116
+
117
+ Identify and mitigate scoping risks:
118
+
119
+ **Technical Risks:**
120
+ "Looking at your innovation and domain requirements:
121
+
122
+ - What's the most technically challenging aspect?
123
+ - Could we simplify the initial implementation?
124
+ - What's the riskiest assumption about technology feasibility?"
125
+
126
+ **Market Risks:**
127
+
128
+ - What's the biggest market risk?
129
+ - How does the MVP address this?
130
+ - What learning do we need to de-risk this?"
131
+
132
+ **Resource Risks:**
133
+
134
+ - What if we have fewer resources than planned?
135
+ - What's the absolute minimum team size needed?
136
+ - Can we launch with a smaller feature set?"
137
+
138
+ ### 6. Generate Scoping Content
139
+
140
+ Prepare comprehensive scoping section:
141
+
142
+ #### Content Structure:
143
+
144
+ ```markdown
145
+ ## Project Scoping & Phased Development
146
+
147
+ ### MVP Strategy & Philosophy
148
+
149
+ **MVP Approach:** {{chosen_mvp_approach}}
150
+ **Resource Requirements:** {{mvp_team_size_and_skills}}
151
+
152
+ ### MVP Feature Set (Phase 1)
153
+
154
+ **Core User Journeys Supported:**
155
+ {{essential_journeys_for_mvp}}
156
+
157
+ **Must-Have Capabilities:**
158
+ {{list_of_essential_mvp_features}}
159
+
160
+ ### Post-MVP Features
161
+
162
+ **Phase 2 (Post-MVP):**
163
+ {{planned_growth_features}}
164
+
165
+ **Phase 3 (Expansion):**
166
+ {{planned_expansion_features}}
167
+
168
+ ### Risk Mitigation Strategy
169
+
170
+ **Technical Risks:** {{mitigation_approach}}
171
+ **Market Risks:** {{validation_approach}}
172
+ **Resource Risks:** {{contingency_approach}}
173
+ ```
174
+
175
+ ### 7. Present MENU OPTIONS
176
+
177
+ Present the scoping decisions for review, then display menu:
178
+ - Show strategic scoping plan (using structure from step 6)
179
+ - Highlight MVP boundaries and phased roadmap
180
+ - Ask if they'd like to refine further, get other perspectives, or proceed
181
+ - Present menu options naturally as part of conversation
182
+
183
+ Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Functional Requirements (Step 9 of 11)"
184
+
185
+ #### Menu Handling Logic:
186
+ - IF A: Execute {advancedElicitationTask} with the current scoping analysis, process the enhanced insights that come back, ask user if they accept the improvements, if yes update content then redisplay menu, if no keep original content then redisplay menu
187
+ - IF P: Execute {partyModeWorkflow} with the scoping context, process the collaborative insights on MVP and roadmap decisions, ask user if they accept the changes, if yes update content then redisplay menu, if no keep original content then redisplay menu
188
+ - IF C: Append the final content to {outputFile}, update frontmatter by adding this step name to the end of the stepsCompleted array, then load, read entire file, then execute {nextStepFile}
189
+ - IF Any other: help user respond, then redisplay menu
190
+
191
+ #### EXECUTION RULES:
192
+ - ALWAYS halt and wait for user input after presenting menu
193
+ - ONLY proceed to next step when user selects 'C'
194
+ - After other menu items execution, return to this menu
195
+
196
+ ## APPEND TO DOCUMENT:
197
+
198
+ When user selects 'C', append the content directly to the document using the structure from step 6.
199
+
200
+ ## SUCCESS METRICS:
201
+
202
+ ✅ Complete PRD document analyzed for scope implications
203
+ ✅ Strategic MVP approach defined and justified
204
+ ✅ Clear MVP feature boundaries established
205
+ ✅ Phased development roadmap created
206
+ ✅ Key risks identified and mitigation strategies defined
207
+ ✅ User explicitly agrees to scope decisions
208
+ ✅ A/P/C menu presented and handled correctly
209
+ ✅ Content properly appended to document when C selected
210
+
211
+ ## FAILURE MODES:
212
+
213
+ ❌ Not analyzing the complete PRD before making scoping decisions
214
+ ❌ Making scope decisions without strategic rationale
215
+ ❌ Not getting explicit user agreement on MVP boundaries
216
+ ❌ Missing critical risk analysis
217
+ ❌ Not creating clear phased development approach
218
+ ❌ Not presenting A/P/C menu after content generation
219
+
220
+ ❌ **CRITICAL**: Reading only partial step file - leads to incomplete understanding and poor decisions
221
+ ❌ **CRITICAL**: Proceeding with 'C' without fully reading and understanding the next step file
222
+ ❌ **CRITICAL**: Making decisions without complete understanding of step requirements and protocols
223
+
224
+ ## NEXT STEP:
225
+
226
+ After user selects 'C' and content is saved to document, load {nextStepFile}.
227
+
228
+ Remember: Do NOT proceed to step-09 until user explicitly selects 'C' from the A/P/C menu and content is saved!