observer-ggboy-bmad-method 6.0.0-alpha.23

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (604) hide show
  1. package/.coderabbit.yaml +40 -0
  2. package/.github/CODE_OF_CONDUCT.md +128 -0
  3. package/.github/FUNDING.yaml +15 -0
  4. package/.github/ISSUE_TEMPLATE/config.yaml +8 -0
  5. package/.github/ISSUE_TEMPLATE/feature_request.md +22 -0
  6. package/.github/ISSUE_TEMPLATE/issue.md +32 -0
  7. package/.github/scripts/discord-helpers.sh +34 -0
  8. package/.github/workflows/bundle-latest.yaml +330 -0
  9. package/.github/workflows/discord.yaml +90 -0
  10. package/.github/workflows/docs.yaml +63 -0
  11. package/.github/workflows/manual-release.yaml +190 -0
  12. package/.github/workflows/quality.yaml +115 -0
  13. package/.health-status.json +7 -0
  14. package/.husky/pre-commit +20 -0
  15. package/.markdownlint-cli2.yaml +41 -0
  16. package/.nvmrc +1 -0
  17. package/.prettierignore +9 -0
  18. package/.vscode/settings.json +97 -0
  19. package/CHANGELOG.md +1394 -0
  20. package/CNAME +1 -0
  21. package/CONTRIBUTING.md +167 -0
  22. package/CONTRIBUTORS.md +32 -0
  23. package/LICENSE +30 -0
  24. package/README.md +100 -0
  25. package/SECURITY.md +85 -0
  26. package/TRADEMARK.md +55 -0
  27. package/Wordmark.png +0 -0
  28. package/banner-bmad-method.png +0 -0
  29. package/bmad-method-6.0.0-alpha.23.tgz +0 -0
  30. package/docs/404.md +9 -0
  31. package/docs/_README_WORKFLOW_DIAGRAMS.md +40 -0
  32. package/docs/_STYLE_GUIDE.md +367 -0
  33. package/docs/_archive/customize-workflows.md +30 -0
  34. package/docs/_archive/getting-started-bmadv4.md +247 -0
  35. package/docs/_archive/vendor-workflows.md +52 -0
  36. package/docs/downloads.md +72 -0
  37. package/docs/explanation/agents/barry-quick-flow.md +328 -0
  38. package/docs/explanation/agents/index.md +19 -0
  39. package/docs/explanation/architecture/four-phases.md +107 -0
  40. package/docs/explanation/architecture/preventing-agent-conflicts.md +111 -0
  41. package/docs/explanation/architecture/why-solutioning-matters.md +75 -0
  42. package/docs/explanation/bmm/index.md +131 -0
  43. package/docs/explanation/core/index.md +18 -0
  44. package/docs/explanation/core-concepts/agent-roles.md +179 -0
  45. package/docs/explanation/core-concepts/index.md +35 -0
  46. package/docs/explanation/core-concepts/what-are-agents.md +97 -0
  47. package/docs/explanation/core-concepts/what-are-modules.md +85 -0
  48. package/docs/explanation/core-concepts/what-are-workflows.md +204 -0
  49. package/docs/explanation/faq/brownfield-faq.md +73 -0
  50. package/docs/explanation/faq/getting-started-faq.md +67 -0
  51. package/docs/explanation/faq/implementation-faq.md +52 -0
  52. package/docs/explanation/faq/index.md +16 -0
  53. package/docs/explanation/faq/levels-and-tracks-faq.md +52 -0
  54. package/docs/explanation/faq/planning-faq.md +41 -0
  55. package/docs/explanation/faq/tools-faq.md +277 -0
  56. package/docs/explanation/faq/workflows-faq.md +61 -0
  57. package/docs/explanation/features/advanced-elicitation.md +95 -0
  58. package/docs/explanation/features/brainstorming-techniques.md +92 -0
  59. package/docs/explanation/features/party-mode.md +95 -0
  60. package/docs/explanation/features/quick-flow.md +149 -0
  61. package/docs/explanation/features/tea-overview.md +410 -0
  62. package/docs/explanation/features/web-bundles.md +34 -0
  63. package/docs/explanation/philosophy/facilitation-over-generation.md +333 -0
  64. package/docs/explanation/philosophy/testing-as-engineering.md +112 -0
  65. package/docs/explanation/tea/engagement-models.md +710 -0
  66. package/docs/explanation/tea/fixture-architecture.md +457 -0
  67. package/docs/explanation/tea/knowledge-base-system.md +554 -0
  68. package/docs/explanation/tea/network-first-patterns.md +853 -0
  69. package/docs/explanation/tea/risk-based-testing.md +586 -0
  70. package/docs/explanation/tea/test-quality-standards.md +907 -0
  71. package/docs/how-to/brownfield/add-feature-to-existing.md +74 -0
  72. package/docs/how-to/brownfield/document-existing-project.md +66 -0
  73. package/docs/how-to/brownfield/index.md +84 -0
  74. package/docs/how-to/brownfield/quick-fix-in-brownfield.md +77 -0
  75. package/docs/how-to/brownfield/use-tea-for-enterprise.md +525 -0
  76. package/docs/how-to/brownfield/use-tea-with-existing-tests.md +577 -0
  77. package/docs/how-to/customization/customize-agents.md +212 -0
  78. package/docs/how-to/customization/enable-tea-mcp-enhancements.md +424 -0
  79. package/docs/how-to/customization/index.md +23 -0
  80. package/docs/how-to/customization/integrate-playwright-utils.md +813 -0
  81. package/docs/how-to/customization/shard-large-documents.md +101 -0
  82. package/docs/how-to/get-answers-about-bmad.md +102 -0
  83. package/docs/how-to/installation/index.md +12 -0
  84. package/docs/how-to/installation/install-bmad.md +111 -0
  85. package/docs/how-to/installation/install-custom-modules.md +118 -0
  86. package/docs/how-to/installation/upgrade-to-v6.md +131 -0
  87. package/docs/how-to/workflows/bmgd-quick-flow.md +156 -0
  88. package/docs/how-to/workflows/conduct-research.md +97 -0
  89. package/docs/how-to/workflows/create-architecture.md +119 -0
  90. package/docs/how-to/workflows/create-epics-and-stories.md +109 -0
  91. package/docs/how-to/workflows/create-prd.md +91 -0
  92. package/docs/how-to/workflows/create-product-brief.md +94 -0
  93. package/docs/how-to/workflows/create-story.md +102 -0
  94. package/docs/how-to/workflows/create-ux-design.md +100 -0
  95. package/docs/how-to/workflows/implement-story.md +97 -0
  96. package/docs/how-to/workflows/quick-spec.md +122 -0
  97. package/docs/how-to/workflows/run-atdd.md +436 -0
  98. package/docs/how-to/workflows/run-automate.md +653 -0
  99. package/docs/how-to/workflows/run-brainstorming-session.md +73 -0
  100. package/docs/how-to/workflows/run-code-review.md +89 -0
  101. package/docs/how-to/workflows/run-implementation-readiness.md +125 -0
  102. package/docs/how-to/workflows/run-nfr-assess.md +679 -0
  103. package/docs/how-to/workflows/run-sprint-planning.md +94 -0
  104. package/docs/how-to/workflows/run-test-design.md +135 -0
  105. package/docs/how-to/workflows/run-test-review.md +605 -0
  106. package/docs/how-to/workflows/run-trace.md +883 -0
  107. package/docs/how-to/workflows/setup-ci.md +712 -0
  108. package/docs/how-to/workflows/setup-party-mode.md +89 -0
  109. package/docs/how-to/workflows/setup-test-framework.md +98 -0
  110. package/docs/index.md +63 -0
  111. package/docs/reference/agents/index.md +109 -0
  112. package/docs/reference/configuration/core-tasks.md +67 -0
  113. package/docs/reference/configuration/global-config.md +28 -0
  114. package/docs/reference/glossary/index.md +159 -0
  115. package/docs/reference/tea/commands.md +276 -0
  116. package/docs/reference/tea/configuration.md +678 -0
  117. package/docs/reference/tea/knowledge-base.md +340 -0
  118. package/docs/reference/workflows/core-workflows.md +32 -0
  119. package/docs/reference/workflows/document-project.md +73 -0
  120. package/docs/reference/workflows/index.md +12 -0
  121. package/docs/tutorials/getting-started/getting-started-bmadv6.md +246 -0
  122. package/docs/tutorials/getting-started/images/workflow-method-greenfield.excalidraw +5034 -0
  123. package/docs/tutorials/getting-started/images/workflow-method-greenfield.svg +4 -0
  124. package/docs/tutorials/getting-started/images/workflow-overview.jpg +0 -0
  125. package/docs/tutorials/getting-started/tea-lite-quickstart.md +444 -0
  126. package/docs/tutorials/getting-started/workflow-overview.jpg +0 -0
  127. package/eslint.config.mjs +152 -0
  128. package/package.json +117 -0
  129. package/prettier.config.mjs +32 -0
  130. package/src/bmm/_module-installer/installer.js +48 -0
  131. package/src/bmm/_module-installer/platform-specifics/claude-code.js +35 -0
  132. package/src/bmm/_module-installer/platform-specifics/windsurf.js +32 -0
  133. package/src/bmm/agents/analyst.agent.yaml +36 -0
  134. package/src/bmm/agents/architect.agent.yaml +28 -0
  135. package/src/bmm/agents/dev.agent.yaml +38 -0
  136. package/src/bmm/agents/pm.agent.yaml +46 -0
  137. package/src/bmm/agents/quick-flow-solo-dev.agent.yaml +32 -0
  138. package/src/bmm/agents/sm.agent.yaml +36 -0
  139. package/src/bmm/agents/tea.agent.yaml +63 -0
  140. package/src/bmm/agents/tech-writer/tech-writer-sidecar/documentation-standards.md +224 -0
  141. package/src/bmm/agents/tech-writer/tech-writer.agent.yaml +45 -0
  142. package/src/bmm/agents/ux-designer.agent.yaml +26 -0
  143. package/src/bmm/data/project-context-template.md +26 -0
  144. package/src/bmm/module-help.csv +32 -0
  145. package/src/bmm/module.yaml +44 -0
  146. package/src/bmm/sub-modules/claude-code/config.yaml +4 -0
  147. package/src/bmm/sub-modules/claude-code/injections.yaml +242 -0
  148. package/src/bmm/sub-modules/claude-code/readme.md +87 -0
  149. package/src/bmm/teams/default-party.csv +21 -0
  150. package/src/bmm/teams/team-fullstack.yaml +12 -0
  151. package/src/bmm/testarch/knowledge/adr-quality-readiness-checklist.md +350 -0
  152. package/src/bmm/testarch/knowledge/api-request.md +442 -0
  153. package/src/bmm/testarch/knowledge/api-testing-patterns.md +843 -0
  154. package/src/bmm/testarch/knowledge/auth-session.md +552 -0
  155. package/src/bmm/testarch/knowledge/burn-in.md +273 -0
  156. package/src/bmm/testarch/knowledge/ci-burn-in.md +675 -0
  157. package/src/bmm/testarch/knowledge/component-tdd.md +486 -0
  158. package/src/bmm/testarch/knowledge/contract-testing.md +957 -0
  159. package/src/bmm/testarch/knowledge/data-factories.md +500 -0
  160. package/src/bmm/testarch/knowledge/email-auth.md +721 -0
  161. package/src/bmm/testarch/knowledge/error-handling.md +725 -0
  162. package/src/bmm/testarch/knowledge/feature-flags.md +750 -0
  163. package/src/bmm/testarch/knowledge/file-utils.md +463 -0
  164. package/src/bmm/testarch/knowledge/fixture-architecture.md +401 -0
  165. package/src/bmm/testarch/knowledge/fixtures-composition.md +382 -0
  166. package/src/bmm/testarch/knowledge/intercept-network-call.md +430 -0
  167. package/src/bmm/testarch/knowledge/log.md +429 -0
  168. package/src/bmm/testarch/knowledge/network-error-monitor.md +405 -0
  169. package/src/bmm/testarch/knowledge/network-first.md +486 -0
  170. package/src/bmm/testarch/knowledge/network-recorder.md +527 -0
  171. package/src/bmm/testarch/knowledge/nfr-criteria.md +670 -0
  172. package/src/bmm/testarch/knowledge/overview.md +286 -0
  173. package/src/bmm/testarch/knowledge/playwright-config.md +730 -0
  174. package/src/bmm/testarch/knowledge/probability-impact.md +601 -0
  175. package/src/bmm/testarch/knowledge/recurse.md +421 -0
  176. package/src/bmm/testarch/knowledge/risk-governance.md +615 -0
  177. package/src/bmm/testarch/knowledge/selective-testing.md +732 -0
  178. package/src/bmm/testarch/knowledge/selector-resilience.md +527 -0
  179. package/src/bmm/testarch/knowledge/test-healing-patterns.md +644 -0
  180. package/src/bmm/testarch/knowledge/test-levels-framework.md +473 -0
  181. package/src/bmm/testarch/knowledge/test-priorities-matrix.md +373 -0
  182. package/src/bmm/testarch/knowledge/test-quality.md +664 -0
  183. package/src/bmm/testarch/knowledge/timing-debugging.md +372 -0
  184. package/src/bmm/testarch/knowledge/visual-debugging.md +524 -0
  185. package/src/bmm/testarch/tea-index.csv +35 -0
  186. package/src/bmm/workflows/1-analysis/create-product-brief/product-brief.template.md +10 -0
  187. package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-01-init.md +177 -0
  188. package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-01b-continue.md +161 -0
  189. package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-02-vision.md +199 -0
  190. package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-03-users.md +202 -0
  191. package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-04-metrics.md +205 -0
  192. package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-05-scope.md +219 -0
  193. package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-06-complete.md +162 -0
  194. package/src/bmm/workflows/1-analysis/create-product-brief/workflow.md +58 -0
  195. package/src/bmm/workflows/1-analysis/research/domain-steps/step-01-init.md +137 -0
  196. package/src/bmm/workflows/1-analysis/research/domain-steps/step-02-domain-analysis.md +229 -0
  197. package/src/bmm/workflows/1-analysis/research/domain-steps/step-03-competitive-landscape.md +238 -0
  198. package/src/bmm/workflows/1-analysis/research/domain-steps/step-04-regulatory-focus.md +206 -0
  199. package/src/bmm/workflows/1-analysis/research/domain-steps/step-05-technical-trends.md +234 -0
  200. package/src/bmm/workflows/1-analysis/research/domain-steps/step-06-research-synthesis.md +443 -0
  201. package/src/bmm/workflows/1-analysis/research/market-steps/step-01-init.md +182 -0
  202. package/src/bmm/workflows/1-analysis/research/market-steps/step-02-customer-behavior.md +237 -0
  203. package/src/bmm/workflows/1-analysis/research/market-steps/step-02-customer-insights.md +200 -0
  204. package/src/bmm/workflows/1-analysis/research/market-steps/step-03-customer-pain-points.md +249 -0
  205. package/src/bmm/workflows/1-analysis/research/market-steps/step-04-customer-decisions.md +259 -0
  206. package/src/bmm/workflows/1-analysis/research/market-steps/step-05-competitive-analysis.md +177 -0
  207. package/src/bmm/workflows/1-analysis/research/market-steps/step-06-research-completion.md +475 -0
  208. package/src/bmm/workflows/1-analysis/research/research.template.md +29 -0
  209. package/src/bmm/workflows/1-analysis/research/technical-steps/step-01-init.md +137 -0
  210. package/src/bmm/workflows/1-analysis/research/technical-steps/step-02-technical-overview.md +239 -0
  211. package/src/bmm/workflows/1-analysis/research/technical-steps/step-03-integration-patterns.md +248 -0
  212. package/src/bmm/workflows/1-analysis/research/technical-steps/step-04-architectural-patterns.md +202 -0
  213. package/src/bmm/workflows/1-analysis/research/technical-steps/step-05-implementation-research.md +239 -0
  214. package/src/bmm/workflows/1-analysis/research/technical-steps/step-06-research-synthesis.md +486 -0
  215. package/src/bmm/workflows/1-analysis/research/workflow.md +173 -0
  216. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-01-init.md +135 -0
  217. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-01b-continue.md +127 -0
  218. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-02-discovery.md +190 -0
  219. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-03-core-experience.md +216 -0
  220. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-04-emotional-response.md +219 -0
  221. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-05-inspiration.md +234 -0
  222. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-06-design-system.md +252 -0
  223. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-07-defining-experience.md +254 -0
  224. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-08-visual-foundation.md +224 -0
  225. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-09-design-directions.md +224 -0
  226. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-10-user-journeys.md +241 -0
  227. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-11-component-strategy.md +248 -0
  228. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-12-ux-patterns.md +237 -0
  229. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-13-responsive-accessibility.md +264 -0
  230. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-14-complete.md +171 -0
  231. package/src/bmm/workflows/2-plan-workflows/create-ux-design/ux-design-template.md +13 -0
  232. package/src/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md +43 -0
  233. package/src/bmm/workflows/2-plan-workflows/prd/data/domain-complexity.csv +13 -0
  234. package/src/bmm/workflows/2-plan-workflows/prd/data/prd-purpose.md +197 -0
  235. package/src/bmm/workflows/2-plan-workflows/prd/data/project-types.csv +11 -0
  236. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-01-init.md +191 -0
  237. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-01b-continue.md +153 -0
  238. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-02-discovery.md +224 -0
  239. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-03-success.md +226 -0
  240. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-04-journeys.md +213 -0
  241. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-05-domain.md +207 -0
  242. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-06-innovation.md +226 -0
  243. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-07-project-type.md +237 -0
  244. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-08-scoping.md +228 -0
  245. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-09-functional.md +231 -0
  246. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-10-nonfunctional.md +242 -0
  247. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-11-polish.md +217 -0
  248. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-12-complete.md +124 -0
  249. package/src/bmm/workflows/2-plan-workflows/prd/steps-e/step-e-01-discovery.md +247 -0
  250. package/src/bmm/workflows/2-plan-workflows/prd/steps-e/step-e-01b-legacy-conversion.md +208 -0
  251. package/src/bmm/workflows/2-plan-workflows/prd/steps-e/step-e-02-review.md +249 -0
  252. package/src/bmm/workflows/2-plan-workflows/prd/steps-e/step-e-03-edit.md +253 -0
  253. package/src/bmm/workflows/2-plan-workflows/prd/steps-e/step-e-04-complete.md +168 -0
  254. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-01-discovery.md +218 -0
  255. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-02-format-detection.md +191 -0
  256. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-02b-parity-check.md +209 -0
  257. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-03-density-validation.md +174 -0
  258. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-04-brief-coverage-validation.md +214 -0
  259. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-05-measurability-validation.md +228 -0
  260. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-06-traceability-validation.md +217 -0
  261. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-07-implementation-leakage-validation.md +205 -0
  262. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-08-domain-compliance-validation.md +243 -0
  263. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-09-project-type-validation.md +263 -0
  264. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-10-smart-validation.md +209 -0
  265. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-11-holistic-quality-validation.md +264 -0
  266. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-12-completeness-validation.md +242 -0
  267. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-13-report-complete.md +231 -0
  268. package/src/bmm/workflows/2-plan-workflows/prd/templates/prd-template.md +10 -0
  269. package/src/bmm/workflows/2-plan-workflows/prd/validation-report-prd-workflow.md +433 -0
  270. package/src/bmm/workflows/2-plan-workflows/prd/workflow.md +150 -0
  271. package/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-01-document-discovery.md +190 -0
  272. package/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-02-prd-analysis.md +178 -0
  273. package/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-03-epic-coverage-validation.md +179 -0
  274. package/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-04-ux-alignment.md +139 -0
  275. package/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-05-epic-quality-review.md +252 -0
  276. package/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-06-final-assessment.md +135 -0
  277. package/src/bmm/workflows/3-solutioning/check-implementation-readiness/templates/readiness-report-template.md +4 -0
  278. package/src/bmm/workflows/3-solutioning/check-implementation-readiness/workflow.md +55 -0
  279. package/src/bmm/workflows/3-solutioning/create-architecture/architecture-decision-template.md +12 -0
  280. package/src/bmm/workflows/3-solutioning/create-architecture/data/domain-complexity.csv +11 -0
  281. package/src/bmm/workflows/3-solutioning/create-architecture/data/project-types.csv +7 -0
  282. package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-01-init.md +153 -0
  283. package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-01b-continue.md +164 -0
  284. package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-02-context.md +224 -0
  285. package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-03-starter.md +331 -0
  286. package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-04-decisions.md +318 -0
  287. package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-05-patterns.md +359 -0
  288. package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-06-structure.md +379 -0
  289. package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-07-validation.md +359 -0
  290. package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-08-complete.md +76 -0
  291. package/src/bmm/workflows/3-solutioning/create-architecture/workflow.md +50 -0
  292. package/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-01-validate-prerequisites.md +259 -0
  293. package/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-02-design-epics.md +233 -0
  294. package/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-03-create-stories.md +272 -0
  295. package/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-04-final-validation.md +149 -0
  296. package/src/bmm/workflows/3-solutioning/create-epics-and-stories/templates/epics-template.md +57 -0
  297. package/src/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md +59 -0
  298. package/src/bmm/workflows/4-implementation/code-review/checklist.md +23 -0
  299. package/src/bmm/workflows/4-implementation/code-review/instructions.xml +227 -0
  300. package/src/bmm/workflows/4-implementation/code-review/workflow.yaml +51 -0
  301. package/src/bmm/workflows/4-implementation/correct-course/checklist.md +288 -0
  302. package/src/bmm/workflows/4-implementation/correct-course/instructions.md +206 -0
  303. package/src/bmm/workflows/4-implementation/correct-course/workflow.yaml +60 -0
  304. package/src/bmm/workflows/4-implementation/create-story/checklist.md +358 -0
  305. package/src/bmm/workflows/4-implementation/create-story/instructions.xml +345 -0
  306. package/src/bmm/workflows/4-implementation/create-story/template.md +49 -0
  307. package/src/bmm/workflows/4-implementation/create-story/workflow.yaml +61 -0
  308. package/src/bmm/workflows/4-implementation/dev-story/checklist.md +80 -0
  309. package/src/bmm/workflows/4-implementation/dev-story/instructions.xml +410 -0
  310. package/src/bmm/workflows/4-implementation/dev-story/workflow.yaml +27 -0
  311. package/src/bmm/workflows/4-implementation/retrospective/instructions.md +1443 -0
  312. package/src/bmm/workflows/4-implementation/retrospective/workflow.yaml +58 -0
  313. package/src/bmm/workflows/4-implementation/sprint-planning/checklist.md +33 -0
  314. package/src/bmm/workflows/4-implementation/sprint-planning/instructions.md +225 -0
  315. package/src/bmm/workflows/4-implementation/sprint-planning/sprint-status-template.yaml +55 -0
  316. package/src/bmm/workflows/4-implementation/sprint-planning/workflow.yaml +54 -0
  317. package/src/bmm/workflows/4-implementation/sprint-status/instructions.md +229 -0
  318. package/src/bmm/workflows/4-implementation/sprint-status/workflow.yaml +36 -0
  319. package/src/bmm/workflows/bmad-quick-flow/quick-dev/data/project-levels.yaml +59 -0
  320. package/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-01-mode-detection.md +156 -0
  321. package/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-02-context-gathering.md +120 -0
  322. package/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-03-execute.md +113 -0
  323. package/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-04-self-check.md +113 -0
  324. package/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-05-adversarial-review.md +106 -0
  325. package/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-06-resolve-findings.md +140 -0
  326. package/src/bmm/workflows/bmad-quick-flow/quick-dev/workflow.md +50 -0
  327. package/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-01-understand.md +189 -0
  328. package/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-02-investigate.md +144 -0
  329. package/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-03-generate.md +128 -0
  330. package/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-04-review.md +191 -0
  331. package/src/bmm/workflows/bmad-quick-flow/quick-spec/tech-spec-template.md +74 -0
  332. package/src/bmm/workflows/bmad-quick-flow/quick-spec/workflow.md +79 -0
  333. package/src/bmm/workflows/document-project/checklist.md +245 -0
  334. package/src/bmm/workflows/document-project/documentation-requirements.csv +12 -0
  335. package/src/bmm/workflows/document-project/instructions.md +221 -0
  336. package/src/bmm/workflows/document-project/templates/deep-dive-template.md +345 -0
  337. package/src/bmm/workflows/document-project/templates/index-template.md +169 -0
  338. package/src/bmm/workflows/document-project/templates/project-overview-template.md +103 -0
  339. package/src/bmm/workflows/document-project/templates/project-scan-report-schema.json +160 -0
  340. package/src/bmm/workflows/document-project/templates/source-tree-template.md +135 -0
  341. package/src/bmm/workflows/document-project/workflow.yaml +30 -0
  342. package/src/bmm/workflows/document-project/workflows/deep-dive-instructions.md +298 -0
  343. package/src/bmm/workflows/document-project/workflows/deep-dive.yaml +31 -0
  344. package/src/bmm/workflows/document-project/workflows/full-scan-instructions.md +1106 -0
  345. package/src/bmm/workflows/document-project/workflows/full-scan.yaml +31 -0
  346. package/src/bmm/workflows/excalidraw-diagrams/_shared/excalidraw-library.json +90 -0
  347. package/src/bmm/workflows/excalidraw-diagrams/_shared/excalidraw-templates.yaml +127 -0
  348. package/src/bmm/workflows/excalidraw-diagrams/create-dataflow/checklist.md +39 -0
  349. package/src/bmm/workflows/excalidraw-diagrams/create-dataflow/instructions.md +130 -0
  350. package/src/bmm/workflows/excalidraw-diagrams/create-dataflow/workflow.yaml +27 -0
  351. package/src/bmm/workflows/excalidraw-diagrams/create-diagram/checklist.md +43 -0
  352. package/src/bmm/workflows/excalidraw-diagrams/create-diagram/instructions.md +141 -0
  353. package/src/bmm/workflows/excalidraw-diagrams/create-diagram/workflow.yaml +27 -0
  354. package/src/bmm/workflows/excalidraw-diagrams/create-flowchart/checklist.md +49 -0
  355. package/src/bmm/workflows/excalidraw-diagrams/create-flowchart/instructions.md +241 -0
  356. package/src/bmm/workflows/excalidraw-diagrams/create-flowchart/workflow.yaml +27 -0
  357. package/src/bmm/workflows/excalidraw-diagrams/create-wireframe/checklist.md +38 -0
  358. package/src/bmm/workflows/excalidraw-diagrams/create-wireframe/instructions.md +133 -0
  359. package/src/bmm/workflows/excalidraw-diagrams/create-wireframe/workflow.yaml +27 -0
  360. package/src/bmm/workflows/testarch/atdd/atdd-checklist-template.md +363 -0
  361. package/src/bmm/workflows/testarch/atdd/checklist.md +374 -0
  362. package/src/bmm/workflows/testarch/atdd/instructions.md +806 -0
  363. package/src/bmm/workflows/testarch/atdd/workflow.yaml +47 -0
  364. package/src/bmm/workflows/testarch/automate/checklist.md +582 -0
  365. package/src/bmm/workflows/testarch/automate/instructions.md +1324 -0
  366. package/src/bmm/workflows/testarch/automate/workflow.yaml +54 -0
  367. package/src/bmm/workflows/testarch/ci/checklist.md +247 -0
  368. package/src/bmm/workflows/testarch/ci/github-actions-template.yaml +198 -0
  369. package/src/bmm/workflows/testarch/ci/gitlab-ci-template.yaml +149 -0
  370. package/src/bmm/workflows/testarch/ci/instructions.md +536 -0
  371. package/src/bmm/workflows/testarch/ci/workflow.yaml +47 -0
  372. package/src/bmm/workflows/testarch/framework/checklist.md +320 -0
  373. package/src/bmm/workflows/testarch/framework/instructions.md +481 -0
  374. package/src/bmm/workflows/testarch/framework/workflow.yaml +49 -0
  375. package/src/bmm/workflows/testarch/nfr-assess/checklist.md +407 -0
  376. package/src/bmm/workflows/testarch/nfr-assess/instructions.md +726 -0
  377. package/src/bmm/workflows/testarch/nfr-assess/nfr-report-template.md +461 -0
  378. package/src/bmm/workflows/testarch/nfr-assess/workflow.yaml +49 -0
  379. package/src/bmm/workflows/testarch/test-design/checklist.md +407 -0
  380. package/src/bmm/workflows/testarch/test-design/instructions.md +1158 -0
  381. package/src/bmm/workflows/testarch/test-design/test-design-architecture-template.md +213 -0
  382. package/src/bmm/workflows/testarch/test-design/test-design-qa-template.md +286 -0
  383. package/src/bmm/workflows/testarch/test-design/test-design-template.md +294 -0
  384. package/src/bmm/workflows/testarch/test-design/workflow.yaml +71 -0
  385. package/src/bmm/workflows/testarch/test-review/checklist.md +472 -0
  386. package/src/bmm/workflows/testarch/test-review/instructions.md +628 -0
  387. package/src/bmm/workflows/testarch/test-review/test-review-template.md +390 -0
  388. package/src/bmm/workflows/testarch/test-review/workflow.yaml +48 -0
  389. package/src/bmm/workflows/testarch/trace/checklist.md +642 -0
  390. package/src/bmm/workflows/testarch/trace/instructions.md +1030 -0
  391. package/src/bmm/workflows/testarch/trace/trace-template.md +675 -0
  392. package/src/bmm/workflows/testarch/trace/workflow.yaml +57 -0
  393. package/src/core/_module-installer/installer.js +60 -0
  394. package/src/core/agents/bmad-master.agent.yaml +29 -0
  395. package/src/core/module-help.csv +9 -0
  396. package/src/core/module.yaml +25 -0
  397. package/src/core/resources/excalidraw/README.md +160 -0
  398. package/src/core/resources/excalidraw/excalidraw-helpers.md +127 -0
  399. package/src/core/resources/excalidraw/library-loader.md +50 -0
  400. package/src/core/resources/excalidraw/validate-json-instructions.md +79 -0
  401. package/src/core/tasks/editorial-review-prose.xml +100 -0
  402. package/src/core/tasks/editorial-review-structure.xml +209 -0
  403. package/src/core/tasks/help.md +62 -0
  404. package/src/core/tasks/index-docs.xml +65 -0
  405. package/src/core/tasks/review-adversarial-general.xml +48 -0
  406. package/src/core/tasks/shard-doc.xml +109 -0
  407. package/src/core/tasks/workflow.xml +235 -0
  408. package/src/core/workflows/advanced-elicitation/methods.csv +51 -0
  409. package/src/core/workflows/advanced-elicitation/workflow.xml +117 -0
  410. package/src/core/workflows/brainstorming/brain-methods.csv +62 -0
  411. package/src/core/workflows/brainstorming/steps/step-01-session-setup.md +197 -0
  412. package/src/core/workflows/brainstorming/steps/step-01b-continue.md +122 -0
  413. package/src/core/workflows/brainstorming/steps/step-02a-user-selected.md +225 -0
  414. package/src/core/workflows/brainstorming/steps/step-02b-ai-recommended.md +237 -0
  415. package/src/core/workflows/brainstorming/steps/step-02c-random-selection.md +209 -0
  416. package/src/core/workflows/brainstorming/steps/step-02d-progressive-flow.md +264 -0
  417. package/src/core/workflows/brainstorming/steps/step-03-technique-execution.md +399 -0
  418. package/src/core/workflows/brainstorming/steps/step-04-idea-organization.md +303 -0
  419. package/src/core/workflows/brainstorming/template.md +15 -0
  420. package/src/core/workflows/brainstorming/workflow.md +58 -0
  421. package/src/core/workflows/party-mode/steps/step-01-agent-loading.md +138 -0
  422. package/src/core/workflows/party-mode/steps/step-02-discussion-orchestration.md +187 -0
  423. package/src/core/workflows/party-mode/steps/step-03-graceful-exit.md +157 -0
  424. package/src/core/workflows/party-mode/workflow.md +194 -0
  425. package/src/utility/agent-components/activation-rules.txt +6 -0
  426. package/src/utility/agent-components/activation-steps.txt +14 -0
  427. package/src/utility/agent-components/agent-command-header.md +1 -0
  428. package/src/utility/agent-components/agent.customize.template.yaml +41 -0
  429. package/src/utility/agent-components/handler-action.txt +4 -0
  430. package/src/utility/agent-components/handler-data.txt +5 -0
  431. package/src/utility/agent-components/handler-exec.txt +6 -0
  432. package/src/utility/agent-components/handler-multi.txt +14 -0
  433. package/src/utility/agent-components/handler-tmpl.txt +5 -0
  434. package/src/utility/agent-components/handler-validate-workflow.txt +7 -0
  435. package/src/utility/agent-components/handler-workflow.txt +10 -0
  436. package/src/utility/agent-components/menu-handlers.txt +6 -0
  437. package/test/README.md +295 -0
  438. package/test/adversarial-review-tests/README.md +56 -0
  439. package/test/adversarial-review-tests/sample-content.md +46 -0
  440. package/test/adversarial-review-tests/test-cases.yaml +103 -0
  441. package/test/fixtures/agent-schema/invalid/critical-actions/actions-as-string.agent.yaml +27 -0
  442. package/test/fixtures/agent-schema/invalid/critical-actions/empty-string-in-actions.agent.yaml +30 -0
  443. package/test/fixtures/agent-schema/invalid/menu/empty-menu.agent.yaml +22 -0
  444. package/test/fixtures/agent-schema/invalid/menu/missing-menu.agent.yaml +20 -0
  445. package/test/fixtures/agent-schema/invalid/menu-commands/empty-command-target.agent.yaml +25 -0
  446. package/test/fixtures/agent-schema/invalid/menu-commands/no-command-target.agent.yaml +24 -0
  447. package/test/fixtures/agent-schema/invalid/menu-triggers/camel-case.agent.yaml +25 -0
  448. package/test/fixtures/agent-schema/invalid/menu-triggers/compound-invalid-format.agent.yaml +25 -0
  449. package/test/fixtures/agent-schema/invalid/menu-triggers/compound-mismatched-kebab.agent.yaml +25 -0
  450. package/test/fixtures/agent-schema/invalid/menu-triggers/duplicate-triggers.agent.yaml +31 -0
  451. package/test/fixtures/agent-schema/invalid/menu-triggers/empty-trigger.agent.yaml +25 -0
  452. package/test/fixtures/agent-schema/invalid/menu-triggers/leading-asterisk.agent.yaml +25 -0
  453. package/test/fixtures/agent-schema/invalid/menu-triggers/snake-case.agent.yaml +25 -0
  454. package/test/fixtures/agent-schema/invalid/menu-triggers/trigger-with-spaces.agent.yaml +25 -0
  455. package/test/fixtures/agent-schema/invalid/metadata/empty-module-string.agent.yaml +26 -0
  456. package/test/fixtures/agent-schema/invalid/metadata/empty-name.agent.yaml +24 -0
  457. package/test/fixtures/agent-schema/invalid/metadata/extra-metadata-fields.agent.yaml +27 -0
  458. package/test/fixtures/agent-schema/invalid/metadata/missing-id.agent.yaml +23 -0
  459. package/test/fixtures/agent-schema/invalid/persona/empty-principles-array.agent.yaml +24 -0
  460. package/test/fixtures/agent-schema/invalid/persona/empty-string-in-principles.agent.yaml +27 -0
  461. package/test/fixtures/agent-schema/invalid/persona/extra-persona-fields.agent.yaml +27 -0
  462. package/test/fixtures/agent-schema/invalid/persona/missing-role.agent.yaml +24 -0
  463. package/test/fixtures/agent-schema/invalid/prompts/empty-content.agent.yaml +29 -0
  464. package/test/fixtures/agent-schema/invalid/prompts/extra-prompt-fields.agent.yaml +31 -0
  465. package/test/fixtures/agent-schema/invalid/prompts/missing-content.agent.yaml +28 -0
  466. package/test/fixtures/agent-schema/invalid/prompts/missing-id.agent.yaml +28 -0
  467. package/test/fixtures/agent-schema/invalid/top-level/empty-file.agent.yaml +5 -0
  468. package/test/fixtures/agent-schema/invalid/top-level/extra-top-level-keys.agent.yaml +28 -0
  469. package/test/fixtures/agent-schema/invalid/top-level/missing-agent-key.agent.yaml +11 -0
  470. package/test/fixtures/agent-schema/invalid/yaml-errors/invalid-indentation.agent.yaml +19 -0
  471. package/test/fixtures/agent-schema/invalid/yaml-errors/malformed-yaml.agent.yaml +18 -0
  472. package/test/fixtures/agent-schema/valid/critical-actions/empty-critical-actions.agent.yaml +24 -0
  473. package/test/fixtures/agent-schema/valid/critical-actions/no-critical-actions.agent.yaml +22 -0
  474. package/test/fixtures/agent-schema/valid/critical-actions/valid-critical-actions.agent.yaml +27 -0
  475. package/test/fixtures/agent-schema/valid/menu/multiple-menu-items.agent.yaml +31 -0
  476. package/test/fixtures/agent-schema/valid/menu/single-menu-item.agent.yaml +22 -0
  477. package/test/fixtures/agent-schema/valid/menu-commands/all-command-types.agent.yaml +38 -0
  478. package/test/fixtures/agent-schema/valid/menu-commands/multiple-commands.agent.yaml +24 -0
  479. package/test/fixtures/agent-schema/valid/menu-triggers/compound-triggers.agent.yaml +31 -0
  480. package/test/fixtures/agent-schema/valid/menu-triggers/kebab-case-triggers.agent.yaml +34 -0
  481. package/test/fixtures/agent-schema/valid/metadata/core-agent-with-module.agent.yaml +24 -0
  482. package/test/fixtures/agent-schema/valid/metadata/empty-module-name-in-path.agent.yaml +24 -0
  483. package/test/fixtures/agent-schema/valid/metadata/malformed-path-treated-as-core.agent.yaml +24 -0
  484. package/test/fixtures/agent-schema/valid/metadata/module-agent-correct.agent.yaml +24 -0
  485. package/test/fixtures/agent-schema/valid/metadata/module-agent-missing-module.agent.yaml +23 -0
  486. package/test/fixtures/agent-schema/valid/metadata/wrong-module-value.agent.yaml +24 -0
  487. package/test/fixtures/agent-schema/valid/persona/complete-persona.agent.yaml +24 -0
  488. package/test/fixtures/agent-schema/valid/prompts/empty-prompts.agent.yaml +24 -0
  489. package/test/fixtures/agent-schema/valid/prompts/no-prompts.agent.yaml +22 -0
  490. package/test/fixtures/agent-schema/valid/prompts/valid-prompts-minimal.agent.yaml +28 -0
  491. package/test/fixtures/agent-schema/valid/prompts/valid-prompts-with-description.agent.yaml +30 -0
  492. package/test/fixtures/agent-schema/valid/top-level/minimal-core-agent.agent.yaml +24 -0
  493. package/test/test-agent-schema.js +387 -0
  494. package/test/test-cli-integration.sh +159 -0
  495. package/test/test-installation-components.js +214 -0
  496. package/test/unit-test-schema.js +133 -0
  497. package/tools/bmad-npx-wrapper.js +38 -0
  498. package/tools/build-docs.js +577 -0
  499. package/tools/cli/README.md +7 -0
  500. package/tools/cli/bmad-cli.js +58 -0
  501. package/tools/cli/commands/install.js +87 -0
  502. package/tools/cli/commands/status.js +65 -0
  503. package/tools/cli/external-official-modules.yaml +56 -0
  504. package/tools/cli/installers/install-messages.yaml +58 -0
  505. package/tools/cli/installers/lib/core/config-collector.js +1079 -0
  506. package/tools/cli/installers/lib/core/custom-module-cache.js +259 -0
  507. package/tools/cli/installers/lib/core/dependency-resolver.js +739 -0
  508. package/tools/cli/installers/lib/core/detector.js +223 -0
  509. package/tools/cli/installers/lib/core/ide-config-manager.js +156 -0
  510. package/tools/cli/installers/lib/core/installer.js +2826 -0
  511. package/tools/cli/installers/lib/core/manifest-generator.js +1054 -0
  512. package/tools/cli/installers/lib/core/manifest.js +1036 -0
  513. package/tools/cli/installers/lib/custom/handler.js +363 -0
  514. package/tools/cli/installers/lib/ide/STANDARDIZATION_PLAN.md +208 -0
  515. package/tools/cli/installers/lib/ide/_base-ide.js +655 -0
  516. package/tools/cli/installers/lib/ide/antigravity.js +474 -0
  517. package/tools/cli/installers/lib/ide/auggie.js +244 -0
  518. package/tools/cli/installers/lib/ide/claude-code.js +506 -0
  519. package/tools/cli/installers/lib/ide/cline.js +272 -0
  520. package/tools/cli/installers/lib/ide/codex.js +412 -0
  521. package/tools/cli/installers/lib/ide/crush.js +149 -0
  522. package/tools/cli/installers/lib/ide/cursor.js +160 -0
  523. package/tools/cli/installers/lib/ide/gemini.js +301 -0
  524. package/tools/cli/installers/lib/ide/github-copilot.js +383 -0
  525. package/tools/cli/installers/lib/ide/iflow.js +191 -0
  526. package/tools/cli/installers/lib/ide/kilo.js +250 -0
  527. package/tools/cli/installers/lib/ide/kiro-cli.js +326 -0
  528. package/tools/cli/installers/lib/ide/manager.js +244 -0
  529. package/tools/cli/installers/lib/ide/opencode.js +257 -0
  530. package/tools/cli/installers/lib/ide/qwen.js +372 -0
  531. package/tools/cli/installers/lib/ide/roo.js +273 -0
  532. package/tools/cli/installers/lib/ide/rovo-dev.js +290 -0
  533. package/tools/cli/installers/lib/ide/shared/agent-command-generator.js +165 -0
  534. package/tools/cli/installers/lib/ide/shared/bmad-artifacts.js +158 -0
  535. package/tools/cli/installers/lib/ide/shared/module-injections.js +136 -0
  536. package/tools/cli/installers/lib/ide/shared/path-utils.js +165 -0
  537. package/tools/cli/installers/lib/ide/shared/task-tool-command-generator.js +268 -0
  538. package/tools/cli/installers/lib/ide/shared/workflow-command-generator.js +293 -0
  539. package/tools/cli/installers/lib/ide/templates/agent-command-template.md +14 -0
  540. package/tools/cli/installers/lib/ide/templates/gemini-agent-command.toml +14 -0
  541. package/tools/cli/installers/lib/ide/templates/gemini-task-command.toml +12 -0
  542. package/tools/cli/installers/lib/ide/templates/workflow-command-template.md +13 -0
  543. package/tools/cli/installers/lib/ide/templates/workflow-commander.md +5 -0
  544. package/tools/cli/installers/lib/ide/trae.js +313 -0
  545. package/tools/cli/installers/lib/ide/windsurf.js +258 -0
  546. package/tools/cli/installers/lib/message-loader.js +85 -0
  547. package/tools/cli/installers/lib/modules/external-manager.js +135 -0
  548. package/tools/cli/installers/lib/modules/manager.js +1375 -0
  549. package/tools/cli/lib/activation-builder.js +163 -0
  550. package/tools/cli/lib/agent/compiler.js +522 -0
  551. package/tools/cli/lib/agent/installer.js +716 -0
  552. package/tools/cli/lib/agent/template-engine.js +152 -0
  553. package/tools/cli/lib/agent-analyzer.js +109 -0
  554. package/tools/cli/lib/agent-party-generator.js +194 -0
  555. package/tools/cli/lib/cli-utils.js +227 -0
  556. package/tools/cli/lib/config.js +213 -0
  557. package/tools/cli/lib/file-ops.js +204 -0
  558. package/tools/cli/lib/platform-codes.js +116 -0
  559. package/tools/cli/lib/project-root.js +77 -0
  560. package/tools/cli/lib/prompts.js +433 -0
  561. package/tools/cli/lib/ui.js +1716 -0
  562. package/tools/cli/lib/xml-handler.js +177 -0
  563. package/tools/cli/lib/xml-to-markdown.js +82 -0
  564. package/tools/cli/lib/yaml-format.js +245 -0
  565. package/tools/cli/lib/yaml-xml-builder.js +587 -0
  566. package/tools/docs/BUNDLE_DISTRIBUTION_SETUP.md +95 -0
  567. package/tools/docs/index.md +2 -0
  568. package/tools/fix-doc-links.js +288 -0
  569. package/tools/flattener/aggregate.js +76 -0
  570. package/tools/flattener/binary.js +80 -0
  571. package/tools/flattener/discovery.js +71 -0
  572. package/tools/flattener/files.js +35 -0
  573. package/tools/flattener/ignoreRules.js +172 -0
  574. package/tools/flattener/main.js +483 -0
  575. package/tools/flattener/projectRoot.js +201 -0
  576. package/tools/flattener/prompts.js +44 -0
  577. package/tools/flattener/stats.helpers.js +368 -0
  578. package/tools/flattener/stats.js +75 -0
  579. package/tools/flattener/test-matrix.js +409 -0
  580. package/tools/flattener/xml.js +82 -0
  581. package/tools/format-workflow-md.js +263 -0
  582. package/tools/lib/xml-utils.js +13 -0
  583. package/tools/maintainer/review-pr-README.md +55 -0
  584. package/tools/maintainer/review-pr.md +242 -0
  585. package/tools/migrate-custom-module-paths.js +124 -0
  586. package/tools/platform-codes.yaml +157 -0
  587. package/tools/schema/agent.js +491 -0
  588. package/tools/validate-agent-schema.js +110 -0
  589. package/tools/validate-doc-links.js +363 -0
  590. package/tools/validate-svg-changes.sh +356 -0
  591. package/website/README.md +76 -0
  592. package/website/astro.config.mjs +228 -0
  593. package/website/public/favicon.ico +0 -0
  594. package/website/public/img/bmad-dark.png +0 -0
  595. package/website/public/img/bmad-light.png +0 -0
  596. package/website/public/img/logo.svg +4 -0
  597. package/website/public/robots.txt +37 -0
  598. package/website/src/components/Banner.astro +59 -0
  599. package/website/src/components/Header.astro +121 -0
  600. package/website/src/components/MobileMenuFooter.astro +53 -0
  601. package/website/src/content/config.ts +6 -0
  602. package/website/src/lib/site-url.js +25 -0
  603. package/website/src/rehype-markdown-links.js +102 -0
  604. package/website/src/styles/custom.css +485 -0
