bmad-fh 6.0.0-alpha.23

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (626) hide show
  1. package/.coderabbit.yaml +40 -0
  2. package/.githooks/post-checkout +129 -0
  3. package/.githooks/pre-commit +63 -0
  4. package/.githooks/pre-push +135 -0
  5. package/.github/CODE_OF_CONDUCT.md +128 -0
  6. package/.github/FUNDING.yaml +15 -0
  7. package/.github/ISSUE_TEMPLATE/config.yaml +8 -0
  8. package/.github/ISSUE_TEMPLATE/feature_request.md +22 -0
  9. package/.github/ISSUE_TEMPLATE/issue.md +32 -0
  10. package/.github/scripts/discord-helpers.sh +34 -0
  11. package/.github/workflows/bundle-latest.yaml +330 -0
  12. package/.github/workflows/discord.yaml +90 -0
  13. package/.github/workflows/docs.yaml +63 -0
  14. package/.github/workflows/manual-release.yaml +190 -0
  15. package/.github/workflows/publish-multi-artifact.yaml +50 -0
  16. package/.github/workflows/quality.yaml +115 -0
  17. package/.husky/pre-commit +20 -0
  18. package/.markdownlint-cli2.yaml +41 -0
  19. package/.nvmrc +1 -0
  20. package/.prettierignore +9 -0
  21. package/.vscode/settings.json +97 -0
  22. package/CHANGELOG.md +1394 -0
  23. package/CNAME +1 -0
  24. package/CONTRIBUTING.md +306 -0
  25. package/CONTRIBUTORS.md +32 -0
  26. package/LICENSE +30 -0
  27. package/README.md +126 -0
  28. package/SECURITY.md +85 -0
  29. package/TRADEMARK.md +55 -0
  30. package/Wordmark.png +0 -0
  31. package/banner-bmad-method.png +0 -0
  32. package/docs/404.md +9 -0
  33. package/docs/_README_WORKFLOW_DIAGRAMS.md +40 -0
  34. package/docs/_STYLE_GUIDE.md +367 -0
  35. package/docs/_archive/customize-workflows.md +30 -0
  36. package/docs/_archive/getting-started-bmadv4.md +247 -0
  37. package/docs/_archive/vendor-workflows.md +52 -0
  38. package/docs/downloads.md +72 -0
  39. package/docs/explanation/agents/barry-quick-flow.md +328 -0
  40. package/docs/explanation/agents/index.md +19 -0
  41. package/docs/explanation/architecture/four-phases.md +107 -0
  42. package/docs/explanation/architecture/preventing-agent-conflicts.md +111 -0
  43. package/docs/explanation/architecture/why-solutioning-matters.md +75 -0
  44. package/docs/explanation/bmm/index.md +131 -0
  45. package/docs/explanation/core/index.md +18 -0
  46. package/docs/explanation/core-concepts/agent-roles.md +179 -0
  47. package/docs/explanation/core-concepts/index.md +35 -0
  48. package/docs/explanation/core-concepts/what-are-agents.md +97 -0
  49. package/docs/explanation/core-concepts/what-are-modules.md +85 -0
  50. package/docs/explanation/core-concepts/what-are-workflows.md +204 -0
  51. package/docs/explanation/faq/brownfield-faq.md +73 -0
  52. package/docs/explanation/faq/getting-started-faq.md +67 -0
  53. package/docs/explanation/faq/implementation-faq.md +52 -0
  54. package/docs/explanation/faq/index.md +16 -0
  55. package/docs/explanation/faq/levels-and-tracks-faq.md +52 -0
  56. package/docs/explanation/faq/planning-faq.md +41 -0
  57. package/docs/explanation/faq/tools-faq.md +277 -0
  58. package/docs/explanation/faq/workflows-faq.md +61 -0
  59. package/docs/explanation/features/advanced-elicitation.md +95 -0
  60. package/docs/explanation/features/brainstorming-techniques.md +92 -0
  61. package/docs/explanation/features/party-mode.md +95 -0
  62. package/docs/explanation/features/quick-flow.md +149 -0
  63. package/docs/explanation/features/tea-overview.md +410 -0
  64. package/docs/explanation/features/web-bundles.md +34 -0
  65. package/docs/explanation/philosophy/facilitation-over-generation.md +333 -0
  66. package/docs/explanation/philosophy/testing-as-engineering.md +112 -0
  67. package/docs/explanation/tea/engagement-models.md +710 -0
  68. package/docs/explanation/tea/fixture-architecture.md +457 -0
  69. package/docs/explanation/tea/knowledge-base-system.md +554 -0
  70. package/docs/explanation/tea/network-first-patterns.md +853 -0
  71. package/docs/explanation/tea/risk-based-testing.md +586 -0
  72. package/docs/explanation/tea/test-quality-standards.md +907 -0
  73. package/docs/how-to/brownfield/add-feature-to-existing.md +74 -0
  74. package/docs/how-to/brownfield/document-existing-project.md +66 -0
  75. package/docs/how-to/brownfield/index.md +84 -0
  76. package/docs/how-to/brownfield/quick-fix-in-brownfield.md +77 -0
  77. package/docs/how-to/brownfield/use-tea-for-enterprise.md +526 -0
  78. package/docs/how-to/brownfield/use-tea-with-existing-tests.md +577 -0
  79. package/docs/how-to/customization/customize-agents.md +212 -0
  80. package/docs/how-to/customization/enable-tea-mcp-enhancements.md +424 -0
  81. package/docs/how-to/customization/index.md +23 -0
  82. package/docs/how-to/customization/integrate-playwright-utils.md +813 -0
  83. package/docs/how-to/customization/shard-large-documents.md +101 -0
  84. package/docs/how-to/get-answers-about-bmad.md +102 -0
  85. package/docs/how-to/installation/index.md +12 -0
  86. package/docs/how-to/installation/install-bmad.md +111 -0
  87. package/docs/how-to/installation/install-custom-modules.md +118 -0
  88. package/docs/how-to/installation/upgrade-to-v6.md +131 -0
  89. package/docs/how-to/workflows/bmgd-quick-flow.md +156 -0
  90. package/docs/how-to/workflows/conduct-research.md +97 -0
  91. package/docs/how-to/workflows/create-architecture.md +119 -0
  92. package/docs/how-to/workflows/create-epics-and-stories.md +109 -0
  93. package/docs/how-to/workflows/create-prd.md +91 -0
  94. package/docs/how-to/workflows/create-product-brief.md +94 -0
  95. package/docs/how-to/workflows/create-story.md +102 -0
  96. package/docs/how-to/workflows/create-ux-design.md +100 -0
  97. package/docs/how-to/workflows/implement-story.md +97 -0
  98. package/docs/how-to/workflows/quick-spec.md +122 -0
  99. package/docs/how-to/workflows/run-atdd.md +436 -0
  100. package/docs/how-to/workflows/run-automate.md +653 -0
  101. package/docs/how-to/workflows/run-brainstorming-session.md +73 -0
  102. package/docs/how-to/workflows/run-code-review.md +89 -0
  103. package/docs/how-to/workflows/run-implementation-readiness.md +125 -0
  104. package/docs/how-to/workflows/run-nfr-assess.md +679 -0
  105. package/docs/how-to/workflows/run-sprint-planning.md +94 -0
  106. package/docs/how-to/workflows/run-test-design.md +98 -0
  107. package/docs/how-to/workflows/run-test-review.md +605 -0
  108. package/docs/how-to/workflows/run-trace.md +883 -0
  109. package/docs/how-to/workflows/setup-ci.md +712 -0
  110. package/docs/how-to/workflows/setup-party-mode.md +89 -0
  111. package/docs/how-to/workflows/setup-test-framework.md +98 -0
  112. package/docs/index.md +63 -0
  113. package/docs/migration-guide.md +365 -0
  114. package/docs/multi-scope-guide.md +379 -0
  115. package/docs/plans/multi-scope-parallel-artifacts-plan.md +695 -0
  116. package/docs/reference/agents/index.md +109 -0
  117. package/docs/reference/configuration/core-tasks.md +67 -0
  118. package/docs/reference/configuration/global-config.md +28 -0
  119. package/docs/reference/glossary/index.md +159 -0
  120. package/docs/reference/tea/commands.md +254 -0
  121. package/docs/reference/tea/configuration.md +678 -0
  122. package/docs/reference/tea/knowledge-base.md +340 -0
  123. package/docs/reference/workflows/core-workflows.md +32 -0
  124. package/docs/reference/workflows/document-project.md +73 -0
  125. package/docs/reference/workflows/index.md +12 -0
  126. package/docs/tutorials/getting-started/getting-started-bmadv6.md +246 -0
  127. package/docs/tutorials/getting-started/images/workflow-method-greenfield.excalidraw +5034 -0
  128. package/docs/tutorials/getting-started/images/workflow-method-greenfield.svg +4 -0
  129. package/docs/tutorials/getting-started/images/workflow-overview.jpg +0 -0
  130. package/docs/tutorials/getting-started/tea-lite-quickstart.md +444 -0
  131. package/docs/tutorials/getting-started/workflow-overview.jpg +0 -0
  132. package/eslint.config.mjs +152 -0
  133. package/package.json +117 -0
  134. package/prettier.config.mjs +32 -0
  135. package/src/bmm/_module-installer/installer.js +48 -0
  136. package/src/bmm/_module-installer/platform-specifics/claude-code.js +35 -0
  137. package/src/bmm/_module-installer/platform-specifics/windsurf.js +32 -0
  138. package/src/bmm/agents/analyst.agent.yaml +41 -0
  139. package/src/bmm/agents/architect.agent.yaml +33 -0
  140. package/src/bmm/agents/dev.agent.yaml +38 -0
  141. package/src/bmm/agents/pm.agent.yaml +51 -0
  142. package/src/bmm/agents/quick-flow-solo-dev.agent.yaml +32 -0
  143. package/src/bmm/agents/sm.agent.yaml +47 -0
  144. package/src/bmm/agents/tea.agent.yaml +68 -0
  145. package/src/bmm/agents/tech-writer/tech-writer-sidecar/documentation-standards.md +224 -0
  146. package/src/bmm/agents/tech-writer/tech-writer.agent.yaml +49 -0
  147. package/src/bmm/agents/ux-designer.agent.yaml +30 -0
  148. package/src/bmm/data/README.md +29 -0
  149. package/src/bmm/data/project-context-template.md +40 -0
  150. package/src/bmm/module.yaml +64 -0
  151. package/src/bmm/sub-modules/claude-code/config.yaml +4 -0
  152. package/src/bmm/sub-modules/claude-code/injections.yaml +242 -0
  153. package/src/bmm/sub-modules/claude-code/readme.md +87 -0
  154. package/src/bmm/teams/default-party.csv +21 -0
  155. package/src/bmm/teams/team-fullstack.yaml +12 -0
  156. package/src/bmm/testarch/knowledge/api-request.md +442 -0
  157. package/src/bmm/testarch/knowledge/api-testing-patterns.md +843 -0
  158. package/src/bmm/testarch/knowledge/auth-session.md +552 -0
  159. package/src/bmm/testarch/knowledge/burn-in.md +273 -0
  160. package/src/bmm/testarch/knowledge/ci-burn-in.md +675 -0
  161. package/src/bmm/testarch/knowledge/component-tdd.md +486 -0
  162. package/src/bmm/testarch/knowledge/contract-testing.md +957 -0
  163. package/src/bmm/testarch/knowledge/data-factories.md +500 -0
  164. package/src/bmm/testarch/knowledge/email-auth.md +721 -0
  165. package/src/bmm/testarch/knowledge/error-handling.md +725 -0
  166. package/src/bmm/testarch/knowledge/feature-flags.md +750 -0
  167. package/src/bmm/testarch/knowledge/file-utils.md +463 -0
  168. package/src/bmm/testarch/knowledge/fixture-architecture.md +401 -0
  169. package/src/bmm/testarch/knowledge/fixtures-composition.md +382 -0
  170. package/src/bmm/testarch/knowledge/intercept-network-call.md +430 -0
  171. package/src/bmm/testarch/knowledge/log.md +429 -0
  172. package/src/bmm/testarch/knowledge/network-error-monitor.md +405 -0
  173. package/src/bmm/testarch/knowledge/network-first.md +486 -0
  174. package/src/bmm/testarch/knowledge/network-recorder.md +527 -0
  175. package/src/bmm/testarch/knowledge/nfr-criteria.md +670 -0
  176. package/src/bmm/testarch/knowledge/overview.md +286 -0
  177. package/src/bmm/testarch/knowledge/playwright-config.md +730 -0
  178. package/src/bmm/testarch/knowledge/probability-impact.md +601 -0
  179. package/src/bmm/testarch/knowledge/recurse.md +421 -0
  180. package/src/bmm/testarch/knowledge/risk-governance.md +615 -0
  181. package/src/bmm/testarch/knowledge/selective-testing.md +732 -0
  182. package/src/bmm/testarch/knowledge/selector-resilience.md +527 -0
  183. package/src/bmm/testarch/knowledge/test-healing-patterns.md +644 -0
  184. package/src/bmm/testarch/knowledge/test-levels-framework.md +473 -0
  185. package/src/bmm/testarch/knowledge/test-priorities-matrix.md +373 -0
  186. package/src/bmm/testarch/knowledge/test-quality.md +664 -0
  187. package/src/bmm/testarch/knowledge/timing-debugging.md +372 -0
  188. package/src/bmm/testarch/knowledge/visual-debugging.md +524 -0
  189. package/src/bmm/testarch/tea-index.csv +34 -0
  190. package/src/bmm/workflows/1-analysis/create-product-brief/product-brief.template.md +10 -0
  191. package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-01-init.md +177 -0
  192. package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-01b-continue.md +161 -0
  193. package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-02-vision.md +199 -0
  194. package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-03-users.md +202 -0
  195. package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-04-metrics.md +205 -0
  196. package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-05-scope.md +219 -0
  197. package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-06-complete.md +194 -0
  198. package/src/bmm/workflows/1-analysis/create-product-brief/workflow.md +58 -0
  199. package/src/bmm/workflows/1-analysis/research/domain-steps/step-01-init.md +137 -0
  200. package/src/bmm/workflows/1-analysis/research/domain-steps/step-02-domain-analysis.md +229 -0
  201. package/src/bmm/workflows/1-analysis/research/domain-steps/step-03-competitive-landscape.md +238 -0
  202. package/src/bmm/workflows/1-analysis/research/domain-steps/step-04-regulatory-focus.md +206 -0
  203. package/src/bmm/workflows/1-analysis/research/domain-steps/step-05-technical-trends.md +234 -0
  204. package/src/bmm/workflows/1-analysis/research/domain-steps/step-06-research-synthesis.md +443 -0
  205. package/src/bmm/workflows/1-analysis/research/market-steps/step-01-init.md +182 -0
  206. package/src/bmm/workflows/1-analysis/research/market-steps/step-02-customer-behavior.md +237 -0
  207. package/src/bmm/workflows/1-analysis/research/market-steps/step-02-customer-insights.md +200 -0
  208. package/src/bmm/workflows/1-analysis/research/market-steps/step-03-customer-pain-points.md +249 -0
  209. package/src/bmm/workflows/1-analysis/research/market-steps/step-04-customer-decisions.md +259 -0
  210. package/src/bmm/workflows/1-analysis/research/market-steps/step-05-competitive-analysis.md +177 -0
  211. package/src/bmm/workflows/1-analysis/research/market-steps/step-06-research-completion.md +475 -0
  212. package/src/bmm/workflows/1-analysis/research/research.template.md +29 -0
  213. package/src/bmm/workflows/1-analysis/research/technical-steps/step-01-init.md +137 -0
  214. package/src/bmm/workflows/1-analysis/research/technical-steps/step-02-technical-overview.md +239 -0
  215. package/src/bmm/workflows/1-analysis/research/technical-steps/step-03-integration-patterns.md +248 -0
  216. package/src/bmm/workflows/1-analysis/research/technical-steps/step-04-architectural-patterns.md +202 -0
  217. package/src/bmm/workflows/1-analysis/research/technical-steps/step-05-implementation-research.md +239 -0
  218. package/src/bmm/workflows/1-analysis/research/technical-steps/step-06-research-synthesis.md +486 -0
  219. package/src/bmm/workflows/1-analysis/research/workflow.md +173 -0
  220. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-01-init.md +135 -0
  221. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-01b-continue.md +127 -0
  222. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-02-discovery.md +190 -0
  223. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-03-core-experience.md +216 -0
  224. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-04-emotional-response.md +219 -0
  225. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-05-inspiration.md +234 -0
  226. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-06-design-system.md +252 -0
  227. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-07-defining-experience.md +254 -0
  228. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-08-visual-foundation.md +224 -0
  229. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-09-design-directions.md +224 -0
  230. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-10-user-journeys.md +241 -0
  231. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-11-component-strategy.md +248 -0
  232. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-12-ux-patterns.md +237 -0
  233. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-13-responsive-accessibility.md +264 -0
  234. package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-14-complete.md +228 -0
  235. package/src/bmm/workflows/2-plan-workflows/create-ux-design/ux-design-template.md +13 -0
  236. package/src/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md +43 -0
  237. package/src/bmm/workflows/2-plan-workflows/prd/data/domain-complexity.csv +13 -0
  238. package/src/bmm/workflows/2-plan-workflows/prd/data/prd-purpose.md +197 -0
  239. package/src/bmm/workflows/2-plan-workflows/prd/data/project-types.csv +11 -0
  240. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-01-init.md +191 -0
  241. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-01b-continue.md +153 -0
  242. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-02-discovery.md +224 -0
  243. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-03-success.md +226 -0
  244. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-04-journeys.md +213 -0
  245. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-05-domain.md +207 -0
  246. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-06-innovation.md +226 -0
  247. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-07-project-type.md +237 -0
  248. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-08-scoping.md +228 -0
  249. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-09-functional.md +231 -0
  250. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-10-nonfunctional.md +242 -0
  251. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-11-polish.md +217 -0
  252. package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-12-complete.md +180 -0
  253. package/src/bmm/workflows/2-plan-workflows/prd/steps-e/step-e-01-discovery.md +247 -0
  254. package/src/bmm/workflows/2-plan-workflows/prd/steps-e/step-e-01b-legacy-conversion.md +208 -0
  255. package/src/bmm/workflows/2-plan-workflows/prd/steps-e/step-e-02-review.md +249 -0
  256. package/src/bmm/workflows/2-plan-workflows/prd/steps-e/step-e-03-edit.md +253 -0
  257. package/src/bmm/workflows/2-plan-workflows/prd/steps-e/step-e-04-complete.md +168 -0
  258. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-01-discovery.md +218 -0
  259. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-02-format-detection.md +191 -0
  260. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-02b-parity-check.md +209 -0
  261. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-03-density-validation.md +174 -0
  262. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-04-brief-coverage-validation.md +214 -0
  263. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-05-measurability-validation.md +228 -0
  264. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-06-traceability-validation.md +217 -0
  265. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-07-implementation-leakage-validation.md +205 -0
  266. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-08-domain-compliance-validation.md +243 -0
  267. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-09-project-type-validation.md +263 -0
  268. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-10-smart-validation.md +209 -0
  269. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-11-holistic-quality-validation.md +264 -0
  270. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-12-completeness-validation.md +242 -0
  271. package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-13-report-complete.md +232 -0
  272. package/src/bmm/workflows/2-plan-workflows/prd/templates/prd-template.md +10 -0
  273. package/src/bmm/workflows/2-plan-workflows/prd/validation-report-prd-workflow.md +433 -0
  274. package/src/bmm/workflows/2-plan-workflows/prd/workflow.md +150 -0
  275. package/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-01-document-discovery.md +190 -0
  276. package/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-02-prd-analysis.md +178 -0
  277. package/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-03-epic-coverage-validation.md +179 -0
  278. package/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-04-ux-alignment.md +139 -0
  279. package/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-05-epic-quality-review.md +252 -0
  280. package/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-06-final-assessment.md +133 -0
  281. package/src/bmm/workflows/3-solutioning/check-implementation-readiness/templates/readiness-report-template.md +4 -0
  282. package/src/bmm/workflows/3-solutioning/check-implementation-readiness/workflow.md +55 -0
  283. package/src/bmm/workflows/3-solutioning/create-architecture/architecture-decision-template.md +12 -0
  284. package/src/bmm/workflows/3-solutioning/create-architecture/data/domain-complexity.csv +11 -0
  285. package/src/bmm/workflows/3-solutioning/create-architecture/data/project-types.csv +7 -0
  286. package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-01-init.md +153 -0
  287. package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-01b-continue.md +164 -0
  288. package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-02-context.md +224 -0
  289. package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-03-starter.md +331 -0
  290. package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-04-decisions.md +318 -0
  291. package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-05-patterns.md +359 -0
  292. package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-06-structure.md +379 -0
  293. package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-07-validation.md +359 -0
  294. package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-08-complete.md +352 -0
  295. package/src/bmm/workflows/3-solutioning/create-architecture/workflow.md +50 -0
  296. package/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-01-validate-prerequisites.md +259 -0
  297. package/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-02-design-epics.md +233 -0
  298. package/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-03-create-stories.md +272 -0
  299. package/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-04-final-validation.md +145 -0
  300. package/src/bmm/workflows/3-solutioning/create-epics-and-stories/templates/epics-template.md +57 -0
  301. package/src/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md +59 -0
  302. package/src/bmm/workflows/4-implementation/code-review/checklist.md +23 -0
  303. package/src/bmm/workflows/4-implementation/code-review/instructions.xml +227 -0
  304. package/src/bmm/workflows/4-implementation/code-review/workflow.yaml +51 -0
  305. package/src/bmm/workflows/4-implementation/correct-course/checklist.md +288 -0
  306. package/src/bmm/workflows/4-implementation/correct-course/instructions.md +206 -0
  307. package/src/bmm/workflows/4-implementation/correct-course/workflow.yaml +60 -0
  308. package/src/bmm/workflows/4-implementation/create-story/checklist.md +358 -0
  309. package/src/bmm/workflows/4-implementation/create-story/instructions.xml +345 -0
  310. package/src/bmm/workflows/4-implementation/create-story/template.md +49 -0
  311. package/src/bmm/workflows/4-implementation/create-story/workflow.yaml +61 -0
  312. package/src/bmm/workflows/4-implementation/dev-story/checklist.md +80 -0
  313. package/src/bmm/workflows/4-implementation/dev-story/instructions.xml +410 -0
  314. package/src/bmm/workflows/4-implementation/dev-story/workflow.yaml +27 -0
  315. package/src/bmm/workflows/4-implementation/retrospective/instructions.md +1443 -0
  316. package/src/bmm/workflows/4-implementation/retrospective/workflow.yaml +58 -0
  317. package/src/bmm/workflows/4-implementation/sprint-planning/checklist.md +33 -0
  318. package/src/bmm/workflows/4-implementation/sprint-planning/instructions.md +225 -0
  319. package/src/bmm/workflows/4-implementation/sprint-planning/sprint-status-template.yaml +55 -0
  320. package/src/bmm/workflows/4-implementation/sprint-planning/workflow.yaml +54 -0
  321. package/src/bmm/workflows/4-implementation/sprint-status/instructions.md +229 -0
  322. package/src/bmm/workflows/4-implementation/sprint-status/workflow.yaml +36 -0
  323. package/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-01-mode-detection.md +156 -0
  324. package/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-02-context-gathering.md +120 -0
  325. package/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-03-execute.md +113 -0
  326. package/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-04-self-check.md +113 -0
  327. package/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-05-adversarial-review.md +106 -0
  328. package/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-06-resolve-findings.md +140 -0
  329. package/src/bmm/workflows/bmad-quick-flow/quick-dev/workflow.md +52 -0
  330. package/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-01-understand.md +189 -0
  331. package/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-02-investigate.md +144 -0
  332. package/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-03-generate.md +128 -0
  333. package/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-04-review.md +191 -0
  334. package/src/bmm/workflows/bmad-quick-flow/quick-spec/tech-spec-template.md +74 -0
  335. package/src/bmm/workflows/bmad-quick-flow/quick-spec/workflow.md +79 -0
  336. package/src/bmm/workflows/document-project/checklist.md +245 -0
  337. package/src/bmm/workflows/document-project/documentation-requirements.csv +12 -0
  338. package/src/bmm/workflows/document-project/instructions.md +221 -0
  339. package/src/bmm/workflows/document-project/templates/deep-dive-template.md +345 -0
  340. package/src/bmm/workflows/document-project/templates/index-template.md +169 -0
  341. package/src/bmm/workflows/document-project/templates/project-overview-template.md +103 -0
  342. package/src/bmm/workflows/document-project/templates/project-scan-report-schema.json +160 -0
  343. package/src/bmm/workflows/document-project/templates/source-tree-template.md +135 -0
  344. package/src/bmm/workflows/document-project/workflow.yaml +30 -0
  345. package/src/bmm/workflows/document-project/workflows/deep-dive-instructions.md +298 -0
  346. package/src/bmm/workflows/document-project/workflows/deep-dive.yaml +31 -0
  347. package/src/bmm/workflows/document-project/workflows/full-scan-instructions.md +1106 -0
  348. package/src/bmm/workflows/document-project/workflows/full-scan.yaml +31 -0
  349. package/src/bmm/workflows/excalidraw-diagrams/_shared/excalidraw-library.json +90 -0
  350. package/src/bmm/workflows/excalidraw-diagrams/_shared/excalidraw-templates.yaml +127 -0
  351. package/src/bmm/workflows/excalidraw-diagrams/create-dataflow/checklist.md +39 -0
  352. package/src/bmm/workflows/excalidraw-diagrams/create-dataflow/instructions.md +130 -0
  353. package/src/bmm/workflows/excalidraw-diagrams/create-dataflow/workflow.yaml +27 -0
  354. package/src/bmm/workflows/excalidraw-diagrams/create-diagram/checklist.md +43 -0
  355. package/src/bmm/workflows/excalidraw-diagrams/create-diagram/instructions.md +141 -0
  356. package/src/bmm/workflows/excalidraw-diagrams/create-diagram/workflow.yaml +27 -0
  357. package/src/bmm/workflows/excalidraw-diagrams/create-flowchart/checklist.md +49 -0
  358. package/src/bmm/workflows/excalidraw-diagrams/create-flowchart/instructions.md +241 -0
  359. package/src/bmm/workflows/excalidraw-diagrams/create-flowchart/workflow.yaml +27 -0
  360. package/src/bmm/workflows/excalidraw-diagrams/create-wireframe/checklist.md +38 -0
  361. package/src/bmm/workflows/excalidraw-diagrams/create-wireframe/instructions.md +133 -0
  362. package/src/bmm/workflows/excalidraw-diagrams/create-wireframe/workflow.yaml +27 -0
  363. package/src/bmm/workflows/generate-project-context/project-context-template.md +21 -0
  364. package/src/bmm/workflows/generate-project-context/steps/step-01-discover.md +184 -0
  365. package/src/bmm/workflows/generate-project-context/steps/step-02-generate.md +318 -0
  366. package/src/bmm/workflows/generate-project-context/steps/step-03-complete.md +278 -0
  367. package/src/bmm/workflows/generate-project-context/workflow.md +49 -0
  368. package/src/bmm/workflows/testarch/atdd/atdd-checklist-template.md +364 -0
  369. package/src/bmm/workflows/testarch/atdd/checklist.md +374 -0
  370. package/src/bmm/workflows/testarch/atdd/instructions.md +806 -0
  371. package/src/bmm/workflows/testarch/atdd/workflow.yaml +47 -0
  372. package/src/bmm/workflows/testarch/automate/checklist.md +582 -0
  373. package/src/bmm/workflows/testarch/automate/instructions.md +1324 -0
  374. package/src/bmm/workflows/testarch/automate/workflow.yaml +54 -0
  375. package/src/bmm/workflows/testarch/ci/checklist.md +248 -0
  376. package/src/bmm/workflows/testarch/ci/github-actions-template.yaml +198 -0
  377. package/src/bmm/workflows/testarch/ci/gitlab-ci-template.yaml +149 -0
  378. package/src/bmm/workflows/testarch/ci/instructions.md +536 -0
  379. package/src/bmm/workflows/testarch/ci/workflow.yaml +47 -0
  380. package/src/bmm/workflows/testarch/framework/checklist.md +321 -0
  381. package/src/bmm/workflows/testarch/framework/instructions.md +481 -0
  382. package/src/bmm/workflows/testarch/framework/workflow.yaml +49 -0
  383. package/src/bmm/workflows/testarch/nfr-assess/checklist.md +407 -0
  384. package/src/bmm/workflows/testarch/nfr-assess/instructions.md +722 -0
  385. package/src/bmm/workflows/testarch/nfr-assess/nfr-report-template.md +445 -0
  386. package/src/bmm/workflows/testarch/nfr-assess/workflow.yaml +49 -0
  387. package/src/bmm/workflows/testarch/test-design/checklist.md +235 -0
  388. package/src/bmm/workflows/testarch/test-design/instructions.md +788 -0
  389. package/src/bmm/workflows/testarch/test-design/test-design-template.md +294 -0
  390. package/src/bmm/workflows/testarch/test-design/workflow.yaml +56 -0
  391. package/src/bmm/workflows/testarch/test-review/checklist.md +472 -0
  392. package/src/bmm/workflows/testarch/test-review/instructions.md +628 -0
  393. package/src/bmm/workflows/testarch/test-review/test-review-template.md +390 -0
  394. package/src/bmm/workflows/testarch/test-review/workflow.yaml +48 -0
  395. package/src/bmm/workflows/testarch/trace/checklist.md +655 -0
  396. package/src/bmm/workflows/testarch/trace/instructions.md +1047 -0
  397. package/src/bmm/workflows/testarch/trace/trace-template.md +675 -0
  398. package/src/bmm/workflows/testarch/trace/workflow.yaml +57 -0
  399. package/src/bmm/workflows/workflow-status/init/instructions.md +346 -0
  400. package/src/bmm/workflows/workflow-status/init/workflow.yaml +30 -0
  401. package/src/bmm/workflows/workflow-status/instructions.md +397 -0
  402. package/src/bmm/workflows/workflow-status/paths/enterprise-brownfield.yaml +103 -0
  403. package/src/bmm/workflows/workflow-status/paths/enterprise-greenfield.yaml +100 -0
  404. package/src/bmm/workflows/workflow-status/paths/method-brownfield.yaml +103 -0
  405. package/src/bmm/workflows/workflow-status/paths/method-greenfield.yaml +100 -0
  406. package/src/bmm/workflows/workflow-status/project-levels.yaml +59 -0
  407. package/src/bmm/workflows/workflow-status/workflow-status-template.yaml +24 -0
  408. package/src/bmm/workflows/workflow-status/workflow.yaml +32 -0
  409. package/src/core/_module-installer/installer.js +60 -0
  410. package/src/core/agents/bmad-master.agent.yaml +30 -0
  411. package/src/core/lib/scope/artifact-resolver.js +298 -0
  412. package/src/core/lib/scope/event-logger.js +411 -0
  413. package/src/core/lib/scope/index.js +30 -0
  414. package/src/core/lib/scope/scope-context.js +307 -0
  415. package/src/core/lib/scope/scope-initializer.js +458 -0
  416. package/src/core/lib/scope/scope-manager.js +512 -0
  417. package/src/core/lib/scope/scope-migrator.js +442 -0
  418. package/src/core/lib/scope/scope-sync.js +489 -0
  419. package/src/core/lib/scope/scope-validator.js +299 -0
  420. package/src/core/lib/scope/state-lock.js +342 -0
  421. package/src/core/module.yaml +53 -0
  422. package/src/core/resources/excalidraw/README.md +160 -0
  423. package/src/core/resources/excalidraw/excalidraw-helpers.md +127 -0
  424. package/src/core/resources/excalidraw/library-loader.md +50 -0
  425. package/src/core/resources/excalidraw/validate-json-instructions.md +79 -0
  426. package/src/core/tasks/editorial-review-prose.xml +91 -0
  427. package/src/core/tasks/editorial-review-structure.xml +198 -0
  428. package/src/core/tasks/index-docs.xml +65 -0
  429. package/src/core/tasks/review-adversarial-general.xml +46 -0
  430. package/src/core/tasks/shard-doc.xml +109 -0
  431. package/src/core/tasks/workflow.xml +277 -0
  432. package/src/core/workflows/advanced-elicitation/methods.csv +51 -0
  433. package/src/core/workflows/advanced-elicitation/workflow.xml +117 -0
  434. package/src/core/workflows/brainstorming/brain-methods.csv +62 -0
  435. package/src/core/workflows/brainstorming/steps/step-01-session-setup.md +197 -0
  436. package/src/core/workflows/brainstorming/steps/step-01b-continue.md +122 -0
  437. package/src/core/workflows/brainstorming/steps/step-02a-user-selected.md +225 -0
  438. package/src/core/workflows/brainstorming/steps/step-02b-ai-recommended.md +237 -0
  439. package/src/core/workflows/brainstorming/steps/step-02c-random-selection.md +209 -0
  440. package/src/core/workflows/brainstorming/steps/step-02d-progressive-flow.md +264 -0
  441. package/src/core/workflows/brainstorming/steps/step-03-technique-execution.md +399 -0
  442. package/src/core/workflows/brainstorming/steps/step-04-idea-organization.md +303 -0
  443. package/src/core/workflows/brainstorming/template.md +15 -0
  444. package/src/core/workflows/brainstorming/workflow.md +58 -0
  445. package/src/core/workflows/party-mode/steps/step-01-agent-loading.md +138 -0
  446. package/src/core/workflows/party-mode/steps/step-02-discussion-orchestration.md +187 -0
  447. package/src/core/workflows/party-mode/steps/step-03-graceful-exit.md +157 -0
  448. package/src/core/workflows/party-mode/workflow.md +194 -0
  449. package/src/utility/agent-components/activation-rules.txt +6 -0
  450. package/src/utility/agent-components/activation-steps.txt +28 -0
  451. package/src/utility/agent-components/agent-command-header.md +1 -0
  452. package/src/utility/agent-components/agent.customize.template.yaml +41 -0
  453. package/src/utility/agent-components/handler-action.txt +4 -0
  454. package/src/utility/agent-components/handler-data.txt +5 -0
  455. package/src/utility/agent-components/handler-exec.txt +19 -0
  456. package/src/utility/agent-components/handler-multi.txt +14 -0
  457. package/src/utility/agent-components/handler-tmpl.txt +5 -0
  458. package/src/utility/agent-components/handler-validate-workflow.txt +7 -0
  459. package/src/utility/agent-components/handler-workflow.txt +10 -0
  460. package/src/utility/agent-components/menu-handlers.txt +6 -0
  461. package/test/README.md +295 -0
  462. package/test/fixtures/agent-schema/invalid/critical-actions/actions-as-string.agent.yaml +27 -0
  463. package/test/fixtures/agent-schema/invalid/critical-actions/empty-string-in-actions.agent.yaml +30 -0
  464. package/test/fixtures/agent-schema/invalid/menu/empty-menu.agent.yaml +22 -0
  465. package/test/fixtures/agent-schema/invalid/menu/missing-menu.agent.yaml +20 -0
  466. package/test/fixtures/agent-schema/invalid/menu-commands/empty-command-target.agent.yaml +25 -0
  467. package/test/fixtures/agent-schema/invalid/menu-commands/no-command-target.agent.yaml +24 -0
  468. package/test/fixtures/agent-schema/invalid/menu-triggers/camel-case.agent.yaml +25 -0
  469. package/test/fixtures/agent-schema/invalid/menu-triggers/compound-invalid-format.agent.yaml +25 -0
  470. package/test/fixtures/agent-schema/invalid/menu-triggers/compound-mismatched-kebab.agent.yaml +25 -0
  471. package/test/fixtures/agent-schema/invalid/menu-triggers/duplicate-triggers.agent.yaml +31 -0
  472. package/test/fixtures/agent-schema/invalid/menu-triggers/empty-trigger.agent.yaml +25 -0
  473. package/test/fixtures/agent-schema/invalid/menu-triggers/leading-asterisk.agent.yaml +25 -0
  474. package/test/fixtures/agent-schema/invalid/menu-triggers/snake-case.agent.yaml +25 -0
  475. package/test/fixtures/agent-schema/invalid/menu-triggers/trigger-with-spaces.agent.yaml +25 -0
  476. package/test/fixtures/agent-schema/invalid/metadata/empty-module-string.agent.yaml +26 -0
  477. package/test/fixtures/agent-schema/invalid/metadata/empty-name.agent.yaml +24 -0
  478. package/test/fixtures/agent-schema/invalid/metadata/extra-metadata-fields.agent.yaml +27 -0
  479. package/test/fixtures/agent-schema/invalid/metadata/missing-id.agent.yaml +23 -0
  480. package/test/fixtures/agent-schema/invalid/persona/empty-principles-array.agent.yaml +24 -0
  481. package/test/fixtures/agent-schema/invalid/persona/empty-string-in-principles.agent.yaml +27 -0
  482. package/test/fixtures/agent-schema/invalid/persona/extra-persona-fields.agent.yaml +27 -0
  483. package/test/fixtures/agent-schema/invalid/persona/missing-role.agent.yaml +24 -0
  484. package/test/fixtures/agent-schema/invalid/prompts/empty-content.agent.yaml +29 -0
  485. package/test/fixtures/agent-schema/invalid/prompts/extra-prompt-fields.agent.yaml +31 -0
  486. package/test/fixtures/agent-schema/invalid/prompts/missing-content.agent.yaml +28 -0
  487. package/test/fixtures/agent-schema/invalid/prompts/missing-id.agent.yaml +28 -0
  488. package/test/fixtures/agent-schema/invalid/top-level/empty-file.agent.yaml +5 -0
  489. package/test/fixtures/agent-schema/invalid/top-level/extra-top-level-keys.agent.yaml +28 -0
  490. package/test/fixtures/agent-schema/invalid/top-level/missing-agent-key.agent.yaml +11 -0
  491. package/test/fixtures/agent-schema/invalid/yaml-errors/invalid-indentation.agent.yaml +19 -0
  492. package/test/fixtures/agent-schema/invalid/yaml-errors/malformed-yaml.agent.yaml +18 -0
  493. package/test/fixtures/agent-schema/valid/critical-actions/empty-critical-actions.agent.yaml +24 -0
  494. package/test/fixtures/agent-schema/valid/critical-actions/no-critical-actions.agent.yaml +22 -0
  495. package/test/fixtures/agent-schema/valid/critical-actions/valid-critical-actions.agent.yaml +27 -0
  496. package/test/fixtures/agent-schema/valid/menu/multiple-menu-items.agent.yaml +31 -0
  497. package/test/fixtures/agent-schema/valid/menu/single-menu-item.agent.yaml +22 -0
  498. package/test/fixtures/agent-schema/valid/menu-commands/all-command-types.agent.yaml +38 -0
  499. package/test/fixtures/agent-schema/valid/menu-commands/multiple-commands.agent.yaml +24 -0
  500. package/test/fixtures/agent-schema/valid/menu-triggers/compound-triggers.agent.yaml +31 -0
  501. package/test/fixtures/agent-schema/valid/menu-triggers/kebab-case-triggers.agent.yaml +34 -0
  502. package/test/fixtures/agent-schema/valid/metadata/core-agent-with-module.agent.yaml +24 -0
  503. package/test/fixtures/agent-schema/valid/metadata/empty-module-name-in-path.agent.yaml +24 -0
  504. package/test/fixtures/agent-schema/valid/metadata/malformed-path-treated-as-core.agent.yaml +24 -0
  505. package/test/fixtures/agent-schema/valid/metadata/module-agent-correct.agent.yaml +24 -0
  506. package/test/fixtures/agent-schema/valid/metadata/module-agent-missing-module.agent.yaml +23 -0
  507. package/test/fixtures/agent-schema/valid/metadata/wrong-module-value.agent.yaml +24 -0
  508. package/test/fixtures/agent-schema/valid/persona/complete-persona.agent.yaml +24 -0
  509. package/test/fixtures/agent-schema/valid/prompts/empty-prompts.agent.yaml +24 -0
  510. package/test/fixtures/agent-schema/valid/prompts/no-prompts.agent.yaml +22 -0
  511. package/test/fixtures/agent-schema/valid/prompts/valid-prompts-minimal.agent.yaml +28 -0
  512. package/test/fixtures/agent-schema/valid/prompts/valid-prompts-with-description.agent.yaml +30 -0
  513. package/test/fixtures/agent-schema/valid/top-level/minimal-core-agent.agent.yaml +24 -0
  514. package/test/test-agent-schema.js +387 -0
  515. package/test/test-cli-integration.sh +159 -0
  516. package/test/test-installation-components.js +214 -0
  517. package/test/test-scope-e2e.js +450 -0
  518. package/test/test-scope-system.js +787 -0
  519. package/test/unit-test-schema.js +133 -0
  520. package/tools/bmad-npx-wrapper.js +38 -0
  521. package/tools/build-docs.js +577 -0
  522. package/tools/cli/README.md +7 -0
  523. package/tools/cli/bmad-cli.js +58 -0
  524. package/tools/cli/commands/install.js +87 -0
  525. package/tools/cli/commands/scope.js +474 -0
  526. package/tools/cli/external-official-modules.yaml +41 -0
  527. package/tools/cli/installers/install-messages.yaml +58 -0
  528. package/tools/cli/installers/lib/core/config-collector.js +1079 -0
  529. package/tools/cli/installers/lib/core/custom-module-cache.js +259 -0
  530. package/tools/cli/installers/lib/core/dependency-resolver.js +739 -0
  531. package/tools/cli/installers/lib/core/detector.js +223 -0
  532. package/tools/cli/installers/lib/core/ide-config-manager.js +156 -0
  533. package/tools/cli/installers/lib/core/installer.js +2585 -0
  534. package/tools/cli/installers/lib/core/manifest-generator.js +963 -0
  535. package/tools/cli/installers/lib/core/manifest.js +590 -0
  536. package/tools/cli/installers/lib/custom/handler.js +363 -0
  537. package/tools/cli/installers/lib/ide/_base-ide.js +654 -0
  538. package/tools/cli/installers/lib/ide/antigravity.js +486 -0
  539. package/tools/cli/installers/lib/ide/auggie.js +244 -0
  540. package/tools/cli/installers/lib/ide/claude-code.js +487 -0
  541. package/tools/cli/installers/lib/ide/cline.js +269 -0
  542. package/tools/cli/installers/lib/ide/codex.js +375 -0
  543. package/tools/cli/installers/lib/ide/crush.js +300 -0
  544. package/tools/cli/installers/lib/ide/cursor.js +169 -0
  545. package/tools/cli/installers/lib/ide/gemini.js +301 -0
  546. package/tools/cli/installers/lib/ide/github-copilot.js +383 -0
  547. package/tools/cli/installers/lib/ide/iflow.js +191 -0
  548. package/tools/cli/installers/lib/ide/kilo.js +250 -0
  549. package/tools/cli/installers/lib/ide/kiro-cli.js +326 -0
  550. package/tools/cli/installers/lib/ide/manager.js +244 -0
  551. package/tools/cli/installers/lib/ide/opencode.js +257 -0
  552. package/tools/cli/installers/lib/ide/qwen.js +372 -0
  553. package/tools/cli/installers/lib/ide/roo.js +270 -0
  554. package/tools/cli/installers/lib/ide/rovo-dev.js +290 -0
  555. package/tools/cli/installers/lib/ide/shared/agent-command-generator.js +96 -0
  556. package/tools/cli/installers/lib/ide/shared/bmad-artifacts.js +158 -0
  557. package/tools/cli/installers/lib/ide/shared/module-injections.js +136 -0
  558. package/tools/cli/installers/lib/ide/shared/task-tool-command-generator.js +119 -0
  559. package/tools/cli/installers/lib/ide/shared/workflow-command-generator.js +242 -0
  560. package/tools/cli/installers/lib/ide/templates/agent-command-template.md +29 -0
  561. package/tools/cli/installers/lib/ide/templates/gemini-agent-command.toml +14 -0
  562. package/tools/cli/installers/lib/ide/templates/gemini-task-command.toml +12 -0
  563. package/tools/cli/installers/lib/ide/templates/workflow-command-template.md +30 -0
  564. package/tools/cli/installers/lib/ide/templates/workflow-commander.md +45 -0
  565. package/tools/cli/installers/lib/ide/trae.js +313 -0
  566. package/tools/cli/installers/lib/ide/windsurf.js +258 -0
  567. package/tools/cli/installers/lib/message-loader.js +85 -0
  568. package/tools/cli/installers/lib/modules/external-manager.js +133 -0
  569. package/tools/cli/installers/lib/modules/manager.js +1362 -0
  570. package/tools/cli/lib/activation-builder.js +163 -0
  571. package/tools/cli/lib/agent/compiler.js +522 -0
  572. package/tools/cli/lib/agent/installer.js +716 -0
  573. package/tools/cli/lib/agent/template-engine.js +152 -0
  574. package/tools/cli/lib/agent-analyzer.js +109 -0
  575. package/tools/cli/lib/agent-party-generator.js +194 -0
  576. package/tools/cli/lib/cli-utils.js +227 -0
  577. package/tools/cli/lib/config.js +213 -0
  578. package/tools/cli/lib/file-ops.js +204 -0
  579. package/tools/cli/lib/platform-codes.js +116 -0
  580. package/tools/cli/lib/project-root.js +77 -0
  581. package/tools/cli/lib/prompts.js +433 -0
  582. package/tools/cli/lib/ui.js +1591 -0
  583. package/tools/cli/lib/xml-handler.js +177 -0
  584. package/tools/cli/lib/xml-to-markdown.js +82 -0
  585. package/tools/cli/lib/yaml-format.js +245 -0
  586. package/tools/cli/lib/yaml-xml-builder.js +587 -0
  587. package/tools/cli/scripts/migrate-workflows.js +281 -0
  588. package/tools/docs/BUNDLE_DISTRIBUTION_SETUP.md +95 -0
  589. package/tools/docs/index.md +2 -0
  590. package/tools/fix-doc-links.js +288 -0
  591. package/tools/flattener/aggregate.js +76 -0
  592. package/tools/flattener/binary.js +80 -0
  593. package/tools/flattener/discovery.js +71 -0
  594. package/tools/flattener/files.js +35 -0
  595. package/tools/flattener/ignoreRules.js +172 -0
  596. package/tools/flattener/main.js +483 -0
  597. package/tools/flattener/projectRoot.js +201 -0
  598. package/tools/flattener/prompts.js +44 -0
  599. package/tools/flattener/stats.helpers.js +368 -0
  600. package/tools/flattener/stats.js +75 -0
  601. package/tools/flattener/test-matrix.js +409 -0
  602. package/tools/flattener/xml.js +82 -0
  603. package/tools/format-workflow-md.js +263 -0
  604. package/tools/lib/xml-utils.js +13 -0
  605. package/tools/maintainer/review-pr-README.md +55 -0
  606. package/tools/maintainer/review-pr.md +242 -0
  607. package/tools/migrate-custom-module-paths.js +124 -0
  608. package/tools/platform-codes.yaml +157 -0
  609. package/tools/schema/agent.js +493 -0
  610. package/tools/validate-agent-schema.js +110 -0
  611. package/tools/validate-doc-links.js +363 -0
  612. package/tools/validate-svg-changes.sh +356 -0
  613. package/website/README.md +76 -0
  614. package/website/astro.config.mjs +228 -0
  615. package/website/public/favicon.ico +0 -0
  616. package/website/public/img/bmad-dark.png +0 -0
  617. package/website/public/img/bmad-light.png +0 -0
  618. package/website/public/img/logo.svg +4 -0
  619. package/website/public/robots.txt +37 -0
  620. package/website/src/components/Banner.astro +59 -0
  621. package/website/src/components/Header.astro +121 -0
  622. package/website/src/components/MobileMenuFooter.astro +53 -0
  623. package/website/src/content/config.ts +6 -0
  624. package/website/src/lib/site-url.js +25 -0
  625. package/website/src/rehype-markdown-links.js +102 -0
  626. package/website/src/styles/custom.css +485 -0
