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,228 @@
1
+ ---
2
+ name: 'step-08-scoping'
3
+ description: 'Define MVP boundaries and prioritize features across development phases'
4
+
5
+ # File References
6
+ nextStepFile: './step-09-functional.md'
7
+ outputFile: '{planning_artifacts}/prd.md'
8
+
9
+ # Task References
10
+ advancedElicitationTask: '{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml'
11
+ partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
12
+ ---
13
+
14
+ # Step 8: Scoping Exercise - MVP & Future Features
15
+
16
+ **Progress: Step 8 of 11** - Next: Functional Requirements
17
+
18
+ ## MANDATORY EXECUTION RULES (READ FIRST):
19
+
20
+ - 🛑 NEVER generate content without user input
21
+
22
+ - 📖 CRITICAL: ALWAYS read the complete step file before taking any action - partial understanding leads to incomplete decisions
23
+ - 🔄 CRITICAL: When loading next step with 'C', ensure the entire file is read and understood before proceeding
24
+ - ✅ ALWAYS treat this as collaborative discovery between PM peers
25
+ - 📋 YOU ARE A FACILITATOR, not a content generator
26
+ - 💬 FOCUS on strategic scope decisions that keep projects viable
27
+ - 🎯 EMPHASIZE lean MVP thinking while preserving long-term vision
28
+ - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
29
+
30
+ ## EXECUTION PROTOCOLS:
31
+
32
+ - 🎯 Show your analysis before taking any action
33
+ - 📚 Review the complete PRD document built so far
34
+ - ⚠️ Present A/P/C menu after generating scoping decisions
35
+ - 💾 ONLY save when user chooses C (Continue)
36
+ - 📖 Update output file frontmatter, adding this step name to the end of the list of stepsCompleted
37
+ - 🚫 FORBIDDEN to load next step until C is selected
38
+
39
+
40
+ ## CONTEXT BOUNDARIES:
41
+
42
+ - Complete PRD document built so far is available for review
43
+ - User journeys, success criteria, and domain requirements are documented
44
+ - Focus on strategic scope decisions, not feature details
45
+ - Balance between user value and implementation feasibility
46
+
47
+ ## YOUR TASK:
48
+
49
+ Conduct comprehensive scoping exercise to define MVP boundaries and prioritize features across development phases.
50
+
51
+ ## SCOPING SEQUENCE:
52
+
53
+ ### 1. Review Current PRD State
54
+
55
+ Analyze everything documented so far:
56
+ - Present synthesis of established vision, success criteria, journeys
57
+ - Assess domain and innovation focus
58
+ - Evaluate scope implications: simple MVP, medium, or complex project
59
+ - Ask if initial assessment feels right or if they see it differently
60
+
61
+ ### 2. Define MVP Strategy
62
+
63
+ Facilitate strategic MVP decisions:
64
+ - Explore MVP philosophy options: problem-solving, experience, platform, or revenue MVP
65
+ - Ask critical questions:
66
+ - What's the minimum that would make users say 'this is useful'?
67
+ - What would make investors/partners say 'this has potential'?
68
+ - What's the fastest path to validated learning?
69
+ - Guide toward appropriate MVP approach for their product
70
+
71
+ ### 3. Scoping Decision Framework
72
+
73
+ Use structured decision-making for scope:
74
+
75
+ **Must-Have Analysis:**
76
+ - Guide identification of absolute MVP necessities
77
+ - For each journey and success criterion, ask:
78
+ - Without this, does the product fail?
79
+ - Can this be manual initially?
80
+ - Is this a deal-breaker for early adopters?
81
+ - Analyze journeys for MVP essentials
82
+
83
+ **Nice-to-Have Analysis:**
84
+ - Identify what could be added later:
85
+ - Features that enhance but aren't essential
86
+ - User types that can be added later
87
+ - Advanced functionality that builds on MVP
88
+ - Ask what features could be added in versions 2, 3, etc.
89
+
90
+ ### 4. Progressive Feature Roadmap
91
+
92
+ Create phased development approach:
93
+ - Guide mapping of features across development phases
94
+ - Structure as Phase 1 (MVP), Phase 2 (Growth), Phase 3 (Vision)
95
+ - Ensure clear progression and dependencies
96
+
97
+ - Core user value delivery
98
+ - Essential user journeys
99
+ - Basic functionality that works reliably
100
+
101
+ **Phase 2: Growth**
102
+
103
+ - Additional user types
104
+ - Enhanced features
105
+ - Scale improvements
106
+
107
+ **Phase 3: Expansion**
108
+
109
+ - Advanced capabilities
110
+ - Platform features
111
+ - New markets or use cases
112
+
113
+ **Where does your current vision fit in this development sequence?**"
114
+
115
+ ### 5. Risk-Based Scoping
116
+
117
+ Identify and mitigate scoping risks:
118
+
119
+ **Technical Risks:**
120
+ "Looking at your innovation and domain requirements:
121
+
122
+ - What's the most technically challenging aspect?
123
+ - Could we simplify the initial implementation?
124
+ - What's the riskiest assumption about technology feasibility?"
125
+
126
+ **Market Risks:**
127
+
128
+ - What's the biggest market risk?
129
+ - How does the MVP address this?
130
+ - What learning do we need to de-risk this?"
131
+
132
+ **Resource Risks:**
133
+
134
+ - What if we have fewer resources than planned?
135
+ - What's the absolute minimum team size needed?
136
+ - Can we launch with a smaller feature set?"
137
+
138
+ ### 6. Generate Scoping Content
139
+
140
+ Prepare comprehensive scoping section:
141
+
142
+ #### Content Structure:
143
+
144
+ ```markdown
145
+ ## Project Scoping & Phased Development
146
+
147
+ ### MVP Strategy & Philosophy
148
+
149
+ **MVP Approach:** {{chosen_mvp_approach}}
150
+ **Resource Requirements:** {{mvp_team_size_and_skills}}
151
+
152
+ ### MVP Feature Set (Phase 1)
153
+
154
+ **Core User Journeys Supported:**
155
+ {{essential_journeys_for_mvp}}
156
+
157
+ **Must-Have Capabilities:**
158
+ {{list_of_essential_mvp_features}}
159
+
160
+ ### Post-MVP Features
161
+
162
+ **Phase 2 (Post-MVP):**
163
+ {{planned_growth_features}}
164
+
165
+ **Phase 3 (Expansion):**
166
+ {{planned_expansion_features}}
167
+
168
+ ### Risk Mitigation Strategy
169
+
170
+ **Technical Risks:** {{mitigation_approach}}
171
+ **Market Risks:** {{validation_approach}}
172
+ **Resource Risks:** {{contingency_approach}}
173
+ ```
174
+
175
+ ### 7. Present MENU OPTIONS
176
+
177
+ Present the scoping decisions for review, then display menu:
178
+ - Show strategic scoping plan (using structure from step 6)
179
+ - Highlight MVP boundaries and phased roadmap
180
+ - Ask if they'd like to refine further, get other perspectives, or proceed
181
+ - Present menu options naturally as part of conversation
182
+
183
+ Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Functional Requirements (Step 9 of 11)"
184
+
185
+ #### Menu Handling Logic:
186
+ - IF A: Read fully and follow: {advancedElicitationTask} with the current scoping analysis, process the enhanced insights that come back, ask user if they accept the improvements, if yes update content then redisplay menu, if no keep original content then redisplay menu
187
+ - IF P: Read fully and follow: {partyModeWorkflow} with the scoping context, process the collaborative insights on MVP and roadmap decisions, ask user if they accept the changes, if yes update content then redisplay menu, if no keep original content then redisplay menu
188
+ - IF C: Append the final content to {outputFile}, update frontmatter by adding this step name to the end of the stepsCompleted array, then read fully and follow: {nextStepFile}
189
+ - IF Any other: help user respond, then redisplay menu
190
+
191
+ #### EXECUTION RULES:
192
+ - ALWAYS halt and wait for user input after presenting menu
193
+ - ONLY proceed to next step when user selects 'C'
194
+ - After other menu items execution, return to this menu
195
+
196
+ ## APPEND TO DOCUMENT:
197
+
198
+ When user selects 'C', append the content directly to the document using the structure from step 6.
199
+
200
+ ## SUCCESS METRICS:
201
+
202
+ ✅ Complete PRD document analyzed for scope implications
203
+ ✅ Strategic MVP approach defined and justified
204
+ ✅ Clear MVP feature boundaries established
205
+ ✅ Phased development roadmap created
206
+ ✅ Key risks identified and mitigation strategies defined
207
+ ✅ User explicitly agrees to scope decisions
208
+ ✅ A/P/C menu presented and handled correctly
209
+ ✅ Content properly appended to document when C selected
210
+
211
+ ## FAILURE MODES:
212
+
213
+ ❌ Not analyzing the complete PRD before making scoping decisions
214
+ ❌ Making scope decisions without strategic rationale
215
+ ❌ Not getting explicit user agreement on MVP boundaries
216
+ ❌ Missing critical risk analysis
217
+ ❌ Not creating clear phased development approach
218
+ ❌ Not presenting A/P/C menu after content generation
219
+
220
+ ❌ **CRITICAL**: Reading only partial step file - leads to incomplete understanding and poor decisions
221
+ ❌ **CRITICAL**: Proceeding with 'C' without fully reading and understanding the next step file
222
+ ❌ **CRITICAL**: Making decisions without complete understanding of step requirements and protocols
223
+
224
+ ## NEXT STEP:
225
+
226
+ After user selects 'C' and content is saved to document, load {nextStepFile}.
227
+
228
+ Remember: Do NOT proceed to step-09 until user explicitly selects 'C' from the A/P/C menu and content is saved!
@@ -0,0 +1,231 @@
1
+ ---
2
+ name: 'step-09-functional'
3
+ description: 'Synthesize all discovery into comprehensive functional requirements'
4
+
5
+ # File References
6
+ nextStepFile: './step-10-nonfunctional.md'
7
+ outputFile: '{planning_artifacts}/prd.md'
8
+
9
+ # Task References
10
+ advancedElicitationTask: '{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml'
11
+ partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
12
+ ---
13
+
14
+ # Step 9: Functional Requirements Synthesis
15
+
16
+ **Progress: Step 9 of 11** - Next: Non-Functional Requirements
17
+
18
+ ## MANDATORY EXECUTION RULES (READ FIRST):
19
+
20
+ - 🛑 NEVER generate content without user input
21
+
22
+ - 📖 CRITICAL: ALWAYS read the complete step file before taking any action - partial understanding leads to incomplete decisions
23
+ - 🔄 CRITICAL: When loading next step with 'C', ensure the entire file is read and understood before proceeding
24
+ - ✅ ALWAYS treat this as collaborative discovery between PM peers
25
+ - 📋 YOU ARE A FACILITATOR, not a content generator
26
+ - 💬 FOCUS on creating comprehensive capability inventory for the product
27
+ - 🎯 CRITICAL: This is THE CAPABILITY CONTRACT for all downstream work
28
+ - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
29
+
30
+ ## EXECUTION PROTOCOLS:
31
+
32
+ - 🎯 Show your analysis before taking any action
33
+ - ⚠️ Present A/P/C menu after generating functional requirements
34
+ - 💾 ONLY save when user chooses C (Continue)
35
+ - 📖 Update output file frontmatter, adding this step name to the end of the list of stepsCompleted
36
+ - 🚫 FORBIDDEN to load next step until C is selected
37
+
38
+
39
+ ## CONTEXT BOUNDARIES:
40
+
41
+ - Current document and frontmatter from previous steps are available
42
+ - ALL previous content (executive summary, success criteria, journeys, domain, innovation, project-type) must be referenced
43
+ - No additional data files needed for this step
44
+ - Focus on capabilities, not implementation details
45
+
46
+ ## CRITICAL IMPORTANCE:
47
+
48
+ **This section defines THE CAPABILITY CONTRACT for the entire product:**
49
+
50
+ - UX designers will ONLY design what's listed here
51
+ - Architects will ONLY support what's listed here
52
+ - Epic breakdown will ONLY implement what's listed here
53
+ - If a capability is missing from FRs, it will NOT exist in the final product
54
+
55
+ ## FUNCTIONAL REQUIREMENTS SYNTHESIS SEQUENCE:
56
+
57
+ ### 1. Understand FR Purpose and Usage
58
+
59
+ Start by explaining the critical role of functional requirements:
60
+
61
+ **Purpose:**
62
+ FRs define WHAT capabilities the product must have. They are the complete inventory of user-facing and system capabilities that deliver the product vision.
63
+
64
+ **Critical Properties:**
65
+ ✅ Each FR is a testable capability
66
+ ✅ Each FR is implementation-agnostic (could be built many ways)
67
+ ✅ Each FR specifies WHO and WHAT, not HOW
68
+ ✅ No UI details, no performance numbers, no technology choices
69
+ ✅ Comprehensive coverage of capability areas
70
+
71
+ **How They Will Be Used:**
72
+
73
+ 1. UX Designer reads FRs → designs interactions for each capability
74
+ 2. Architect reads FRs → designs systems to support each capability
75
+ 3. PM reads FRs → creates epics and stories to implement each capability
76
+
77
+ ### 2. Review Existing Content for Capability Extraction
78
+
79
+ Systematically review all previous sections to extract capabilities:
80
+
81
+ **Extract From:**
82
+
83
+ - Executive Summary → Core product differentiator capabilities
84
+ - Success Criteria → Success-enabling capabilities
85
+ - User Journeys → Journey-revealed capabilities
86
+ - Domain Requirements → Compliance and regulatory capabilities
87
+ - Innovation Patterns → Innovative feature capabilities
88
+ - Project-Type Requirements → Technical capability needs
89
+
90
+ ### 3. Organize Requirements by Capability Area
91
+
92
+ Group FRs by logical capability areas (NOT by technology or layer):
93
+
94
+ **Good Grouping Examples:**
95
+
96
+ - ✅ "User Management" (not "Authentication System")
97
+ - ✅ "Content Discovery" (not "Search Algorithm")
98
+ - ✅ "Team Collaboration" (not "WebSocket Infrastructure")
99
+
100
+ **Target 5-8 Capability Areas** for typical projects.
101
+
102
+ ### 4. Generate Comprehensive FR List
103
+
104
+ Create complete functional requirements using this format:
105
+
106
+ **Format:**
107
+
108
+ - FR#: [Actor] can [capability] [context/constraint if needed]
109
+ - Number sequentially (FR1, FR2, FR3...)
110
+ - Aim for 20-50 FRs for typical projects
111
+
112
+ **Altitude Check:**
113
+ Each FR should answer "WHAT capability exists?" NOT "HOW it's implemented?"
114
+
115
+ **Examples:**
116
+
117
+ - ✅ "Users can customize appearance settings"
118
+ - ❌ "Users can toggle light/dark theme with 3 font size options stored in LocalStorage"
119
+
120
+ ### 5. Self-Validation Process
121
+
122
+ Before presenting to user, validate the FR list:
123
+
124
+ **Completeness Check:**
125
+
126
+ 1. "Did I cover EVERY capability mentioned in the MVP scope section?"
127
+ 2. "Did I include domain-specific requirements as FRs?"
128
+ 3. "Did I cover the project-type specific needs?"
129
+ 4. "Could a UX designer read ONLY the FRs and know what to design?"
130
+ 5. "Could an Architect read ONLY the FRs and know what to support?"
131
+ 6. "Are there any user actions or system behaviors we discussed that have no FR?"
132
+
133
+ **Altitude Check:**
134
+
135
+ 1. "Am I stating capabilities (WHAT) or implementation (HOW)?"
136
+ 2. "Am I listing acceptance criteria or UI specifics?" (Remove if yes)
137
+ 3. "Could this FR be implemented 5 different ways?" (Good - means it's not prescriptive)
138
+
139
+ **Quality Check:**
140
+
141
+ 1. "Is each FR clear enough that someone could test whether it exists?"
142
+ 2. "Is each FR independent (not dependent on reading other FRs to understand)?"
143
+ 3. "Did I avoid vague terms like 'good', 'fast', 'easy'?" (Use NFRs for quality attributes)
144
+
145
+ ### 6. Generate Functional Requirements Content
146
+
147
+ Prepare the content to append to the document:
148
+
149
+ #### Content Structure:
150
+
151
+ When saving to document, append these Level 2 and Level 3 sections:
152
+
153
+ ```markdown
154
+ ## Functional Requirements
155
+
156
+ ### [Capability Area Name]
157
+
158
+ - FR1: [Specific Actor] can [specific capability]
159
+ - FR2: [Specific Actor] can [specific capability]
160
+ - FR3: [Specific Actor] can [specific capability]
161
+
162
+ ### [Another Capability Area]
163
+
164
+ - FR4: [Specific Actor] can [specific capability]
165
+ - FR5: [Specific Actor] can [specific capability]
166
+
167
+ [Continue for all capability areas discovered in conversation]
168
+ ```
169
+
170
+ ### 7. Present MENU OPTIONS
171
+
172
+ Present the functional requirements for review, then display menu:
173
+ - Show synthesized functional requirements (using structure from step 6)
174
+ - Emphasize this is the capability contract for all downstream work
175
+ - Highlight that every feature must trace back to these requirements
176
+ - Ask if they'd like to refine further, get other perspectives, or proceed
177
+ - Present menu options naturally as part of conversation
178
+
179
+ **What would you like to do?**"
180
+
181
+ Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Non-Functional Requirements (Step 10 of 11)"
182
+
183
+ #### Menu Handling Logic:
184
+ - IF A: Read fully and follow: {advancedElicitationTask} with the current FR list, process the enhanced capability coverage that comes back, ask user if they accept the additions, if yes update content then redisplay menu, if no keep original content then redisplay menu
185
+ - IF P: Read fully and follow: {partyModeWorkflow} with the current FR list, process the collaborative capability validation and additions, ask user if they accept the changes, if yes update content then redisplay menu, if no keep original content then redisplay menu
186
+ - IF C: Append the final content to {outputFile}, update frontmatter by adding this step name to the end of the stepsCompleted array, then read fully and follow: {nextStepFile}
187
+ - IF Any other: help user respond, then redisplay menu
188
+
189
+ #### EXECUTION RULES:
190
+ - ALWAYS halt and wait for user input after presenting menu
191
+ - ONLY proceed to next step when user selects 'C'
192
+ - After other menu items execution, return to this menu
193
+
194
+ ## APPEND TO DOCUMENT:
195
+
196
+ When user selects 'C', append the content directly to the document using the structure from step 6.
197
+
198
+ ## SUCCESS METRICS:
199
+
200
+ ✅ All previous discovery content synthesized into FRs
201
+ ✅ FRs organized by capability areas (not technology)
202
+ ✅ Each FR states WHAT capability exists, not HOW to implement
203
+ ✅ Comprehensive coverage with 20-50 FRs typical
204
+ ✅ Altitude validation ensures implementation-agnostic requirements
205
+ ✅ Completeness check validates coverage of all discussed capabilities
206
+ ✅ A/P/C menu presented and handled correctly
207
+ ✅ Content properly appended to document when C selected
208
+
209
+ ## FAILURE MODES:
210
+
211
+ ❌ Missing capabilities from previous discovery sections
212
+ ❌ Organizing FRs by technology instead of capability areas
213
+ ❌ Including implementation details or UI specifics in FRs
214
+ ❌ Not achieving comprehensive coverage of discussed capabilities
215
+ ❌ Using vague terms instead of testable capabilities
216
+ ❌ Not presenting A/P/C menu after content generation
217
+ ❌ Appending content without user selecting 'C'
218
+
219
+ ❌ **CRITICAL**: Reading only partial step file - leads to incomplete understanding and poor decisions
220
+ ❌ **CRITICAL**: Proceeding with 'C' without fully reading and understanding the next step file
221
+ ❌ **CRITICAL**: Making decisions without complete understanding of step requirements and protocols
222
+
223
+ ## CAPABILITY CONTRACT REMINDER:
224
+
225
+ Emphasize to user: "This FR list is now binding. Any feature not listed here will not exist in the final product unless we explicitly add it. This is why it's critical to ensure completeness now."
226
+
227
+ ## NEXT STEP:
228
+
229
+ After user selects 'C' and content is saved to document, load {nextStepFile} to define non-functional requirements.
230
+
231
+ 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,242 @@
1
+ ---
2
+ name: 'step-10-nonfunctional'
3
+ description: 'Define quality attributes that matter for this specific product'
4
+
5
+ # File References
6
+ nextStepFile: './step-11-polish.md'
7
+ outputFile: '{planning_artifacts}/prd.md'
8
+
9
+ # Task References
10
+ advancedElicitationTask: '{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml'
11
+ partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
12
+ ---
13
+
14
+ # Step 10: Non-Functional Requirements
15
+
16
+ **Progress: Step 10 of 12** - Next: Polish Document
17
+
18
+ ## MANDATORY EXECUTION RULES (READ FIRST):
19
+
20
+ - 🛑 NEVER generate content without user input
21
+
22
+ - 📖 CRITICAL: ALWAYS read the complete step file before taking any action - partial understanding leads to incomplete decisions
23
+ - 🔄 CRITICAL: When loading next step with 'C', ensure the entire file is read and understood before proceeding
24
+ - ✅ ALWAYS treat this as collaborative discovery between PM peers
25
+ - 📋 YOU ARE A FACILITATOR, not a content generator
26
+ - 💬 FOCUS on quality attributes that matter for THIS specific product
27
+ - 🎯 SELECTIVE: Only document NFRs that actually apply to the product
28
+ - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
29
+
30
+ ## EXECUTION PROTOCOLS:
31
+
32
+ - 🎯 Show your analysis before taking any action
33
+ - ⚠️ Present A/P/C menu after generating NFR content
34
+ - 💾 ONLY save when user chooses C (Continue)
35
+ - 📖 Update output file frontmatter, adding this step name to the end of the list of stepsCompleted
36
+ - 🚫 FORBIDDEN to load next step until C is selected
37
+
38
+
39
+ ## CONTEXT BOUNDARIES:
40
+
41
+ - Current document and frontmatter from previous steps are available
42
+ - Functional requirements already defined and will inform NFRs
43
+ - Domain and project-type context will guide which NFRs matter
44
+ - Focus on specific, measurable quality criteria
45
+
46
+ ## YOUR TASK:
47
+
48
+ Define non-functional requirements that specify quality attributes for the product, focusing only on what matters for THIS specific product.
49
+
50
+ ## NON-FUNCTIONAL REQUIREMENTS SEQUENCE:
51
+
52
+ ### 1. Explain NFR Purpose and Scope
53
+
54
+ Start by clarifying what NFRs are and why we're selective:
55
+
56
+ **NFR Purpose:**
57
+ NFRs define HOW WELL the system must perform, not WHAT it must do. They specify quality attributes like performance, security, scalability, etc.
58
+
59
+ **Selective Approach:**
60
+ We only document NFRs that matter for THIS product. If a category doesn't apply, we skip it entirely. This prevents requirement bloat and focuses on what's actually important.
61
+
62
+ ### 2. Assess Product Context for NFR Relevance
63
+
64
+ Evaluate which NFR categories matter based on product context:
65
+
66
+ **Quick Assessment Questions:**
67
+
68
+ - **Performance**: Is there user-facing impact of speed?
69
+ - **Security**: Are we handling sensitive data or payments?
70
+ - **Scalability**: Do we expect rapid user growth?
71
+ - **Accessibility**: Are we serving broad public audiences?
72
+ - **Integration**: Do we need to connect with other systems?
73
+ - **Reliability**: Would downtime cause significant problems?
74
+
75
+ ### 3. Explore Relevant NFR Categories
76
+
77
+ For each relevant category, conduct targeted discovery:
78
+
79
+ #### Performance NFRs (If relevant):
80
+
81
+ Explore performance requirements:
82
+ - What parts of the system need to be fast for users to be successful?
83
+ - Are there specific response time expectations?
84
+ - What happens if performance is slower than expected?
85
+ - Are there concurrent user scenarios we need to support?
86
+
87
+ #### Security NFRs (If relevant):
88
+
89
+ Explore security requirements:
90
+ - What data needs to be protected?
91
+ - Who should have access to what?
92
+ - What are the security risks we need to mitigate?
93
+ - Are there compliance requirements (GDPR, HIPAA, PCI-DSS)?
94
+
95
+ #### Scalability NFRs (If relevant):
96
+
97
+ Explore scalability requirements:
98
+ - How many users do we expect initially? Long-term?
99
+ - Are there seasonal or event-based traffic spikes?
100
+ - What happens if we exceed our capacity?
101
+ - What growth scenarios should we plan for?
102
+
103
+ #### Accessibility NFRs (If relevant):
104
+
105
+ Explore accessibility requirements:
106
+ - Are we serving users with visual, hearing, or motor impairments?
107
+ - Are there legal accessibility requirements (WCAG, Section 508)?
108
+ - What accessibility features are most important for our users?
109
+
110
+ #### Integration NFRs (If relevant):
111
+
112
+ Explore integration requirements:
113
+ - What external systems do we need to connect with?
114
+ - Are there APIs or data formats we must support?
115
+ - How reliable do these integrations need to be?
116
+
117
+ ### 4. Make NFRs Specific and Measurable
118
+
119
+ For each relevant NFR category, ensure criteria are testable:
120
+
121
+ **From Vague to Specific:**
122
+
123
+ - NOT: "The system should be fast" → "User actions complete within 2 seconds"
124
+ - NOT: "The system should be secure" → "All data is encrypted at rest and in transit"
125
+ - NOT: "The system should scale" → "System supports 10x user growth with <10% performance degradation"
126
+
127
+ ### 5. Generate NFR Content (Only Relevant Categories)
128
+
129
+ Prepare the content to append to the document:
130
+
131
+ #### Content Structure (Dynamic based on relevance):
132
+
133
+ When saving to document, append these Level 2 and Level 3 sections (only include sections that are relevant):
134
+
135
+ ```markdown
136
+ ## Non-Functional Requirements
137
+
138
+ ### Performance
139
+
140
+ [Performance requirements based on conversation - only include if relevant]
141
+
142
+ ### Security
143
+
144
+ [Security requirements based on conversation - only include if relevant]
145
+
146
+ ### Scalability
147
+
148
+ [Scalability requirements based on conversation - only include if relevant]
149
+
150
+ ### Accessibility
151
+
152
+ [Accessibility requirements based on conversation - only include if relevant]
153
+
154
+ ### Integration
155
+
156
+ [Integration requirements based on conversation - only include if relevant]
157
+ ```
158
+
159
+ ### 6. Present MENU OPTIONS
160
+
161
+ Present the non-functional requirements for review, then display menu:
162
+ - Show defined NFRs (using structure from step 5)
163
+ - Note that only relevant categories were included
164
+ - Emphasize NFRs specify how well the system needs to perform
165
+ - Ask if they'd like to refine further, get other perspectives, or proceed
166
+ - Present menu options naturally as part of conversation
167
+
168
+ Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Polish Document (Step 11 of 12)"
169
+
170
+ #### Menu Handling Logic:
171
+ - IF A: Read fully and follow: {advancedElicitationTask} with the current NFR content, process the enhanced quality attribute insights that come back, ask user if they accept the improvements, if yes update content then redisplay menu, if no keep original content then redisplay menu
172
+ - IF P: Read fully and follow: {partyModeWorkflow} with the current NFR list, process the collaborative technical validation and additions, ask user if they accept the changes, if yes update content then redisplay menu, if no keep original content then redisplay menu
173
+ - IF C: Append the final content to {outputFile}, update frontmatter by adding this step name to the end of the stepsCompleted array, then read fully and follow: {nextStepFile}
174
+ - IF Any other: help user respond, then redisplay menu
175
+
176
+ #### EXECUTION RULES:
177
+ - ALWAYS halt and wait for user input after presenting menu
178
+ - ONLY proceed to next step when user selects 'C'
179
+ - After other menu items execution, return to this menu
180
+
181
+ ## APPEND TO DOCUMENT:
182
+
183
+ When user selects 'C', append the content directly to the document using the structure from step 5.
184
+
185
+ ## SUCCESS METRICS:
186
+
187
+ ✅ Only relevant NFR categories documented (no requirement bloat)
188
+ ✅ Each NFR is specific and measurable
189
+ ✅ NFRs connected to actual user needs and business context
190
+ ✅ Vague requirements converted to testable criteria
191
+ ✅ Domain-specific compliance requirements included if relevant
192
+ ✅ A/P/C menu presented and handled correctly
193
+ ✅ Content properly appended to document when C selected
194
+
195
+ ## FAILURE MODES:
196
+
197
+ ❌ Documenting NFR categories that don't apply to the product
198
+ ❌ Leaving requirements vague and unmeasurable
199
+ ❌ Not connecting NFRs to actual user or business needs
200
+ ❌ Missing domain-specific compliance requirements
201
+ ❌ Creating overly prescriptive technical requirements
202
+ ❌ Not presenting A/P/C menu after content generation
203
+ ❌ Appending content without user selecting 'C'
204
+
205
+ ❌ **CRITICAL**: Reading only partial step file - leads to incomplete understanding and poor decisions
206
+ ❌ **CRITICAL**: Proceeding with 'C' without fully reading and understanding the next step file
207
+ ❌ **CRITICAL**: Making decisions without complete understanding of step requirements and protocols
208
+
209
+ ## NFR CATEGORY GUIDANCE:
210
+
211
+ **Include Performance When:**
212
+
213
+ - User-facing response times impact success
214
+ - Real-time interactions are critical
215
+ - Performance is a competitive differentiator
216
+
217
+ **Include Security When:**
218
+
219
+ - Handling sensitive user data
220
+ - Processing payments or financial information
221
+ - Subject to compliance regulations
222
+ - Protecting intellectual property
223
+
224
+ **Include Scalability When:**
225
+
226
+ - Expecting rapid user growth
227
+ - Handling variable traffic patterns
228
+ - Supporting enterprise-scale usage
229
+ - Planning for market expansion
230
+
231
+ **Include Accessibility When:**
232
+
233
+ - Serving broad public audiences
234
+ - Subject to accessibility regulations
235
+ - Targeting users with disabilities
236
+ - B2B customers with accessibility requirements
237
+
238
+ ## NEXT STEP:
239
+
240
+ After user selects 'C' and content is saved to document, load {nextStepFile} to finalize the PRD and complete the workflow.
241
+
242
+ Remember: Do NOT proceed to step-11 until user explicitly selects 'C' from the A/P/C menu and content is saved!