@@ -0,0 +1,224 @@
1
+ # Step 8: Visual Foundation
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 establishing visual design foundation (colors, typography, spacing)
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 visual foundation 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 visual insights
28
+ - **P (Party Mode)**: Bring multiple perspectives to define visual foundation
29
+ - **C (Continue)**: Save the content to the document and proceed to next step
30
+
31
+ ## PROTOCOL INTEGRATION:
32
+
33
+ - When 'A' selected: Read fully and follow: {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml
34
+ - When 'P' selected: Read fully and follow: {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
+ - Design system choice from step 6 provides component foundation
42
+ - Emotional response goals from step 4 inform visual decisions
43
+ - Focus on colors, typography, spacing, and layout foundation
44
+
45
+ ## YOUR TASK:
46
+
47
+ Establish the visual design foundation including color themes, typography, and spacing systems.
48
+
49
+ ## VISUAL FOUNDATION SEQUENCE:
50
+
51
+ ### 1. Brand Guidelines Assessment
52
+
53
+ Check for existing brand requirements:
54
+ "Do you have existing brand guidelines or a specific color palette I should follow? (y/n)
55
+
56
+ If yes, I'll extract and document your brand colors and create semantic color mappings.
57
+ If no, I'll generate theme options based on your project's personality and emotional goals from our earlier discussion."
58
+
59
+ ### 2. Generate Color Theme Options (If no brand guidelines)
60
+
61
+ Create visual exploration opportunities:
62
+ "If no existing brand guidelines, I'll create a color theme visualizer to help you explore options.
63
+
64
+ 🎨 I can generate comprehensive HTML color theme visualizers with multiple theme options, complete UI examples, and the ability to see how colors work in real interface contexts.
65
+
66
+ This will help you make an informed decision about the visual direction for {{project_name}}."
67
+
68
+ ### 3. Define Typography System
69
+
70
+ Establish the typographic foundation:
71
+ "**Typography Questions:**
72
+
73
+ - What should the overall tone feel like? (Professional, friendly, modern, classic?)
74
+ - How much text content will users read? (Headings only? Long-form content?)
75
+ - Any accessibility requirements for font sizes or contrast?
76
+ - Any brand fonts we must use?
77
+
78
+ **Typography Strategy:**
79
+
80
+ - Choose primary and secondary typefaces
81
+ - Establish type scale (h1, h2, h3, body, etc.)
82
+ - Define line heights and spacing relationships
83
+ - Consider readability and accessibility"
84
+
85
+ ### 4. Establish Spacing and Layout Foundation
86
+
87
+ Define the structural foundation:
88
+ "**Spacing and Layout Foundation:**
89
+
90
+ - How should the overall layout feel? (Dense and efficient? Airy and spacious?)
91
+ - What spacing unit should we use? (4px, 8px, 12px base?)
92
+ - How much white space should be between elements?
93
+ - Should we use a grid system? If so, what column structure?
94
+
95
+ **Layout Principles:**
96
+
97
+ - [Layout principle 1 based on product type]
98
+ - [Layout principle 2 based on user needs]
99
+ - [Layout principle 3 based on platform requirements]"
100
+
101
+ ### 5. Create Visual Foundation Strategy
102
+
103
+ Synthesize all visual decisions:
104
+ "**Visual Foundation Strategy:**
105
+
106
+ **Color System:**
107
+
108
+ - [Color strategy based on brand guidelines or generated themes]
109
+ - Semantic color mapping (primary, secondary, success, warning, error, etc.)
110
+ - Accessibility compliance (contrast ratios)
111
+
112
+ **Typography System:**
113
+
114
+ - [Typography strategy based on content needs and tone]
115
+ - Type scale and hierarchy
116
+ - Font pairing rationale
117
+
118
+ **Spacing & Layout:**
119
+
120
+ - [Spacing strategy based on content density and platform]
121
+ - Grid system approach
122
+ - Component spacing relationships
123
+
124
+ This foundation will ensure consistency across all our design decisions."
125
+
126
+ ### 6. Generate Visual Foundation Content
127
+
128
+ Prepare the content to append to the document:
129
+
130
+ #### Content Structure:
131
+
132
+ When saving to document, append these Level 2 and Level 3 sections:
133
+
134
+ ```markdown
135
+ ## Visual Design Foundation
136
+
137
+ ### Color System
138
+
139
+ [Color system strategy based on conversation]
140
+
141
+ ### Typography System
142
+
143
+ [Typography system strategy based on conversation]
144
+
145
+ ### Spacing & Layout Foundation
146
+
147
+ [Spacing and layout foundation based on conversation]
148
+
149
+ ### Accessibility Considerations
150
+
151
+ [Accessibility considerations based on conversation]
152
+ ```
153
+
154
+ ### 7. Present Content and Menu
155
+
156
+ Show the generated visual foundation content and present choices:
157
+ "I've established the visual design foundation for {{project_name}}. This provides the building blocks for consistent, beautiful design.
158
+
159
+ **Here's what I'll add to the document:**
160
+
161
+ [Show the complete markdown content from step 6]
162
+
163
+ **What would you like to do?**
164
+ [A] Advanced Elicitation - Let's refine our visual foundation
165
+ [P] Party Mode - Bring design perspectives on visual choices
166
+ [C] Continue - Save this to the document and move to design directions
167
+
168
+ ### 8. Handle Menu Selection
169
+
170
+ #### If 'A' (Advanced Elicitation):
171
+
172
+ - Read fully and follow: {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml with the current visual foundation content
173
+ - Process the enhanced visual insights that come back
174
+ - Ask user: "Accept these improvements to the visual foundation? (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 'P' (Party Mode):
179
+
180
+ - Read fully and follow: {project-root}/_bmad/core/workflows/party-mode/workflow.md with the current visual foundation
181
+ - Process the collaborative visual insights that come back
182
+ - Ask user: "Accept these changes to the visual foundation? (y/n)"
183
+ - If yes: Update content with improvements, then return to A/P/C menu
184
+ - If no: Keep original content, then return to A/P/C menu
185
+
186
+ #### If 'C' (Continue):
187
+
188
+ - Append the final content to `{planning_artifacts}/ux-design-specification.md`
189
+ - Update frontmatter: append step to end of stepsCompleted array
190
+ - Load `./step-09-design-directions.md`
191
+
192
+ ## APPEND TO DOCUMENT:
193
+
194
+ When user selects 'C', append the content directly to the document using the structure from step 6.
195
+
196
+ ## SUCCESS METRICS:
197
+
198
+ ✅ Brand guidelines assessed and incorporated if available
199
+ ✅ Color system established with accessibility consideration
200
+ ✅ Typography system defined with appropriate hierarchy
201
+ ✅ Spacing and layout foundation created
202
+ ✅ Visual foundation strategy documented
203
+ ✅ A/P/C menu presented and handled correctly
204
+ ✅ Content properly appended to document when C selected
205
+
206
+ ## FAILURE MODES:
207
+
208
+ ❌ Not checking for existing brand guidelines first
209
+ ❌ Color palette not aligned with emotional goals
210
+ ❌ Typography not suitable for content type or readability needs
211
+ ❌ Spacing system not appropriate for content density
212
+ ❌ Missing accessibility considerations
213
+ ❌ Not presenting A/P/C menu after content generation
214
+ ❌ Appending content without user selecting 'C'
215
+
216
+ ❌ **CRITICAL**: Reading only partial step file - leads to incomplete understanding and poor decisions
217
+ ❌ **CRITICAL**: Proceeding with 'C' without fully reading and understanding the next step file
218
+ ❌ **CRITICAL**: Making decisions without complete understanding of step requirements and protocols
219
+
220
+ ## NEXT STEP:
221
+
222
+ After user selects 'C' and content is saved to document, load `./step-09-design-directions.md` to generate design direction mockups.
223
+
224
+ Remember: Do NOT proceed to step-09 until user explicitly selects 'C' from the A/P/C menu and content is saved!
@@ -0,0 +1,224 @@
1
+ # Step 9: Design Direction Mockups
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 generating and evaluating design direction variations
12
+ - 🎯 COLLABORATIVE exploration, 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 design direction content
19
+ - 💾 Generate HTML visualizer for design directions
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 design insights
28
+ - **P (Party Mode)**: Bring multiple perspectives to evaluate design directions
29
+ - **C (Continue)**: Save the content to the document and proceed to next step
30
+
31
+ ## PROTOCOL INTEGRATION:
32
+
33
+ - When 'A' selected: Read fully and follow: {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml
34
+ - When 'P' selected: Read fully and follow: {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
+ - Visual foundation from step 8 provides design tokens
42
+ - Core experience from step 7 informs layout and interaction design
43
+ - Focus on exploring different visual design directions
44
+
45
+ ## YOUR TASK:
46
+
47
+ Generate comprehensive design direction mockups showing different visual approaches for the product.
48
+
49
+ ## DESIGN DIRECTIONS SEQUENCE:
50
+
51
+ ### 1. Generate Design Direction Variations
52
+
53
+ Create diverse visual explorations:
54
+ "I'll generate 6-8 different design direction variations exploring:
55
+
56
+ - Different layout approaches and information hierarchy
57
+ - Various interaction patterns and visual weights
58
+ - Alternative color applications from our foundation
59
+ - Different density and spacing approaches
60
+ - Various navigation and component arrangements
61
+
62
+ Each mockup will show a complete vision for {{project_name}} with all our design decisions applied."
63
+
64
+ ### 2. Create HTML Design Direction Showcase
65
+
66
+ Generate interactive visual exploration:
67
+ "🎨 Design Direction Mockups Generated!
68
+
69
+ I'm creating a comprehensive HTML design direction showcase at `{planning_artifacts}/ux-design-directions.html`
70
+
71
+ **What you'll see:**
72
+
73
+ - 6-8 full-screen mockup variations
74
+ - Interactive states and hover effects
75
+ - Side-by-side comparison tools
76
+ - Complete UI examples with real content
77
+ - Responsive behavior demonstrations
78
+
79
+ Each mockup represents a complete visual direction for your app's look and feel."
80
+
81
+ ### 3. Present Design Exploration Framework
82
+
83
+ Guide evaluation criteria:
84
+ "As you explore the design directions, look for:
85
+
86
+ ✅ **Layout Intuitiveness** - Which information hierarchy matches your priorities?
87
+ ✅ **Interaction Style** - Which interaction style fits your core experience?
88
+ ✅ **Visual Weight** - Which visual density feels right for your brand?
89
+ ✅ **Navigation Approach** - Which navigation pattern matches user expectations?
90
+ ✅ **Component Usage** - How well do the components support your user journeys?
91
+ ✅ **Brand Alignment** - Which direction best supports your emotional goals?
92
+
93
+ Take your time exploring - this is a crucial decision that will guide all our design work!"
94
+
95
+ ### 4. Facilitate Design Direction Selection
96
+
97
+ Help user choose or combine elements:
98
+ "After exploring all the design directions:
99
+
100
+ **Which approach resonates most with you?**
101
+
102
+ - Pick a favorite direction as-is
103
+ - Combine elements from multiple directions
104
+ - Request modifications to any direction
105
+ - Use one direction as a base and iterate
106
+
107
+ **Tell me:**
108
+
109
+ - Which layout feels most intuitive for your users?
110
+ - Which visual weight matches your brand personality?
111
+ - Which interaction style supports your core experience?
112
+ - Are there elements from different directions you'd like to combine?"
113
+
114
+ ### 5. Document Design Direction Decision
115
+
116
+ Capture the chosen approach:
117
+ "Based on your exploration, I'm understanding your design direction preference:
118
+
119
+ **Chosen Direction:** [Direction number or combination]
120
+ **Key Elements:** [Specific elements you liked]
121
+ **Modifications Needed:** [Any changes requested]
122
+ **Rationale:** [Why this direction works for your product]
123
+
124
+ This will become our design foundation moving forward. Are we ready to lock this in, or do you want to explore variations?"
125
+
126
+ ### 6. Generate Design Direction Content
127
+
128
+ Prepare the content to append to the document:
129
+
130
+ #### Content Structure:
131
+
132
+ When saving to document, append these Level 2 and Level 3 sections:
133
+
134
+ ```markdown
135
+ ## Design Direction Decision
136
+
137
+ ### Design Directions Explored
138
+
139
+ [Summary of design directions explored based on conversation]
140
+
141
+ ### Chosen Direction
142
+
143
+ [Chosen design direction based on conversation]
144
+
145
+ ### Design Rationale
146
+
147
+ [Rationale for design direction choice based on conversation]
148
+
149
+ ### Implementation Approach
150
+
151
+ [Implementation approach based on chosen direction]
152
+ ```
153
+
154
+ ### 7. Present Content and Menu
155
+
156
+ Show the generated design direction content and present choices:
157
+ "I've documented our design direction decision for {{project_name}}. This visual approach will guide all our detailed design work.
158
+
159
+ **Here's what I'll add to the document:**
160
+
161
+ [Show the complete markdown content from step 6]
162
+
163
+ **What would you like to do?**
164
+ [A] Advanced Elicitation - Let's refine our design direction
165
+ [P] Party Mode - Bring different perspectives on visual choices
166
+ [C] Continue - Save this to the document and move to user journey flows
167
+
168
+ ### 8. Handle Menu Selection
169
+
170
+ #### If 'A' (Advanced Elicitation):
171
+
172
+ - Read fully and follow: {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml with the current design direction content
173
+ - Process the enhanced design insights that come back
174
+ - Ask user: "Accept these improvements to the design direction? (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 'P' (Party Mode):
179
+
180
+ - Read fully and follow: {project-root}/_bmad/core/workflows/party-mode/workflow.md with the current design direction
181
+ - Process the collaborative design insights that come back
182
+ - Ask user: "Accept these changes to the design direction? (y/n)"
183
+ - If yes: Update content with improvements, then return to A/P/C menu
184
+ - If no: Keep original content, then return to A/P/C menu
185
+
186
+ #### If 'C' (Continue):
187
+
188
+ - Append the final content to `{planning_artifacts}/ux-design-specification.md`
189
+ - Update frontmatter: append step to end of stepsCompleted array
190
+ - Load `./step-10-user-journeys.md`
191
+
192
+ ## APPEND TO DOCUMENT:
193
+
194
+ When user selects 'C', append the content directly to the document using the structure from step 6.
195
+
196
+ ## SUCCESS METRICS:
197
+
198
+ ✅ Multiple design direction variations generated
199
+ ✅ HTML showcase created with interactive elements
200
+ ✅ Design evaluation criteria clearly established
201
+ ✅ User able to explore and compare directions effectively
202
+ ✅ Design direction decision made with clear rationale
203
+ ✅ A/P/C menu presented and handled correctly
204
+ ✅ Content properly appended to document when C selected
205
+
206
+ ## FAILURE MODES:
207
+
208
+ ❌ Not creating enough variation in design directions
209
+ ❌ Design directions not aligned with established foundation
210
+ ❌ Missing interactive elements in HTML showcase
211
+ ❌ Not providing clear evaluation criteria
212
+ ❌ Rushing decision without thorough exploration
213
+ ❌ Not presenting A/P/C menu after content generation
214
+ ❌ Appending content without user selecting 'C'
215
+
216
+ ❌ **CRITICAL**: Reading only partial step file - leads to incomplete understanding and poor decisions
217
+ ❌ **CRITICAL**: Proceeding with 'C' without fully reading and understanding the next step file
218
+ ❌ **CRITICAL**: Making decisions without complete understanding of step requirements and protocols
219
+
220
+ ## NEXT STEP:
221
+
222
+ After user selects 'C' and content is saved to document, load `./step-10-user-journeys.md` to design user journey flows.
223
+
224
+ Remember: Do NOT proceed to step-10 until user explicitly selects 'C' from the A/P/C menu and content is saved!
@@ -0,0 +1,241 @@
1
+ # Step 10: User Journey Flows
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 designing user flows and journey interactions
12
+ - 🎯 COLLABORATIVE flow design, not assumption-based layouts
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 user journey 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 journey insights
28
+ - **P (Party Mode)**: Bring multiple perspectives to design user flows
29
+ - **C (Continue)**: Save the content to the document and proceed to next step
30
+
31
+ ## PROTOCOL INTEGRATION:
32
+
33
+ - When 'A' selected: Read fully and follow: {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml
34
+ - When 'P' selected: Read fully and follow: {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
+ - Design direction from step 9 informs flow layout and visual design
42
+ - Core experience from step 7 defines key journey interactions
43
+ - Focus on designing detailed user flows with Mermaid diagrams
44
+
45
+ ## YOUR TASK:
46
+
47
+ Design detailed user journey flows for critical user interactions.
48
+
49
+ ## USER JOURNEY FLOWS SEQUENCE:
50
+
51
+ ### 1. Load PRD User Journeys as Foundation
52
+
53
+ Start with user journeys already defined in the PRD:
54
+ "Great! Since we have the PRD available, let's build on the user journeys already documented there.
55
+
56
+ **Existing User Journeys from PRD:**
57
+ I've already loaded these user journeys from your PRD:
58
+ [Journey narratives from PRD input documents]
59
+
60
+ These journeys tell us **who** users are and **why** they take certain actions. Now we need to design **how** those journeys work in detail.
61
+
62
+ **Critical Journeys to Design Flows For:**
63
+ Looking at the PRD journeys, I need to design detailed interaction flows for:
64
+
65
+ - [Critical journey 1 identified from PRD narratives]
66
+ - [Critical journey 2 identified from PRD narratives]
67
+ - [Critical journey 3 identified from PRD narratives]
68
+
69
+ The PRD gave us the stories - now we design the mechanics!"
70
+
71
+ ### 2. Design Each Journey Flow
72
+
73
+ For each critical journey, design detailed flow:
74
+
75
+ **For [Journey Name]:**
76
+ "Let's design the flow for users accomplishing [journey goal].
77
+
78
+ **Flow Design Questions:**
79
+
80
+ - How do users start this journey? (entry point)
81
+ - What information do they need at each step?
82
+ - What decisions do they need to make?
83
+ - How do they know they're progressing successfully?
84
+ - What does success look like for this journey?
85
+ - Where might they get confused or stuck?
86
+ - How do they recover from errors?"
87
+
88
+ ### 3. Create Flow Diagrams
89
+
90
+ Visualize each journey with Mermaid diagrams:
91
+ "I'll create detailed flow diagrams for each journey showing:
92
+
93
+ **[Journey Name] Flow:**
94
+
95
+ - Entry points and triggers
96
+ - Decision points and branches
97
+ - Success and failure paths
98
+ - Error recovery mechanisms
99
+ - Progressive disclosure of information
100
+
101
+ Each diagram will map the complete user experience from start to finish."
102
+
103
+ ### 4. Optimize for Efficiency and Delight
104
+
105
+ Refine flows for optimal user experience:
106
+ "**Flow Optimization:**
107
+ For each journey, let's ensure we're:
108
+
109
+ - Minimizing steps to value (getting users to success quickly)
110
+ - Reducing cognitive load at each decision point
111
+ - Providing clear feedback and progress indicators
112
+ - Creating moments of delight or accomplishment
113
+ - Handling edge cases and error recovery gracefully
114
+
115
+ **Specific Optimizations:**
116
+
117
+ - [Optimization 1 for journey efficiency]
118
+ - [Optimization 2 for user delight]
119
+ - [Optimization 3 for error handling]"
120
+
121
+ ### 5. Document Journey Patterns
122
+
123
+ Extract reusable patterns across journeys:
124
+ "**Journey Patterns:**
125
+ Across these flows, I'm seeing some common patterns we can standardize:
126
+
127
+ **Navigation Patterns:**
128
+
129
+ - [Navigation pattern 1]
130
+ - [Navigation pattern 2]
131
+
132
+ **Decision Patterns:**
133
+
134
+ - [Decision pattern 1]
135
+ - [Decision pattern 2]
136
+
137
+ **Feedback Patterns:**
138
+
139
+ - [Feedback pattern 1]
140
+ - [Feedback pattern 2]
141
+
142
+ These patterns will ensure consistency across all user experiences."
143
+
144
+ ### 6. Generate User Journey Content
145
+
146
+ Prepare the content to append to the document:
147
+
148
+ #### Content Structure:
149
+
150
+ When saving to document, append these Level 2 and Level 3 sections:
151
+
152
+ ```markdown
153
+ ## User Journey Flows
154
+
155
+ ### [Journey 1 Name]
156
+
157
+ [Journey 1 description and Mermaid diagram]
158
+
159
+ ### [Journey 2 Name]
160
+
161
+ [Journey 2 description and Mermaid diagram]
162
+
163
+ ### Journey Patterns
164
+
165
+ [Journey patterns identified based on conversation]
166
+
167
+ ### Flow Optimization Principles
168
+
169
+ [Flow optimization principles based on conversation]
170
+ ```
171
+
172
+ ### 7. Present Content and Menu
173
+
174
+ Show the generated user journey content and present choices:
175
+ "I've designed detailed user journey flows for {{project_name}}. These flows will guide the detailed design of each user interaction.
176
+
177
+ **Here's what I'll add to the document:**
178
+
179
+ [Show the complete markdown content from step 6]
180
+
181
+ **What would you like to do?**
182
+ [A] Advanced Elicitation - Let's refine our user journey designs
183
+ [P] Party Mode - Bring different perspectives on user flows
184
+ [C] Continue - Save this to the document and move to component strategy
185
+
186
+ ### 8. Handle Menu Selection
187
+
188
+ #### If 'A' (Advanced Elicitation):
189
+
190
+ - Read fully and follow: {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml with the current user journey content
191
+ - Process the enhanced journey insights that come back
192
+ - Ask user: "Accept these improvements to the user journeys? (y/n)"
193
+ - If yes: Update content with improvements, then return to A/P/C menu
194
+ - If no: Keep original content, then return to A/P/C menu
195
+
196
+ #### If 'P' (Party Mode):
197
+
198
+ - Read fully and follow: {project-root}/_bmad/core/workflows/party-mode/workflow.md with the current user journeys
199
+ - Process the collaborative journey insights that come back
200
+ - Ask user: "Accept these changes to the user journeys? (y/n)"
201
+ - If yes: Update content with improvements, then return to A/P/C menu
202
+ - If no: Keep original content, then return to A/P/C menu
203
+
204
+ #### If 'C' (Continue):
205
+
206
+ - Append the final content to `{planning_artifacts}/ux-design-specification.md`
207
+ - Update frontmatter: append step to end of stepsCompleted array
208
+ - Load `./step-11-component-strategy.md`
209
+
210
+ ## APPEND TO DOCUMENT:
211
+
212
+ When user selects 'C', append the content directly to the document using the structure from step 6.
213
+
214
+ ## SUCCESS METRICS:
215
+
216
+ ✅ Critical user journeys identified and designed
217
+ ✅ Detailed flow diagrams created for each journey
218
+ ✅ Flows optimized for efficiency and user delight
219
+ ✅ Common journey patterns extracted and documented
220
+ ✅ A/P/C menu presented and handled correctly
221
+ ✅ Content properly appended to document when C selected
222
+
223
+ ## FAILURE MODES:
224
+
225
+ ❌ Not identifying all critical user journeys
226
+ ❌ Flows too complex or not optimized for user success
227
+ ❌ Missing error recovery paths
228
+ ❌ Not extracting reusable patterns across journeys
229
+ ❌ Flow diagrams unclear or incomplete
230
+ ❌ Not presenting A/P/C menu after content generation
231
+ ❌ Appending content without user selecting 'C'
232
+
233
+ ❌ **CRITICAL**: Reading only partial step file - leads to incomplete understanding and poor decisions
234
+ ❌ **CRITICAL**: Proceeding with 'C' without fully reading and understanding the next step file
235
+ ❌ **CRITICAL**: Making decisions without complete understanding of step requirements and protocols
236
+
237
+ ## NEXT STEP:
238
+
239
+ After user selects 'C' and content is saved to document, load `./step-11-component-strategy.md` to define component library strategy.
240
+
241
+ Remember: Do NOT proceed to step-11 until user explicitly selects 'C' from the A/P/C menu and content is saved!