bmad-method 6.0.0-alpha.3 → 6.0.0-alpha.5

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 (540) hide show
  1. package/.claude/commands/bmad/bmm/agents/analyst.md +67 -0
  2. package/.claude/commands/bmad/bmm/agents/architect.md +72 -0
  3. package/.claude/commands/bmad/bmm/agents/dev.md +69 -0
  4. package/.claude/commands/bmad/bmm/agents/paige.md +82 -0
  5. package/.claude/commands/bmad/bmm/agents/pm.md +76 -0
  6. package/.claude/commands/bmad/bmm/agents/sm.md +85 -0
  7. package/.claude/commands/bmad/bmm/agents/tea.md +72 -0
  8. package/.claude/commands/bmad/bmm/agents/tech-writer.md +82 -0
  9. package/.claude/commands/bmad/bmm/agents/ux-designer.md +71 -0
  10. package/.claude/commands/bmad/bmm/workflows/README.md +132 -0
  11. package/.claude/commands/bmad/bmm/workflows/architecture.md +15 -0
  12. package/.claude/commands/bmad/bmm/workflows/brainstorm-project.md +15 -0
  13. package/.claude/commands/bmad/bmm/workflows/code-review.md +15 -0
  14. package/.claude/commands/bmad/bmm/workflows/correct-course.md +15 -0
  15. package/.claude/commands/bmad/bmm/workflows/create-epics-and-stories.md +15 -0
  16. package/.claude/commands/bmad/bmm/workflows/create-story.md +15 -0
  17. package/.claude/commands/bmad/bmm/workflows/create-ux-design.md +15 -0
  18. package/.claude/commands/bmad/bmm/workflows/dev-story.md +15 -0
  19. package/.claude/commands/bmad/bmm/workflows/document-project.md +15 -0
  20. package/.claude/commands/bmad/bmm/workflows/epic-tech-context.md +15 -0
  21. package/.claude/commands/bmad/bmm/workflows/narrative.md +15 -0
  22. package/.claude/commands/bmad/bmm/workflows/prd.md +15 -0
  23. package/.claude/commands/bmad/bmm/workflows/product-brief.md +15 -0
  24. package/.claude/commands/bmad/bmm/workflows/research.md +15 -0
  25. package/.claude/commands/bmad/bmm/workflows/retrospective.md +15 -0
  26. package/.claude/commands/bmad/bmm/workflows/solutioning-gate-check.md +15 -0
  27. package/.claude/commands/bmad/bmm/workflows/sprint-planning.md +15 -0
  28. package/.claude/commands/bmad/bmm/workflows/story-context.md +15 -0
  29. package/.claude/commands/bmad/bmm/workflows/story-done.md +15 -0
  30. package/.claude/commands/bmad/bmm/workflows/story-ready.md +15 -0
  31. package/.claude/commands/bmad/bmm/workflows/tech-spec-sm.md +15 -0
  32. package/.claude/commands/bmad/bmm/workflows/tech-spec.md +15 -0
  33. package/.claude/commands/bmad/bmm/workflows/workflow-init.md +15 -0
  34. package/.claude/commands/bmad/bmm/workflows/workflow-status.md +15 -0
  35. package/.claude/commands/bmad/cis/agents/README.md +104 -0
  36. package/.claude/commands/bmad/cis/agents/brainstorming-coach.md +62 -0
  37. package/.claude/commands/bmad/cis/agents/creative-problem-solver.md +62 -0
  38. package/.claude/commands/bmad/cis/agents/design-thinking-coach.md +62 -0
  39. package/.claude/commands/bmad/cis/agents/innovation-strategist.md +62 -0
  40. package/.claude/commands/bmad/cis/agents/storyteller.md +59 -0
  41. package/.claude/commands/bmad/cis/workflows/README.md +37 -0
  42. package/.claude/commands/bmad/cis/workflows/design-thinking.md +15 -0
  43. package/.claude/commands/bmad/cis/workflows/innovation-strategy.md +15 -0
  44. package/.claude/commands/bmad/cis/workflows/problem-solving.md +15 -0
  45. package/.claude/commands/bmad/cis/workflows/storytelling.md +15 -0
  46. package/.claude/commands/bmad/core/workflows/README.md +10 -0
  47. package/.claude/settings.local.json +7 -42
  48. package/CHANGELOG.md +544 -0
  49. package/README.md +266 -101
  50. package/bmad/_cfg/agent-manifest.csv +13 -3
  51. package/bmad/_cfg/agents/bmm-dev.customize.yaml +42 -0
  52. package/bmad/_cfg/agents/bmm-paige.customize.yaml +42 -0
  53. package/bmad/_cfg/agents/bmm-pm.customize.yaml +42 -0
  54. package/bmad/_cfg/agents/bmm-sm.customize.yaml +42 -0
  55. package/bmad/_cfg/agents/bmm-tea.customize.yaml +42 -0
  56. package/bmad/_cfg/agents/bmm-tech-writer.customize.yaml +42 -0
  57. package/bmad/_cfg/agents/bmm-ux-designer.customize.yaml +42 -0
  58. package/bmad/_cfg/agents/cis-brainstorming-coach.customize.yaml +42 -0
  59. package/bmad/_cfg/agents/cis-creative-problem-solver.customize.yaml +42 -0
  60. package/bmad/_cfg/agents/cis-design-thinking-coach.customize.yaml +42 -0
  61. package/bmad/_cfg/agents/cis-innovation-strategist.customize.yaml +42 -0
  62. package/bmad/_cfg/agents/cis-storyteller.customize.yaml +42 -0
  63. package/bmad/_cfg/files-manifest.csv +267 -22
  64. package/bmad/_cfg/ides/claude-code.yaml +6 -0
  65. package/bmad/_cfg/manifest.yaml +5 -5
  66. package/bmad/_cfg/task-manifest.csv +5 -0
  67. package/bmad/_cfg/tool-manifest.csv +1 -0
  68. package/bmad/_cfg/workflow-manifest.csv +37 -2
  69. package/bmad/bmb/README.md +135 -73
  70. package/bmad/bmb/agents/bmad-builder.md.bak +70 -0
  71. package/bmad/bmb/config.yaml +2 -2
  72. package/bmad/bmb/workflows/audit-workflow/instructions.md +1 -1
  73. package/bmad/bmb/workflows/audit-workflow/workflow.yaml.bak +3 -1
  74. package/bmad/bmb/workflows/create-agent/README.md +126 -243
  75. package/bmad/bmb/workflows/create-agent/instructions.md +25 -12
  76. package/bmad/bmb/workflows/create-module/README.md +163 -154
  77. package/bmad/bmb/workflows/create-module/workflow.yaml.bak +2 -0
  78. package/bmad/bmb/workflows/create-workflow/instructions.md +16 -8
  79. package/bmad/bmb/workflows/create-workflow/workflow-creation-guide.md +158 -0
  80. package/bmad/bmb/workflows/create-workflow/workflow.yaml.bak +2 -0
  81. package/bmad/bmb/workflows/edit-agent/workflow.yaml.bak +33 -0
  82. package/bmad/bmb/workflows/edit-module/workflow.yaml.bak +34 -0
  83. package/bmad/bmb/workflows/edit-workflow/workflow.yaml.bak +2 -0
  84. package/bmad/bmb/workflows/module-brief/workflow.yaml.bak +2 -0
  85. package/bmad/bmb/workflows/redoc/workflow.yaml.bak +1 -0
  86. package/bmad/bmm/README.md +128 -0
  87. package/bmad/bmm/README.md.bak +169 -0
  88. package/bmad/bmm/agents/analyst.md +67 -0
  89. package/bmad/bmm/agents/analyst.md.bak +67 -0
  90. package/bmad/bmm/agents/architect.md +72 -0
  91. package/bmad/bmm/agents/architect.md.bak +73 -0
  92. package/bmad/bmm/agents/dev.md +69 -0
  93. package/bmad/bmm/agents/dev.md.bak +69 -0
  94. package/bmad/bmm/agents/paige.md.bak +82 -0
  95. package/bmad/bmm/agents/pm.md +76 -0
  96. package/bmad/bmm/agents/pm.md.bak +76 -0
  97. package/bmad/bmm/agents/sm.md +85 -0
  98. package/bmad/bmm/agents/sm.md.bak +85 -0
  99. package/bmad/bmm/agents/tea.md +72 -0
  100. package/bmad/bmm/agents/tea.md.bak +72 -0
  101. package/bmad/bmm/agents/tech-writer.md +82 -0
  102. package/bmad/bmm/agents/ux-designer.md +71 -0
  103. package/bmad/bmm/agents/ux-designer.md.bak +71 -0
  104. package/bmad/bmm/config.yaml +17 -0
  105. package/bmad/bmm/docs/README.md +235 -0
  106. package/bmad/bmm/docs/agents-guide.md +1057 -0
  107. package/bmad/bmm/docs/brownfield-guide.md +759 -0
  108. package/bmad/bmm/docs/enterprise-agentic-development.md +680 -0
  109. package/bmad/bmm/docs/faq.md +589 -0
  110. package/bmad/bmm/docs/glossary.md +321 -0
  111. package/bmad/bmm/docs/party-mode.md +224 -0
  112. package/bmad/bmm/docs/quick-spec-flow.md +652 -0
  113. package/{docs/BMad-Method-V6-Quick-Start.md → bmad/bmm/docs/quick-start.md} +72 -47
  114. package/bmad/bmm/docs/scale-adaptive-system.md +599 -0
  115. package/bmad/bmm/docs/troubleshooting.md +680 -0
  116. package/{src/modules/bmm/workflows/3-solutioning/architecture/README.md → bmad/bmm/docs/workflow-architecture-reference.md} +130 -77
  117. package/{src/modules/bmm/workflows/document-project/README.md → bmad/bmm/docs/workflow-document-project-reference.md} +45 -2
  118. package/bmad/bmm/docs/workflows-analysis.md +670 -0
  119. package/bmad/bmm/docs/workflows-implementation.md +1758 -0
  120. package/bmad/bmm/docs/workflows-planning.md +1086 -0
  121. package/bmad/bmm/docs/workflows-solutioning.md +726 -0
  122. package/bmad/bmm/tasks/daily-standup.xml +85 -0
  123. package/bmad/bmm/teams/team-fullstack.yaml +11 -0
  124. package/bmad/bmm/teams/team-gamedev.yaml +14 -0
  125. package/bmad/bmm/testarch/knowledge/ci-burn-in.md +675 -0
  126. package/bmad/bmm/testarch/knowledge/component-tdd.md +486 -0
  127. package/bmad/bmm/testarch/knowledge/contract-testing.md +957 -0
  128. package/bmad/bmm/testarch/knowledge/data-factories.md +500 -0
  129. package/bmad/bmm/testarch/knowledge/email-auth.md +721 -0
  130. package/bmad/bmm/testarch/knowledge/error-handling.md +725 -0
  131. package/bmad/bmm/testarch/knowledge/feature-flags.md +750 -0
  132. package/bmad/bmm/testarch/knowledge/fixture-architecture.md +401 -0
  133. package/bmad/bmm/testarch/knowledge/network-first.md +486 -0
  134. package/bmad/bmm/testarch/knowledge/nfr-criteria.md +670 -0
  135. package/bmad/bmm/testarch/knowledge/playwright-config.md +730 -0
  136. package/bmad/bmm/testarch/knowledge/probability-impact.md +601 -0
  137. package/bmad/bmm/testarch/knowledge/risk-governance.md +615 -0
  138. package/bmad/bmm/testarch/knowledge/selective-testing.md +732 -0
  139. package/bmad/bmm/testarch/knowledge/selector-resilience.md +527 -0
  140. package/bmad/bmm/testarch/knowledge/test-healing-patterns.md +644 -0
  141. package/bmad/bmm/testarch/knowledge/test-levels-framework.md +473 -0
  142. package/bmad/bmm/testarch/knowledge/test-priorities-matrix.md +373 -0
  143. package/bmad/bmm/testarch/knowledge/test-quality.md +664 -0
  144. package/bmad/bmm/testarch/knowledge/timing-debugging.md +372 -0
  145. package/bmad/bmm/testarch/knowledge/visual-debugging.md +524 -0
  146. package/bmad/bmm/testarch/tea-index.csv +22 -0
  147. package/bmad/bmm/workflows/1-analysis/brainstorm-project/instructions.md +110 -0
  148. package/bmad/bmm/workflows/1-analysis/brainstorm-project/project-context.md +25 -0
  149. package/bmad/bmm/workflows/1-analysis/brainstorm-project/workflow.yaml +26 -0
  150. package/bmad/bmm/workflows/1-analysis/domain-research/instructions.md +423 -0
  151. package/bmad/bmm/workflows/1-analysis/domain-research/template.md +180 -0
  152. package/bmad/bmm/workflows/1-analysis/domain-research/workflow.yaml +36 -0
  153. package/bmad/bmm/workflows/1-analysis/product-brief/checklist.md +115 -0
  154. package/bmad/bmm/workflows/1-analysis/product-brief/instructions.md +524 -0
  155. package/bmad/bmm/workflows/1-analysis/product-brief/template.md +181 -0
  156. package/bmad/bmm/workflows/1-analysis/product-brief/workflow.yaml +45 -0
  157. package/bmad/bmm/workflows/1-analysis/research/checklist-deep-prompt.md +144 -0
  158. package/bmad/bmm/workflows/1-analysis/research/checklist-technical.md +249 -0
  159. package/bmad/bmm/workflows/1-analysis/research/checklist.md +299 -0
  160. package/bmad/bmm/workflows/1-analysis/research/claude-code/injections.yaml +114 -0
  161. package/bmad/bmm/workflows/1-analysis/research/instructions-deep-prompt.md +439 -0
  162. package/bmad/bmm/workflows/1-analysis/research/instructions-market.md +679 -0
  163. package/bmad/bmm/workflows/1-analysis/research/instructions-router.md +133 -0
  164. package/bmad/bmm/workflows/1-analysis/research/instructions-technical.md +538 -0
  165. package/bmad/bmm/workflows/1-analysis/research/template-deep-prompt.md +94 -0
  166. package/bmad/bmm/workflows/1-analysis/research/template-market.md +347 -0
  167. package/bmad/bmm/workflows/1-analysis/research/template-technical.md +245 -0
  168. package/bmad/bmm/workflows/1-analysis/research/workflow.yaml +44 -0
  169. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/checklist.md +310 -0
  170. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/instructions.md +1319 -0
  171. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/ux-design-template.md +145 -0
  172. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.yaml +64 -0
  173. package/bmad/bmm/workflows/2-plan-workflows/narrative/checklist.md +139 -0
  174. package/bmad/bmm/workflows/2-plan-workflows/narrative/instructions-narrative.md +608 -0
  175. package/bmad/bmm/workflows/2-plan-workflows/narrative/narrative-template.md +195 -0
  176. package/bmad/bmm/workflows/2-plan-workflows/narrative/workflow.yaml +29 -0
  177. package/bmad/bmm/workflows/2-plan-workflows/prd/checklist.md +349 -0
  178. package/bmad/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/instructions.md +395 -0
  179. package/bmad/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/workflow.yaml +33 -0
  180. package/bmad/bmm/workflows/2-plan-workflows/prd/domain-complexity.csv +13 -0
  181. package/bmad/bmm/workflows/2-plan-workflows/prd/instructions.md +423 -0
  182. package/bmad/bmm/workflows/2-plan-workflows/prd/prd-template.md +237 -0
  183. package/bmad/bmm/workflows/2-plan-workflows/prd/project-types.csv +11 -0
  184. package/bmad/bmm/workflows/2-plan-workflows/prd/workflow.yaml +46 -0
  185. package/bmad/bmm/workflows/2-plan-workflows/tech-spec/checklist.md +214 -0
  186. package/bmad/bmm/workflows/2-plan-workflows/tech-spec/epics-template.md +58 -0
  187. package/bmad/bmm/workflows/2-plan-workflows/tech-spec/instructions-level0-story.md +200 -0
  188. package/bmad/bmm/workflows/2-plan-workflows/tech-spec/instructions-level1-stories.md +451 -0
  189. package/bmad/bmm/workflows/2-plan-workflows/tech-spec/instructions.md +1133 -0
  190. package/bmad/bmm/workflows/2-plan-workflows/tech-spec/tech-spec-template.md +181 -0
  191. package/bmad/bmm/workflows/2-plan-workflows/tech-spec/user-story-template.md +87 -0
  192. package/bmad/bmm/workflows/2-plan-workflows/tech-spec/workflow.yaml +60 -0
  193. package/bmad/bmm/workflows/2-plan-workflows/tech-spec/workflow.yaml.bak +60 -0
  194. package/bmad/bmm/workflows/3-solutioning/architecture/architecture-patterns.yaml +347 -0
  195. package/bmad/bmm/workflows/3-solutioning/architecture/architecture-template.md +103 -0
  196. package/bmad/bmm/workflows/3-solutioning/architecture/checklist.md +244 -0
  197. package/bmad/bmm/workflows/3-solutioning/architecture/decision-catalog.yaml +222 -0
  198. package/bmad/bmm/workflows/3-solutioning/architecture/instructions.md +715 -0
  199. package/bmad/bmm/workflows/3-solutioning/architecture/pattern-categories.csv +13 -0
  200. package/bmad/bmm/workflows/3-solutioning/architecture/workflow.yaml +67 -0
  201. package/bmad/bmm/workflows/3-solutioning/solutioning-gate-check/checklist.md +175 -0
  202. package/bmad/bmm/workflows/3-solutioning/solutioning-gate-check/instructions.md +322 -0
  203. package/bmad/bmm/workflows/3-solutioning/solutioning-gate-check/template.md +146 -0
  204. package/bmad/bmm/workflows/3-solutioning/solutioning-gate-check/validation-criteria.yaml +189 -0
  205. package/bmad/bmm/workflows/3-solutioning/solutioning-gate-check/workflow.yaml +64 -0
  206. package/bmad/bmm/workflows/4-implementation/code-review/backlog_template.md +12 -0
  207. package/bmad/bmm/workflows/4-implementation/code-review/checklist.md +22 -0
  208. package/bmad/bmm/workflows/4-implementation/code-review/instructions.md +420 -0
  209. package/bmad/bmm/workflows/4-implementation/code-review/workflow.yaml +74 -0
  210. package/bmad/bmm/workflows/4-implementation/correct-course/checklist.md +279 -0
  211. package/bmad/bmm/workflows/4-implementation/correct-course/instructions.md +201 -0
  212. package/bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml +43 -0
  213. package/bmad/bmm/workflows/4-implementation/create-story/checklist.md +240 -0
  214. package/bmad/bmm/workflows/4-implementation/create-story/instructions.md +283 -0
  215. package/bmad/bmm/workflows/4-implementation/create-story/template.md +51 -0
  216. package/bmad/bmm/workflows/4-implementation/create-story/workflow.yaml +74 -0
  217. package/bmad/bmm/workflows/4-implementation/dev-story/AUDIT-REPORT.md +367 -0
  218. package/bmad/bmm/workflows/4-implementation/dev-story/checklist.md +38 -0
  219. package/bmad/bmm/workflows/4-implementation/dev-story/instructions.md +262 -0
  220. package/bmad/bmm/workflows/4-implementation/dev-story/workflow.yaml +26 -0
  221. package/bmad/bmm/workflows/4-implementation/epic-tech-context/checklist.md +17 -0
  222. package/bmad/bmm/workflows/4-implementation/epic-tech-context/instructions.md +189 -0
  223. package/bmad/bmm/workflows/4-implementation/epic-tech-context/template.md +76 -0
  224. package/bmad/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml +58 -0
  225. package/bmad/bmm/workflows/4-implementation/retrospective/instructions.md +1460 -0
  226. package/bmad/bmm/workflows/4-implementation/retrospective/workflow.yaml +71 -0
  227. package/bmad/bmm/workflows/4-implementation/sprint-planning/checklist.md +33 -0
  228. package/bmad/bmm/workflows/4-implementation/sprint-planning/instructions.md +238 -0
  229. package/bmad/bmm/workflows/4-implementation/sprint-planning/sprint-status-template.yaml +55 -0
  230. package/bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml +47 -0
  231. package/bmad/bmm/workflows/4-implementation/story-context/checklist.md +16 -0
  232. package/bmad/bmm/workflows/4-implementation/story-context/context-template.xml +34 -0
  233. package/bmad/bmm/workflows/4-implementation/story-context/instructions.md +234 -0
  234. package/bmad/bmm/workflows/4-implementation/story-context/workflow.yaml +57 -0
  235. package/bmad/bmm/workflows/4-implementation/story-done/instructions.md +111 -0
  236. package/bmad/bmm/workflows/4-implementation/story-done/workflow.yaml +25 -0
  237. package/bmad/bmm/workflows/4-implementation/story-ready/instructions.md +117 -0
  238. package/bmad/bmm/workflows/4-implementation/story-ready/workflow.yaml +25 -0
  239. package/bmad/bmm/workflows/document-project/checklist.md +245 -0
  240. package/bmad/bmm/workflows/document-project/documentation-requirements.csv +12 -0
  241. package/bmad/bmm/workflows/document-project/instructions.md +222 -0
  242. package/bmad/bmm/workflows/document-project/templates/deep-dive-template.md +345 -0
  243. package/bmad/bmm/workflows/document-project/templates/index-template.md +169 -0
  244. package/bmad/bmm/workflows/document-project/templates/project-overview-template.md +103 -0
  245. package/bmad/bmm/workflows/document-project/templates/project-scan-report-schema.json +160 -0
  246. package/bmad/bmm/workflows/document-project/templates/source-tree-template.md +135 -0
  247. package/bmad/bmm/workflows/document-project/workflow.yaml +34 -0
  248. package/bmad/bmm/workflows/document-project/workflows/deep-dive-instructions.md +298 -0
  249. package/bmad/bmm/workflows/document-project/workflows/deep-dive.yaml +31 -0
  250. package/bmad/bmm/workflows/document-project/workflows/full-scan-instructions.md +1106 -0
  251. package/bmad/bmm/workflows/document-project/workflows/full-scan.yaml +31 -0
  252. package/bmad/bmm/workflows/techdoc/documentation-standards.md +239 -0
  253. package/bmad/bmm/workflows/techdoc/documentation-standards.md.bak +238 -0
  254. package/bmad/bmm/workflows/testarch/atdd/atdd-checklist-template.md +363 -0
  255. package/bmad/bmm/workflows/testarch/atdd/checklist.md +373 -0
  256. package/bmad/bmm/workflows/testarch/atdd/instructions.md +785 -0
  257. package/bmad/bmm/workflows/testarch/atdd/workflow.yaml +52 -0
  258. package/bmad/bmm/workflows/testarch/automate/checklist.md +580 -0
  259. package/bmad/bmm/workflows/testarch/automate/instructions.md +1303 -0
  260. package/bmad/bmm/workflows/testarch/automate/workflow.yaml +61 -0
  261. package/bmad/bmm/workflows/testarch/ci/checklist.md +246 -0
  262. package/bmad/bmm/workflows/testarch/ci/github-actions-template.yaml +165 -0
  263. package/bmad/bmm/workflows/testarch/ci/gitlab-ci-template.yaml +128 -0
  264. package/bmad/bmm/workflows/testarch/ci/instructions.md +517 -0
  265. package/bmad/bmm/workflows/testarch/ci/workflow.yaml +53 -0
  266. package/bmad/bmm/workflows/testarch/framework/checklist.md +321 -0
  267. package/bmad/bmm/workflows/testarch/framework/instructions.md +455 -0
  268. package/bmad/bmm/workflows/testarch/framework/workflow.yaml +53 -0
  269. package/bmad/bmm/workflows/testarch/nfr-assess/checklist.md +405 -0
  270. package/bmad/bmm/workflows/testarch/nfr-assess/instructions.md +722 -0
  271. package/bmad/bmm/workflows/testarch/nfr-assess/nfr-report-template.md +443 -0
  272. package/bmad/bmm/workflows/testarch/nfr-assess/workflow.yaml +56 -0
  273. package/bmad/bmm/workflows/testarch/test-design/checklist.md +234 -0
  274. package/bmad/bmm/workflows/testarch/test-design/instructions.md +621 -0
  275. package/bmad/bmm/workflows/testarch/test-design/test-design-template.md +285 -0
  276. package/bmad/bmm/workflows/testarch/test-design/workflow.yaml +52 -0
  277. package/bmad/bmm/workflows/testarch/test-review/checklist.md +470 -0
  278. package/bmad/bmm/workflows/testarch/test-review/instructions.md +608 -0
  279. package/bmad/bmm/workflows/testarch/test-review/test-review-template.md +388 -0
  280. package/bmad/bmm/workflows/testarch/test-review/workflow.yaml +53 -0
  281. package/bmad/bmm/workflows/testarch/trace/checklist.md +654 -0
  282. package/bmad/bmm/workflows/testarch/trace/instructions.md +1045 -0
  283. package/bmad/bmm/workflows/testarch/trace/trace-template.md +673 -0
  284. package/bmad/bmm/workflows/testarch/trace/workflow.yaml +66 -0
  285. package/bmad/bmm/workflows/workflow-status/init/instructions.md +771 -0
  286. package/bmad/bmm/workflows/workflow-status/init/workflow.yaml +27 -0
  287. package/bmad/bmm/workflows/workflow-status/init/workflow.yaml.bak +27 -0
  288. package/bmad/bmm/workflows/workflow-status/instructions.md +386 -0
  289. package/bmad/bmm/workflows/workflow-status/paths/enterprise-brownfield.yaml +120 -0
  290. package/bmad/bmm/workflows/workflow-status/paths/enterprise-greenfield.yaml +108 -0
  291. package/bmad/bmm/workflows/workflow-status/paths/game-design.yaml +75 -0
  292. package/{src/modules/bmm/workflows/workflow-status/paths/brownfield-level-3.yaml → bmad/bmm/workflows/workflow-status/paths/method-brownfield.yaml} +33 -31
  293. package/{src/modules/bmm/workflows/workflow-status/paths/greenfield-level-2.yaml → bmad/bmm/workflows/workflow-status/paths/method-greenfield.yaml} +31 -21
  294. package/{src/modules/bmm/workflows/workflow-status/paths/brownfield-level-1.yaml → bmad/bmm/workflows/workflow-status/paths/quick-flow-brownfield.yaml} +18 -18
  295. package/{src/modules/bmm/workflows/workflow-status/paths/greenfield-level-1.yaml → bmad/bmm/workflows/workflow-status/paths/quick-flow-greenfield.yaml} +16 -18
  296. package/bmad/bmm/workflows/workflow-status/project-levels.yaml +59 -0
  297. package/bmad/bmm/workflows/workflow-status/sample-level-3-workflow.yaml +49 -0
  298. package/bmad/bmm/workflows/workflow-status/workflow-status-template.yaml +31 -0
  299. package/bmad/bmm/workflows/workflow-status/workflow.yaml +28 -0
  300. package/bmad/cis/README.md +153 -0
  301. package/bmad/cis/agents/README.md +104 -0
  302. package/bmad/cis/agents/brainstorming-coach.md +62 -0
  303. package/bmad/cis/agents/brainstorming-coach.md.bak +62 -0
  304. package/bmad/cis/agents/creative-problem-solver.md +62 -0
  305. package/bmad/cis/agents/creative-problem-solver.md.bak +62 -0
  306. package/bmad/cis/agents/design-thinking-coach.md +62 -0
  307. package/bmad/cis/agents/design-thinking-coach.md.bak +62 -0
  308. package/bmad/cis/agents/innovation-strategist.md +62 -0
  309. package/bmad/cis/agents/innovation-strategist.md.bak +62 -0
  310. package/bmad/cis/agents/storyteller.md +59 -0
  311. package/bmad/cis/agents/storyteller.md.bak +59 -0
  312. package/bmad/{bmd → cis}/config.yaml +3 -3
  313. package/bmad/cis/teams/creative-squad.yaml +6 -0
  314. package/bmad/cis/workflows/README.md +139 -0
  315. package/bmad/cis/workflows/design-thinking/README.md +56 -0
  316. package/bmad/cis/workflows/design-thinking/design-methods.csv +31 -0
  317. package/bmad/cis/workflows/design-thinking/instructions.md +200 -0
  318. package/bmad/cis/workflows/design-thinking/template.md +111 -0
  319. package/bmad/cis/workflows/design-thinking/workflow.yaml +32 -0
  320. package/bmad/cis/workflows/innovation-strategy/README.md +56 -0
  321. package/bmad/cis/workflows/innovation-strategy/innovation-frameworks.csv +31 -0
  322. package/bmad/cis/workflows/innovation-strategy/instructions.md +274 -0
  323. package/bmad/cis/workflows/innovation-strategy/template.md +189 -0
  324. package/bmad/cis/workflows/innovation-strategy/workflow.yaml +32 -0
  325. package/bmad/cis/workflows/problem-solving/README.md +56 -0
  326. package/bmad/cis/workflows/problem-solving/instructions.md +250 -0
  327. package/bmad/cis/workflows/problem-solving/solving-methods.csv +31 -0
  328. package/bmad/cis/workflows/problem-solving/template.md +165 -0
  329. package/bmad/cis/workflows/problem-solving/workflow.yaml +32 -0
  330. package/bmad/cis/workflows/storytelling/README.md +58 -0
  331. package/bmad/cis/workflows/storytelling/instructions.md +291 -0
  332. package/bmad/cis/workflows/storytelling/story-types.csv +26 -0
  333. package/bmad/cis/workflows/storytelling/template.md +113 -0
  334. package/bmad/cis/workflows/storytelling/workflow.yaml +32 -0
  335. package/bmad/core/agents/bmad-master.md.bak +71 -0
  336. package/bmad/core/config.yaml +2 -2
  337. package/bmad/core/tasks/workflow.xml +1 -19
  338. package/bmad/core/tools/shard-doc.xml +8 -43
  339. package/docs/document-sharding-guide.md +447 -0
  340. package/docs/index.md +37 -41
  341. package/package.json +1 -1
  342. package/src/core/tasks/workflow.xml +1 -11
  343. package/src/core/tools/shard-doc.xml +8 -43
  344. package/src/modules/bmb/workflows/audit-workflow/instructions.md +1 -1
  345. package/src/modules/bmb/workflows/create-workflow/workflow-creation-guide.md +158 -0
  346. package/src/modules/bmm/README.md +79 -95
  347. package/src/modules/bmm/agents/architect.agent.yaml +0 -4
  348. package/src/modules/bmm/agents/game-designer.agent.yaml +2 -2
  349. package/src/modules/bmm/agents/game-dev.agent.yaml +8 -12
  350. package/src/modules/bmm/agents/pm.agent.yaml +11 -1
  351. package/src/modules/bmm/agents/sm.agent.yaml +1 -1
  352. package/src/modules/bmm/agents/tech-writer.agent.yaml +69 -0
  353. package/src/modules/bmm/docs/README.md +235 -0
  354. package/src/modules/bmm/docs/agents-guide.md +1057 -0
  355. package/src/modules/bmm/docs/brownfield-guide.md +759 -0
  356. package/src/modules/bmm/docs/enterprise-agentic-development.md +680 -0
  357. package/src/modules/bmm/docs/faq.md +589 -0
  358. package/src/modules/bmm/docs/glossary.md +321 -0
  359. package/src/modules/bmm/docs/party-mode.md +224 -0
  360. package/src/modules/bmm/docs/quick-spec-flow.md +652 -0
  361. package/src/modules/bmm/docs/quick-start.md +366 -0
  362. package/src/modules/bmm/docs/scale-adaptive-system.md +599 -0
  363. package/src/modules/bmm/docs/troubleshooting.md +680 -0
  364. package/src/modules/bmm/docs/workflow-architecture-reference.md +371 -0
  365. package/src/modules/bmm/docs/workflow-document-project-reference.md +487 -0
  366. package/src/modules/bmm/docs/workflows-analysis.md +670 -0
  367. package/src/modules/bmm/docs/workflows-implementation.md +1758 -0
  368. package/src/modules/bmm/docs/workflows-planning.md +1086 -0
  369. package/src/modules/bmm/docs/workflows-solutioning.md +726 -0
  370. package/src/modules/bmm/tasks/daily-standup.xml +1 -1
  371. package/src/modules/bmm/workflows/1-analysis/domain-research/instructions.md +423 -0
  372. package/src/modules/bmm/workflows/1-analysis/domain-research/template.md +180 -0
  373. package/src/modules/bmm/workflows/1-analysis/domain-research/workflow.yaml +36 -0
  374. package/src/modules/bmm/workflows/1-analysis/product-brief/instructions.md +405 -213
  375. package/src/modules/bmm/workflows/1-analysis/product-brief/template.md +93 -77
  376. package/src/modules/bmm/workflows/1-analysis/product-brief/workflow.yaml +14 -0
  377. package/src/modules/bmm/workflows/1-analysis/research/checklist-deep-prompt.md +144 -0
  378. package/src/modules/bmm/workflows/1-analysis/research/checklist-technical.md +249 -0
  379. package/src/modules/bmm/workflows/1-analysis/research/checklist.md +154 -57
  380. package/src/modules/bmm/workflows/1-analysis/research/instructions-deep-prompt.md +45 -29
  381. package/src/modules/bmm/workflows/1-analysis/research/instructions-market.md +181 -104
  382. package/src/modules/bmm/workflows/1-analysis/research/instructions-router.md +24 -32
  383. package/src/modules/bmm/workflows/1-analysis/research/instructions-technical.md +94 -46
  384. package/src/modules/bmm/workflows/1-analysis/research/template-market.md +37 -1
  385. package/src/modules/bmm/workflows/1-analysis/research/template-technical.md +36 -1
  386. package/src/modules/bmm/workflows/1-analysis/research/workflow.yaml +13 -0
  387. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/instructions.md +1 -1
  388. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/workflow.yaml +22 -0
  389. package/src/modules/bmm/workflows/2-plan-workflows/gdd/instructions-gdd.md +18 -0
  390. package/src/modules/bmm/workflows/2-plan-workflows/gdd/workflow.yaml +14 -0
  391. package/src/modules/bmm/workflows/2-plan-workflows/prd/checklist.md +296 -63
  392. package/src/modules/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/epics-template.md +52 -0
  393. package/src/modules/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/instructions.md +169 -0
  394. package/src/modules/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/workflow.yaml +55 -0
  395. package/src/modules/bmm/workflows/2-plan-workflows/prd/domain-complexity.csv +13 -0
  396. package/src/modules/bmm/workflows/2-plan-workflows/prd/instructions.md +268 -291
  397. package/src/modules/bmm/workflows/2-plan-workflows/prd/prd-template.md +198 -23
  398. package/src/modules/bmm/workflows/2-plan-workflows/prd/project-types.csv +11 -0
  399. package/src/modules/bmm/workflows/2-plan-workflows/prd/workflow.yaml +26 -8
  400. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/checklist.md +138 -31
  401. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/epics-template.md +73 -4
  402. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/instructions-level0-story.md +50 -17
  403. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/instructions-level1-stories.md +199 -26
  404. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/instructions.md +971 -109
  405. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/tech-spec-template.md +132 -6
  406. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/user-story-template.md +54 -20
  407. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/workflow.yaml +23 -2
  408. package/src/modules/bmm/workflows/3-solutioning/architecture/architecture-template.md +1 -1
  409. package/src/modules/bmm/workflows/3-solutioning/architecture/instructions.md +40 -32
  410. package/src/modules/bmm/workflows/3-solutioning/architecture/workflow.yaml +17 -4
  411. package/src/modules/bmm/workflows/3-solutioning/solutioning-gate-check/instructions.md +1 -0
  412. package/src/modules/bmm/workflows/3-solutioning/solutioning-gate-check/workflow.yaml +32 -6
  413. package/src/modules/bmm/workflows/4-implementation/code-review/instructions.md +29 -0
  414. package/src/modules/bmm/workflows/4-implementation/code-review/workflow.yaml +20 -0
  415. package/src/modules/bmm/workflows/4-implementation/create-story/instructions.md +29 -0
  416. package/src/modules/bmm/workflows/4-implementation/create-story/workflow.yaml +27 -0
  417. package/src/modules/bmm/workflows/4-implementation/epic-tech-context/instructions.md +29 -0
  418. package/src/modules/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml +32 -6
  419. package/src/modules/bmm/workflows/4-implementation/retrospective/instructions.md +1222 -241
  420. package/src/modules/bmm/workflows/4-implementation/retrospective/workflow.yaml +28 -0
  421. package/src/modules/bmm/workflows/4-implementation/sprint-planning/instructions.md +17 -0
  422. package/src/modules/bmm/workflows/4-implementation/sprint-planning/workflow.yaml +8 -0
  423. package/src/modules/bmm/workflows/4-implementation/story-context/instructions.md +31 -1
  424. package/src/modules/bmm/workflows/4-implementation/story-context/workflow.yaml +27 -0
  425. package/src/modules/bmm/workflows/techdoc/documentation-standards.md +239 -0
  426. package/src/modules/bmm/workflows/workflow-status/init/instructions.md +623 -242
  427. package/src/modules/bmm/workflows/workflow-status/paths/enterprise-brownfield.yaml +120 -0
  428. package/src/modules/bmm/workflows/workflow-status/paths/enterprise-greenfield.yaml +108 -0
  429. package/src/modules/bmm/workflows/workflow-status/paths/{brownfield-level-4.yaml → method-brownfield.yaml} +35 -26
  430. package/src/modules/bmm/workflows/workflow-status/paths/{greenfield-level-3.yaml → method-greenfield.yaml} +32 -17
  431. package/src/modules/bmm/workflows/workflow-status/paths/{brownfield-level-0.yaml → quick-flow-brownfield.yaml} +23 -19
  432. package/src/modules/bmm/workflows/workflow-status/paths/{greenfield-level-0.yaml → quick-flow-greenfield.yaml} +18 -16
  433. package/src/modules/bmm/workflows/workflow-status/workflow-status-template.yaml +4 -4
  434. package/tools/cli/commands/install.js +1 -1
  435. package/.claude/commands/bmad/bmd/agents/cli-chief.md +0 -108
  436. package/.claude/commands/bmad/bmd/agents/doc-keeper.md +0 -115
  437. package/.claude/commands/bmad/bmd/agents/release-chief.md +0 -109
  438. package/.claude/hooks/bmad-tts-injector.sh +0 -415
  439. package/.claude/hooks/bmad-voice-manager.sh +0 -511
  440. package/.claude/hooks/check-output-style.sh +0 -112
  441. package/.claude/hooks/download-extra-voices.sh +0 -244
  442. package/.claude/hooks/github-star-reminder.sh +0 -154
  443. package/.claude/hooks/language-manager.sh +0 -392
  444. package/.claude/hooks/learn-manager.sh +0 -475
  445. package/.claude/hooks/personality-manager.sh +0 -438
  446. package/.claude/hooks/piper-download-voices.sh +0 -165
  447. package/.claude/hooks/piper-installer.sh +0 -178
  448. package/.claude/hooks/piper-multispeaker-registry.sh +0 -165
  449. package/.claude/hooks/piper-voice-manager.sh +0 -293
  450. package/.claude/hooks/play-tts-elevenlabs.sh +0 -404
  451. package/.claude/hooks/play-tts-piper.sh +0 -338
  452. package/.claude/hooks/play-tts.sh +0 -100
  453. package/.claude/hooks/provider-commands.sh +0 -540
  454. package/.claude/hooks/provider-manager.sh +0 -298
  455. package/.claude/hooks/replay-target-audio.sh +0 -95
  456. package/.claude/hooks/sentiment-manager.sh +0 -201
  457. package/.claude/hooks/speed-manager.sh +0 -291
  458. package/.claude/hooks/voice-manager.sh +0 -594
  459. package/.claude/hooks/voices-config.sh +0 -70
  460. package/bmad/_cfg/agents/bmd-cli-chief.customize.yaml +0 -32
  461. package/bmad/bmb/workflows/create-agent/agent-architecture.md.bak +0 -412
  462. package/bmad/bmb/workflows/create-agent/agent-command-patterns.md.bak +0 -759
  463. package/bmad/bmb/workflows/create-module/README.md.bak +0 -218
  464. package/bmad/bmb/workflows/create-module/checklist.md.bak +0 -245
  465. package/bmad/bmb/workflows/create-module/installer-templates/installer.js.bak +0 -231
  466. package/bmad/bmb/workflows/create-module/instructions.md.bak +0 -521
  467. package/bmad/bmb/workflows/create-module/module-structure.md.bak +0 -310
  468. package/bmad/bmd/README.md +0 -193
  469. package/bmad/bmd/README.md.bak +0 -193
  470. package/bmad/bmd/agents/cli-chief-sidecar/instructions.md +0 -102
  471. package/bmad/bmd/agents/cli-chief-sidecar/instructions.md.bak +0 -102
  472. package/bmad/bmd/agents/cli-chief-sidecar/knowledge/README.md +0 -68
  473. package/bmad/bmd/agents/cli-chief-sidecar/knowledge/README.md.bak +0 -68
  474. package/bmad/bmd/agents/cli-chief-sidecar/knowledge/cli-reference.md +0 -123
  475. package/bmad/bmd/agents/cli-chief-sidecar/knowledge/cli-reference.md.bak +0 -123
  476. package/bmad/bmd/agents/cli-chief-sidecar/memories.md +0 -53
  477. package/bmad/bmd/agents/cli-chief-sidecar/memories.md.bak +0 -53
  478. package/bmad/bmd/agents/cli-chief.md +0 -108
  479. package/bmad/bmd/agents/cli-chief.md.bak +0 -108
  480. package/bmad/bmd/agents/doc-keeper-sidecar/instructions.md +0 -177
  481. package/bmad/bmd/agents/doc-keeper-sidecar/instructions.md.bak +0 -177
  482. package/bmad/bmd/agents/doc-keeper-sidecar/knowledge/README.md +0 -81
  483. package/bmad/bmd/agents/doc-keeper-sidecar/knowledge/README.md.bak +0 -81
  484. package/bmad/bmd/agents/doc-keeper-sidecar/memories.md +0 -88
  485. package/bmad/bmd/agents/doc-keeper-sidecar/memories.md.bak +0 -88
  486. package/bmad/bmd/agents/doc-keeper.md +0 -115
  487. package/bmad/bmd/agents/doc-keeper.md.bak +0 -115
  488. package/bmad/bmd/agents/release-chief-sidecar/instructions.md +0 -164
  489. package/bmad/bmd/agents/release-chief-sidecar/instructions.md.bak +0 -164
  490. package/bmad/bmd/agents/release-chief-sidecar/knowledge/README.md +0 -82
  491. package/bmad/bmd/agents/release-chief-sidecar/knowledge/README.md.bak +0 -82
  492. package/bmad/bmd/agents/release-chief-sidecar/memories.md +0 -73
  493. package/bmad/bmd/agents/release-chief-sidecar/memories.md.bak +0 -73
  494. package/bmad/bmd/agents/release-chief.md +0 -109
  495. package/bmad/bmd/agents/release-chief.md.bak +0 -109
  496. package/bmad/docs/codex-instructions.md +0 -21
  497. package/docs/bmad-brownfield-guide.md +0 -1260
  498. package/docs/conversion-report-shard-doc-2025-10-26.md +0 -188
  499. package/src/modules/bmm/tasks/retrospective.xml +0 -104
  500. package/src/modules/bmm/testarch/README.md +0 -311
  501. package/src/modules/bmm/workflows/1-analysis/brainstorm-game/README.md +0 -38
  502. package/src/modules/bmm/workflows/1-analysis/brainstorm-project/README.md +0 -113
  503. package/src/modules/bmm/workflows/1-analysis/game-brief/README.md +0 -221
  504. package/src/modules/bmm/workflows/1-analysis/product-brief/README.md +0 -180
  505. package/src/modules/bmm/workflows/1-analysis/research/README.md +0 -454
  506. package/src/modules/bmm/workflows/1-analysis/research/claude-code/sub-agents/bmm-competitor-analyzer.md +0 -259
  507. package/src/modules/bmm/workflows/1-analysis/research/claude-code/sub-agents/bmm-data-analyst.md +0 -190
  508. package/src/modules/bmm/workflows/1-analysis/research/claude-code/sub-agents/bmm-market-researcher.md +0 -337
  509. package/src/modules/bmm/workflows/1-analysis/research/claude-code/sub-agents/bmm-trend-spotter.md +0 -107
  510. package/src/modules/bmm/workflows/1-analysis/research/claude-code/sub-agents/bmm-user-researcher.md +0 -329
  511. package/src/modules/bmm/workflows/2-plan-workflows/README.md +0 -258
  512. package/src/modules/bmm/workflows/2-plan-workflows/gdd/README.md +0 -222
  513. package/src/modules/bmm/workflows/3-solutioning/README.md +0 -1
  514. package/src/modules/bmm/workflows/3-solutioning/solutioning-gate-check/README.md +0 -177
  515. package/src/modules/bmm/workflows/4-implementation/README.md +0 -221
  516. package/src/modules/bmm/workflows/4-implementation/code-review/README.md +0 -69
  517. package/src/modules/bmm/workflows/4-implementation/correct-course/README.md +0 -73
  518. package/src/modules/bmm/workflows/4-implementation/create-story/README.md +0 -146
  519. package/src/modules/bmm/workflows/4-implementation/dev-story/README.md +0 -206
  520. package/src/modules/bmm/workflows/4-implementation/epic-tech-context/README.md +0 -195
  521. package/src/modules/bmm/workflows/4-implementation/retrospective/README.md +0 -77
  522. package/src/modules/bmm/workflows/4-implementation/sprint-planning/README.md +0 -156
  523. package/src/modules/bmm/workflows/4-implementation/story-context/README.md +0 -234
  524. package/src/modules/bmm/workflows/README.md +0 -215
  525. package/src/modules/bmm/workflows/document-project/templates/README.md +0 -38
  526. package/src/modules/bmm/workflows/testarch/README.md +0 -26
  527. package/src/modules/bmm/workflows/testarch/atdd/README.md +0 -672
  528. package/src/modules/bmm/workflows/testarch/automate/README.md +0 -869
  529. package/src/modules/bmm/workflows/testarch/ci/README.md +0 -493
  530. package/src/modules/bmm/workflows/testarch/framework/README.md +0 -340
  531. package/src/modules/bmm/workflows/testarch/nfr-assess/README.md +0 -469
  532. package/src/modules/bmm/workflows/testarch/test-design/README.md +0 -493
  533. package/src/modules/bmm/workflows/testarch/test-review/README.md +0 -775
  534. package/src/modules/bmm/workflows/testarch/trace/README.md +0 -802
  535. package/src/modules/bmm/workflows/workflow-status/README.md +0 -260
  536. package/src/modules/bmm/workflows/workflow-status/paths/brownfield-level-2.yaml +0 -76
  537. package/src/modules/bmm/workflows/workflow-status/paths/greenfield-level-4.yaml +0 -75
  538. /package/bmad/_cfg/agents/{bmd-doc-keeper.customize.yaml → bmm-analyst.customize.yaml} +0 -0
  539. /package/bmad/_cfg/agents/{bmd-release-chief.customize.yaml → bmm-architect.customize.yaml} +0 -0
  540. /package/{src/modules/bmm/workflows/2-plan-workflows/prd → bmad/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories}/epics-template.md +0 -0
