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,135 @@
1
+ # Step 1: UX Design Workflow Initialization
2
+
3
+ ## MANDATORY EXECUTION RULES (READ FIRST):
4
+
5
+ - 🛑 NEVER generate content without user input
6
+
7
+ - 📖 CRITICAL: ALWAYS read the complete step file before taking any action - partial understanding leads to incomplete decisions
8
+ - 🔄 CRITICAL: When loading next step with 'C', ensure the entire file is read and understood before proceeding
9
+ - ✅ ALWAYS treat this as collaborative discovery between UX facilitator and stakeholder
10
+ - 📋 YOU ARE A UX FACILITATOR, not a content generator
11
+ - 💬 FOCUS on initialization and setup only - don't look ahead to future steps
12
+ - 🚪 DETECT existing workflow state and handle continuation properly
13
+ - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
14
+
15
+ ## EXECUTION PROTOCOLS:
16
+
17
+ - 🎯 Show your analysis before taking any action
18
+ - 💾 Initialize document and update frontmatter
19
+ - 📖 Set up frontmatter `stepsCompleted: [1]` before loading next step
20
+ - 🚫 FORBIDDEN to load next step until setup is complete
21
+
22
+ ## CONTEXT BOUNDARIES:
23
+
24
+ - Variables from workflow.md are available in memory
25
+ - Previous context = what's in output document + frontmatter
26
+ - Don't assume knowledge from other steps
27
+ - Input document discovery happens in this step
28
+
29
+ ## YOUR TASK:
30
+
31
+ Initialize the UX design workflow by detecting continuation state and setting up the design specification document.
32
+
33
+ ## INITIALIZATION SEQUENCE:
34
+
35
+ ### 1. Check for Existing Workflow
36
+
37
+ First, check if the output document already exists:
38
+
39
+ - Look for file at `{planning_artifacts}/*ux-design-specification*.md`
40
+ - If exists, read the complete file including frontmatter
41
+ - If not exists, this is a fresh workflow
42
+
43
+ ### 2. Handle Continuation (If Document Exists)
44
+
45
+ If the document exists and has frontmatter with `stepsCompleted`:
46
+
47
+ - **STOP here** and load `./step-01b-continue.md` immediately
48
+ - Do not proceed with any initialization tasks
49
+ - Let step-01b handle the continuation logic
50
+
51
+ ### 3. Fresh Workflow Setup (If No Document)
52
+
53
+ If no document exists or no `stepsCompleted` in frontmatter:
54
+
55
+ #### A. Input Document Discovery
56
+
57
+ Discover and load context documents using smart discovery. Documents can be in the following locations:
58
+ - {planning_artifacts}/**
59
+ - {output_folder}/**
60
+ - {product_knowledge}/**
61
+ - docs/**
62
+
63
+ Also - when searching - documents can be a single markdown file, or a folder with an index and multiple files. For Example, if searching for `*foo*.md` and not found, also search for a folder called *foo*/index.md (which indicates sharded content)
64
+
65
+ Try to discover the following:
66
+ - Product Brief (`*brief*.md`)
67
+ - Research Documents (`*prd*.md`)
68
+ - Project Documentation (generally multiple documents might be found for this in the `{product_knowledge}` or `docs` folder.)
69
+ - Project Context (`**/project-context.md`)
70
+
71
+ <critical>Confirm what you have found with the user, along with asking if the user wants to provide anything else. Only after this confirmation will you proceed to follow the loading rules</critical>
72
+
73
+ **Loading Rules:**
74
+
75
+ - Load ALL discovered files completely that the user confirmed or provided (no offset/limit)
76
+ - If there is a project context, whatever is relevant should try to be biased in the remainder of this whole workflow process
77
+ - For sharded folders, load ALL files to get complete picture, using the index first to potentially know the potential of each document
78
+ - index.md is a guide to what's relevant whenever available
79
+ - Track all successfully loaded files in frontmatter `inputDocuments` array
80
+
81
+ #### B. Create Initial Document
82
+
83
+ Copy the template from `{installed_path}/ux-design-template.md` to `{planning_artifacts}/ux-design-specification.md`
84
+ Initialize frontmatter in the template.
85
+
86
+ #### C. Complete Initialization and Report
87
+
88
+ Complete setup and report to user:
89
+
90
+ **Document Setup:**
91
+
92
+ - Created: `{planning_artifacts}/ux-design-specification.md` from template
93
+ - Initialized frontmatter with workflow state
94
+
95
+ **Input Documents Discovered:**
96
+ Report what was found:
97
+ "Welcome {{user_name}}! I've set up your UX design workspace for {{project_name}}.
98
+
99
+ **Documents Found:**
100
+
101
+ - PRD: {number of PRD files loaded or "None found"}
102
+ - Product brief: {number of brief files loaded or "None found"}
103
+ - Other context: {number of other files loaded or "None found"}
104
+
105
+ **Files loaded:** {list of specific file names or "No additional documents found"}
106
+
107
+ Do you have any other documents you'd like me to include, or shall we continue to the next step?
108
+
109
+ [C] Continue to UX discovery"
110
+
111
+ ## NEXT STEP:
112
+
113
+ After user selects [C] to continue, ensure the file `{planning_artifacts}/ux-design-specification.md` has been created and saved, and then load `./step-02-discovery.md` to begin the UX discovery phase.
114
+
115
+ Remember: Do NOT proceed to step-02 until output file has been updated and user explicitly selects [C] to continue!
116
+
117
+ ## SUCCESS METRICS:
118
+
119
+ ✅ Existing workflow detected and handed off to step-01b correctly
120
+ ✅ Fresh workflow initialized with template and frontmatter
121
+ ✅ Input documents discovered and loaded using sharded-first logic
122
+ ✅ All discovered files tracked in frontmatter `inputDocuments`
123
+ ✅ User confirmed document setup and can proceed
124
+
125
+ ## FAILURE MODES:
126
+
127
+ ❌ Proceeding with fresh initialization when existing workflow exists
128
+ ❌ Not updating frontmatter with discovered input documents
129
+ ❌ Creating document without proper template
130
+ ❌ Not checking sharded folders first before whole files
131
+ ❌ Not reporting what documents were found to user
132
+
133
+ ❌ **CRITICAL**: Reading only partial step file - leads to incomplete understanding and poor decisions
134
+ ❌ **CRITICAL**: Proceeding with 'C' without fully reading and understanding the next step file
135
+ ❌ **CRITICAL**: Making decisions without complete understanding of step requirements and protocols
@@ -0,0 +1,127 @@
1
+ # Step 1B: UX Design Workflow Continuation
2
+
3
+ ## MANDATORY EXECUTION RULES (READ FIRST):
4
+
5
+ - 🛑 NEVER generate content without user input
6
+
7
+ - 📖 CRITICAL: ALWAYS read the complete step file before taking any action - partial understanding leads to incomplete decisions
8
+ - 🔄 CRITICAL: When loading next step with 'C', ensure the entire file is read and understood before proceeding
9
+ - ✅ ALWAYS treat this as collaborative discovery between UX facilitator and stakeholder
10
+ - 📋 YOU ARE A UX FACILITATOR, not a content generator
11
+ - 💬 FOCUS on understanding where we left off and continuing appropriately
12
+ - 🚪 RESUME workflow from exact point where it was interrupted
13
+ - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
14
+
15
+ ## EXECUTION PROTOCOLS:
16
+
17
+ - 🎯 Show your analysis of current state before taking action
18
+ - 💾 Keep existing frontmatter `stepsCompleted` values
19
+ - 📖 Only load documents that were already tracked in `inputDocuments`
20
+ - 🚫 FORBIDDEN to modify content completed in previous steps
21
+
22
+ ## CONTEXT BOUNDARIES:
23
+
24
+ - Current document and frontmatter are already loaded
25
+ - Previous context = complete document + existing frontmatter
26
+ - Input documents listed in frontmatter were already processed
27
+ - Last completed step = `lastStep` value from frontmatter
28
+
29
+ ## YOUR TASK:
30
+
31
+ Resume the UX design workflow from where it was left off, ensuring smooth continuation.
32
+
33
+ ## CONTINUATION SEQUENCE:
34
+
35
+ ### 1. Analyze Current State
36
+
37
+ Review the frontmatter to understand:
38
+
39
+ - `stepsCompleted`: Which steps are already done
40
+ - `lastStep`: The most recently completed step number
41
+ - `inputDocuments`: What context was already loaded
42
+ - All other frontmatter variables
43
+
44
+ ### 2. Load All Input Documents
45
+
46
+ Reload the context documents listed in `inputDocuments`:
47
+
48
+ - For each document in `inputDocuments`, load the complete file
49
+ - This ensures you have full context for continuation
50
+ - Don't discover new documents - only reload what was previously processed
51
+
52
+ ### 3. Summarize Current Progress
53
+
54
+ Welcome the user back and provide context:
55
+ "Welcome back {{user_name}}! I'm resuming our UX design collaboration for {{project_name}}.
56
+
57
+ **Current Progress:**
58
+
59
+ - Steps completed: {stepsCompleted}
60
+ - Last worked on: Step {lastStep}
61
+ - Context documents available: {len(inputDocuments)} files
62
+ - Current UX design specification is ready with all completed sections
63
+
64
+ **Document Status:**
65
+
66
+ - Current UX design document is ready with all completed sections
67
+ - Ready to continue from where we left off
68
+
69
+ Does this look right, or do you want to make any adjustments before we proceed?"
70
+
71
+ ### 4. Determine Next Step
72
+
73
+ Based on `lastStep` value, determine which step to load next:
74
+
75
+ - If `lastStep = 1` → Load `./step-02-discovery.md`
76
+ - If `lastStep = 2` → Load `./step-03-core-experience.md`
77
+ - If `lastStep = 3` → Load `./step-04-emotional-response.md`
78
+ - Continue this pattern for all steps
79
+ - If `lastStep` indicates final step → Workflow already complete
80
+
81
+ ### 5. Present Continuation Options
82
+
83
+ After presenting current progress, ask:
84
+ "Ready to continue with Step {nextStepNumber}: {nextStepTitle}?
85
+
86
+ [C] Continue to Step {nextStepNumber}"
87
+
88
+ ## SUCCESS METRICS:
89
+
90
+ ✅ All previous input documents successfully reloaded
91
+ ✅ Current workflow state accurately analyzed and presented
92
+ ✅ User confirms understanding of progress
93
+ ✅ Correct next step identified and prepared for loading
94
+
95
+ ## FAILURE MODES:
96
+
97
+ ❌ Discovering new input documents instead of reloading existing ones
98
+ ❌ Modifying content from already completed steps
99
+ ❌ Loading wrong next step based on `lastStep` value
100
+ ❌ Proceeding without user confirmation of current state
101
+
102
+ ❌ **CRITICAL**: Reading only partial step file - leads to incomplete understanding and poor decisions
103
+ ❌ **CRITICAL**: Proceeding with 'C' without fully reading and understanding the next step file
104
+ ❌ **CRITICAL**: Making decisions without complete understanding of step requirements and protocols
105
+
106
+ ## WORKFLOW ALREADY COMPLETE?
107
+
108
+ If `lastStep` indicates the final step is completed:
109
+ "Great news! It looks like we've already completed the UX design workflow for {{project_name}}.
110
+
111
+ The final UX design specification is ready at {output_folder}/ux-design-specification.md with all sections completed through step {finalStepNumber}.
112
+
113
+ The complete UX design includes visual foundations, user flows, and design specifications ready for implementation.
114
+
115
+ Would you like me to:
116
+
117
+ - Review the completed UX design specification with you
118
+ - Suggest next workflow steps (like wireframe generation or architecture)
119
+ - Start a new UX design revision
120
+
121
+ What would be most helpful?"
122
+
123
+ ## NEXT STEP:
124
+
125
+ After user confirms they're ready to continue, load the appropriate next step file based on the `lastStep` value from frontmatter.
126
+
127
+ Remember: Do NOT load the next step until user explicitly selects [C] to continue!
@@ -0,0 +1,190 @@
1
+ # Step 2: Project Understanding
2
+
3
+ ## MANDATORY EXECUTION RULES (READ FIRST):
4
+
5
+ - 🛑 NEVER generate content without user input
6
+
7
+ - 📖 CRITICAL: ALWAYS read the complete step file before taking any action - partial understanding leads to incomplete decisions
8
+ - 🔄 CRITICAL: When loading next step with 'C', ensure the entire file is read and understood before proceeding
9
+ - ✅ ALWAYS treat this as collaborative discovery between UX facilitator and stakeholder
10
+ - 📋 YOU ARE A UX FACILITATOR, not a content generator
11
+ - 💬 FOCUS on understanding project context and user needs
12
+ - 🎯 COLLABORATIVE discovery, not assumption-based design
13
+ - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
14
+
15
+ ## EXECUTION PROTOCOLS:
16
+
17
+ - 🎯 Show your analysis before taking any action
18
+ - ⚠️ Present A/P/C menu after generating project understanding content
19
+ - 💾 ONLY save when user chooses C (Continue)
20
+ - 📖 Update output file frontmatter, adding this step to the end of the list of stepsCompleted.
21
+ - 🚫 FORBIDDEN to load next step until C is selected
22
+
23
+ ## COLLABORATION MENUS (A/P/C):
24
+
25
+ This step will generate content and present choices:
26
+
27
+ - **A (Advanced Elicitation)**: Use discovery protocols to develop deeper project insights
28
+ - **P (Party Mode)**: Bring multiple perspectives to understand project context
29
+ - **C (Continue)**: Save the content to the document and proceed to next step
30
+
31
+ ## PROTOCOL INTEGRATION:
32
+
33
+ - When 'A' selected: Execute {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml
34
+ - When 'P' selected: Execute {project-root}/_bmad/core/workflows/party-mode/workflow.md
35
+ - PROTOCOLS always return to this step's A/P/C menu
36
+ - User accepts/rejects protocol changes before proceeding
37
+
38
+ ## CONTEXT BOUNDARIES:
39
+
40
+ - Current document and frontmatter from step 1 are available
41
+ - Input documents (PRD, briefs, epics) already loaded are in memory
42
+ - No additional data files needed for this step
43
+ - Focus on project and user understanding
44
+
45
+ ## YOUR TASK:
46
+
47
+ Understand the project context, target users, and what makes this product special from a UX perspective.
48
+
49
+ ## PROJECT DISCOVERY SEQUENCE:
50
+
51
+ ### 1. Review Loaded Context
52
+
53
+ Start by analyzing what we know from the loaded documents:
54
+ "Based on the project documentation we have loaded, let me confirm what I'm understanding about {{project_name}}.
55
+
56
+ **From the documents:**
57
+ {summary of key insights from loaded PRD, briefs, and other context documents}
58
+
59
+ **Target Users:**
60
+ {summary of user information from loaded documents}
61
+
62
+ **Key Features/Goals:**
63
+ {summary of main features and goals from loaded documents}
64
+
65
+ Does this match your understanding? Are there any corrections or additions you'd like to make?"
66
+
67
+ ### 2. Fill Context Gaps (If no documents or gaps exist)
68
+
69
+ If no documents were loaded or key information is missing:
70
+ "Since we don't have complete documentation, let's start with the essentials:
71
+
72
+ **What are you building?** (Describe your product in 1-2 sentences)
73
+
74
+ **Who is this for?** (Describe your ideal user or target audience)
75
+
76
+ **What makes this special or different?** (What's the unique value proposition?)
77
+
78
+ **What's the main thing users will do with this?** (Core user action or goal)"
79
+
80
+ ### 3. Explore User Context Deeper
81
+
82
+ Dive into user understanding:
83
+ "Let me understand your users better to inform the UX design:
84
+
85
+ **User Context Questions:**
86
+
87
+ - What problem are users trying to solve?
88
+ - What frustrates them with current solutions?
89
+ - What would make them say 'this is exactly what I needed'?
90
+ - How tech-savvy are your target users?
91
+ - What devices will they use most?
92
+ - When/where will they use this product?"
93
+
94
+ ### 4. Identify UX Design Challenges
95
+
96
+ Surface the key UX challenges to address:
97
+ "From what we've discussed, I'm seeing some key UX design considerations:
98
+
99
+ **Design Challenges:**
100
+
101
+ - [Identify 2-3 key UX challenges based on project type and user needs]
102
+ - [Note any platform-specific considerations]
103
+ - [Highlight any complex user flows or interactions]
104
+
105
+ **Design Opportunities:**
106
+
107
+ - [Identify 2-3 areas where great UX could create competitive advantage]
108
+ - [Note any opportunities for innovative UX patterns]
109
+
110
+ Does this capture the key UX considerations we need to address?"
111
+
112
+ ### 5. Generate Project Understanding Content
113
+
114
+ Prepare the content to append to the document:
115
+
116
+ #### Content Structure:
117
+
118
+ When saving to document, append these Level 2 and Level 3 sections:
119
+
120
+ ```markdown
121
+ ## Executive Summary
122
+
123
+ ### Project Vision
124
+
125
+ [Project vision summary based on conversation]
126
+
127
+ ### Target Users
128
+
129
+ [Target user descriptions based on conversation]
130
+
131
+ ### Key Design Challenges
132
+
133
+ [Key UX challenges identified based on conversation]
134
+
135
+ ### Design Opportunities
136
+
137
+ [Design opportunities identified based on conversation]
138
+ ```
139
+
140
+ ### 6. Present Content and Menu
141
+
142
+ Show the generated project understanding content and present choices:
143
+ "I've documented our understanding of {{project_name}} from a UX perspective. This will guide all our design decisions moving forward.
144
+
145
+ **Here's what I'll add to the document:**
146
+
147
+ [Show the complete markdown content from step 5]
148
+
149
+ **What would you like to do?**
150
+ [C] Continue - Save this to the document and move to core experience definition"
151
+
152
+ ### 7. Handle Menu Selection
153
+
154
+ #### If 'C' (Continue):
155
+
156
+ - Append the final content to `{planning_artifacts}/ux-design-specification.md`
157
+ - Update frontmatter: `stepsCompleted: [1, 2]`
158
+ - Load `./step-03-core-experience.md`
159
+
160
+ ## APPEND TO DOCUMENT:
161
+
162
+ When user selects 'C', append the content directly to the document. Only after the content is saved to document, load `./step-03-core-experience.md` and execute the instructions.
163
+
164
+ ## SUCCESS METRICS:
165
+
166
+ ✅ All available context documents reviewed and synthesized
167
+ ✅ Project vision clearly articulated
168
+ ✅ Target users well understood
169
+ ✅ Key UX challenges identified
170
+ ✅ Design opportunities surfaced
171
+ ✅ A/P/C menu presented and handled correctly
172
+ ✅ Content properly appended to document when C selected
173
+
174
+ ## FAILURE MODES:
175
+
176
+ ❌ Not reviewing loaded context documents thoroughly
177
+ ❌ Making assumptions about users without asking
178
+ ❌ Missing key UX challenges that will impact design
179
+ ❌ Not identifying design opportunities
180
+ ❌ Generating generic content without real project insight
181
+ ❌ Not presenting A/P/C menu after content generation
182
+ ❌ Appending content without user selecting 'C'
183
+
184
+ ❌ **CRITICAL**: Reading only partial step file - leads to incomplete understanding and poor decisions
185
+ ❌ **CRITICAL**: Proceeding with 'C' without fully reading and understanding the next step file
186
+ ❌ **CRITICAL**: Making decisions without complete understanding of step requirements and protocols
187
+
188
+ ## NEXT STEP:
189
+
190
+ Remember: Do NOT proceed to step-03 until user explicitly selects 'C' from the menu and content is saved!
@@ -0,0 +1,216 @@
1
+ # Step 3: Core Experience Definition
2
+
3
+ ## MANDATORY EXECUTION RULES (READ FIRST):
4
+
5
+ - 🛑 NEVER generate content without user input
6
+
7
+ - 📖 CRITICAL: ALWAYS read the complete step file before taking any action - partial understanding leads to incomplete decisions
8
+ - 🔄 CRITICAL: When loading next step with 'C', ensure the entire file is read and understood before proceeding
9
+ - ✅ ALWAYS treat this as collaborative discovery between UX facilitator and stakeholder
10
+ - 📋 YOU ARE A UX FACILITATOR, not a content generator
11
+ - 💬 FOCUS on defining the core user experience and platform
12
+ - 🎯 COLLABORATIVE discovery, not assumption-based design
13
+ - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
14
+
15
+ ## EXECUTION PROTOCOLS:
16
+
17
+ - 🎯 Show your analysis before taking any action
18
+ - ⚠️ Present A/P/C menu after generating core experience content
19
+ - 💾 ONLY save when user chooses C (Continue)
20
+ - 📖 Update output file frontmatter, adding this step to the end of the list of stepsCompleted.
21
+ - 🚫 FORBIDDEN to load next step until C is selected
22
+
23
+ ## COLLABORATION MENUS (A/P/C):
24
+
25
+ This step will generate content and present choices:
26
+
27
+ - **A (Advanced Elicitation)**: Use discovery protocols to develop deeper experience insights
28
+ - **P (Party Mode)**: Bring multiple perspectives to define optimal user experience
29
+ - **C (Continue)**: Save the content to the document and proceed to next step
30
+
31
+ ## PROTOCOL INTEGRATION:
32
+
33
+ - When 'A' selected: Execute {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml
34
+ - When 'P' selected: Execute {project-root}/_bmad/core/workflows/party-mode/workflow.md
35
+ - PROTOCOLS always return to this step's A/P/C menu
36
+ - User accepts/rejects protocol changes before proceeding
37
+
38
+ ## CONTEXT BOUNDARIES:
39
+
40
+ - Current document and frontmatter from previous steps are available
41
+ - Project understanding from step 2 informs this step
42
+ - No additional data files needed for this step
43
+ - Focus on core experience and platform decisions
44
+
45
+ ## YOUR TASK:
46
+
47
+ Define the core user experience, platform requirements, and what makes the interaction effortless.
48
+
49
+ ## CORE EXPERIENCE DISCOVERY SEQUENCE:
50
+
51
+ ### 1. Define Core User Action
52
+
53
+ Start by identifying the most important user interaction:
54
+ "Now let's dig into the heart of the user experience for {{project_name}}.
55
+
56
+ **Core Experience Questions:**
57
+
58
+ - What's the ONE thing users will do most frequently?
59
+ - What user action is absolutely critical to get right?
60
+ - What should be completely effortless for users?
61
+ - If we nail one interaction, everything else follows - what is it?
62
+
63
+ Think about the core loop or primary action that defines your product's value."
64
+
65
+ ### 2. Explore Platform Requirements
66
+
67
+ Determine where and how users will interact:
68
+ "Let's define the platform context for {{project_name}}:
69
+
70
+ **Platform Questions:**
71
+
72
+ - Web, mobile app, desktop, or multiple platforms?
73
+ - Will this be primarily touch-based or mouse/keyboard?
74
+ - Any specific platform requirements or constraints?
75
+ - Do we need to consider offline functionality?
76
+ - Any device-specific capabilities we should leverage?"
77
+
78
+ ### 3. Identify Effortless Interactions
79
+
80
+ Surface what should feel magical or completely seamless:
81
+ "**Effortless Experience Design:**
82
+
83
+ - What user actions should feel completely natural and require zero thought?
84
+ - Where do users currently struggle with similar products?
85
+ - What interaction, if made effortless, would create delight?
86
+ - What should happen automatically without user intervention?
87
+ - Where can we eliminate steps that competitors require?"
88
+
89
+ ### 4. Define Critical Success Moments
90
+
91
+ Identify the moments that determine success or failure:
92
+ "**Critical Success Moments:**
93
+
94
+ - What's the moment where users realize 'this is better'?
95
+ - When does the user feel successful or accomplished?
96
+ - What interaction, if failed, would ruin the experience?
97
+ - What are the make-or-break user flows?
98
+ - Where does first-time user success happen?"
99
+
100
+ ### 5. Synthesize Experience Principles
101
+
102
+ Extract guiding principles from the conversation:
103
+ "Based on our discussion, I'm hearing these core experience principles for {{project_name}}:
104
+
105
+ **Experience Principles:**
106
+
107
+ - [Principle 1 based on core action focus]
108
+ - [Principle 2 based on effortless interactions]
109
+ - [Principle 3 based on platform considerations]
110
+ - [Principle 4 based on critical success moments]
111
+
112
+ These principles will guide all our UX decisions. Do these capture what's most important?"
113
+
114
+ ### 6. Generate Core Experience Content
115
+
116
+ Prepare the content to append to the document:
117
+
118
+ #### Content Structure:
119
+
120
+ When saving to document, append these Level 2 and Level 3 sections:
121
+
122
+ ```markdown
123
+ ## Core User Experience
124
+
125
+ ### Defining Experience
126
+
127
+ [Core experience definition based on conversation]
128
+
129
+ ### Platform Strategy
130
+
131
+ [Platform requirements and decisions based on conversation]
132
+
133
+ ### Effortless Interactions
134
+
135
+ [Effortless interaction areas identified based on conversation]
136
+
137
+ ### Critical Success Moments
138
+
139
+ [Critical success moments defined based on conversation]
140
+
141
+ ### Experience Principles
142
+
143
+ [Guiding principles for UX decisions based on conversation]
144
+ ```
145
+
146
+ ### 7. Present Content and Menu
147
+
148
+ Show the generated core experience content and present choices:
149
+ "I've defined the core user experience for {{project_name}} based on our conversation. This establishes the foundation for all our UX design decisions.
150
+
151
+ **Here's what I'll add to the document:**
152
+
153
+ [Show the complete markdown content from step 6]
154
+
155
+ **What would you like to do?**
156
+ [A] Advanced Elicitation - Let's refine the core experience definition
157
+ [P] Party Mode - Bring different perspectives on the user experience
158
+ [C] Continue - Save this to the document and move to emotional response definition"
159
+
160
+ ### 8. Handle Menu Selection
161
+
162
+ #### If 'A' (Advanced Elicitation):
163
+
164
+ - Execute {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml with the current core experience content
165
+ - Process the enhanced experience insights that come back
166
+ - Ask user: "Accept these improvements to the core experience definition? (y/n)"
167
+ - If yes: Update content with improvements, then return to A/P/C menu
168
+ - If no: Keep original content, then return to A/P/C menu
169
+
170
+ #### If 'P' (Party Mode):
171
+
172
+ - Execute {project-root}/_bmad/core/workflows/party-mode/workflow.md with the current core experience definition
173
+ - Process the collaborative experience improvements that come back
174
+ - Ask user: "Accept these changes to the core experience definition? (y/n)"
175
+ - If yes: Update content with improvements, then return to A/P/C menu
176
+ - If no: Keep original content, then return to A/P/C menu
177
+
178
+ #### If 'C' (Continue):
179
+
180
+ - Append the final content to `{planning_artifacts}/ux-design-specification.md`
181
+ - Update frontmatter: append step to end of stepsCompleted array
182
+ - Load `./step-04-emotional-response.md`
183
+
184
+ ## APPEND TO DOCUMENT:
185
+
186
+ When user selects 'C', append the content directly to the document using the structure from step 6.
187
+
188
+ ## SUCCESS METRICS:
189
+
190
+ ✅ Core user action clearly identified and defined
191
+ ✅ Platform requirements thoroughly explored
192
+ ✅ Effortless interaction areas identified
193
+ ✅ Critical success moments mapped out
194
+ ✅ Experience principles established as guiding framework
195
+ ✅ A/P/C menu presented and handled correctly
196
+ ✅ Content properly appended to document when C selected
197
+
198
+ ## FAILURE MODES:
199
+
200
+ ❌ Missing the core user action that defines the product
201
+ ❌ Not properly considering platform requirements
202
+ ❌ Overlooking what should be effortless for users
203
+ ❌ Not identifying critical make-or-break interactions
204
+ ❌ Experience principles too generic or not actionable
205
+ ❌ Not presenting A/P/C menu after content generation
206
+ ❌ Appending content without user selecting 'C'
207
+
208
+ ❌ **CRITICAL**: Reading only partial step file - leads to incomplete understanding and poor decisions
209
+ ❌ **CRITICAL**: Proceeding with 'C' without fully reading and understanding the next step file
210
+ ❌ **CRITICAL**: Making decisions without complete understanding of step requirements and protocols
211
+
212
+ ## NEXT STEP:
213
+
214
+ After user selects 'C' and content is saved to document, load `./step-04-emotional-response.md` to define desired emotional responses.
215
+
216
+ Remember: Do NOT proceed to step-04 until user explicitly selects 'C' from the A/P/C menu and content is saved!