bmad-method 6.0.0-alpha.7 → 6.0.0-alpha.9

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 (457) hide show
  1. package/.github/ISSUE_TEMPLATE/idea_submission.md +1 -1
  2. package/.github/workflows/bundle-latest.yaml +277 -0
  3. package/.github/workflows/manual-release.yaml +55 -16
  4. package/.vscode/settings.json +2 -1
  5. package/CHANGELOG.md +439 -1
  6. package/README.md +12 -4
  7. package/docs/BUNDLE_DISTRIBUTION_SETUP.md +95 -0
  8. package/docs/agent-customization-guide.md +208 -0
  9. package/docs/ide-info/crush.md +1 -1
  10. package/docs/ide-info/cursor.md +7 -7
  11. package/docs/ide-info/iflow.md +3 -3
  12. package/docs/ide-info/opencode.md +1 -1
  13. package/docs/index.md +3 -1
  14. package/docs/installers-bundlers/ide-injections.md +2 -2
  15. package/docs/installers-bundlers/installers-modules-platforms-reference.md +23 -23
  16. package/docs/v4-to-v6-upgrade.md +12 -12
  17. package/docs/web-bundles-gemini-gpt-guide.md +473 -0
  18. package/package.json +1 -1
  19. package/src/core/_module-installer/install-config.yaml +17 -10
  20. package/src/core/_module-installer/installer.js +0 -8
  21. package/src/core/agents/bmad-master.agent.yaml +5 -5
  22. package/src/core/agents/bmad-web-orchestrator.agent.xml +8 -17
  23. package/src/core/tasks/{adv-elicit.xml → advanced-elicitation.xml} +6 -4
  24. package/src/core/tasks/index-docs.xml +1 -1
  25. package/src/core/tasks/validate-workflow.xml +1 -1
  26. package/src/core/tasks/workflow.xml +125 -11
  27. package/src/core/tools/shard-doc.xml +45 -1
  28. package/src/core/workflows/brainstorming/README.md +6 -16
  29. package/src/core/workflows/brainstorming/instructions.md +6 -5
  30. package/src/core/workflows/brainstorming/template.md +4 -0
  31. package/src/core/workflows/brainstorming/workflow.yaml +8 -8
  32. package/src/core/workflows/party-mode/instructions.md +2 -7
  33. package/src/core/workflows/party-mode/workflow.yaml +10 -6
  34. package/src/modules/bmb/_module-installer/install-config.yaml +9 -4
  35. package/src/modules/bmb/agents/bmad-builder.agent.yaml +11 -10
  36. package/src/modules/bmb/workflows/audit-workflow/checklist.md +5 -6
  37. package/src/modules/bmb/workflows/audit-workflow/instructions.md +5 -5
  38. package/src/modules/bmb/workflows/audit-workflow/workflow.yaml +2 -2
  39. package/src/modules/bmb/workflows/convert-legacy/README.md +5 -5
  40. package/src/modules/bmb/workflows/convert-legacy/checklist.md +2 -2
  41. package/src/modules/bmb/workflows/convert-legacy/instructions.md +17 -17
  42. package/src/modules/bmb/workflows/convert-legacy/workflow.yaml +6 -6
  43. package/src/modules/bmb/workflows/create-agent/README.md +5 -5
  44. package/src/modules/bmb/workflows/create-agent/agent-architecture.md +15 -19
  45. package/src/modules/bmb/workflows/create-agent/agent-command-patterns.md +28 -28
  46. package/src/modules/bmb/workflows/create-agent/agent-types.md +15 -15
  47. package/src/modules/bmb/workflows/create-agent/checklist.md +3 -3
  48. package/src/modules/bmb/workflows/create-agent/instructions.md +24 -27
  49. package/src/modules/bmb/workflows/create-agent/workflow.yaml +12 -12
  50. package/src/modules/bmb/workflows/create-module/README.md +1 -1
  51. package/src/modules/bmb/workflows/create-module/checklist.md +1 -10
  52. package/src/modules/bmb/workflows/create-module/installer-templates/install-config.yaml +1 -1
  53. package/src/modules/bmb/workflows/create-module/instructions.md +12 -17
  54. package/src/modules/bmb/workflows/create-module/module-structure.md +7 -7
  55. package/src/modules/bmb/workflows/create-module/workflow.yaml +9 -9
  56. package/src/modules/bmb/workflows/create-workflow/README.md +4 -4
  57. package/src/modules/bmb/workflows/create-workflow/checklist.md +1 -1
  58. package/src/modules/bmb/workflows/create-workflow/instructions.md +29 -29
  59. package/src/modules/bmb/workflows/create-workflow/workflow-creation-guide.md +40 -42
  60. package/src/modules/bmb/workflows/create-workflow/workflow-template/instructions.md +2 -2
  61. package/src/modules/bmb/workflows/create-workflow/workflow-template/workflow.yaml +12 -12
  62. package/src/modules/bmb/workflows/create-workflow/workflow.yaml +5 -5
  63. package/src/modules/bmb/workflows/edit-agent/checklist.md +1 -1
  64. package/src/modules/bmb/workflows/edit-agent/instructions.md +2 -2
  65. package/src/modules/bmb/workflows/edit-agent/workflow.yaml +8 -8
  66. package/src/modules/bmb/workflows/edit-module/README.md +2 -2
  67. package/src/modules/bmb/workflows/edit-module/checklist.md +2 -2
  68. package/src/modules/bmb/workflows/edit-module/instructions.md +4 -4
  69. package/src/modules/bmb/workflows/edit-module/workflow.yaml +10 -10
  70. package/src/modules/bmb/workflows/edit-workflow/instructions.md +4 -4
  71. package/src/modules/bmb/workflows/edit-workflow/workflow.yaml +5 -5
  72. package/src/modules/bmb/workflows/module-brief/README.md +2 -2
  73. package/src/modules/bmb/workflows/module-brief/checklist.md +2 -2
  74. package/src/modules/bmb/workflows/module-brief/instructions.md +2 -2
  75. package/src/modules/bmb/workflows/module-brief/workflow.yaml +4 -4
  76. package/src/modules/bmb/workflows/redoc/README.md +5 -5
  77. package/src/modules/bmb/workflows/redoc/instructions.md +1 -1
  78. package/src/modules/bmb/workflows/redoc/workflow.yaml +1 -1
  79. package/src/modules/bmgd/README.md +1 -1
  80. package/src/modules/bmgd/_module-installer/install-config.yaml +12 -24
  81. package/src/modules/bmgd/agents/game-architect.agent.yaml +15 -10
  82. package/src/modules/bmgd/agents/game-designer.agent.yaml +16 -11
  83. package/src/modules/bmgd/agents/game-dev.agent.yaml +18 -12
  84. package/src/modules/bmgd/agents/game-scrum-master.agent.yaml +30 -25
  85. package/src/modules/bmgd/teams/default-party.csv +10 -0
  86. package/src/modules/bmgd/teams/team-gamedev.yaml +2 -0
  87. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/instructions.md +1 -1
  88. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/workflow.yaml +9 -9
  89. package/src/modules/bmgd/workflows/1-preproduction/game-brief/instructions.md +1 -1
  90. package/src/modules/bmgd/workflows/1-preproduction/game-brief/workflow.yaml +8 -8
  91. package/src/modules/bmgd/workflows/2-design/gdd/instructions-gdd.md +5 -10
  92. package/src/modules/bmgd/workflows/2-design/gdd/workflow.yaml +30 -30
  93. package/src/modules/bmgd/workflows/2-design/narrative/instructions-narrative.md +1 -6
  94. package/src/modules/bmgd/workflows/2-design/narrative/workflow.yaml +5 -5
  95. package/src/modules/bmgd/workflows/3-technical/game-architecture/architecture-patterns.yaml +0 -26
  96. package/src/modules/bmgd/workflows/3-technical/game-architecture/checklist.md +2 -6
  97. package/src/modules/bmgd/workflows/3-technical/game-architecture/instructions.md +2 -7
  98. package/src/modules/bmgd/workflows/3-technical/game-architecture/workflow.yaml +2 -2
  99. package/src/modules/bmgd/workflows/4-production/code-review/instructions.md +25 -47
  100. package/src/modules/bmgd/workflows/4-production/code-review/workflow.yaml +13 -32
  101. package/src/modules/bmgd/workflows/4-production/correct-course/checklist.md +1 -1
  102. package/src/modules/bmgd/workflows/4-production/correct-course/instructions.md +7 -2
  103. package/src/modules/bmgd/workflows/4-production/correct-course/workflow.yaml +32 -25
  104. package/src/modules/bmgd/workflows/4-production/create-story/instructions.md +20 -47
  105. package/src/modules/bmgd/workflows/4-production/create-story/workflow.yaml +16 -24
  106. package/src/modules/bmgd/workflows/4-production/dev-story/instructions.md +8 -3
  107. package/src/modules/bmgd/workflows/4-production/dev-story/workflow.yaml +30 -5
  108. package/src/modules/bmgd/workflows/4-production/epic-tech-context/checklist.md +1 -1
  109. package/src/modules/bmgd/workflows/4-production/epic-tech-context/instructions.md +10 -35
  110. package/src/modules/bmgd/workflows/4-production/epic-tech-context/workflow.yaml +16 -24
  111. package/src/modules/bmgd/workflows/4-production/retrospective/instructions.md +18 -36
  112. package/src/modules/bmgd/workflows/4-production/retrospective/workflow.yaml +16 -37
  113. package/src/modules/bmgd/workflows/4-production/sprint-planning/instructions.md +11 -15
  114. package/src/modules/bmgd/workflows/4-production/sprint-planning/sprint-status-template.yaml +1 -1
  115. package/src/modules/bmgd/workflows/4-production/sprint-planning/workflow.yaml +8 -7
  116. package/src/modules/bmgd/workflows/4-production/story-context/checklist.md +1 -1
  117. package/src/modules/bmgd/workflows/4-production/story-context/context-template.xml +1 -1
  118. package/src/modules/bmgd/workflows/4-production/story-context/instructions.md +20 -45
  119. package/src/modules/bmgd/workflows/4-production/story-context/workflow.yaml +15 -17
  120. package/src/modules/bmgd/workflows/4-production/story-done/instructions.md +1 -1
  121. package/src/modules/bmgd/workflows/4-production/story-done/workflow.yaml +5 -4
  122. package/src/modules/bmgd/workflows/4-production/story-ready/instructions.md +6 -6
  123. package/src/modules/bmgd/workflows/4-production/story-ready/workflow.yaml +5 -7
  124. package/src/modules/bmm/_module-installer/install-config.yaml +9 -28
  125. package/src/modules/bmm/_module-installer/installer.js +2 -2
  126. package/src/modules/bmm/agents/analyst.agent.yaml +20 -15
  127. package/src/modules/bmm/agents/architect.agent.yaml +17 -12
  128. package/src/modules/bmm/agents/dev.agent.yaml +9 -12
  129. package/src/modules/bmm/agents/pm.agent.yaml +24 -23
  130. package/src/modules/bmm/agents/sm.agent.yaml +24 -19
  131. package/src/modules/bmm/agents/tea.agent.yaml +23 -17
  132. package/src/modules/bmm/agents/tech-writer.agent.yaml +15 -11
  133. package/src/modules/bmm/agents/ux-designer.agent.yaml +16 -11
  134. package/src/modules/bmm/docs/agents-guide.md +4 -4
  135. package/src/modules/bmm/docs/brownfield-guide.md +4 -4
  136. package/src/modules/bmm/docs/enterprise-agentic-development.md +3 -3
  137. package/src/modules/bmm/docs/faq.md +1 -1
  138. package/src/modules/bmm/docs/party-mode.md +3 -3
  139. package/src/modules/bmm/docs/quick-start.md +1 -1
  140. package/src/modules/bmm/docs/test-architecture.md +1 -1
  141. package/src/modules/bmm/docs/workflow-document-project-reference.md +1 -1
  142. package/src/modules/bmm/teams/default-party.csv +19 -0
  143. package/src/modules/bmm/teams/team-fullstack.yaml +1 -0
  144. package/src/modules/bmm/workflows/1-analysis/brainstorm-project/instructions.md +1 -1
  145. package/src/modules/bmm/workflows/1-analysis/brainstorm-project/workflow.yaml +8 -8
  146. package/src/modules/bmm/workflows/1-analysis/domain-research/instructions.md +1 -1
  147. package/src/modules/bmm/workflows/1-analysis/domain-research/workflow.yaml +8 -21
  148. package/src/modules/bmm/workflows/1-analysis/product-brief/instructions.md +10 -12
  149. package/src/modules/bmm/workflows/1-analysis/product-brief/workflow.yaml +13 -9
  150. package/src/modules/bmm/workflows/1-analysis/research/checklist-deep-prompt.md +2 -2
  151. package/src/modules/bmm/workflows/1-analysis/research/checklist-technical.md +2 -2
  152. package/src/modules/bmm/workflows/1-analysis/research/checklist.md +2 -2
  153. package/src/modules/bmm/workflows/1-analysis/research/instructions-deep-prompt.md +1 -3
  154. package/src/modules/bmm/workflows/1-analysis/research/instructions-market.md +2 -7
  155. package/src/modules/bmm/workflows/1-analysis/research/instructions-router.md +1 -1
  156. package/src/modules/bmm/workflows/1-analysis/research/instructions-technical.md +1 -6
  157. package/src/modules/bmm/workflows/1-analysis/research/workflow.yaml +14 -14
  158. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/instructions.md +7 -2
  159. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/workflow.yaml +16 -10
  160. package/src/modules/bmm/workflows/2-plan-workflows/prd/checklist.md +8 -12
  161. package/src/modules/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/epics-template.md +28 -0
  162. package/src/modules/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/instructions.md +146 -23
  163. package/src/modules/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/workflow.yaml +7 -9
  164. package/src/modules/bmm/workflows/2-plan-workflows/prd/instructions.md +152 -35
  165. package/src/modules/bmm/workflows/2-plan-workflows/prd/prd-template.md +2 -2
  166. package/src/modules/bmm/workflows/2-plan-workflows/prd/workflow.yaml +20 -16
  167. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/checklist.md +12 -9
  168. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/epics-template.md +0 -6
  169. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/instructions-generate-stories.md +434 -0
  170. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/instructions.md +129 -266
  171. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/workflow.yaml +15 -37
  172. package/src/modules/bmm/workflows/3-solutioning/architecture/architecture-patterns.yaml +0 -26
  173. package/src/modules/bmm/workflows/3-solutioning/architecture/checklist.md +3 -7
  174. package/src/modules/bmm/workflows/3-solutioning/architecture/instructions.md +30 -38
  175. package/src/modules/bmm/workflows/3-solutioning/architecture/workflow.yaml +25 -43
  176. package/src/modules/bmm/workflows/3-solutioning/solutioning-gate-check/checklist.md +7 -13
  177. package/src/modules/bmm/workflows/3-solutioning/solutioning-gate-check/instructions.md +57 -60
  178. package/src/modules/bmm/workflows/3-solutioning/solutioning-gate-check/workflow.yaml +12 -12
  179. package/src/modules/bmm/workflows/4-implementation/code-review/instructions.md +25 -47
  180. package/src/modules/bmm/workflows/4-implementation/code-review/workflow.yaml +13 -32
  181. package/src/modules/bmm/workflows/4-implementation/correct-course/checklist.md +1 -1
  182. package/src/modules/bmm/workflows/4-implementation/correct-course/instructions.md +7 -2
  183. package/src/modules/bmm/workflows/4-implementation/correct-course/workflow.yaml +32 -25
  184. package/src/modules/bmm/workflows/4-implementation/create-story/instructions.md +20 -47
  185. package/src/modules/bmm/workflows/4-implementation/create-story/workflow.yaml +16 -24
  186. package/src/modules/bmm/workflows/4-implementation/dev-story/instructions.md +8 -3
  187. package/src/modules/bmm/workflows/4-implementation/dev-story/workflow.yaml +30 -5
  188. package/src/modules/bmm/workflows/4-implementation/epic-tech-context/checklist.md +1 -1
  189. package/src/modules/bmm/workflows/4-implementation/epic-tech-context/instructions.md +10 -35
  190. package/src/modules/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml +16 -24
  191. package/src/modules/bmm/workflows/4-implementation/retrospective/instructions.md +18 -36
  192. package/src/modules/bmm/workflows/4-implementation/retrospective/workflow.yaml +16 -37
  193. package/src/modules/bmm/workflows/4-implementation/sprint-planning/instructions.md +11 -15
  194. package/src/modules/bmm/workflows/4-implementation/sprint-planning/sprint-status-template.yaml +1 -1
  195. package/src/modules/bmm/workflows/4-implementation/sprint-planning/workflow.yaml +8 -7
  196. package/src/modules/bmm/workflows/4-implementation/story-context/checklist.md +1 -1
  197. package/src/modules/bmm/workflows/4-implementation/story-context/context-template.xml +1 -1
  198. package/src/modules/bmm/workflows/4-implementation/story-context/instructions.md +20 -45
  199. package/src/modules/bmm/workflows/4-implementation/story-context/workflow.yaml +15 -17
  200. package/src/modules/bmm/workflows/4-implementation/story-done/instructions.md +1 -1
  201. package/src/modules/bmm/workflows/4-implementation/story-done/workflow.yaml +5 -4
  202. package/src/modules/bmm/workflows/4-implementation/story-ready/instructions.md +6 -6
  203. package/src/modules/bmm/workflows/4-implementation/story-ready/workflow.yaml +5 -7
  204. package/src/modules/bmm/workflows/document-project/checklist.md +1 -1
  205. package/src/modules/bmm/workflows/document-project/instructions.md +5 -5
  206. package/src/modules/bmm/workflows/document-project/workflow.yaml +2 -2
  207. package/src/modules/bmm/workflows/document-project/workflows/deep-dive-instructions.md +4 -4
  208. package/src/modules/bmm/workflows/document-project/workflows/deep-dive.yaml +5 -5
  209. package/src/modules/bmm/workflows/document-project/workflows/full-scan-instructions.md +13 -13
  210. package/src/modules/bmm/workflows/document-project/workflows/full-scan.yaml +5 -5
  211. package/src/modules/bmm/workflows/testarch/atdd/instructions.md +2 -2
  212. package/src/modules/bmm/workflows/testarch/atdd/workflow.yaml +2 -2
  213. package/src/modules/bmm/workflows/testarch/automate/instructions.md +2 -2
  214. package/src/modules/bmm/workflows/testarch/automate/workflow.yaml +2 -2
  215. package/src/modules/bmm/workflows/testarch/ci/checklist.md +4 -4
  216. package/src/modules/bmm/workflows/testarch/ci/instructions.md +2 -2
  217. package/src/modules/bmm/workflows/testarch/ci/workflow.yaml +2 -2
  218. package/src/modules/bmm/workflows/testarch/framework/checklist.md +4 -4
  219. package/src/modules/bmm/workflows/testarch/framework/instructions.md +2 -2
  220. package/src/modules/bmm/workflows/testarch/framework/workflow.yaml +2 -2
  221. package/src/modules/bmm/workflows/testarch/nfr-assess/instructions.md +1 -1
  222. package/src/modules/bmm/workflows/testarch/nfr-assess/workflow.yaml +2 -2
  223. package/src/modules/bmm/workflows/testarch/test-design/checklist.md +4 -4
  224. package/src/modules/bmm/workflows/testarch/test-design/instructions.md +175 -14
  225. package/src/modules/bmm/workflows/testarch/test-design/test-design-template.md +4 -4
  226. package/src/modules/bmm/workflows/testarch/test-design/workflow.yaml +7 -3
  227. package/src/modules/bmm/workflows/testarch/test-review/instructions.md +1 -1
  228. package/src/modules/bmm/workflows/testarch/test-review/workflow.yaml +2 -2
  229. package/src/modules/bmm/workflows/testarch/trace/instructions.md +9 -9
  230. package/src/modules/bmm/workflows/testarch/trace/workflow.yaml +2 -2
  231. package/src/modules/bmm/workflows/workflow-status/init/instructions.md +33 -31
  232. package/src/modules/bmm/workflows/workflow-status/init/workflow.yaml +5 -4
  233. package/src/modules/bmm/workflows/workflow-status/instructions.md +5 -4
  234. package/src/modules/bmm/workflows/workflow-status/paths/enterprise-brownfield.yaml +9 -16
  235. package/src/modules/bmm/workflows/workflow-status/paths/enterprise-greenfield.yaml +11 -18
  236. package/src/modules/bmm/workflows/workflow-status/paths/method-brownfield.yaml +8 -1
  237. package/src/modules/bmm/workflows/workflow-status/paths/method-greenfield.yaml +9 -2
  238. package/src/modules/bmm/workflows/workflow-status/project-levels.yaml +1 -1
  239. package/src/modules/bmm/workflows/workflow-status/workflow-status-template.yaml +2 -9
  240. package/src/modules/bmm/workflows/workflow-status/workflow.yaml +2 -2
  241. package/src/modules/cis/README.md +1 -1
  242. package/src/modules/cis/_module-installer/install-config.yaml +6 -4
  243. package/src/modules/cis/agents/README.md +1 -1
  244. package/src/modules/cis/agents/brainstorming-coach.agent.yaml +13 -8
  245. package/src/modules/cis/agents/creative-problem-solver.agent.yaml +13 -8
  246. package/src/modules/cis/agents/design-thinking-coach.agent.yaml +13 -8
  247. package/src/modules/cis/agents/innovation-strategist.agent.yaml +13 -8
  248. package/src/modules/cis/agents/storyteller.agent.yaml +13 -8
  249. package/src/modules/cis/teams/creative-squad.yaml +1 -0
  250. package/src/modules/cis/teams/default-party.csv +11 -0
  251. package/src/modules/cis/workflows/README.md +1 -1
  252. package/src/modules/cis/workflows/design-thinking/instructions.md +2 -2
  253. package/src/modules/cis/workflows/design-thinking/workflow.yaml +7 -7
  254. package/src/modules/cis/workflows/innovation-strategy/instructions.md +2 -2
  255. package/src/modules/cis/workflows/innovation-strategy/workflow.yaml +7 -7
  256. package/src/modules/cis/workflows/problem-solving/instructions.md +2 -2
  257. package/src/modules/cis/workflows/problem-solving/workflow.yaml +7 -7
  258. package/src/modules/cis/workflows/storytelling/instructions.md +2 -2
  259. package/src/modules/cis/workflows/storytelling/workflow.yaml +7 -7
  260. package/src/utility/models/action-command-header.md +0 -0
  261. package/src/utility/models/agent-activation-ide.xml +3 -3
  262. package/src/utility/models/agent-activation-web.xml +4 -4
  263. package/src/utility/models/agent-command-header.md +1 -0
  264. package/src/utility/models/fragments/activation-steps.xml +3 -2
  265. package/src/utility/models/fragments/handler-validate-workflow.xml +1 -1
  266. package/src/utility/models/fragments/handler-workflow.xml +1 -1
  267. package/src/utility/models/fragments/web-bundle-activation-steps.xml +3 -3
  268. package/tools/cli/README.md +50 -32
  269. package/tools/cli/bundlers/web-bundler.js +86 -17
  270. package/tools/cli/commands/install.js +1 -4
  271. package/tools/cli/installers/lib/core/config-collector.js +201 -28
  272. package/tools/cli/installers/lib/core/detector.js +62 -7
  273. package/tools/cli/installers/lib/core/installer.js +175 -33
  274. package/tools/cli/installers/lib/core/manifest-generator.js +26 -115
  275. package/tools/cli/installers/lib/ide/_base-ide.js +57 -3
  276. package/tools/cli/installers/lib/ide/auggie.js +78 -224
  277. package/tools/cli/installers/lib/ide/claude-code.js +14 -22
  278. package/tools/cli/installers/lib/ide/cline.js +15 -18
  279. package/tools/cli/installers/lib/ide/codex.js +17 -48
  280. package/tools/cli/installers/lib/ide/crush.js +14 -50
  281. package/tools/cli/installers/lib/ide/cursor.js +51 -8
  282. package/tools/cli/installers/lib/ide/gemini.js +87 -37
  283. package/tools/cli/installers/lib/ide/github-copilot.js +47 -35
  284. package/tools/cli/installers/lib/ide/iflow.js +13 -30
  285. package/tools/cli/installers/lib/ide/kilo.js +20 -16
  286. package/tools/cli/installers/lib/ide/manager.js +15 -0
  287. package/tools/cli/installers/lib/ide/opencode.js +16 -17
  288. package/tools/cli/installers/lib/ide/qwen.js +39 -11
  289. package/tools/cli/installers/lib/ide/roo.js +27 -62
  290. package/tools/cli/installers/lib/ide/shared/agent-command-generator.js +90 -0
  291. package/tools/cli/installers/lib/ide/{task-tool-command-generator.js → shared/task-tool-command-generator.js} +1 -1
  292. package/tools/cli/installers/lib/ide/{workflow-command-generator.js → shared/workflow-command-generator.js} +11 -9
  293. package/tools/cli/installers/lib/ide/templates/agent-command-template.md +14 -0
  294. package/tools/cli/installers/lib/ide/templates/gemini-agent-command.toml +14 -0
  295. package/tools/cli/installers/lib/ide/templates/gemini-task-command.toml +12 -0
  296. package/tools/cli/installers/lib/ide/{workflow-command-template.md → templates/workflow-command-template.md} +3 -5
  297. package/tools/cli/installers/lib/ide/trae.js +20 -32
  298. package/tools/cli/installers/lib/ide/windsurf.js +18 -8
  299. package/tools/cli/installers/lib/modules/manager.js +89 -17
  300. package/tools/cli/lib/cli-utils.js +52 -50
  301. package/tools/cli/lib/ui.js +29 -12
  302. package/tools/cli/lib/yaml-xml-builder.js +20 -2
  303. package/tools/schema/agent.js +7 -3
  304. package/.claude/commands/bmad/bmb/agents/bmad-builder.md +0 -70
  305. package/.claude/commands/bmad/bmb/workflows/audit-workflow.md +0 -15
  306. package/.claude/commands/bmad/bmb/workflows/convert-legacy.md +0 -15
  307. package/.claude/commands/bmad/bmb/workflows/create-agent.md +0 -15
  308. package/.claude/commands/bmad/bmb/workflows/create-module.md +0 -15
  309. package/.claude/commands/bmad/bmb/workflows/create-workflow.md +0 -15
  310. package/.claude/commands/bmad/bmb/workflows/edit-agent.md +0 -15
  311. package/.claude/commands/bmad/bmb/workflows/edit-module.md +0 -15
  312. package/.claude/commands/bmad/bmb/workflows/edit-workflow.md +0 -15
  313. package/.claude/commands/bmad/bmb/workflows/module-brief.md +0 -15
  314. package/.claude/commands/bmad/bmb/workflows/redoc.md +0 -15
  315. package/.claude/commands/bmad/core/agents/bmad-master.md +0 -71
  316. package/.claude/commands/bmad/core/tasks/index-docs.md +0 -9
  317. package/.claude/commands/bmad/core/tools/shard-doc.md +0 -9
  318. package/.claude/commands/bmad/core/workflows/brainstorming.md +0 -15
  319. package/.claude/commands/bmad/core/workflows/party-mode.md +0 -15
  320. package/.claude/settings.local.json +0 -22
  321. package/bmad/_cfg/agent-manifest.csv +0 -5
  322. package/bmad/_cfg/agents/bmb-bmad-builder.customize.yaml +0 -42
  323. package/bmad/_cfg/agents/core-bmad-master.customize.yaml +0 -42
  324. package/bmad/_cfg/files-manifest.csv +0 -82
  325. package/bmad/_cfg/ides/claude-code.yaml +0 -6
  326. package/bmad/_cfg/manifest.yaml +0 -11
  327. package/bmad/_cfg/task-manifest.csv +0 -13
  328. package/bmad/_cfg/tool-manifest.csv +0 -4
  329. package/bmad/_cfg/workflow-manifest.csv +0 -17
  330. package/bmad/bmb/README.md +0 -194
  331. package/bmad/bmb/agents/bmad-builder.md +0 -70
  332. package/bmad/bmb/config.yaml +0 -14
  333. package/bmad/bmb/workflows/audit-workflow/checklist.md +0 -143
  334. package/bmad/bmb/workflows/audit-workflow/instructions.md +0 -341
  335. package/bmad/bmb/workflows/audit-workflow/template.md +0 -118
  336. package/bmad/bmb/workflows/audit-workflow/workflow.yaml +0 -23
  337. package/bmad/bmb/workflows/convert-legacy/README.md +0 -262
  338. package/bmad/bmb/workflows/convert-legacy/checklist.md +0 -205
  339. package/bmad/bmb/workflows/convert-legacy/instructions.md +0 -377
  340. package/bmad/bmb/workflows/convert-legacy/workflow.yaml +0 -32
  341. package/bmad/bmb/workflows/create-agent/README.md +0 -203
  342. package/bmad/bmb/workflows/create-agent/agent-architecture.md +0 -419
  343. package/bmad/bmb/workflows/create-agent/agent-command-patterns.md +0 -759
  344. package/bmad/bmb/workflows/create-agent/agent-types.md +0 -292
  345. package/bmad/bmb/workflows/create-agent/brainstorm-context.md +0 -174
  346. package/bmad/bmb/workflows/create-agent/checklist.md +0 -62
  347. package/bmad/bmb/workflows/create-agent/communication-styles.md +0 -202
  348. package/bmad/bmb/workflows/create-agent/instructions.md +0 -459
  349. package/bmad/bmb/workflows/create-agent/workflow.yaml +0 -37
  350. package/bmad/bmb/workflows/create-module/README.md +0 -229
  351. package/bmad/bmb/workflows/create-module/brainstorm-context.md +0 -137
  352. package/bmad/bmb/workflows/create-module/checklist.md +0 -244
  353. package/bmad/bmb/workflows/create-module/installer-templates/install-config.yaml +0 -92
  354. package/bmad/bmb/workflows/create-module/installer-templates/installer.js +0 -231
  355. package/bmad/bmb/workflows/create-module/instructions.md +0 -581
  356. package/bmad/bmb/workflows/create-module/module-structure.md +0 -400
  357. package/bmad/bmb/workflows/create-module/workflow.yaml +0 -42
  358. package/bmad/bmb/workflows/create-workflow/README.md +0 -277
  359. package/bmad/bmb/workflows/create-workflow/brainstorm-context.md +0 -197
  360. package/bmad/bmb/workflows/create-workflow/checklist.md +0 -94
  361. package/bmad/bmb/workflows/create-workflow/instructions.md +0 -724
  362. package/bmad/bmb/workflows/create-workflow/workflow-creation-guide.md +0 -1308
  363. package/bmad/bmb/workflows/create-workflow/workflow-template/checklist.md +0 -24
  364. package/bmad/bmb/workflows/create-workflow/workflow-template/instructions.md +0 -13
  365. package/bmad/bmb/workflows/create-workflow/workflow-template/template.md +0 -9
  366. package/bmad/bmb/workflows/create-workflow/workflow-template/workflow.yaml +0 -39
  367. package/bmad/bmb/workflows/create-workflow/workflow.yaml +0 -40
  368. package/bmad/bmb/workflows/edit-agent/README.md +0 -112
  369. package/bmad/bmb/workflows/edit-agent/checklist.md +0 -112
  370. package/bmad/bmb/workflows/edit-agent/instructions.md +0 -290
  371. package/bmad/bmb/workflows/edit-agent/workflow.yaml +0 -33
  372. package/bmad/bmb/workflows/edit-module/README.md +0 -187
  373. package/bmad/bmb/workflows/edit-module/checklist.md +0 -165
  374. package/bmad/bmb/workflows/edit-module/instructions.md +0 -339
  375. package/bmad/bmb/workflows/edit-module/workflow.yaml +0 -34
  376. package/bmad/bmb/workflows/edit-workflow/README.md +0 -119
  377. package/bmad/bmb/workflows/edit-workflow/checklist.md +0 -70
  378. package/bmad/bmb/workflows/edit-workflow/instructions.md +0 -342
  379. package/bmad/bmb/workflows/edit-workflow/workflow.yaml +0 -27
  380. package/bmad/bmb/workflows/module-brief/README.md +0 -264
  381. package/bmad/bmb/workflows/module-brief/checklist.md +0 -116
  382. package/bmad/bmb/workflows/module-brief/instructions.md +0 -267
  383. package/bmad/bmb/workflows/module-brief/template.md +0 -275
  384. package/bmad/bmb/workflows/module-brief/workflow.yaml +0 -29
  385. package/bmad/bmb/workflows/redoc/README.md +0 -87
  386. package/bmad/bmb/workflows/redoc/checklist.md +0 -99
  387. package/bmad/bmb/workflows/redoc/instructions.md +0 -265
  388. package/bmad/bmb/workflows/redoc/workflow.yaml +0 -32
  389. package/bmad/core/agents/bmad-master.md +0 -71
  390. package/bmad/core/agents/bmad-web-orchestrator.agent.xml +0 -122
  391. package/bmad/core/config.yaml +0 -9
  392. package/bmad/core/tasks/adv-elicit-methods.csv +0 -39
  393. package/bmad/core/tasks/adv-elicit.xml +0 -104
  394. package/bmad/core/tasks/index-docs.xml +0 -65
  395. package/bmad/core/tasks/validate-workflow.xml +0 -89
  396. package/bmad/core/tasks/workflow.xml +0 -156
  397. package/bmad/core/tools/shard-doc.xml +0 -65
  398. package/bmad/core/workflows/brainstorming/README.md +0 -271
  399. package/bmad/core/workflows/brainstorming/brain-methods.csv +0 -36
  400. package/bmad/core/workflows/brainstorming/instructions.md +0 -314
  401. package/bmad/core/workflows/brainstorming/template.md +0 -102
  402. package/bmad/core/workflows/brainstorming/workflow.yaml +0 -43
  403. package/bmad/core/workflows/party-mode/instructions.md +0 -188
  404. package/bmad/core/workflows/party-mode/workflow.yaml +0 -23
  405. package/bmad/docs/claude-code-instructions.md +0 -25
  406. package/bmd/README.md +0 -193
  407. package/bmd/agents/cli-chief-sidecar/instructions.md +0 -102
  408. package/bmd/agents/cli-chief-sidecar/knowledge/README.md +0 -68
  409. package/bmd/agents/cli-chief-sidecar/knowledge/cli-reference.md +0 -123
  410. package/bmd/agents/cli-chief-sidecar/memories.md +0 -53
  411. package/bmd/agents/cli-chief.agent.yaml +0 -126
  412. package/bmd/agents/doc-keeper-sidecar/instructions.md +0 -177
  413. package/bmd/agents/doc-keeper-sidecar/knowledge/README.md +0 -81
  414. package/bmd/agents/doc-keeper-sidecar/memories.md +0 -88
  415. package/bmd/agents/doc-keeper.agent.yaml +0 -137
  416. package/bmd/agents/release-chief-sidecar/instructions.md +0 -164
  417. package/bmd/agents/release-chief-sidecar/knowledge/README.md +0 -82
  418. package/bmd/agents/release-chief-sidecar/memories.md +0 -73
  419. package/bmd/agents/release-chief.agent.yaml +0 -127
  420. package/bmd/bmad-custom-module-installer-plan.md +0 -1176
  421. package/bmd/config.yaml +0 -12
  422. package/src/modules/bmgd/workflows/4-production/dev-story/AUDIT-REPORT.md +0 -367
  423. package/src/modules/bmm/sub-modules/claude-code/README.md +0 -87
  424. package/src/modules/bmm/sub-modules/claude-code/config.yaml +0 -5
  425. package/src/modules/bmm/sub-modules/claude-code/injections.yaml +0 -242
  426. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-analysis/api-documenter.md +0 -102
  427. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-analysis/codebase-analyzer.md +0 -82
  428. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-analysis/data-analyst.md +0 -101
  429. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-analysis/pattern-detector.md +0 -84
  430. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-planning/dependency-mapper.md +0 -83
  431. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-planning/epic-optimizer.md +0 -81
  432. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-planning/requirements-analyst.md +0 -61
  433. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-planning/technical-decisions-curator.md +0 -168
  434. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-planning/trend-spotter.md +0 -115
  435. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-planning/user-journey-mapper.md +0 -123
  436. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-planning/user-researcher.md +0 -72
  437. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-research/market-researcher.md +0 -51
  438. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-research/tech-debt-auditor.md +0 -106
  439. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-review/document-reviewer.md +0 -102
  440. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-review/technical-evaluator.md +0 -68
  441. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-review/test-coverage-analyzer.md +0 -108
  442. package/src/modules/bmm/tasks/daily-standup.xml +0 -85
  443. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/instructions-level0-story.md +0 -200
  444. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/instructions-level1-stories.md +0 -451
  445. package/src/modules/bmm/workflows/3-solutioning/solutioning-gate-check/validation-criteria.yaml +0 -189
  446. package/src/modules/bmm/workflows/4-implementation/dev-story/AUDIT-REPORT.md +0 -367
  447. package/src/modules/bmm/workflows/workflow-status/sample-level-3-workflow.yaml +0 -49
  448. package/test/fixtures/agent-schema/invalid/persona/principles-as-string.agent.yaml +0 -23
  449. package/web-bundles/bmm/agents/analyst.xml +0 -5028
  450. package/web-bundles/bmm/agents/architect.xml +0 -2047
  451. package/web-bundles/bmm/agents/dev.xml +0 -68
  452. package/web-bundles/bmm/agents/pm.xml +0 -3808
  453. package/web-bundles/bmm/agents/sm.xml +0 -77
  454. package/web-bundles/bmm/agents/tea.xml +0 -66
  455. package/web-bundles/bmm/agents/tech-writer.xml +0 -84
  456. package/web-bundles/bmm/agents/ux-designer.xml +0 -2018
  457. package/web-bundles/bmm/teams/team-fullstack.xml +0 -12039