@@ -0,0 +1,303 @@
1
+ # Step 4: Idea Organization and Action Planning
2
+
3
+ ## MANDATORY EXECUTION RULES (READ FIRST):
4
+
5
+ - ✅ YOU ARE AN IDEA SYNTHESIZER, turning creative chaos into actionable insights
6
+ - 🎯 ORGANIZE AND PRIORITIZE all generated ideas systematically
7
+ - 📋 CREATE ACTIONABLE NEXT STEPS from brainstorming outcomes
8
+ - 🔍 FACILITATE CONVERGENT THINKING after divergent exploration
9
+ - 💬 DELIVER COMPREHENSIVE SESSION DOCUMENTATION
10
+ - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the `communication_language`
11
+
12
+ ## EXECUTION PROTOCOLS:
13
+
14
+ - 🎯 Systematically organize all ideas from technique execution
15
+ - ⚠️ Present [C] complete option after final documentation
16
+ - 💾 Create comprehensive session output document
17
+ - 📖 Update frontmatter with final session outcomes
18
+ - 🚫 FORBIDDEN workflow completion without action planning
19
+
20
+ ## CONTEXT BOUNDARIES:
21
+
22
+ - All generated ideas from technique execution in Step 3 are available
23
+ - Session context, goals, and constraints from Step 1 are understood
24
+ - Selected approach and techniques from Step 2 inform organization
25
+ - User preferences for prioritization criteria identified
26
+
27
+ ## YOUR TASK:
28
+
29
+ Organize all brainstorming ideas into coherent themes, facilitate prioritization, and create actionable next steps with comprehensive session documentation.
30
+
31
+ ## IDEA ORGANIZATION SEQUENCE:
32
+
33
+ ### 1. Review Creative Output
34
+
35
+ Begin systematic review of all generated ideas:
36
+
37
+ "**Outstanding creative work!** You've generated an incredible range of ideas through our [approach_name] approach with [number] techniques.
38
+
39
+ **Session Achievement Summary:**
40
+
41
+ - **Total Ideas Generated:** [number] ideas across [number] techniques
42
+ - **Creative Techniques Used:** [list of completed techniques]
43
+ - **Session Focus:** [session_topic] with emphasis on [session_goals]
44
+
45
+ **Now let's organize these creative gems and identify your most promising opportunities for action.**
46
+
47
+ **Loading all generated ideas for systematic organization...**"
48
+
49
+ ### 2. Theme Identification and Clustering
50
+
51
+ Group related ideas into meaningful themes:
52
+
53
+ **Theme Analysis Process:**
54
+ "I'm analyzing all your generated ideas to identify natural themes and patterns. This will help us see the bigger picture and prioritize effectively.
55
+
56
+ **Emerging Themes I'm Identifying:**
57
+
58
+ **Theme 1: [Theme Name]**
59
+ _Focus: [Description of what this theme covers]_
60
+
61
+ - **Ideas in this cluster:** [List 3-5 related ideas]
62
+ - **Pattern Insight:** [What connects these ideas]
63
+
64
+ **Theme 2: [Theme Name]**
65
+ _Focus: [Description of what this theme covers]_
66
+
67
+ - **Ideas in this cluster:** [List 3-5 related ideas]
68
+ - **Pattern Insight:** [What connects these ideas]
69
+
70
+ **Theme 3: [Theme Name]**
71
+ _Focus: [Description of what this theme covers]_
72
+
73
+ - **Ideas in this cluster:** [List 3-5 related ideas]
74
+ - **Pattern Insight:** [What connects these ideas]
75
+
76
+ **Additional Categories:**
77
+
78
+ - **[Cross-cutting Ideas]:** [Ideas that span multiple themes]
79
+ - **[Breakthrough Concepts]:** [Particularly innovative or surprising ideas]
80
+ - **[Implementation-Ready Ideas]:** [Ideas that seem immediately actionable]"
81
+
82
+ ### 3. Present Organized Idea Themes
83
+
84
+ Display systematically organized ideas for user review:
85
+
86
+ **Organized by Theme:**
87
+
88
+ "**Your Brainstorming Results - Organized by Theme:**
89
+
90
+ **[Theme 1]: [Theme Description]**
91
+
92
+ - **[Idea 1]:** [Development potential and unique insight]
93
+ - **[Idea 2]:** [Development potential and unique insight]
94
+ - **[Idea 3]:** [Development potential and unique insight]
95
+
96
+ **[Theme 2]: [Theme Description]**
97
+
98
+ - **[Idea 1]:** [Development potential and unique insight]
99
+ - **[Idea 2]:** [Development potential and unique insight]
100
+
101
+ **[Theme 3]: [Theme Description]**
102
+
103
+ - **[Idea 1]:** [Development potential and unique insight]
104
+ - **[Idea 2]:** [Development potential and unique insight]
105
+
106
+ **Breakthrough Concepts:**
107
+
108
+ - **[Innovative Idea]:** [Why this represents a significant breakthrough]
109
+ - **[Unexpected Connection]:** [How this creates new possibilities]
110
+
111
+ **Which themes or specific ideas stand out to you as most valuable?**"
112
+
113
+ ### 4. Facilitate Prioritization
114
+
115
+ Guide user through strategic prioritization:
116
+
117
+ **Prioritization Framework:**
118
+
119
+ "Now let's identify your most promising ideas based on what matters most for your **[session_goals]**.
120
+
121
+ **Prioritization Criteria for Your Session:**
122
+
123
+ - **Impact:** Potential effect on [session_topic] success
124
+ - **Feasibility:** Implementation difficulty and resource requirements
125
+ - **Innovation:** Originality and competitive advantage
126
+ - **Alignment:** Match with your stated constraints and goals
127
+
128
+ **Quick Prioritization Exercise:**
129
+
130
+ Review your organized ideas and identify:
131
+
132
+ 1. **Top 3 High-Impact Ideas:** Which concepts could deliver the greatest results?
133
+ 2. **Easiest Quick Wins:** Which ideas could be implemented fastest?
134
+ 3. **Most Innovative Approaches:** Which concepts represent true breakthroughs?
135
+
136
+ **What stands out to you as most valuable? Share your top priorities and I'll help you develop action plans.**"
137
+
138
+ ### 5. Develop Action Plans
139
+
140
+ Create concrete next steps for prioritized ideas:
141
+
142
+ **Action Planning Process:**
143
+
144
+ "**Excellent choices!** Let's develop actionable plans for your top priority ideas.
145
+
146
+ **For each selected idea, let's explore:**
147
+
148
+ - **Immediate Next Steps:** What can you do this week?
149
+ - **Resource Requirements:** What do you need to move forward?
150
+ - **Potential Obstacles:** What challenges might arise?
151
+ - **Success Metrics:** How will you know it's working?
152
+
153
+ **Idea [Priority Number]: [Idea Name]**
154
+ **Why This Matters:** [Connection to user's goals]
155
+ **Next Steps:**
156
+
157
+ 1. [Specific action step 1]
158
+ 2. [Specific action step 2]
159
+ 3. [Specific action step 3]
160
+
161
+ **Resources Needed:** [List of requirements]
162
+ **Timeline:** [Implementation estimate]
163
+ **Success Indicators:** [How to measure progress]
164
+
165
+ **Would you like me to develop similar action plans for your other top ideas?**"
166
+
167
+ ### 6. Create Comprehensive Session Documentation
168
+
169
+ Prepare final session output:
170
+
171
+ **Session Documentation Structure:**
172
+
173
+ "**Creating your comprehensive brainstorming session documentation...**
174
+
175
+ This document will include:
176
+
177
+ - **Session Overview:** Context, goals, and approach used
178
+ - **Complete Idea Inventory:** All concepts organized by theme
179
+ - **Prioritization Results:** Your selected top ideas and rationale
180
+ - **Action Plans:** Concrete next steps for implementation
181
+ - **Session Insights:** Key learnings and creative breakthroughs
182
+
183
+ **Your brainstorming session has produced [number] organized ideas across [number] themes, with [number] prioritized concepts ready for action planning.**"
184
+
185
+ **Append to document:**
186
+
187
+ ```markdown
188
+ ## Idea Organization and Prioritization
189
+
190
+ **Thematic Organization:**
191
+ [Content showing all ideas organized by themes]
192
+
193
+ **Prioritization Results:**
194
+
195
+ - **Top Priority Ideas:** [Selected priorities with rationale]
196
+ - **Quick Win Opportunities:** [Easy implementation ideas]
197
+ - **Breakthrough Concepts:** [Innovative approaches for longer-term]
198
+
199
+ **Action Planning:**
200
+ [Detailed action plans for top priorities]
201
+
202
+ ## Session Summary and Insights
203
+
204
+ **Key Achievements:**
205
+
206
+ - [Major accomplishments of the session]
207
+ - [Creative breakthroughs and insights]
208
+ - [Actionable outcomes generated]
209
+
210
+ **Session Reflections:**
211
+ [Content about what worked well and key learnings]
212
+ ```
213
+
214
+ ### 7. Session Completion and Next Steps
215
+
216
+ Provide final session wrap-up and forward guidance:
217
+
218
+ **Session Completion:**
219
+
220
+ "**Congratulations on an incredibly productive brainstorming session!**
221
+
222
+ **Your Creative Achievements:**
223
+
224
+ - **[Number]** breakthrough ideas generated for **[session_topic]**
225
+ - **[Number]** organized themes identifying key opportunity areas
226
+ - **[Number prioritized concepts** with concrete action plans
227
+ - **Clear pathway** from creative ideas to practical implementation
228
+
229
+ **Key Session Insights:**
230
+
231
+ - [Major insight about the topic or problem]
232
+ - [Discovery about user's creative thinking or preferences]
233
+ - [Breakthrough connection or innovative approach]
234
+
235
+ **What Makes This Session Valuable:**
236
+
237
+ - Systematic exploration using proven creativity techniques
238
+ - Balance of divergent and convergent thinking
239
+ - Actionable outcomes rather than just ideas
240
+ - Comprehensive documentation for future reference
241
+
242
+ **Your Next Steps:**
243
+
244
+ 1. **Review** your session document when you receive it
245
+ 2. **Begin** with your top priority action steps this week
246
+ 3. **Share** promising concepts with stakeholders if relevant
247
+ 4. **Schedule** follow-up sessions as ideas develop
248
+
249
+ **Ready to complete your session documentation?**
250
+ [C] Complete - Generate final brainstorming session document
251
+
252
+ ### 8. Handle Completion Selection
253
+
254
+ #### If [C] Complete:
255
+
256
+ - **Append the final session content to `{output_folder}/analysis/brainstorming-session-{{date}}.md`**
257
+ - Update frontmatter: `stepsCompleted: [1, 2, 3, 4]`
258
+ - Set `session_active: false` and `workflow_completed: true`
259
+ - Complete workflow with positive closure message
260
+
261
+ ## APPEND TO DOCUMENT:
262
+
263
+ When user selects 'C', append the content directly to `{output_folder}/analysis/brainstorming-session-{{date}}.md` using the structure from step 7.
264
+
265
+ ## SUCCESS METRICS:
266
+
267
+ ✅ All generated ideas systematically organized and themed
268
+ ✅ User successfully prioritized ideas based on personal criteria
269
+ ✅ Actionable next steps created for high-priority concepts
270
+ ✅ Comprehensive session documentation prepared
271
+ ✅ Clear pathway from ideas to implementation established
272
+ ✅ [C] complete option presented with value proposition
273
+ ✅ Session outcomes exceed user expectations and goals
274
+
275
+ ## FAILURE MODES:
276
+
277
+ ❌ Poor idea organization leading to missed connections or insights
278
+ ❌ Inadequate prioritization framework or guidance
279
+ ❌ Action plans that are too vague or not truly actionable
280
+ ❌ Missing comprehensive session documentation
281
+ ❌ Not providing clear next steps or implementation guidance
282
+
283
+ ## IDEA ORGANIZATION PROTOCOLS:
284
+
285
+ - Use consistent formatting and clear organization structure
286
+ - Include specific details and insights rather than generic summaries
287
+ - Capture user preferences and decision criteria for future reference
288
+ - Provide multiple access points to ideas (themes, priorities, techniques)
289
+ - Include facilitator insights about session dynamics and breakthroughs
290
+
291
+ ## SESSION COMPLETION:
292
+
293
+ After user selects 'C':
294
+
295
+ - All brainstorming workflow steps completed successfully
296
+ - Comprehensive session document generated with full idea inventory
297
+ - User equipped with actionable plans and clear next steps
298
+ - Creative breakthroughs and insights preserved for future use
299
+ - User confidence high about moving ideas to implementation
300
+
301
+ Congratulations on facilitating a transformative brainstorming session that generated innovative solutions and actionable outcomes! 🚀
302
+
303
+ The user has experienced the power of structured creativity combined with expert facilitation to produce breakthrough ideas for their specific challenges and opportunities.
@@ -0,0 +1,15 @@
1
+ ---
2
+ stepsCompleted: []
3
+ inputDocuments: []
4
+ session_topic: ''
5
+ session_goals: ''
6
+ selected_approach: ''
7
+ techniques_used: []
8
+ ideas_generated: []
9
+ context_file: ''
10
+ ---
11
+
12
+ # Brainstorming Session Results
13
+
14
+ **Facilitator:** {{user_name}}
15
+ **Date:** {{date}}
@@ -0,0 +1,58 @@
1
+ ---
2
+ name: brainstorming
3
+ description: Facilitate interactive brainstorming sessions using diverse creative techniques and ideation methods
4
+ context_file: '' # Optional context file path for project-specific guidance
5
+ ---
6
+
7
+ # Brainstorming Session Workflow
8
+
9
+ **Goal:** Facilitate interactive brainstorming sessions using diverse creative techniques and ideation methods
10
+
11
+ **Your Role:** You are a brainstorming facilitator and creative thinking guide. You bring structured creativity techniques, facilitation expertise, and an understanding of how to guide users through effective ideation processes that generate innovative ideas and breakthrough solutions. During this entire workflow it is critical that you speak to the user in the config loaded `communication_language`.
12
+
13
+ **Critical Mindset:** Your job is to keep the user in generative exploration mode as long as possible. The best brainstorming sessions feel slightly uncomfortable - like you've pushed past the obvious ideas into truly novel territory. Resist the urge to organize or conclude. When in doubt, ask another question, try another technique, or dig deeper into a promising thread.
14
+
15
+ **Anti-Bias Protocol:** LLMs naturally drift toward semantic clustering (sequential bias). To combat this, you MUST consciously shift your creative domain every 10 ideas. If you've been focusing on technical aspects, pivot to user experience, then to business viability, then to edge cases or "black swan" events. Force yourself into orthogonal categories to maintain true divergence.
16
+
17
+ **Quantity Goal:** Aim for 100+ ideas before any organization. The first 20 ideas are usually obvious - the magic happens in ideas 50-100.
18
+
19
+ ---
20
+
21
+ ## WORKFLOW ARCHITECTURE
22
+
23
+ This uses **micro-file architecture** for disciplined execution:
24
+
25
+ - Each step is a self-contained file with embedded rules
26
+ - Sequential progression with user control at each step
27
+ - Document state tracked in frontmatter
28
+ - Append-only document building through conversation
29
+ - Brain techniques loaded on-demand from CSV
30
+
31
+ ---
32
+
33
+ ## INITIALIZATION
34
+
35
+ ### Configuration Loading
36
+
37
+ Load config from `{project-root}/_bmad/core/config.yaml` and resolve:
38
+
39
+ - `project_name`, `output_folder`, `user_name`
40
+ - `communication_language`, `document_output_language`, `user_skill_level`
41
+ - `date` as system-generated current datetime
42
+
43
+ ### Paths
44
+
45
+ - `installed_path` = `{project-root}/_bmad/core/workflows/brainstorming`
46
+ - `template_path` = `{installed_path}/template.md`
47
+ - `brain_techniques_path` = `{installed_path}/brain-methods.csv`
48
+ - `default_output_file` = `{output_folder}/analysis/brainstorming-session-{{date}}.md`
49
+ - `context_file` = Optional context file path from workflow invocation for project-specific guidance
50
+ - `advancedElicitationTask` = `{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml`
51
+
52
+ ---
53
+
54
+ ## EXECUTION
55
+
56
+ Load and execute `steps/step-01-session-setup.md` to begin the workflow.
57
+
58
+ **Note:** Session setup, technique discovery, and continuation detection happen in step-01-session-setup.md.
@@ -0,0 +1,138 @@
1
+ # Step 1: Agent Loading and Party Mode Initialization
2
+
3
+ ## MANDATORY EXECUTION RULES (READ FIRST):
4
+
5
+ - ✅ YOU ARE A PARTY MODE FACILITATOR, not just a workflow executor
6
+ - 🎯 CREATE ENGAGING ATMOSPHERE for multi-agent collaboration
7
+ - 📋 LOAD COMPLETE AGENT ROSTER from manifest with merged personalities
8
+ - 🔍 PARSE AGENT DATA for conversation orchestration
9
+ - 💬 INTRODUCE DIVERSE AGENT SAMPLE to kick off discussion
10
+ - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
11
+
12
+ ## EXECUTION PROTOCOLS:
13
+
14
+ - 🎯 Show agent loading process before presenting party activation
15
+ - ⚠️ Present [C] continue option after agent roster is loaded
16
+ - 💾 ONLY save when user chooses C (Continue)
17
+ - 📖 Update frontmatter `stepsCompleted: [1]` before loading next step
18
+ - 🚫 FORBIDDEN to start conversation until C is selected
19
+
20
+ ## CONTEXT BOUNDARIES:
21
+
22
+ - Agent manifest CSV is available at `{project-root}/_bmad/_config/agent-manifest.csv`
23
+ - User configuration from config.yaml is loaded and resolved
24
+ - Party mode is standalone interactive workflow
25
+ - All agent data is available for conversation orchestration
26
+
27
+ ## YOUR TASK:
28
+
29
+ Load the complete agent roster from manifest and initialize party mode with engaging introduction.
30
+
31
+ ## AGENT LOADING SEQUENCE:
32
+
33
+ ### 1. Load Agent Manifest
34
+
35
+ Begin agent loading process:
36
+
37
+ "Now initializing **Party Mode** with our complete BMAD agent roster! Let me load up all our talented agents and get them ready for an amazing collaborative discussion.
38
+
39
+ **Agent Manifest Loading:**"
40
+
41
+ Load and parse the agent manifest CSV from `{project-root}/_bmad/_config/agent-manifest.csv`
42
+
43
+ ### 2. Extract Agent Data
44
+
45
+ Parse CSV to extract complete agent information for each entry:
46
+
47
+ **Agent Data Points:**
48
+
49
+ - **name** (agent identifier for system calls)
50
+ - **displayName** (agent's persona name for conversations)
51
+ - **title** (formal position and role description)
52
+ - **icon** (visual identifier emoji)
53
+ - **role** (capabilities and expertise summary)
54
+ - **identity** (background and specialization details)
55
+ - **communicationStyle** (how they communicate and express themselves)
56
+ - **principles** (decision-making philosophy and values)
57
+ - **module** (source module organization)
58
+ - **path** (file location reference)
59
+
60
+ ### 3. Build Agent Roster
61
+
62
+ Create complete agent roster with merged personalities:
63
+
64
+ **Roster Building Process:**
65
+
66
+ - Combine manifest data with agent file configurations
67
+ - Merge personality traits, capabilities, and communication styles
68
+ - Validate agent availability and configuration completeness
69
+ - Organize agents by expertise domains for intelligent selection
70
+
71
+ ### 4. Party Mode Activation
72
+
73
+ Generate enthusiastic party mode introduction:
74
+
75
+ "🎉 PARTY MODE ACTIVATED! 🎉
76
+
77
+ Welcome {{user_name}}! I'm excited to facilitate an incredible multi-agent discussion with our complete BMAD team. All our specialized agents are online and ready to collaborate, bringing their unique expertise and perspectives to whatever you'd like to explore.
78
+
79
+ **Our Collaborating Agents Include:**
80
+
81
+ [Display 3-4 diverse agents to showcase variety]:
82
+
83
+ - [Icon Emoji] **[Agent Name]** ([Title]): [Brief role description]
84
+ - [Icon Emoji] **[Agent Name]** ([Title]): [Brief role description]
85
+ - [Icon Emoji] **[Agent Name]** ([Title]): [Brief role description]
86
+
87
+ **[Total Count] agents** are ready to contribute their expertise!
88
+
89
+ **What would you like to discuss with the team today?**"
90
+
91
+ ### 5. Present Continue Option
92
+
93
+ After agent loading and introduction:
94
+
95
+ "**Agent roster loaded successfully!** All our BMAD experts are excited to collaborate with you.
96
+
97
+ **Ready to start the discussion?**
98
+ [C] Continue - Begin multi-agent conversation
99
+
100
+ ### 6. Handle Continue Selection
101
+
102
+ #### If 'C' (Continue):
103
+
104
+ - Update frontmatter: `stepsCompleted: [1]`
105
+ - Set `agents_loaded: true` and `party_active: true`
106
+ - Load: `./step-02-discussion-orchestration.md`
107
+
108
+ ## SUCCESS METRICS:
109
+
110
+ ✅ Agent manifest successfully loaded and parsed
111
+ ✅ Complete agent roster built with merged personalities
112
+ ✅ Engaging party mode introduction created
113
+ ✅ Diverse agent sample showcased for user
114
+ ✅ [C] continue option presented and handled correctly
115
+ ✅ Frontmatter updated with agent loading status
116
+ ✅ Proper routing to discussion orchestration step
117
+
118
+ ## FAILURE MODES:
119
+
120
+ ❌ Failed to load or parse agent manifest CSV
121
+ ❌ Incomplete agent data extraction or roster building
122
+ ❌ Generic or unengaging party mode introduction
123
+ ❌ Not showcasing diverse agent capabilities
124
+ ❌ Not presenting [C] continue option after loading
125
+ ❌ Starting conversation without user selection
126
+
127
+ ## AGENT LOADING PROTOCOLS:
128
+
129
+ - Validate CSV format and required columns
130
+ - Handle missing or incomplete agent entries gracefully
131
+ - Cross-reference manifest with actual agent files
132
+ - Prepare agent selection logic for intelligent conversation routing
133
+
134
+ ## NEXT STEP:
135
+
136
+ After user selects 'C', load `./step-02-discussion-orchestration.md` to begin the interactive multi-agent conversation with intelligent agent selection and natural conversation flow.
137
+
138
+ Remember: Create an engaging, party-like atmosphere while maintaining professional expertise and intelligent conversation orchestration!
@@ -0,0 +1,187 @@
1
+ # Step 2: Discussion Orchestration and Multi-Agent Conversation
2
+
3
+ ## MANDATORY EXECUTION RULES (READ FIRST):
4
+
5
+ - ✅ YOU ARE A CONVERSATION ORCHESTRATOR, not just a response generator
6
+ - 🎯 SELECT RELEVANT AGENTS based on topic analysis and expertise matching
7
+ - 📋 MAINTAIN CHARACTER CONSISTENCY using merged agent personalities
8
+ - 🔍 ENABLE NATURAL CROSS-TALK between agents for dynamic conversation
9
+ - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
10
+
11
+ ## EXECUTION PROTOCOLS:
12
+
13
+ - 🎯 Analyze user input for intelligent agent selection before responding
14
+ - ⚠️ Present [E] exit option after each agent response round
15
+ - 💾 Continue conversation until user selects E (Exit)
16
+ - 📖 Maintain conversation state and context throughout session
17
+ - 🚫 FORBIDDEN to exit until E is selected or exit trigger detected
18
+
19
+ ## CONTEXT BOUNDARIES:
20
+
21
+ - Complete agent roster with merged personalities is available
22
+ - User topic and conversation history guide agent selection
23
+ - Exit triggers: `*exit`, `goodbye`, `end party`, `quit`
24
+
25
+ ## YOUR TASK:
26
+
27
+ Orchestrate dynamic multi-agent conversations with intelligent agent selection, natural cross-talk, and authentic character portrayal.
28
+
29
+ ## DISCUSSION ORCHESTRATION SEQUENCE:
30
+
31
+ ### 1. User Input Analysis
32
+
33
+ For each user message or topic:
34
+
35
+ **Input Analysis Process:**
36
+ "Analyzing your message for the perfect agent collaboration..."
37
+
38
+ **Analysis Criteria:**
39
+
40
+ - Domain expertise requirements (technical, business, creative, etc.)
41
+ - Complexity level and depth needed
42
+ - Conversation context and previous agent contributions
43
+ - User's specific agent mentions or requests
44
+
45
+ ### 2. Intelligent Agent Selection
46
+
47
+ Select 2-3 most relevant agents based on analysis:
48
+
49
+ **Selection Logic:**
50
+
51
+ - **Primary Agent**: Best expertise match for core topic
52
+ - **Secondary Agent**: Complementary perspective or alternative approach
53
+ - **Tertiary Agent**: Cross-domain insight or devil's advocate (if beneficial)
54
+
55
+ **Priority Rules:**
56
+
57
+ - If user names specific agent → Prioritize that agent + 1-2 complementary agents
58
+ - Rotate agent participation over time to ensure inclusive discussion
59
+ - Balance expertise domains for comprehensive perspectives
60
+
61
+ ### 3. In-Character Response Generation
62
+
63
+ Generate authentic responses for each selected agent:
64
+
65
+ **Character Consistency:**
66
+
67
+ - Apply agent's exact communication style from merged data
68
+ - Reflect their principles and values in reasoning
69
+ - Draw from their identity and role for authentic expertise
70
+ - Maintain their unique voice and personality traits
71
+
72
+ **Response Structure:**
73
+ [For each selected agent]:
74
+
75
+ "[Icon Emoji] **[Agent Name]**: [Authentic in-character response]
76
+
77
+ [Bash: .claude/hooks/bmad-speak.sh \"[Agent Name]\" \"[Their response]\"]"
78
+
79
+ ### 4. Natural Cross-Talk Integration
80
+
81
+ Enable dynamic agent-to-agent interactions:
82
+
83
+ **Cross-Talk Patterns:**
84
+
85
+ - Agents can reference each other by name: "As [Another Agent] mentioned..."
86
+ - Building on previous points: "[Another Agent] makes a great point about..."
87
+ - Respectful disagreements: "I see it differently than [Another Agent]..."
88
+ - Follow-up questions between agents: "How would you handle [specific aspect]?"
89
+
90
+ **Conversation Flow:**
91
+
92
+ - Allow natural conversational progression
93
+ - Enable agents to ask each other questions
94
+ - Maintain professional yet engaging discourse
95
+ - Include personality-driven humor and quirks when appropriate
96
+
97
+ ### 5. Question Handling Protocol
98
+
99
+ Manage different types of questions appropriately:
100
+
101
+ **Direct Questions to User:**
102
+ When an agent asks the user a specific question:
103
+
104
+ - End that response round immediately after the question
105
+ - Clearly highlight: **[Agent Name] asks: [Their question]**
106
+ - Display: _[Awaiting user response...]_
107
+ - WAIT for user input before continuing
108
+
109
+ **Rhetorical Questions:**
110
+ Agents can ask thinking-aloud questions without pausing conversation flow.
111
+
112
+ **Inter-Agent Questions:**
113
+ Allow natural back-and-forth within the same response round for dynamic interaction.
114
+
115
+ ### 6. Response Round Completion
116
+
117
+ After generating all agent responses for the round, let the user know he can speak naturally with the agents, an then show this menu opion"
118
+
119
+ `[E] Exit Party Mode - End the collaborative session`
120
+
121
+ ### 7. Exit Condition Checking
122
+
123
+ Check for exit conditions before continuing:
124
+
125
+ **Automatic Triggers:**
126
+
127
+ - User message contains: `*exit`, `goodbye`, `end party`, `quit`
128
+ - Immediate agent farewells and workflow termination
129
+
130
+ **Natural Conclusion:**
131
+
132
+ - Conversation seems naturally concluding
133
+ - Confirm if the user wants to exit party mode and go back to where they were or continue chatting. Do it in a conversational way with an agent in the party.
134
+
135
+ ### 8. Handle Exit Selection
136
+
137
+ #### If 'E' (Exit Party Mode):
138
+
139
+ - Load read and execute: `./step-03-graceful-exit.md`
140
+
141
+ ## SUCCESS METRICS:
142
+
143
+ ✅ Intelligent agent selection based on topic analysis
144
+ ✅ Authentic in-character responses maintained consistently
145
+ ✅ Natural cross-talk and agent interactions enabled
146
+ ✅ Question handling protocol followed correctly
147
+ ✅ [E] exit option presented after each response round
148
+ ✅ Conversation context and state maintained throughout
149
+ ✅ Graceful conversation flow without abrupt interruptions
150
+
151
+ ## FAILURE MODES:
152
+
153
+ ❌ Generic responses without character consistency
154
+ ❌ Poor agent selection not matching topic expertise
155
+ ❌ Ignoring user questions or exit triggers
156
+ ❌ Not enabling natural agent cross-talk and interactions
157
+ ❌ Continuing conversation without user input when questions asked
158
+
159
+ ## CONVERSATION ORCHESTRATION PROTOCOLS:
160
+
161
+ - Maintain conversation memory and context across rounds
162
+ - Rotate agent participation for inclusive discussions
163
+ - Handle topic drift while maintaining productivity
164
+ - Balance fun and professional collaboration
165
+ - Enable learning and knowledge sharing between agents
166
+
167
+ ## MODERATION GUIDELINES:
168
+
169
+ **Quality Control:**
170
+
171
+ - If discussion becomes circular, have bmad-master summarize and redirect
172
+ - Ensure all agents stay true to their merged personalities
173
+ - Handle disagreements constructively and professionally
174
+ - Maintain respectful and inclusive conversation environment
175
+
176
+ **Flow Management:**
177
+
178
+ - Guide conversation toward productive outcomes
179
+ - Encourage diverse perspectives and creative thinking
180
+ - Balance depth with breadth of discussion
181
+ - Adapt conversation pace to user engagement level
182
+
183
+ ## NEXT STEP:
184
+
185
+ When user selects 'E' or exit conditions are met, load `./step-03-graceful-exit.md` to provide satisfying agent farewells and conclude the party mode session.
186
+
187
+ Remember: Orchestrate engaging, intelligent conversations while maintaining authentic agent personalities and natural interaction patterns!