bmad-fh 6.0.0-alpha.052779ef

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 +54 -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 +400 -0
  413. package/src/core/lib/scope/index.js +30 -0
  414. package/src/core/lib/scope/scope-context.js +301 -0
  415. package/src/core/lib/scope/scope-initializer.js +456 -0
  416. package/src/core/lib/scope/scope-manager.js +512 -0
  417. package/src/core/lib/scope/scope-migrator.js +434 -0
  418. package/src/core/lib/scope/scope-sync.js +483 -0
  419. package/src/core/lib/scope/scope-validator.js +294 -0
  420. package/src/core/lib/scope/state-lock.js +336 -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 +439 -0
  518. package/test/test-scope-system.js +781 -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 +273 -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-03-success'
3
+ description: 'Define comprehensive success criteria covering user, business, and technical success'
4
+
5
+ # File References
6
+ nextStepFile: './step-04-journeys.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 3: Success Criteria Definition
15
+
16
+ **Progress: Step 3 of 11** - Next: User Journey Mapping
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 defining what winning looks like for this product
27
+ - 🎯 COLLABORATIVE discovery, not assumption-based goal setting
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
+ - ⚠️ Present A/P/C menu after generating success criteria content
34
+ - 💾 ONLY save when user chooses C (Continue)
35
+ - 📖 Update output file frontmatter, adding this step name to the end of the list of stepsCompleted
36
+ - 🚫 FORBIDDEN to load next step until C is selected
37
+
38
+ ## CONTEXT BOUNDARIES:
39
+
40
+ - Current document and frontmatter from previous steps are available
41
+ - Executive Summary and Project Classification already exist in document
42
+ - Input documents from step-01 are available (product briefs, research, brainstorming)
43
+ - No additional data files needed for this step
44
+ - Focus on measurable, specific success criteria
45
+ - LEVERAGE existing input documents to inform success criteria
46
+
47
+ ## YOUR TASK:
48
+
49
+ Define comprehensive success criteria that cover user success, business success, and technical success, using input documents as a foundation while allowing user refinement.
50
+
51
+ ## SUCCESS DISCOVERY SEQUENCE:
52
+
53
+ ### 1. Begin Success Definition Conversation
54
+
55
+ **Check Input Documents for Success Indicators:**
56
+ Analyze product brief, research, and brainstorming documents for success criteria already mentioned.
57
+
58
+ **If Input Documents Contain Success Criteria:**
59
+ Guide user to refine existing success criteria:
60
+ - Acknowledge what's already documented in their materials
61
+ - Extract key success themes from brief, research, and brainstorming
62
+ - Help user identify gaps and areas for expansion
63
+ - Probe for specific, measurable outcomes: When do users feel delighted/relieved/empowered?
64
+ - Ask about emotional success moments and completion scenarios
65
+ - Explore what "worth it" means beyond what's already captured
66
+
67
+ **If No Success Criteria in Input Documents:**
68
+ Start with user-centered success exploration:
69
+ - Guide conversation toward defining what "worth it" means for users
70
+ - Ask about the moment users realize their problem is solved
71
+ - Explore specific user outcomes and emotional states
72
+ - Identify success "aha!" moments and completion scenarios
73
+ - Focus on user experience of success first
74
+
75
+ ### 2. Explore User Success Metrics
76
+
77
+ Listen for specific user outcomes and help make them measurable:
78
+
79
+ - Guide from vague to specific: NOT "users are happy" → "users complete [key action] within [timeframe]"
80
+ - Ask about emotional success: "When do they feel delighted/relieved/empowered?"
81
+ - Identify success moments: "What's the 'aha!' moment?"
82
+ - Define completion scenarios: "What does 'done' look like for the user?"
83
+
84
+ ### 3. Define Business Success
85
+
86
+ Transition to business metrics:
87
+ - Guide conversation to business perspective on success
88
+ - Explore timelines: What does 3-month success look like? 12-month success?
89
+ - Identify key business metrics: revenue, user growth, engagement, or other measures?
90
+ - Ask what specific metric would indicate "this is working"
91
+ - Understand business success from their perspective
92
+
93
+ ### 4. Challenge Vague Metrics
94
+
95
+ Push for specificity on business metrics:
96
+
97
+ - "10,000 users" → "What kind of users? Doing what?"
98
+ - "99.9% uptime" → "What's the real concern - data loss? Failed payments?"
99
+ - "Fast" → "How fast, and what specifically needs to be fast?"
100
+ - "Good adoption" → "What percentage adoption by when?"
101
+
102
+ ### 5. Connect to Product Differentiator
103
+
104
+ Tie success metrics back to what makes the product special:
105
+ - Connect success criteria to the product's unique differentiator
106
+ - Ensure metrics reflect the specific value proposition
107
+ - Adapt success criteria to domain context:
108
+ - Consumer: User love, engagement, retention
109
+ - B2B: ROI, efficiency, adoption
110
+ - Developer tools: Developer experience, community
111
+ - Regulated: Compliance, safety, validation
112
+ - GovTech: Government compliance, accessibility, procurement
113
+
114
+ ### 6. Smart Scope Negotiation
115
+
116
+ Guide scope definition through success lens:
117
+ - Help user distinguish MVP (must work to be useful) from growth (competitive) and vision (dream)
118
+ - Guide conversation through three scope levels:
119
+ 1. MVP: What's essential for proving the concept?
120
+ 2. Growth: What makes it competitive?
121
+ 3. Vision: What's the dream version?
122
+ - Challenge scope creep conversationally: Could this wait until after launch? Is this essential for MVP?
123
+ - For complex domains: Ensure compliance minimums are included in MVP
124
+
125
+ ### 7. Generate Success Criteria Content
126
+
127
+ Prepare the content to append to the document:
128
+
129
+ #### Content Structure:
130
+
131
+ When saving to document, append these Level 2 and Level 3 sections:
132
+
133
+ ```markdown
134
+ ## Success Criteria
135
+
136
+ ### User Success
137
+
138
+ [Content about user success criteria based on conversation]
139
+
140
+ ### Business Success
141
+
142
+ [Content about business success metrics based on conversation]
143
+
144
+ ### Technical Success
145
+
146
+ [Content about technical success requirements based on conversation]
147
+
148
+ ### Measurable Outcomes
149
+
150
+ [Content about specific measurable outcomes based on conversation]
151
+
152
+ ## Product Scope
153
+
154
+ ### MVP - Minimum Viable Product
155
+
156
+ [Content about MVP scope based on conversation]
157
+
158
+ ### Growth Features (Post-MVP)
159
+
160
+ [Content about growth features based on conversation]
161
+
162
+ ### Vision (Future)
163
+
164
+ [Content about future vision based on conversation]
165
+ ```
166
+
167
+ ### 8. Present MENU OPTIONS
168
+
169
+ Present the success criteria content for user review, then display menu:
170
+
171
+ - Show the drafted success criteria and scope definition (using structure from section 7)
172
+ - Ask if they'd like to refine further, get other perspectives, or proceed
173
+ - Present menu options naturally as part of the conversation
174
+
175
+ Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to User Journey Mapping (Step 4 of 11)"
176
+
177
+ #### Menu Handling Logic:
178
+ - IF A: Execute {advancedElicitationTask} with the current success criteria content, process the enhanced success metrics that come back, ask user "Accept these improvements to the success criteria? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
179
+ - IF P: Execute {partyModeWorkflow} with the current success criteria, process the collaborative improvements to metrics and scope, ask user "Accept these changes to the success criteria? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
180
+ - 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}
181
+ - IF Any other: help user respond, then redisplay menu
182
+
183
+ #### EXECUTION RULES:
184
+ - ALWAYS halt and wait for user input after presenting menu
185
+ - ONLY proceed to next step when user selects 'C'
186
+ - After other menu items execution, return to this menu
187
+
188
+ ## APPEND TO DOCUMENT:
189
+
190
+ When user selects 'C', append the content directly to the document using the structure from step 7.
191
+
192
+ ## SUCCESS METRICS:
193
+
194
+ ✅ User success criteria clearly identified and made measurable
195
+ ✅ Business success metrics defined with specific targets
196
+ ✅ Success criteria connected to product differentiator
197
+ ✅ Scope properly negotiated (MVP, Growth, Vision)
198
+ ✅ A/P/C menu presented and handled correctly
199
+ ✅ Content properly appended to document when C selected
200
+
201
+ ## FAILURE MODES:
202
+
203
+ ❌ Accepting vague success metrics without pushing for specificity
204
+ ❌ Not connecting success criteria back to product differentiator
205
+ ❌ Missing scope negotiation and leaving it undefined
206
+ ❌ Generating content without real user input on what success looks like
207
+ ❌ Not presenting A/P/C menu after content generation
208
+ ❌ Appending content without user selecting 'C'
209
+
210
+ ❌ **CRITICAL**: Reading only partial step file - leads to incomplete understanding and poor decisions
211
+ ❌ **CRITICAL**: Proceeding with 'C' without fully reading and understanding the next step file
212
+ ❌ **CRITICAL**: Making decisions without complete understanding of step requirements and protocols
213
+
214
+ ## DOMAIN CONSIDERATIONS:
215
+
216
+ If working in regulated domains (healthcare, fintech, govtech):
217
+
218
+ - Include compliance milestones in success criteria
219
+ - Add regulatory approval timelines to MVP scope
220
+ - Consider audit requirements as technical success metrics
221
+
222
+ ## NEXT STEP:
223
+
224
+ After user selects 'C' and content is saved to document, load `./step-04-journeys.md` to map user journeys.
225
+
226
+ Remember: Do NOT proceed to step-04 until user explicitly selects 'C' from the A/P/C menu and content is saved!
@@ -0,0 +1,213 @@
1
+ ---
2
+ name: 'step-04-journeys'
3
+ description: 'Map ALL user types that interact with the system with narrative story-based journeys'
4
+
5
+ # File References
6
+ nextStepFile: './step-05-domain.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 4: User Journey Mapping
15
+
16
+ **Progress: Step 4 of 11** - Next: Domain 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 mapping ALL user types that interact with the system
27
+ - 🎯 CRITICAL: No journey = no functional requirements = product doesn't exist
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
+ - ⚠️ Present A/P/C menu after generating journey content
34
+ - 💾 ONLY save when user chooses C (Continue)
35
+ - 📖 Update output file frontmatter, adding this step name to the end of the list of stepsCompleted
36
+ - 🚫 FORBIDDEN to load next step until C is selected
37
+
38
+ ## CONTEXT BOUNDARIES:
39
+
40
+ - Current document and frontmatter from previous steps are available
41
+ - Success criteria and scope already defined
42
+ - Input documents from step-01 are available (product briefs with user personas)
43
+ - Every human interaction with the system needs a journey
44
+
45
+ ## YOUR TASK:
46
+
47
+ Create compelling narrative user journeys that leverage existing personas from product briefs and identify additional user types needed for comprehensive coverage.
48
+
49
+ ## JOURNEY MAPPING SEQUENCE:
50
+
51
+ ### 1. Leverage Existing Users & Identify Additional Types
52
+
53
+ **Check Input Documents for Existing Personas:**
54
+ Analyze product brief, research, and brainstorming documents for user personas already defined.
55
+
56
+ **If User Personas Exist in Input Documents:**
57
+ Guide user to build on existing personas:
58
+ - Acknowledge personas found in their product brief
59
+ - Extract key persona details and backstories
60
+ - Leverage existing insights about their needs
61
+ - Prompt to identify additional user types beyond those documented
62
+ - Suggest additional user types based on product context (admins, moderators, support, API consumers, internal ops)
63
+ - Ask what additional user types should be considered
64
+
65
+ **If No Personas in Input Documents:**
66
+ Start with comprehensive user type discovery:
67
+ - Guide exploration of ALL people who interact with the system
68
+ - Consider beyond primary users: admins, moderators, support staff, API consumers, internal ops
69
+ - Ask what user types should be mapped for this specific product
70
+ - Ensure comprehensive coverage of all system interactions
71
+
72
+ ### 2. Create Narrative Story-Based Journeys
73
+
74
+ For each user type, create compelling narrative journeys that tell their story:
75
+
76
+ #### Narrative Journey Creation Process:
77
+
78
+ **If Using Existing Persona from Input Documents:**
79
+ Guide narrative journey creation:
80
+ - Use persona's existing backstory from brief
81
+ - Explore how the product changes their life/situation
82
+ - Craft journey narrative: where do we meet them, how does product help them write their next chapter?
83
+
84
+ **If Creating New Persona:**
85
+ Guide persona creation with story framework:
86
+ - Name: realistic name and personality
87
+ - Situation: What's happening in their life/work that creates need?
88
+ - Goal: What do they desperately want to achieve?
89
+ - Obstacle: What's standing in their way?
90
+ - Solution: How does the product solve their story?
91
+
92
+ **Story-Based Journey Mapping:**
93
+
94
+ Guide narrative journey creation using story structure:
95
+ - **Opening Scene**: Where/how do we meet them? What's their current pain?
96
+ - **Rising Action**: What steps do they take? What do they discover?
97
+ - **Climax**: Critical moment where product delivers real value
98
+ - **Resolution**: How does their situation improve? What's their new reality?
99
+
100
+ Encourage narrative format with specific user details, emotional journey, and clear before/after contrast
101
+
102
+ ### 3. Guide Journey Exploration
103
+
104
+ For each journey, facilitate detailed exploration:
105
+ - What happens at each step specifically?
106
+ - What could go wrong? What's the recovery path?
107
+ - What information do they need to see/hear?
108
+ - What's their emotional state at each point?
109
+ - Where does this journey succeed or fail?
110
+
111
+ ### 4. Connect Journeys to Requirements
112
+
113
+ After each journey, explicitly state:
114
+ - This journey reveals requirements for specific capability areas
115
+ - Help user see how different journeys create different feature sets
116
+ - Connect journey needs to concrete capabilities (onboarding, dashboards, notifications, etc.)
117
+
118
+ ### 5. Aim for Comprehensive Coverage
119
+
120
+ Guide toward complete journey set:
121
+
122
+ - **Primary user** - happy path (core experience)
123
+ - **Primary user** - edge case (different goal, error recovery)
124
+ - **Secondary user** (admin, moderator, support, etc.)
125
+ - **API consumer** (if applicable)
126
+
127
+ Ask if additional journeys are needed to cover uncovered user types
128
+
129
+ ### 6. Generate User Journey Content
130
+
131
+ Prepare the content to append to the document:
132
+
133
+ #### Content Structure:
134
+
135
+ When saving to document, append these Level 2 and Level 3 sections:
136
+
137
+ ```markdown
138
+ ## User Journeys
139
+
140
+ [All journey narratives based on conversation]
141
+
142
+ ### Journey Requirements Summary
143
+
144
+ [Summary of capabilities revealed by journeys based on conversation]
145
+ ```
146
+
147
+ ### 7. Present MENU OPTIONS
148
+
149
+ Present the user journey content for review, then display menu:
150
+ - Show the mapped user journeys (using structure from section 6)
151
+ - Highlight how each journey reveals different capabilities
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 Domain Requirements (Step 5 of 11)"
156
+
157
+ #### Menu Handling Logic:
158
+ - IF A: Execute {advancedElicitationTask} with the current journey content, process the enhanced journey insights that come back, ask user "Accept these improvements to the user journeys? (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 journeys, process the collaborative journey improvements and additions, ask user "Accept these changes to the user journeys? (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
+ ## APPEND TO DOCUMENT:
169
+
170
+ When user selects 'C', append the content directly to the document using the structure from step 6.
171
+
172
+ ## SUCCESS METRICS:
173
+
174
+ ✅ Existing personas from product briefs leveraged when available
175
+ ✅ All user types identified (not just primary users)
176
+ ✅ Rich narrative storytelling for each persona and journey
177
+ ✅ Complete story-based journey mapping with emotional arc
178
+ ✅ Journey requirements clearly connected to capabilities needed
179
+ ✅ Minimum 3-4 compelling narrative journeys covering different user types
180
+ ✅ A/P/C menu presented and handled correctly
181
+ ✅ Content properly appended to document when C selected
182
+
183
+ ## FAILURE MODES:
184
+
185
+ ❌ Ignoring existing personas from product briefs
186
+ ❌ Only mapping primary user journeys and missing secondary users
187
+ ❌ Creating generic journeys without rich persona details and narrative
188
+ ❌ Missing emotional storytelling elements that make journeys compelling
189
+ ❌ Missing critical decision points and failure scenarios
190
+ ❌ Not connecting journeys to required capabilities
191
+ ❌ Not having enough journey diversity (admin, support, API, etc.)
192
+ ❌ Not presenting A/P/C menu after content generation
193
+ ❌ Appending content without user selecting 'C'
194
+
195
+ ❌ **CRITICAL**: Reading only partial step file - leads to incomplete understanding and poor decisions
196
+ ❌ **CRITICAL**: Proceeding with 'C' without fully reading and understanding the next step file
197
+ ❌ **CRITICAL**: Making decisions without complete understanding of step requirements and protocols
198
+
199
+ ## JOURNEY TYPES TO ENSURE:
200
+
201
+ **Minimum Coverage:**
202
+
203
+ 1. **Primary User - Success Path**: Core experience journey
204
+ 2. **Primary User - Edge Case**: Error recovery, alternative goals
205
+ 3. **Admin/Operations User**: Management, configuration, monitoring
206
+ 4. **Support/Troubleshooting**: Help, investigation, issue resolution
207
+ 5. **API/Integration** (if applicable): Developer/technical user journey
208
+
209
+ ## NEXT STEP:
210
+
211
+ After user selects 'C' and content is saved to document, load `./step-05-domain.md`.
212
+
213
+ Remember: Do NOT proceed to step-05 until user explicitly selects 'C' from the A/P/C menu and content is saved!
@@ -0,0 +1,207 @@
1
+ ---
2
+ name: 'step-05-domain'
3
+ description: 'Explore domain-specific requirements for complex domains (optional step)'
4
+
5
+ # File References
6
+ nextStepFile: './step-06-innovation.md'
7
+ outputFile: '{planning_artifacts}/prd.md'
8
+ domainComplexityCSV: '../data/domain-complexity.csv'
9
+
10
+ # Task References
11
+ advancedElicitationTask: '{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml'
12
+ partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
13
+ ---
14
+
15
+ # Step 5: Domain-Specific Requirements (Optional)
16
+
17
+ **Progress: Step 5 of 13** - Next: Innovation Focus
18
+
19
+ ## STEP GOAL:
20
+
21
+ For complex domains only that have a mapping in {domainComplexityCSV}, explore domain-specific constraints, compliance requirements, and technical considerations that shape the product.
22
+
23
+ ## MANDATORY EXECUTION RULES (READ FIRST):
24
+
25
+ ### Universal Rules:
26
+
27
+ - 🛑 NEVER generate content without user input
28
+ - 📖 CRITICAL: Read the complete step file before taking any action
29
+ - 🔄 CRITICAL: When loading next step with 'C', ensure the entire file is read
30
+ - ✅ ALWAYS treat this as collaborative discovery between PM peers
31
+ - 📋 YOU ARE A FACILITATOR, not a content generator
32
+ - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
33
+
34
+ ### Role Reinforcement:
35
+
36
+ - ✅ You are a product-focused PM facilitator collaborating with an expert peer
37
+ - ✅ We engage in collaborative dialogue, not command-response
38
+ - ✅ You bring structured thinking and facilitation skills, while the user brings domain expertise
39
+
40
+ ### Step-Specific Rules:
41
+
42
+ - 🎯 This step is OPTIONAL - only needed for complex domains
43
+ - 🚫 SKIP if domain complexity is "low" from step-02
44
+ - 💬 APPROACH: Natural conversation to discover domain-specific needs
45
+ - 🎯 Focus on constraints, compliance, and domain patterns
46
+
47
+ ## EXECUTION PROTOCOLS:
48
+
49
+ - 🎯 Check domain complexity from step-02 classification first
50
+ - ⚠️ If complexity is "low", offer to skip this step
51
+ - ⚠️ Present A/P/C menu after domain requirements defined (or skipped)
52
+ - 💾 ONLY save when user chooses C (Continue)
53
+ - 📖 Update output file frontmatter, adding this step name to the end of the list of stepsCompleted
54
+ - 🚫 FORBIDDEN to load next step until C is selected
55
+
56
+ ## CONTEXT BOUNDARIES:
57
+
58
+ - Domain classification from step-02 is available
59
+ - If complexity is low, this step may be skipped
60
+ - Domain CSV data provides complexity reference
61
+ - Focus on domain-specific constraints, not general requirements
62
+
63
+ ## YOUR TASK:
64
+
65
+ For complex domains, explore what makes this domain special:
66
+ - **Compliance requirements** - regulations, standards, certifications
67
+ - **Technical constraints** - security, privacy, integration requirements
68
+ - **Domain patterns** - common patterns, best practices, anti-patterns
69
+ - **Risks and mitigations** - what could go wrong, how to prevent it
70
+
71
+ ## DOMAIN DISCOVERY SEQUENCE:
72
+
73
+ ### 1. Check Domain Complexity
74
+
75
+ **Review classification from step-02:**
76
+
77
+ - What's the domain complexity level? (low/medium/high)
78
+ - What's the specific domain? (healthcare, fintech, education, etc.)
79
+
80
+ **If complexity is LOW:**
81
+
82
+ Offer to skip:
83
+ "The domain complexity from our discovery is low. We may not need deep domain-specific requirements. Would you like to:
84
+ - [C] Skip this step and move to Innovation
85
+ - [D] Do domain exploration anyway"
86
+
87
+ **If complexity is MEDIUM or HIGH:**
88
+
89
+ Proceed with domain exploration.
90
+
91
+ ### 2. Load Domain Reference Data
92
+
93
+ **Attempt subprocess data lookup:**
94
+
95
+ "Your task: Lookup data in {domainComplexityCSV}
96
+
97
+ **Search criteria:**
98
+ - Find row where domain matches {{domainFromStep02}}
99
+
100
+ **Return format:**
101
+ Return ONLY the matching row as a YAML-formatted object with these fields:
102
+ domain, complexity, typical_concerns, compliance_requirements
103
+
104
+ **Do NOT return the entire CSV - only the matching row.**"
105
+
106
+ **Graceful degradation (if Task tool unavailable):**
107
+ - Load the CSV file directly
108
+ - Find the matching row manually
109
+ - Extract required fields
110
+ - Understand typical concerns and compliance requirements
111
+
112
+ ### 3. Explore Domain-Specific Concerns
113
+
114
+ **Start with what you know:**
115
+
116
+ Acknowledge the domain and explore what makes it complex:
117
+ - What regulations apply? (HIPAA, PCI-DSS, GDPR, SOX, etc.)
118
+ - What standards matter? (ISO, NIST, domain-specific standards)
119
+ - What certifications are needed? (security, privacy, domain-specific)
120
+ - What integrations are required? (EMR systems, payment processors, etc.)
121
+
122
+ **Explore technical constraints:**
123
+ - Security requirements (encryption, audit logs, access control)
124
+ - Privacy requirements (data handling, consent, retention)
125
+ - Performance requirements (real-time, batch, latency)
126
+ - Availability requirements (uptime, disaster recovery)
127
+
128
+ ### 4. Document Domain Requirements
129
+
130
+ **Structure the requirements around key concerns:**
131
+
132
+ ```markdown
133
+ ### Compliance & Regulatory
134
+ - [Specific requirements]
135
+
136
+ ### Technical Constraints
137
+ - [Security, privacy, performance needs]
138
+
139
+ ### Integration Requirements
140
+ - [Required systems and data flows]
141
+
142
+ ### Risk Mitigations
143
+ - [Domain-specific risks and how to address them]
144
+ ```
145
+
146
+ ### 5. Validate Completeness
147
+
148
+ **Check with the user:**
149
+
150
+ "Are there other domain-specific concerns we should consider? For [this domain], what typically gets overlooked?"
151
+
152
+ ### N. Present MENU OPTIONS
153
+
154
+ Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue - Save and Proceed to Innovation (Step 6 of 13)"
155
+
156
+ #### Menu Handling Logic:
157
+ - IF A: Execute {advancedElicitationTask}, and when finished redisplay the menu
158
+ - IF P: Execute {partyModeWorkflow}, and when finished redisplay the menu
159
+ - IF C: Save content to {outputFile}, update frontmatter, then load, read entire file, then execute {nextStepFile}
160
+ - IF Any other comments or queries: help user respond then [Redisplay Menu Options](#n-present-menu-options)
161
+
162
+ #### EXECUTION RULES:
163
+ - ALWAYS halt and wait for user input after presenting menu
164
+ - ONLY proceed to next step when user selects 'C'
165
+ - After other menu items execution, return to this menu
166
+
167
+ ## APPEND TO DOCUMENT
168
+
169
+ When user selects 'C', append to `{outputFile}`:
170
+
171
+ ```markdown
172
+ ## Domain-Specific Requirements
173
+
174
+ {{discovered domain requirements}}
175
+ ```
176
+
177
+ If step was skipped, append nothing and proceed.
178
+
179
+ ## CRITICAL STEP COMPLETION NOTE
180
+
181
+ ONLY WHEN [C continue option] is selected and [content saved or skipped], will you then load and read fully `{nextStepFile}` to explore innovation.
182
+
183
+ ---
184
+
185
+ ## 🚨 SYSTEM SUCCESS/FAILURE METRICS
186
+
187
+ ### ✅ SUCCESS:
188
+
189
+ - Domain complexity checked before proceeding
190
+ - Offered to skip if complexity is low
191
+ - Natural conversation exploring domain concerns
192
+ - Compliance, technical, and integration requirements identified
193
+ - Domain-specific risks documented with mitigations
194
+ - User validated completeness
195
+ - Content properly saved (or step skipped) when C selected
196
+
197
+ ### ❌ SYSTEM FAILURE:
198
+
199
+ - Not checking domain complexity first
200
+ - Not offering to skip for low-complexity domains
201
+ - Missing critical compliance requirements
202
+ - Not exploring technical constraints
203
+ - Not asking about domain-specific risks
204
+ - Being generic instead of domain-specific
205
+ - Proceeding without user validation
206
+
207
+ **Master Rule:** This step is OPTIONAL for simple domains. For complex domains, focus on compliance, constraints, and domain patterns. Natural conversation, not checklists.