@@ -2,40 +2,60 @@
2
2
 
3
3
  <critical>The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.xml</critical>
4
4
  <critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
5
- <critical>This is an INTERACTIVE workflow with web research capabilities. Engage the user at key decision points.</critical>
5
+ <critical>This workflow uses ADAPTIVE FACILITATION - adjust your communication style based on {user_skill_level}</critical>
6
+ <critical>This is a HIGHLY INTERACTIVE workflow - collaborate with user throughout, don't just gather info and disappear</critical>
7
+ <critical>Web research is MANDATORY - use WebSearch tool with {{current_year}} for all market intelligence gathering</critical>
8
+ <critical>Communicate all responses in {communication_language} and tailor to {user_skill_level}</critical>
9
+ <critical>Generate all documents in {document_output_language}</critical>
10
+
11
+ <critical>🚨 ANTI-HALLUCINATION PROTOCOL - MANDATORY 🚨</critical>
12
+ <critical>NEVER invent market data - if you cannot find reliable data, explicitly state: "I could not find verified data for [X]"</critical>
13
+ <critical>EVERY statistic, market size, growth rate, or competitive claim MUST have a cited source with URL</critical>
14
+ <critical>For CRITICAL claims (TAM/SAM/SOM, market size, growth rates), require 2+ independent sources that agree</critical>
15
+ <critical>When data sources conflict (e.g., different market size estimates), present ALL estimates with sources and explain variance</critical>
16
+ <critical>Mark data confidence: [Verified - 2+ sources], [Single source - verify], [Estimated - low confidence]</critical>
17
+ <critical>Clearly label: FACT (sourced data), ANALYSIS (your interpretation), PROJECTION (forecast/speculation)</critical>
18
+ <critical>After each WebSearch, extract and store source URLs - include them in the report</critical>
19
+ <critical>If a claim seems suspicious or too convenient, STOP and cross-verify with additional searches</critical>
6
20
 