@@ -0,0 +1,473 @@
1
+ # Using BMad Web Bundles in Gemini Gems & Custom GPTs
2
+
3
+ Web bundles package BMad agents as self-contained XML files that work in Gemini Gems and Custom GPTs. Everything the agent needs - instructions, workflows, dependencies - is bundled into a single file.
4
+
5
+ ## What Are Web Bundles?
6
+
7
+ Web bundles are standalone XML files containing:
8
+
9
+ - Complete agent persona and instructions
10
+ - All workflows and dependencies
11
+ - Interactive menu system
12
+ - Party mode for multi-agent collaboration
13
+ - No external files required
14
+
15
+ **Perfect for:** Uploading a single file to a Gemini GEM or Custom GPT to use BMad Method from the Web, generally at a huge cost savings, at the expense of some quality and convenience of using locally.
16
+
17
+ ## Critical Setup Rules
18
+
19
+ **READ THIS FIRST - Following these rules ensures BMad works correctly in Gemini/GPT:**
20
+
21
+ 1. **ONE file per Gem/GPT** - Upload exactly ONE XML file per Gemini Gem or Custom GPT instance. Do NOT combine multiple agent files.
22
+
23
+ 2. **Use the setup instructions** - When creating your Gem/GPT, you MUST add the configuration prompt (shown in Quick Start below) so it knows how to read the XML file.
24
+
25
+ 3. **Enable Canvas/Code Execution** - This is ESSENTIAL for document generation workflows (PRD, Architecture, etc.). Enable this in your Gem/GPT settings.
26
+
27
+ 4. **Gemini Gems are strongly preferred** - They work significantly better than Custom GPTs for BMad workflows.
28
+
29
+ 5. **Team bundles = Gemini 2.5 Pro+ only** - Team bundles (multiple agents) have terrible performance in Custom GPTs due to context limits. Only use them with Gemini 2.5 Pro or higher.
30
+
31
+ 6. **Create separate Gems for each agent** - Make a PM Gem, an Architect Gem, a Developer Gem, etc. Don't try to combine them (except via official team bundles).
32
+
33
+ ## Quick Start
34
+
35
+ ### 1. Get Web Bundle Files
36
+
37
+ **Option A: Download Pre-Bundled Files (Quickest)**
38
+
39
+ Download ready-to-use bundles directly from GitHub:
40
+
41
+ **[→ Browse Web Bundles on GitHub](https://github.com/bmad-code-org/BMAD-METHOD/tree/main/web-bundles)**
42
+
43
+ Navigate to the module folder (bmm, bmb, cis, bmgd) → agents folder → download the `.xml` file you need.
44
+
45
+ **Option B: Generate from Local Installation**
46
+
47
+ From your BMad project directory:
48
+
49
+ ```bash
50
+ # Generate all agent bundles
51
+ npm run bundle
52
+
53
+ # Or generate specific bundles
54
+ node tools/cli/bundlers/bundle-web.js module bmm
55
+ node tools/cli/bundlers/bundle-web.js agent bmm dev
56
+ ```
57
+
58
+ **Output location:** `web-bundles/` directory
59
+
60
+ ```
61
+ web-bundles/
62
+ ├── bmm/
63
+ │ ├── agents/ # Individual agents
64
+ │ └── teams/ # Multi-agent teams
65
+ ├── bmb/
66
+ ├── cis/
67
+ └── bmgd/
68
+ ```
69
+
70
+ ### 2. Upload to Gemini Gems (Recommended)
71
+
72
+ **IMPORTANT: Create ONE Gem per agent file. Do NOT upload multiple agent files to a single Gem.**
73
+
74
+ **Create a Gem:**
75
+
76
+ 1. Go to [Google AI Studio](https://aistudio.google.com/)
77
+ 2. Click "New Gem" or "Create Gem"
78
+ 3. Give your Gem a name (e.g., "BMad PM Agent")
79
+ 4. **Enable "Code execution" for best results with document generation**
80
+ 5. In the **System Instructions** field, add this EXACT text (customize the config values):
81
+
82
+ ```
83
+ All of your operating instructions and resources are contained in the XML file attached. Read in the initial agent block and instructions to understand it. You will not deviate from the character and rules outlined in the attached!
84
+
85
+ CONFIG.YAML Values:
86
+ - user_name: [Your Name]
87
+ - communication_language: English
88
+ - user_skill_level: [Beginner|Intermediate|Expert]
89
+ - document_output_language: English
90
+ - bmm-workflow-status: standalone (no workflow)
91
+ ```
92
+
93
+ 6. **Upload ONE XML file** (e.g., `pm.xml`) - either attach as a file or paste contents
94
+ 7. Save and test your Gem by typing `*help` to see the menu
95
+
96
+ **Tips for Gemini:**
97
+
98
+ - **Enable Code Execution/Canvas** - Critical for document output (PRDs, architecture docs, etc.)
99
+ - **Use Gemini 2.5 Pro+** for best results, especially for complex workflows
100
+ - **One agent per Gem** - Create separate Gems for PM, Architect, Developer, etc.
101
+ - Test the agent by triggering menu items with `*workflow-name`
102
+
103
+ ### 3. Upload to Custom GPTs
104
+
105
+ **IMPORTANT: Create ONE Custom GPT per agent file. Do NOT upload multiple agent files to a single GPT.**
106
+
107
+ **Create a Custom GPT:**
108
+
109
+ 1. Go to [ChatGPT](https://chat.openai.com/)
110
+ 2. Click your profile → "My GPTs" → "Create a GPT"
111
+ 3. Configure your GPT:
112
+ - **Name:** BMad PM Agent (or your choice)
113
+ - **Description:** AI planning agent powered by BMad Method
114
+ 4. In the **Instructions** field, add this EXACT text at the top (customize the config values):
115
+
116
+ ```
117
+ All of your operating instructions and resources are contained in the XML file attached. Read in the initial agent block and instructions to understand it. You will not deviate from the character and rules outlined in the attached!
118
+
119
+ CONFIG.YAML Values:
120
+ - user_name: [Your Name]
121
+ - communication_language: English
122
+ - user_skill_level: [Beginner|Intermediate|Expert]
123
+ - document_output_language: English
124
+ - bmm-workflow-status: standalone (no workflow)
125
+ ```
126
+
127
+ 5. **Below that text**, paste the entire contents of ONE XML file (e.g., `pm.xml`)
128
+ 6. **Enable "Canvas" in ChatGPT settings** for better document output
129
+ 7. Save and test by typing `*help`
130
+
131
+ **Tips for Custom GPTs:**
132
+
133
+ - **Enable Canvas** - Essential for workflow document generation
134
+ - **One agent per GPT** - Create separate GPTs for each agent
135
+ - Custom GPTs have smaller context windows than Gemini - avoid team bundles
136
+ - Works best with focused agents (PM, Analyst, Architect)
137
+
138
+ ## Available Web Bundles
139
+
140
+ After running `npm run bundle`, you'll have access to:
141
+
142
+ ### BMad Method (BMM) Agents
143
+
144
+ - **analyst.xml** - Business analysis and requirements gathering
145
+ - **architect.xml** - System architecture and technical design
146
+ - **dev.xml** - Full-stack development and implementation
147
+ - **pm.xml** - Product management and planning
148
+ - **sm.xml** - Scrum master and agile facilitation
149
+ - **tea.xml** - Test architecture and quality assurance
150
+ - **tech-writer.xml** - Technical documentation
151
+ - **ux-designer.xml** - User experience design
152
+ - **game-designer.xml** - Game design and mechanics
153
+ - **game-dev.xml** - Game development
154
+ - **game-architect.xml** - Game architecture
155
+
156
+ ### BMad Builder (BMB) Agent
157
+
158
+ - **bmad-builder.xml** - Create custom agents, workflows, and modules
159
+
160
+ ### Creative Intelligence Suite (CIS) Agents
161
+
162
+ - **brainstorming-coach.xml** - Creative brainstorming facilitation
163
+ - **design-thinking-coach.xml** - Human-centered problem solving
164
+ - **innovation-strategist.xml** - Innovation and strategy
165
+ - **creative-problem-solver.xml** - Breakthrough problem solving
166
+ - **storyteller.xml** - Narrative and storytelling
167
+
168
+ ### Team Bundles (Multi-Agent Collaboration)
169
+
170
+ **CRITICAL: Team bundles are ONLY recommended for Gemini 2.5 Pro+ in the web. The experience is poor with Custom GPTs due to limited context windows.**
171
+
172
+ - **bmm/teams/team-fullstack.xml** - Full BMad Method development team
173
+ - **bmgd/teams/team-gamedev.xml** - Game development team
174
+ - **cis/teams/creative-squad.xml** - Creative Intelligence team
175
+
176
+ **When to use team bundles:**
177
+
178
+ - You want multiple agents collaborating in one Gem
179
+ - You're using Gemini 2.5 Pro+ (required)
180
+ - You need diverse perspectives on complex problems
181
+
182
+ **When to use individual agents instead:**
183
+
184
+ - Using Custom GPTs (always use individual agents)
185
+ - Want focused expertise from a single agent
186
+ - Need faster, more streamlined interactions
187
+
188
+ ## Recommended Workflow: Web Planning → Local Implementation
189
+
190
+ **Save significant costs** by doing planning phases in web bundles, then switching to local IDE for implementation.
191
+
192
+ ### Cost-Saving Strategy
193
+
194
+ **Phase 1-3: Do in Web (Major Cost Savings)**
195
+
196
+ Use Gemini Gems or Custom GPTs for these workflows:
197
+
198
+ 1. **Analysis Phase** (Analyst, PM)
199
+ - `*brainstorm-project` - Brainstorm ideas and features
200
+ - `*research` - Market and technical research
201
+ - `*product-brief` - Create product vision
202
+
203
+ 2. **Planning Phase** (PM)
204
+ - `*prd` - Generate comprehensive Product Requirements Document
205
+ - `*create-epics-and-stories` - Break down into development stories
206
+
207
+ 3. **Solutioning Phase** (Architect, UX Designer)
208
+ - `*architecture` - Define technical architecture
209
+ - `*create-ux-design` - Design user experience
210
+
211
+ **Export Artifacts:**
212
+ After each workflow, copy/download the generated documents (PRD, Architecture, UX Design, etc.)
213
+
214
+ **Phase 4: Switch to Local IDE (Required for Implementation)**
215
+
216
+ 1. Save exported artifacts to your project's `docs/` folder
217
+ 2. Run local BMad installation with `*workflow-init`
218
+ 3. BMad will detect the existing artifacts and update workflow status
219
+ 4. Proceed with implementation using Developer agent locally
220
+
221
+ **Why this works:**
222
+
223
+ - **Planning workflows** are token-heavy but don't need code context
224
+ - **Web models (Gemini/GPT)** handle planning excellently at lower cost
225
+ - **Local IDE implementation** needs full codebase access and tools
226
+ - **Best of both worlds**: Cost savings + full implementation capabilities
227
+
228
+ **Typical savings:** 60-80% cost reduction by doing analysis, planning, and architecture in web before moving to local implementation.
229
+
230
+ ## Using Web Bundles
231
+
232
+ ### Basic Usage
233
+
234
+ **1. Load the Agent**
235
+
236
+ Upload or paste the XML file into Gemini/GPT. The agent will introduce itself and show its menu.
237
+
238
+ **2. Choose a Workflow**
239
+
240
+ Use natural language or shortcuts:
241
+
242
+ ```
243
+ "Run the PRD workflow"
244
+ *prd
245
+
246
+ "Start brainstorming"
247
+ *brainstorm-project
248
+
249
+ "Show me the menu"
250
+ *help
251
+ ```
252
+
253
+ **3. Follow the Workflow**
254
+
255
+ The agent guides you through the workflow step-by-step, asking questions and creating deliverables.
256
+
257
+ ### Advanced Features
258
+
259
+ **Party Mode**
260
+
261
+ All web bundles include party mode for multi-agent collaboration:
262
+
263
+ ```
264
+ *party
265
+ ```
266
+
267
+ This activates multiple agents who collaborate on your task, providing diverse perspectives.
268
+
269
+ **Context Loading**
270
+
271
+ Some workflows load additional context:
272
+
273
+ ```
274
+ *workflow-init # Initialize project workflow
275
+ *document-project # Analyze existing codebase
276
+ ```
277
+
278
+ **Dynamic Menus**
279
+
280
+ Agents adapt their menus based on project phase and available workflows.
281
+
282
+ ## Platform Differences
283
+
284
+ ### Gemini Gems (Strongly Recommended)
285
+
286
+ **Pros:**
287
+
288
+ - Better XML parsing and handling
289
+ - Handles large bundles well
290
+ - Supports complex workflows
291
+ - Larger context window (better for team bundles)
292
+ - Code execution for document generation
293
+ - Works excellently with BMad workflows
294
+
295
+ **Cons:**
296
+
297
+ - Requires Google account
298
+ - May have rate limits on free tier
299
+
300
+ **Best for:**
301
+
302
+ - All individual agents (PM, Architect, Developer, UX Designer, etc.)
303
+ - Team bundles (requires Gemini 2.5 Pro+)
304
+ - Complex multi-step workflows
305
+ - Document-heavy workflows (PRD, Architecture)
306
+
307
+ **Recommended Model:** Gemini 2.5 Pro or higher
308
+
309
+ ### Custom GPTs
310
+
311
+ **Pros:**
312
+
313
+ - Familiar ChatGPT interface
314
+ - Good for conversational workflows
315
+ - Easy sharing with team via link
316
+
317
+ **Cons:**
318
+
319
+ - Smaller context window than Gemini
320
+ - Character limit on instructions (large bundles may not fit)
321
+ - **NOT recommended for team bundles**
322
+ - Canvas feature less mature than Gemini's code execution
323
+
324
+ **Best for:**
325
+
326
+ - Individual focused agents (PM, Analyst, Architect)
327
+ - Creative agents (CIS)
328
+ - Simpler workflows (product-brief, brainstorm-project)
329
+ - Quick prototyping
330
+
331
+ **NOT recommended for:** Team bundles, Developer agent, complex technical workflows
332
+
333
+ ## Customization
334
+
335
+ **Before Bundling:**
336
+
337
+ Customize agents using the [Agent Customization Guide](./agent-customization-guide.md):
338
+
339
+ 1. Edit `{bmad_folder}/_cfg/agents/<agent>.customize.yaml`
340
+ 2. Rebuild: `npx bmad-method build <agent-name>`
341
+ 3. Generate bundles: `npm run bundle`
342
+
343
+ Your customizations will be included in the web bundles.
344
+
345
+ **After Bundling:**
346
+
347
+ You can manually edit the XML to:
348
+
349
+ - Change agent name (search for `<name>`)
350
+ - Modify persona (search for `<persona>`)
351
+ - Add custom instructions (in `<critical>` blocks)
352
+
353
+ ## Troubleshooting
354
+
355
+ **Agent not responding correctly?**
356
+
357
+ - Check that the entire XML file was uploaded
358
+ - Verify no truncation occurred (Gemini/GPT have character limits)
359
+ - Try a simpler agent first (analyst, pm)
360
+
361
+ **Menu items not working?**
362
+
363
+ - Use the `*` prefix for shortcuts: `*prd` not `prd`
364
+ - Or use natural language: "Run the PRD workflow"
365
+ - Check the agent's menu with `*help`
366
+
367
+ **Workflows failing?**
368
+
369
+ - Some workflows expect project files (not available in web context)
370
+ - Use workflows designed for planning/analysis in web bundles
371
+ - For implementation workflows, use local IDE installation
372
+
373
+ **File too large for GPT?**
374
+
375
+ - Split into sections and use multiple GPTs
376
+ - Use Gemini Gems instead (better for large files)
377
+ - Generate single-agent bundles instead of team bundles
378
+
379
+ ## Best Practices
380
+
381
+ 1. **One File Per Gem/GPT** - Always upload only ONE XML file per Gemini Gem or Custom GPT instance
382
+ 2. **Prefer Gemini Over GPT** - Gemini Gems work significantly better with BMad bundles
383
+ 3. **Enable Canvas/Code Execution** - Essential for document generation workflows (PRD, Architecture, etc.)
384
+ 4. **Create Separate Gems for Each Agent** - Don't try to combine agents except via team bundles
385
+ 5. **Team Bundles = Gemini 2.5 Pro+ Only** - Never use team bundles with Custom GPTs
386
+ 6. **Use for Planning Phases** - Web bundles excel at analysis, planning, and architecture (Phases 1-3)
387
+ 7. **Switch to Local for Implementation** - Use local IDE installation for Phase 4 development
388
+ 8. **Export and Save Artifacts** - Copy generated documents to your project's `docs/` folder
389
+ 9. **Run workflow-init Locally** - After importing web artifacts, initialize local workflow status
390
+ 10. **Keep Updated** - Rebuild bundles after BMad updates to get latest improvements
391
+
392
+ ## Examples
393
+
394
+ ### Example 1: Complete Web → Local Workflow (Recommended)
395
+
396
+ **Goal:** Build a new SaaS product with maximum cost savings
397
+
398
+ **Phase 1-3: Web Planning (Gemini Gems)**
399
+
400
+ 1. **Download bundles:**
401
+ - `bmm/agents/analyst.xml`
402
+ - `bmm/agents/pm.xml`
403
+ - `bmm/agents/architect.xml`
404
+ - `bmm/agents/ux-designer.xml`
405
+
406
+ 2. **Create 4 separate Gemini Gems** (one per agent, enable Code Execution)
407
+
408
+ 3. **Analysis (Analyst Gem):**
409
+ - Run: `*brainstorm-project` → Generate ideas
410
+ - Run: `*research` → Market analysis
411
+ - Export: Save research findings
412
+
413
+ 4. **Planning (PM Gem):**
414
+ - Share research findings
415
+ - Run: `*product-brief` → Product vision
416
+ - Run: `*prd` → Full requirements document
417
+ - Export: Save PRD to `docs/prd.md`
418
+
419
+ 5. **UX Design (UX Designer Gem):**
420
+ - Share PRD
421
+ - Run: `*create-ux-design` → UX specifications
422
+ - Export: Save UX design to `docs/ux-design.md`
423
+
424
+ 6. **Architecture (Architect Gem):**
425
+ - Share PRD and UX Design
426
+ - Run: `*architecture` → Technical architecture
427
+ - Export: Save to `docs/architecture.md`
428
+
429
+ **Phase 4: Local Implementation**
430
+
431
+ 7. **Setup local BMad:**
432
+ - Install BMad locally: `npx bmad-method@alpha install`
433
+ - Place exported docs in project `docs/` folder
434
+ - Load Developer agent
435
+ - Run: `*workflow-init` → BMad detects artifacts, suggests next steps
436
+
437
+ 8. **Implement:**
438
+ - Run: `*sprint-planning` → Set up sprint
439
+ - Run: `*dev-story` → Implement features
440
+ - Use full IDE capabilities with codebase access
441
+
442
+ **Cost Savings:** 60-80% by doing planning in Gemini before local implementation
443
+
444
+ ### Example 2: Quick Brainstorming Session
445
+
446
+ 1. Download `cis/agents/brainstorming-coach.xml`
447
+ 2. Create Gemini Gem with Code Execution enabled
448
+ 3. Run: `*brainstorming`
449
+ 4. Choose technique (e.g., SCAMPER, Mind Mapping)
450
+ 5. Generate and refine ideas
451
+ 6. Export results for team review
452
+
453
+ ### Example 3: Architecture Review
454
+
455
+ 1. Download `bmm/agents/architect.xml`
456
+ 2. Create Gemini Gem (enable Code Execution)
457
+ 3. Paste existing PRD into conversation
458
+ 4. Run: `*architecture`
459
+ 5. Collaborate on technical decisions
460
+ 6. Export architecture document to `docs/architecture.md`
461
+
462
+ ## Next Steps
463
+
464
+ - **[Agent Customization Guide](./agent-customization-guide.md)** - Customize before bundling
465
+ - **[BMM Documentation](../src/modules/bmm/docs/README.md)** - Learn all workflows
466
+ - **[Web Bundler Technical Docs](./installers-bundlers/web-bundler-usage.md)** - Advanced bundling options
467
+ - **[Contributing Guide](../CONTRIBUTING.md)** - Help improve web bundles
468
+
469
+ ## Resources
470
+
471
+ - **[Google AI Studio](https://aistudio.google.com/)** - Create Gemini Gems
472
+ - **[Custom GPTs](https://chat.openai.com/gpts)** - Build Custom GPTs
473
+ - **[BMad Discord](https://discord.gg/gk8jAdXWmj)** - Get help and share your Gems/GPTs
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://json.schemastore.org/package.json",
3
3
  "name": "bmad-method",
4
- "version": "6.0.0-alpha.7",
4
+ "version": "6.0.0-alpha.9",
5
5
  "description": "Breakthrough Method of Agile AI-driven Development",
6
6
  "keywords": [
7
7
  "agile",
@@ -1,28 +1,35 @@
1
1
  # BMAD™ Core Configuration
2
+ header: "BMAD™ Core Configuration"
3
+ subheader: "Configure the core settings for your BMAD™ installation.\nThese settings will be used across all modules and agents."
2
4
 
3
- prompt:
4
- - "Welcome and thank you for choosing BMAD™! This is the Core Configuration."
5
- - "This will impact all selected modules, either additions or upgrades."
5
+ bmad_folder:
6
+ prompt: "What is the root folder for BMAD installation? (Recommended: .bmad)"
7
+ default: ".bmad"
8
+ result: "{value}"
9
+ regex: "^[a-zA-Z0-9._-]{1,20}$"
6
10
 
7
- # This is injected into the custom agent activation rules
8
11
  user_name:
9
- prompt: "What is your name?"
12
+ prompt: "What shall the agents call you?"
10
13
  default: "BMad"
11
14
  result: "{value}"
12
15
 
13
- # This is injected into the custom agent activation rules and most workflows
14
16
  communication_language:
15
- prompt: "Preferred Chat Language?"
17
+ prompt: "Preferred Chat Language/Style? (English, Mandarin, English Pirate, etc...)"
16
18
  default: "English"
17
19
  result: "{value}"
18
20
 
19
21
  document_output_language:
20
22
  prompt: "Preferred Document Output Language?"
21
- default: "English"
23
+ default: "{communication_language}"
22
24
  result: "{value}"
23
25
 
24
- # This is injected into the custom agent activation rules
26
+ # This is the folder where all generated AI Output documents from workflows will default be sa
25
27
  output_folder:
26
- prompt: "Where should the generated output default save location be?"
28
+ prompt: "Where should AI Generated Artifacts be saved across all modules?"
27
29
  default: "docs"
28
30
  result: "{project-root}/{value}"
31
+
32
+ install_user_docs:
33
+ prompt: "Install user documentation and optimized agent intelligence to each selected modules docs folder?"
34
+ default: true
35
+ result: "{value}"
@@ -49,14 +49,6 @@ async function configureForIDE(ide) {
49
49
  // Claude Code specific Core configurations
50
50
  break;
51
51
  }
52
- case 'cursor': {
53
- // Cursor specific Core configurations
54
- break;
55
- }
56
- case 'windsurf': {
57
- // Windsurf specific Core configurations
58
- break;
59
- }
60
52
  // Add more IDEs as needed
61
53
  default: {
62
54
  // No specific configuration needed
@@ -3,7 +3,7 @@
3
3
 
4
4
  agent:
5
5
  metadata:
6
- id: "bmad/core/agents/bmad-master.md"
6
+ id: "{bmad_folder}/core/agents/bmad-master.md"
7
7
  name: "BMad Master"
8
8
  title: "BMad Master Executor, Knowledge Custodian, and Workflow Orchestrator"
9
9
  icon: "🧙"
@@ -17,22 +17,22 @@ agent:
17
17
 
18
18
  # Agent-specific critical actions
19
19
  critical_actions:
20
- - "Load into memory {project-root}/bmad/core/config.yaml and set variable project_name, output_folder, user_name, communication_language"
20
+ - "Load into memory {project-root}/{bmad_folder}/core/config.yaml and set variable project_name, output_folder, user_name, communication_language"
21
21
  - "Remember the users name is {user_name}"
22
22
  - "ALWAYS communicate in {communication_language}"
23
23
 
24
24
  # Agent menu items
25
25
  menu:
26
26
  - trigger: "list-tasks"
27
- action: "list all tasks from {project-root}/bmad/_cfg/task-manifest.csv"
27
+ action: "list all tasks from {project-root}/{bmad_folder}/_cfg/task-manifest.csv"
28
28
  description: "List Available Tasks"
29
29
 
30
30
  - trigger: "list-workflows"
31
- action: "list all workflows from {project-root}/bmad/_cfg/workflow-manifest.csv"
31
+ action: "list all workflows from {project-root}/{bmad_folder}/_cfg/workflow-manifest.csv"
32
32
  description: "List Workflows"
33
33
 
34
34
  - trigger: "party-mode"
35
- workflow: "{project-root}/bmad/core/workflows/party-mode/workflow.yaml"
35
+ workflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml"
36
36
  description: "Group chat with all agents"
37
37
 
38
38
  # Empty prompts section (no custom prompts for this agent)
@@ -1,7 +1,8 @@
1
- <agent id="bmad/core/agents/bmad-orchestrator.md" name="BMad Orchestrator" title="BMad Web Orchestrator" icon="🎭" localskip="true">
1
+ <agent id="{bmad_folder}/core/agents/bmad-orchestrator.md" name="BMad Orchestrator" title="BMad Web Orchestrator" icon="🎭" localskip="true">
2
2
  <activation critical="MANDATORY">
3
3
  <step n="1">Load this complete web bundle XML - you are the BMad Orchestrator, first agent in this bundle</step>
4
- <step n="2">CRITICAL: This bundle contains ALL agents as XML nodes with id="bmad/..." and ALL workflows/tasks as nodes findable by type
4
+ <step n="2">CRITICAL: This bundle contains ALL agents as XML nodes with id="{bmad_folder}/..." and ALL workflows/tasks as nodes findable
5
+ by type
5
6
  and id</step>
6
7
  <step n="3">Greet user as BMad Orchestrator and display numbered list of ALL menu items from menu section below</step>
7
8
  <step n="4">STOP and WAIT for user input - do NOT execute menu items automatically - accept number or trigger text</step>
@@ -15,7 +16,7 @@
15
16
  <handler type="workflow">
16
17
  When menu item has: workflow="workflow-id"
17
18
  1. Find workflow node by id in this bundle (e.g., &lt;workflow id="workflow-id"&gt;)
18
- 2. CRITICAL: Always LOAD bmad/core/tasks/workflow.xml if referenced
19
+ 2. CRITICAL: Always LOAD {bmad_folder}/core/tasks/workflow.xml if referenced
19
20
  3. Execute the workflow content precisely following all steps
20
21
  4. Save outputs after completing EACH workflow step (never batch)
21
22
  5. If workflow id is "todo", inform user it hasn't been implemented yet
@@ -48,7 +49,7 @@
48
49
 
49
50
  <handler type="validate-workflow">
50
51
  When menu item has: validate-workflow="workflow-id"
51
- 1. MUST LOAD bmad/core/tasks/validate-workflow.xml
52
+ 1. MUST LOAD {bmad_folder}/core/tasks/validate-workflow.xml
52
53
  2. Execute all validation instructions from that file
53
54
  3. Check workflow's validation property for schema
54
55
  4. Identify file to validate or ask user to specify
@@ -69,18 +70,6 @@
69
70
  5. On *exit: Confirm, then return to BMad Orchestrator persona
70
71
  </agent-transformation>
71
72
 
72
- <party-mode critical="true">
73
- When user selects *party-mode:
74
- 1. Enter group chat simulation mode
75
- 2. Load ALL agent personas from this bundle
76
- 3. Simulate each agent distinctly with their name and emoji
77
- 4. Create engaging multi-agent conversation
78
- 5. Each agent contributes based on their expertise
79
- 6. Format: "[emoji] Name: message"
80
- 7. Maintain distinct voices and perspectives for each agent
81
- 8. Continue until user types *exit-party
82
- </party-mode>
83
-
84
73
  <list-agents critical="true">
85
74
  When user selects *list-agents:
86
75
  1. Scan all agent nodes in this bundle
@@ -116,7 +105,9 @@
116
105
  <item cmd="*help">Show numbered command list</item>
117
106
  <item cmd="*list-agents">List all available agents with their capabilities</item>
118
107
  <item cmd="*agents [agent-name]">Transform into a specific agent</item>
119
- <item cmd="*party-mode">Enter group chat with all agents simultaneously</item>
108
+ <item cmd="*party-mode" workflow="bmad/bmm/workflows/1-analysis/product-brief/workflow.yaml">Enter group chat with all agents
109
+ simultaneously</item>
110
+ <item cmd="*advanced-elicitation" task="bmad/core/tasks/advanced-elicitation.xml">Push agent to perform advanced elicitation</item>
120
111
  <item cmd="*exit">Exit current session</item>
121
112
  </menu>
122
113
  </agent>
@@ -1,4 +1,6 @@
1
- <task id="bmad/core/tasks/adv-elicit.xml" name="Advanced Elicitation" standalone="true">
1
+ <task id="{bmad_folder}/core/tasks/advanced-elicitation.xml" name="Advanced Elicitation" standalone="true"
2
+ methods="{project-root}/{bmad_folder}/core/tasks/advanced-elicitation-methods.csv"
3
+ agent-party="{project-root}/{bmad_folder}/_cfg/agent-manifest.csv">
2
4
  <llm critical="true">
3
5
  <i>MANDATORY: Execute ALL steps in the flow section IN EXACT ORDER</i>
4
6
  <i>DO NOT skip steps or change the sequence</i>
@@ -9,7 +11,7 @@
9
11
 
10
12
  <integration description="When called from workflow">
11
13
  <desc>When called during template workflow processing:</desc>
12
- <i>1. Receive the current section content that was just generated</i>
14
+ <i>1. Receive or review the current section content that was just generated or</i>
13
15
  <i>2. Apply elicitation methods iteratively to enhance that specific content</i>
14
16
  <i>3. Return the enhanced version back when user selects 'x' to proceed and return back</i>
15
17
  <i>4. The enhanced content replaces the original section content in the output document</i>
@@ -17,7 +19,7 @@
17
19
 
18
20
  <flow>
19
21
  <step n="1" title="Method Registry Loading">
20
- <action>Load and read {project-root}/core/tasks/adv-elicit-methods.csv</action>
22
+ <action>Load and read {{methods}} and {{agent-party}}</action>
21
23
 
22
24
  <csv-structure>
23
25
  <i>category: Method grouping (core, structural, risk, etc.)</i>
@@ -66,7 +68,7 @@
66
68
  <i>CRITICAL: Re-present the same 1-5,r,x prompt to allow additional elicitations</i>
67
69
  </case>
68
70
  <case n="r">
69
- <i>Select 5 different methods from adv-elicit-methods.csv, present new list with same prompt format</i>
71
+ <i>Select 5 different methods from advanced-elicitation-methods.csv, present new list with same prompt format</i>
70
72
  </case>
71
73
  <case n="x">
72
74
  <i>Complete elicitation and proceed</i>
@@ -1,4 +1,4 @@
1
- <task id="bmad/core/tasks/index-docs" name="Index Docs"
1
+ <task id="{bmad_folder}/core/tasks/index-docs" name="Index Docs"
2
2
  description="Generates or updates an index.md of all documents in the specified directory" webskip="true" standalone="true">
3
3
  <llm critical="true">
4
4
  <i>MANDATORY: Execute ALL steps in the flow section IN EXACT ORDER</i>