7
21
  <!-- IDE-INJECT-POINT: market-research-subagents -->
8
22
 
9
23
  <workflow>
10
24
 
11
- <step n="1" goal="Research Discovery and Scoping">
12
- <action>Welcome the user and explain the market research journey ahead</action>
25
+ <step n="1" goal="Discover research needs and scope collaboratively">
13
26
 
14
- Ask the user these critical questions to shape the research:
27
+ <action>Welcome {user_name} warmly. Position yourself as their collaborative research partner who will:
15
28
 
16
- 1. **What is the product/service you're researching?**
17
- - Name and brief description
18
- - Current stage (idea, MVP, launched, scaling)
29
+ - Gather live {{current_year}} market data
30
+ - Share findings progressively throughout
31
+ - Help make sense of what we discover together
19
32
 
20
- 2. **What are your primary research objectives?**
21
- - Market sizing and opportunity assessment?
22
- - Competitive intelligence gathering?
23
- - Customer segment validation?
24
- - Go-to-market strategy development?
25
- - Investment/fundraising support?
26
- - Product-market fit validation?
33
+ Ask what they're building and what market questions they need answered.
34
+ </action>
27
35
 
28
- 3. **Research depth preference:**
29
- - Quick scan (2-3 hours) - High-level insights
30
- - Standard analysis (4-6 hours) - Comprehensive coverage
31
- - Deep dive (8+ hours) - Exhaustive research with modeling
36
+ <action>Through natural conversation, discover:
32
37
 
33
- 4. **Do you have any existing research or documents to build upon?**
38
+ - The product/service and current stage
39
+ - Their burning questions (what they REALLY need to know)
40
+ - Context and urgency (fundraising? launch decision? pivot?)
41
+ - Existing knowledge vs. uncertainties
42
+ - Desired depth (gauge from their needs, don't ask them to choose)
43
+
44
+ Adapt your approach: If uncertain → help them think it through. If detailed → dig deeper.
45
+
46
+ Collaboratively define scope:
47
+
48
+ - Markets/segments to focus on
49
+ - Geographic boundaries
50
+ - Critical questions vs. nice-to-have
51
+ </action>
52
+
53
+ <action>Reflect understanding back to confirm you're aligned on what matters.</action>
34
54
 
35
55
  <template-output>product_name</template-output>
36
56
  <template-output>product_description</template-output>
37
57
  <template-output>research_objectives</template-output>
38
- <template-output>research_depth</template-output>
58
+ <template-output>research_scope</template-output>
39
59
  </step>
40
60
 
41
61
  <step n="2" goal="Market Definition and Boundaries">
@@ -65,49 +85,64 @@ Work with the user to establish:
65
85
  <template-output>segment_boundaries</template-output>
66
86
  </step>
67
87
 
68
- <step n="3" goal="Live Market Intelligence Gathering" if="enable_web_research == true">
69
- <action>Conduct real-time web research to gather current market data</action>
88
+ <step n="3" goal="Gather live market intelligence collaboratively">
89
+
90
+ <critical>This step REQUIRES WebSearch tool usage - gather CURRENT data from {{current_year}}</critical>
91
+ <critical>Share findings as you go - make this collaborative, not a black box</critical>
70
92
 
71
- <critical>This step performs ACTUAL web searches to gather live market intelligence</critical>
93
+ <action>Let {user_name} know you're searching for current {{market_category}} market data: size, growth, analyst reports, recent trends. Tell them you'll share what you find in a few minutes and review it together.</action>
72
94
 
73
- Conduct systematic research across multiple sources:
95
+ <step n="3a" title="Search for market size and industry data">
96
+ <action>Conduct systematic web searches using WebSearch tool:
74
97
 
75
- <step n="3a" title="Industry Reports and Statistics">
76
- <action>Search for latest industry reports, market size data, and growth projections</action>
77
- Search queries to execute:
78
- - "[market_category] market size [geographic_scope] [current_year]"
79
- - "[market_category] industry report Gartner Forrester IDC McKinsey"
80
- - "[market_category] market growth rate CAGR forecast"
81
- - "[market_category] market trends [current_year]"
98
+ <WebSearch>{{market_category}} market size {{geographic_scope}} {{current_year}}</WebSearch>
99
+ <WebSearch>{{market_category}} industry report Gartner Forrester IDC {{current_year}}</WebSearch>
100
+ <WebSearch>{{market_category}} market growth rate CAGR forecast {{current_year}}</WebSearch>
101
+ <WebSearch>{{market_category}} market trends {{current_year}}</WebSearch>
102
+ <WebSearch>{{market_category}} TAM SAM market opportunity {{current_year}}</WebSearch>
103
+ </action>
104
+
105
+ <action>Share findings WITH SOURCES including URLs and dates. Ask if it aligns with their expectations.</action>
106
+
107
+ <action>CRITICAL - Validate data before proceeding:
108
+
109
+ - Multiple sources with similar figures?
110
+ - Recent sources ({{current_year}} or within 1-2 years)?
111
+ - Credible sources (Gartner, Forrester, govt data, reputable pubs)?
112
+ - Conflicts? Note explicitly, search for more sources, mark [Low Confidence]
113
+ </action>
114
+
115
+ <action if="user_has_questions">Explore surprising data points together</action>
82
116
 
83
117
  <invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
84
- </step>
85
118
 
86
- <step n="3b" title="Regulatory and Government Data">
87
- <action>Search government databases and regulatory sources</action>
88
- Search for:
89
- - Government statistics bureaus
90
- - Industry associations
91
- - Regulatory body reports
92
- - Census and economic data
119
+ <template-output>sources_market_size</template-output>
93
120
  </step>
94
121
 
95
- <step n="3c" title="News and Recent Developments">
96
- <action>Gather recent news, funding announcements, and market events</action>
97
- Search for articles from the last 6-12 months about:
98
- - Major deals and acquisitions
99
- - Funding rounds in the space
100
- - New market entrants
101
- - Regulatory changes
102
- - Technology disruptions
122
+ <step n="3b" title="Search for recent news and developments" optional="true">
123
+ <action>Search for recent market developments:
124
+
125
+ <WebSearch>{{market_category}} news {{current_year}} funding acquisitions</WebSearch>
126
+ <WebSearch>{{market_category}} recent developments {{current_year}}</WebSearch>
127
+ <WebSearch>{{market_category}} regulatory changes {{current_year}}</WebSearch>
128
+ </action>
129
+
130
+ <action>Share noteworthy findings:
131
+
132
+ "I found some interesting recent developments:
133
+
134
+ {{key_news_highlights}}
135
+
136
+ Anything here surprise you or confirm what you suspected?"
137
+ </action>
103
138
  </step>
104
139
 
105
- <step n="3d" title="Academic and Research Papers">
106
- <action>Search for academic research and white papers</action>
107
- Look for peer-reviewed studies on:
108
- - Market dynamics
109
- - Technology adoption patterns
110
- - Customer behavior research
140
+ <step n="3c" title="Optional: Government and academic sources" optional="true">
141
+ <action if="research needs high credibility">Search for authoritative sources:
142
+
143
+ <WebSearch>{{market_category}} government statistics census data {{current_year}}</WebSearch>
144
+ <WebSearch>{{market_category}} academic research white papers {{current_year}}</WebSearch>
145
+ </action>
111
146
  </step>
112
147
 
113
148
  <template-output>market_intelligence_raw</template-output>
@@ -250,38 +285,36 @@ Analyze:
250
285
  </step>
251
286
  </step>
252
287
 
253
- <step n="6" goal="Competitive Intelligence" if="enable_competitor_analysis == true">
254
- <action>Conduct comprehensive competitive analysis</action>
288
+ <step n="6" goal="Understand the competitive landscape">
289
+ <action>Ask if they know their main competitors or if you should search for them.</action>
255
290
 
256
- <step n="6a" title="Competitor Identification">
257
- <action>Create comprehensive competitor list</action>
291
+ <step n="6a" title="Discover competitors together">
292
+ <action if="user doesn't know competitors">Search for competitors:
258
293
 
259
- Search for and categorize:
294
+ <WebSearch>{{product_category}} competitors {{geographic_scope}} {{current_year}}</WebSearch>
295
+ <WebSearch>{{product_category}} alternatives comparison {{current_year}}</WebSearch>
296
+ <WebSearch>top {{product_category}} companies {{current_year}}</WebSearch>
297
+ </action>
260
298
 
261
- 1. **Direct Competitors** - Same solution, same market
262
- 2. **Indirect Competitors** - Different solution, same problem
263
- 3. **Potential Competitors** - Could enter market
264
- 4. **Substitute Products** - Alternative approaches
265
-
266
- <ask>Do you have a specific list of competitors to analyze, or should I discover them through research?</ask>
299
+ <action>Present findings. Ask them to pick the 3-5 that matter most (most concerned about or curious to understand).</action>
267
300
  </step>
268
301
 
269
- <step n="6b" title="Competitor Deep Dive" repeat="5">
270
- <action>For top 5 competitors, research and analyze</action>
302
+ <step n="6b" title="Research each competitor together" repeat="for-each-selected-competitor">
303
+ <action>For each competitor, search for:
304
+ - Company overview, product features
305
+ - Pricing model
306
+ - Funding and recent news
307
+ - Customer reviews and ratings
308
+
309
+ Use {{current_year}} in all searches.
310
+ </action>
271
311
 
272
- Gather intelligence on:
312
+ <action>Share findings with sources. Ask what jumps out and if it matches expectations.</action>
273
313
 
274
- - Company overview and history
275
- - Product features and positioning
276
- - Pricing strategy and models
277
- - Target customer focus
278
- - Recent news and developments
279
- - Funding and financial health
280
- - Team and leadership
281
- - Customer reviews and sentiment
314
+ <action if="user has follow-up questions">Dig deeper based on their interests</action>
282
315
 
283
316
  <invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
284
- <template-output>competitor*analysis*{{competitor_number}}</template-output>
317
+ <template-output>competitor*analysis*{{competitor_name}}</template-output>
285
318
  </step>
286
319
 
287
320
  <step n="6c" title="Competitive Positioning Map">
@@ -485,55 +518,99 @@ Provide mitigation strategies.
485
518
 
486
519
  </step>
487
520
 
488
- <step n="11" goal="Executive Summary Creation">
489
- <action>Synthesize all findings into executive summary</action>
521
+ <step n="11" goal="Synthesize findings together into executive summary">
490
522
 
491
- <critical>Write this AFTER all other sections are complete</critical>
523
+ <critical>This is the last major content section - make it collaborative</critical>
492
524
 
493
- Create compelling executive summary with:
525
+ <action>Review the research journey together. Share high-level summaries of market size, competitive dynamics, customer insights. Ask what stands out most - what surprised them or confirmed their thinking.</action>
494
526
 
495
- **Market Opportunity:**
527
+ <action>Collaboratively craft the narrative:
496
528
 
497
- - TAM/SAM/SOM summary
498
- - Growth trajectory
529
+ - What's the headline? (The ONE thing someone should know)
530
+ - What are the 3-5 critical insights?
531
+ - Recommended path forward?
532
+ - Key risks?
499
533
 
500
- **Key Insights:**
534
+ This should read like a strategic brief, not a data dump.
535
+ </action>
501
536
 
502
- - Top 3-5 findings
503
- - Surprising discoveries
504
- - Critical success factors
537
+ <action>Draft executive summary and share. Ask if it captures the essence and if anything is missing or overemphasized.</action>
505
538
 
506
- **Competitive Landscape:**
539
+ <template-output>executive_summary</template-output>
540
+ </step>
507
541
 
508
- - Market structure
509
- - Positioning opportunity
542
+ <step n="12" goal="Validate sources and compile report">
510
543
 
511
- **Strategic Recommendations:**
544
+ <critical>MANDATORY SOURCE VALIDATION - Do NOT skip this step!</critical>
512
545
 
513
- - Priority actions
514
- - Go-to-market approach
515
- - Investment requirements
546
+ <action>Before finalizing, conduct source audit:
516
547
 
517
- **Risk Summary:**
548
+ Review every major claim in the report and verify:
518
549
 
519
- - Major risks
520
- - Mitigation approach
550
+ **For Market Size Claims:**
521
551
 
522
- <template-output>executive_summary</template-output>
523
- </step>
552
+ - [ ] At least 2 independent sources cited with URLs
553
+ - [ ] Sources are from {{current_year}} or within 2 years
554
+ - [ ] Sources are credible (Gartner, Forrester, govt data, reputable pubs)
555
+ - [ ] Conflicting estimates are noted with all sources
556
+
557
+ **For Competitive Data:**
558
+
559
+ - [ ] Competitor information has source URLs
560
+ - [ ] Pricing data is current and sourced
561
+ - [ ] Funding data is verified with dates
562
+ - [ ] Customer reviews/ratings have source links
563
+
564
+ **For Growth Rates and Projections:**
565
+
566
+ - [ ] CAGR and forecast data are sourced
567
+ - [ ] Methodology is explained or linked
568
+ - [ ] Multiple analyst estimates are compared if available
569
+
570
+ **For Customer Insights:**
571
+
572
+ - [ ] Persona data is based on real research (cited)
573
+ - [ ] Survey/interview data has sample size and source
574
+ - [ ] Behavioral claims are backed by studies/data
575
+ </action>
576
+
577
+ <action>Count and document source quality:
578
+
579
+ - Total sources cited: {{count_all_sources}}
580
+ - High confidence (2+ sources): {{high_confidence_claims}}
581
+ - Single source (needs verification): {{single_source_claims}}
582
+ - Uncertain/speculative: {{low_confidence_claims}}
583
+
584
+ If {{single_source_claims}} or {{low_confidence_claims}} is high, consider additional research.
585
+ </action>
586
+
587
+ <action>Compile full report with ALL sources properly referenced:
588
+
589
+ Generate the complete market research report using the template:
590
+
591
+ - Ensure every statistic has inline citation: [Source: Company, Year, URL]
592
+ - Populate all {{sources_*}} template variables
593
+ - Include confidence levels for major claims
594
+ - Add References section with full source list
595
+ </action>
596
+
597
+ <action>Present source quality summary to user:
598
+
599
+ "I've completed the research with {{count_all_sources}} total sources:
524
600
 
525
- <step n="12" goal="Report Compilation and Review">
526
- <action>Compile full report and review with user</action>
601
+ - {{high_confidence_claims}} claims verified with multiple sources
602
+ - {{single_source_claims}} claims from single sources (marked for verification)
603
+ - {{low_confidence_claims}} claims with low confidence or speculation
527
604
 
528
- <action>Generate the complete market research report using the template</action>
529
- <action>Review all sections for completeness and consistency</action>
530
- <action>Ensure all data sources are properly cited</action>
605
+ Would you like me to strengthen any areas with additional research?"
606
+ </action>
531
607
 
532
608
  <ask>Would you like to review any specific sections before finalizing? Are there any additional analyses you'd like to include?</ask>
533
609
 
534
610
  <goto step="9a" if="user requests changes">Return to refine opportunities</goto>
535
611
 
536
612
  <template-output>final_report_ready</template-output>
613
+ <template-output>source_audit_complete</template-output>
537
614
  </step>
538
615
 
539
616
  <step n="13" goal="Appendices and Supporting Materials" optional="true">
@@ -2,7 +2,17 @@
2
2
 
3
3
  <critical>The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.xml</critical>
4
4
  <critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
5
- <critical>Communicate all responses in {communication_language}</critical>
5
+ <critical>Communicate in {communication_language}, generate documents in {document_output_language}</critical>
6
+ <critical>Web research is ENABLED - always use current {{current_year}} data</critical>
7
+
8
+ <critical>🚨 ANTI-HALLUCINATION PROTOCOL - MANDATORY 🚨</critical>
9
+ <critical>NEVER present information without a verified source - if you cannot find a source, say "I could not find reliable data on this"</critical>
10
+ <critical>ALWAYS cite sources with URLs when presenting data, statistics, or factual claims</critical>
11
+ <critical>REQUIRE at least 2 independent sources for critical claims (market size, growth rates, competitive data)</critical>
12
+ <critical>When sources conflict, PRESENT BOTH views and note the discrepancy - do NOT pick one arbitrarily</critical>
13
+ <critical>Flag any data you are uncertain about with confidence levels: [High Confidence], [Medium Confidence], [Low Confidence - verify]</critical>
14
+ <critical>Distinguish clearly between: FACTS (from sources), ANALYSIS (your interpretation), and SPECULATION (educated guesses)</critical>
15
+ <critical>When using WebSearch results, ALWAYS extract and include the source URL for every claim</critical>
6
16
 
7
17
  <!-- IDE-INJECT-POINT: research-subagents -->
8
18
 
@@ -49,43 +59,25 @@
49
59
  </check>
50
60
  </step>
51
61
 
52
- <step n="2" goal="Welcome and Research Type Selection">
53
- <action>Welcome the user to the Research Workflow</action>
62
+ <step n="2" goal="Discover research needs through conversation">
54
63
 
55
- **The Research Workflow supports multiple research types:**
64
+ <action>Welcome {user_name} warmly. Position yourself as their research partner who uses live {{current_year}} web data. Ask what they're looking to understand or research.</action>
56
65
 
57
- Present the user with research type options:
66
+ <action>Listen and collaboratively identify the research type based on what they describe:
58
67
 
59
- **What type of research do you need?**
68
+ - Market/Business questions Market Research
69
+ - Competitor questions → Competitive Intelligence
70
+ - Customer questions → User Research
71
+ - Technology questions → Technical Research
72
+ - Industry questions → Domain Research
73
+ - Creating research prompts for AI platforms → Deep Research Prompt Generator
60
74
 
61
- 1. **Market Research** - Comprehensive market analysis with TAM/SAM/SOM calculations, competitive intelligence, customer segments, and go-to-market strategy
62
- - Use for: Market opportunity assessment, competitive landscape analysis, market sizing
63
- - Output: Detailed market research report with financials
75
+ Confirm your understanding of what type would be most helpful and what it will produce.
76
+ </action>
64
77
 
65
- 2. **Deep Research Prompt Generator** - Create structured, multi-step research prompts optimized for AI platforms (ChatGPT, Gemini, Grok, Claude)
66
- - Use for: Generating comprehensive research prompts, structuring complex investigations
67
- - Output: Optimized research prompt with framework, scope, and validation criteria
68
-
69
- 3. **Technical/Architecture Research** - Evaluate technology stacks, architecture patterns, frameworks, and technical approaches
70
- - Use for: Tech stack decisions, architecture pattern selection, framework evaluation
71
- - Output: Technical research report with recommendations and trade-off analysis
72
-
73
- 4. **Competitive Intelligence** - Deep dive into specific competitors, their strategies, products, and market positioning
74
- - Use for: Competitor deep dives, competitive strategy analysis
75
- - Output: Competitive intelligence report
76
-
77
- 5. **User Research** - Customer insights, personas, jobs-to-be-done, and user behavior analysis
78
- - Use for: Customer discovery, persona development, user journey mapping
79
- - Output: User research report with personas and insights
80
-
81
- 6. **Domain/Industry Research** - Deep dive into specific industries, domains, or subject matter areas
82
- - Use for: Industry analysis, domain expertise building, trend analysis
83
- - Output: Domain research report
84
-
85
- <ask>Select a research type (1-6) or describe your research needs:</ask>
86
-
87
- <action>Capture user selection as {{research_type}}</action>
78
+ <action>Capture {{research_type}} and {{research_mode}}</action>
88
79
 
80
+ <template-output>research_type_discovery</template-output>
89
81
  </step>
90
82
 
91
83
  <step n="3" goal="Route to Appropriate Research Instructions">
@@ -2,38 +2,65 @@
2
2
 
3
3
  <critical>The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.xml</critical>
4
4
  <critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
5
- <critical>This workflow conducts technical research for architecture and technology decisions</critical>
5
+ <critical>This workflow uses ADAPTIVE FACILITATION - adjust your communication style based on {user_skill_level}</critical>
6
+ <critical>This is a HIGHLY INTERACTIVE workflow - make technical decisions WITH user, not FOR them</critical>
7
+ <critical>Web research is MANDATORY - use WebSearch tool with {{current_year}} for current version info and trends</critical>
8
+ <critical>ALWAYS verify current versions - NEVER use hardcoded or outdated version numbers</critical>
9
+ <critical>Communicate all responses in {communication_language} and tailor to {user_skill_level}</critical>
10
+ <critical>Generate all documents in {document_output_language}</critical>
11
+
12
+ <critical>🚨 ANTI-HALLUCINATION PROTOCOL - MANDATORY 🚨</critical>
13
+ <critical>NEVER invent version numbers, features, or technical details - ALWAYS verify with current {{current_year}} sources</critical>
14
+ <critical>Every technical claim (version, feature, performance, compatibility) MUST have a cited source with URL</critical>
15
+ <critical>Version numbers MUST be verified via WebSearch - do NOT rely on training data (it's outdated!)</critical>
16
+ <critical>When comparing technologies, cite sources for each claim (performance benchmarks, community size, etc.)</critical>
17
+ <critical>Mark confidence levels: [Verified {{current_year}} source], [Older source - verify], [Uncertain - needs verification]</critical>
18
+ <critical>Distinguish: FACT (from official docs/sources), OPINION (from community/reviews), SPECULATION (your analysis)</critical>
19
+ <critical>If you cannot find current information about a technology, state: "I could not find recent {{current_year}} data on [X]"</critical>
20
+ <critical>Extract and include source URLs in all technology profiles and comparisons</critical>
6
21
 
7
22
  <workflow>
8
23
 
9
- <step n="1" goal="Technical Research Discovery">
10
- <action>Understand the technical research requirements</action>
24
+ <step n="1" goal="Discover technical research needs through conversation">
11
25
 
12
- **Welcome to Technical/Architecture Research!**
26
+ <action>Engage conversationally based on skill level:
13
27
 
14
- <ask>What technical decision or research do you need?
28
+ <check if="{user_skill_level} == 'expert'">
29
+ "Let's research the technical options for your decision.
15
30
 
16
- Common scenarios:
31
+ I'll gather current data from {{current_year}}, compare approaches, and help you think through trade-offs.
17
32
 
18
- - Evaluate technology stack for a new project
19
- - Compare frameworks or libraries (React vs Vue, Postgres vs MongoDB)
20
- - Research architecture patterns (microservices, event-driven, CQRS)
21
- - Investigate specific technologies or tools
22
- - Best practices for specific use cases
23
- - Performance and scalability considerations
24
- - Security and compliance research</ask>
33
+ What technical question are you wrestling with?"
34
+ </check>
25
35
 
26
- <template-output>technical_question</template-output>
36
+ <check if="{user_skill_level} == 'intermediate'">
37
+ "I'll help you research and evaluate your technical options.
38
+
39
+ We'll look at current technologies (using {{current_year}} data), understand the trade-offs, and figure out what fits your needs best.
40
+
41
+ What technical decision are you trying to make?"
42
+ </check>
43
+
44
+ <check if="{user_skill_level} == 'beginner'">
45
+ "Think of this as having a technical advisor help you research your options.
27
46
 
28
- <ask>What's the context for this decision?
47
+ I'll explain what different technologies do, why you might choose one over another, and help you make an informed decision.
29
48
 
30
- - New greenfield project
31
- - Adding to existing system (brownfield)
32
- - Refactoring/modernizing legacy system
33
- - Proof of concept / prototype
34
- - Production-ready implementation
35
- - Academic/learning purpose</ask>
49
+ What technical challenge brought you here?"
50
+ </check>
51
+ </action>
52
+
53
+ <action>Through conversation, understand:
54
+
55
+ - **The technical question** - What they need to decide or understand
56
+ - **The context** - Greenfield? Brownfield? Learning? Production?
57
+ - **Current constraints** - Languages, platforms, team skills, budget
58
+ - **What they already know** - Do they have candidates in mind?
36
59
 
60
+ Don't interrogate - explore together. If they're unsure, help them articulate the problem.
61
+ </action>
62
+
63
+ <template-output>technical_question</template-output>
37
64
  <template-output>project_context</template-output>
38
65
 
39
66
  </step>
@@ -82,49 +109,70 @@ Consider:
82
109
 
83
110
  </step>
84
111
 
85
- <step n="3" goal="Identify Alternatives and Options">
86
- <action>Research and identify technology options to evaluate</action>
112
+ <step n="3" goal="Discover and evaluate technology options together">
87
113
 
88
- <ask>Do you have specific technologies in mind to compare, or should I discover options?
114
+ <critical>MUST use WebSearch to find current options from {{current_year}}</critical>
89
115
 
90
- If you have specific options, list them. Otherwise, I'll research current leading solutions based on your requirements.</ask>
116
+ <action>Ask if they have candidates in mind:
91
117
 
92
- <template-output if="user provides options">user_provided_options</template-output>
118
+ "Do you already have specific technologies you want to compare, or should I search for the current options?"
119
+ </action>
93
120
 
94
- <check if="discovering options">
95
- <action>Conduct web research to identify current leading solutions</action>
96
- <action>Search for:
121
+ <action if="user has candidates">Great! Let's research: {{user_candidates}}</action>
97
122
 
98
- - "[technical_category] best tools 2025"
99
- - "[technical_category] comparison [use_case]"
100
- - "[technical_category] production experiences reddit"
101
- - "State of [technical_category] 2025"
102
- </action>
123
+ <action if="discovering options">Search for current leading technologies:
103
124
 
104
- <invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
125
+ <WebSearch>{{technical_category}} best tools {{current_year}}</WebSearch>
126
+ <WebSearch>{{technical_category}} comparison {{use_case}} {{current_year}}</WebSearch>
127
+ <WebSearch>{{technical_category}} popular frameworks {{current_year}}</WebSearch>
128
+ <WebSearch>state of {{technical_category}} {{current_year}}</WebSearch>
129
+ </action>
105
130
 
106
- <action>Present discovered options (typically 3-5 main candidates)</action>
107
- <template-output>technology_options</template-output>
131
+ <action>Share findings conversationally:
108
132
 
133
+ "Based on current {{current_year}} data, here are the main options:
134
+
135
+ {{discovered_options}}
136
+
137
+ <check if="{user_skill_level} == 'expert'">
138
+ These are the leaders right now. Which ones make sense to evaluate for your use case?"
139
+ </check>
140
+
141
+ <check if="{user_skill_level} == 'beginner'">
142
+ Each of these is popular for different reasons. Let me know if you want me to explain what makes each one different."
109
143
  </check>
144
+ </action>
145
+
146
+ <invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
147
+
148
+ <template-output>technology_options</template-output>
110
149
 
111
150
  </step>
112
151
 
113
- <step n="4" goal="Deep Dive Research on Each Option">
114
- <action>Research each technology option in depth</action>
152
+ <step n="4" goal="Research each technology together in depth">
115
153
 
116
- <critical>For each technology option, research thoroughly</critical>
154
+ <critical>For each option, use WebSearch to gather CURRENT {{current_year}} information</critical>
117
155
 
118
- <step n="4a" title="Technology Profile" repeat="for-each-option">
156
+ <step n="4a" title="Deep dive on each technology" repeat="for-each-option">
119
157
 
120
- Research and document:
158
+ <action>For {{technology_name}}, conduct comprehensive research:
159
+
160
+ <WebSearch>{{technology_name}} overview what is {{current_year}}</WebSearch>
161
+ <WebSearch>{{technology_name}} latest version release notes {{current_year}}</WebSearch>
162
+ <WebSearch>{{technology_name}} pros cons trade-offs {{current_year}}</WebSearch>
163
+ <WebSearch>{{technology_name}} production experience real world {{current_year}}</WebSearch>
164
+ <WebSearch>{{technology_name}} vs alternatives comparison {{current_year}}</WebSearch>
165
+ </action>
166
+
167
+ <action>Share findings conversationally and collaboratively:
168
+
169
+ "Here's what I found about {{technology_name}}:
121
170
 
122
171
  **Overview:**
172
+ {{what_it_is_and_solves}}
123
173
 
124
- - What is it and what problem does it solve?
125
- - Maturity level (experimental, stable, mature, legacy)
126
- - Community size and activity
127
- - Maintenance status and release cadence
174
+ **Current Status ({{current_year}}):**
175
+ {{maturity_community_release_cadence}}
128
176
 
129
177
  **Technical Characteristics:**
130
178