bmad-method 5.0.0 → 5.0.1

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 (329) hide show
  1. package/.github/FUNDING.yaml +15 -0
  2. package/.github/ISSUE_TEMPLATE/bug_report.md +32 -0
  3. package/.github/ISSUE_TEMPLATE/feature_request.md +22 -0
  4. package/.github/workflows/discord.yaml +25 -0
  5. package/.github/workflows/format-check.yaml +42 -0
  6. package/.github/workflows/manual-release.yaml +173 -0
  7. package/.husky/pre-commit +3 -2
  8. package/.vscode/settings.json +67 -74
  9. package/CHANGELOG.md +564 -19
  10. package/CONTRIBUTING.md +168 -5
  11. package/LICENSE +1 -1
  12. package/README.md +146 -218
  13. package/bmad-core/agent-teams/team-all.yaml +14 -0
  14. package/bmad-core/agent-teams/team-fullstack.yaml +18 -0
  15. package/bmad-core/agent-teams/team-ide-minimal.yaml +10 -0
  16. package/bmad-core/agent-teams/team-no-ui.yaml +13 -0
  17. package/bmad-core/agents/analyst.md +81 -0
  18. package/bmad-core/agents/architect.md +83 -0
  19. package/bmad-core/agents/bmad-master.md +107 -0
  20. package/bmad-core/agents/bmad-orchestrator.md +149 -0
  21. package/bmad-core/agents/dev.md +75 -0
  22. package/bmad-core/agents/pm.md +81 -0
  23. package/bmad-core/agents/po.md +76 -0
  24. package/bmad-core/agents/qa.md +88 -0
  25. package/bmad-core/agents/sm.md +62 -0
  26. package/bmad-core/agents/ux-expert.md +66 -0
  27. package/{.bmad-core → bmad-core}/checklists/architect-checklist.md +0 -5
  28. package/{.bmad-core → bmad-core}/checklists/change-checklist.md +2 -2
  29. package/{.bmad-core → bmad-core}/checklists/pm-checklist.md +0 -5
  30. package/{.bmad-core → bmad-core}/checklists/po-master-checklist.md +0 -9
  31. package/{.bmad-core → bmad-core}/checklists/story-dod-checklist.md +0 -7
  32. package/{.bmad-core → bmad-core}/checklists/story-draft-checklist.md +1 -4
  33. package/bmad-core/core-config.yaml +20 -0
  34. package/bmad-core/data/bmad-kb.md +806 -0
  35. package/bmad-core/data/brainstorming-techniques.md +36 -0
  36. package/bmad-core/data/elicitation-methods.md +154 -0
  37. package/bmad-core/data/test-levels-framework.md +146 -0
  38. package/bmad-core/data/test-priorities-matrix.md +172 -0
  39. package/bmad-core/tasks/advanced-elicitation.md +117 -0
  40. package/{.bmad-core → bmad-core}/tasks/correct-course.md +9 -12
  41. package/bmad-core/tasks/create-brownfield-story.md +312 -0
  42. package/{.bmad-core → bmad-core}/tasks/create-deep-research-prompt.md +4 -27
  43. package/bmad-core/tasks/create-next-story.md +112 -0
  44. package/bmad-core/tasks/document-project.md +343 -0
  45. package/bmad-core/tasks/facilitate-brainstorming-session.md +136 -0
  46. package/bmad-core/tasks/generate-ai-frontend-prompt.md +51 -0
  47. package/{.bmad-core → bmad-core}/tasks/index-docs.md +3 -13
  48. package/bmad-core/tasks/kb-mode-interaction.md +75 -0
  49. package/bmad-core/tasks/nfr-assess.md +343 -0
  50. package/bmad-core/tasks/qa-gate.md +159 -0
  51. package/bmad-core/tasks/review-story.md +314 -0
  52. package/bmad-core/tasks/risk-profile.md +353 -0
  53. package/{.bmad-core → bmad-core}/tasks/shard-doc.md +27 -15
  54. package/bmad-core/tasks/test-design.md +174 -0
  55. package/bmad-core/tasks/trace-requirements.md +264 -0
  56. package/bmad-core/tasks/validate-next-story.md +134 -0
  57. package/bmad-core/templates/architecture-tmpl.yaml +650 -0
  58. package/bmad-core/templates/brainstorming-output-tmpl.yaml +156 -0
  59. package/bmad-core/templates/brownfield-architecture-tmpl.yaml +476 -0
  60. package/bmad-core/templates/brownfield-prd-tmpl.yaml +280 -0
  61. package/bmad-core/templates/competitor-analysis-tmpl.yaml +306 -0
  62. package/bmad-core/templates/front-end-architecture-tmpl.yaml +218 -0
  63. package/bmad-core/templates/front-end-spec-tmpl.yaml +349 -0
  64. package/bmad-core/templates/fullstack-architecture-tmpl.yaml +823 -0
  65. package/bmad-core/templates/market-research-tmpl.yaml +252 -0
  66. package/bmad-core/templates/prd-tmpl.yaml +202 -0
  67. package/bmad-core/templates/project-brief-tmpl.yaml +221 -0
  68. package/bmad-core/templates/qa-gate-tmpl.yaml +102 -0
  69. package/bmad-core/templates/story-tmpl.yaml +137 -0
  70. package/bmad-core/workflows/brownfield-fullstack.yaml +297 -0
  71. package/bmad-core/workflows/brownfield-service.yaml +187 -0
  72. package/bmad-core/workflows/brownfield-ui.yaml +197 -0
  73. package/{.bmad-core/workflows/greenfield-fullstack.yml → bmad-core/workflows/greenfield-fullstack.yaml} +140 -77
  74. package/bmad-core/workflows/greenfield-service.yaml +206 -0
  75. package/bmad-core/workflows/greenfield-ui.yaml +235 -0
  76. package/common/tasks/create-doc.md +101 -0
  77. package/{.bmad-core → common}/tasks/execute-checklist.md +2 -13
  78. package/common/utils/bmad-doc-template.md +325 -0
  79. package/common/utils/workflow-management.md +69 -0
  80. package/dist/agents/analyst.txt +2889 -0
  81. package/dist/agents/architect.txt +3552 -0
  82. package/dist/agents/bmad-master.txt +8769 -0
  83. package/dist/agents/bmad-orchestrator.txt +1513 -0
  84. package/dist/agents/dev.txt +414 -0
  85. package/{.bmad-core/web-bundles → dist}/agents/pm.txt +668 -1119
  86. package/{.bmad-core/web-bundles → dist}/agents/po.txt +341 -484
  87. package/dist/agents/qa.txt +1987 -0
  88. package/dist/agents/sm.txt +658 -0
  89. package/dist/agents/ux-expert.txt +694 -0
  90. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +2371 -0
  91. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +1620 -0
  92. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +815 -0
  93. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +10952 -0
  94. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.txt +4012 -0
  95. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt +3698 -0
  96. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.txt +450 -0
  97. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.txt +973 -0
  98. package/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt +15376 -0
  99. package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +2075 -0
  100. package/dist/teams/team-all.txt +12682 -0
  101. package/dist/teams/team-fullstack.txt +10421 -0
  102. package/dist/teams/team-ide-minimal.txt +5103 -0
  103. package/dist/teams/team-no-ui.txt +8980 -0
  104. package/docs/GUIDING-PRINCIPLES.md +91 -0
  105. package/docs/core-architecture.md +219 -0
  106. package/docs/enhanced-ide-development-workflow.md +248 -0
  107. package/docs/expansion-packs.md +280 -0
  108. package/docs/how-to-contribute-with-pull-requests.md +158 -0
  109. package/docs/user-guide.md +504 -0
  110. package/docs/versioning-and-releases.md +115 -53
  111. package/docs/versions.md +4 -5
  112. package/docs/working-in-the-brownfield.md +597 -0
  113. package/eslint.config.mjs +119 -0
  114. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/Complete AI Agent System - Flowchart.svg +102 -0
  115. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.1 Google Cloud Project Setup/1.1.1 - Initial Project Configuration - bash copy.txt +13 -0
  116. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.1 Google Cloud Project Setup/1.1.1 - Initial Project Configuration - bash.txt +13 -0
  117. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.2 Agent Development Kit Installation/1.2.2 - Basic Project Structure - txt.txt +25 -0
  118. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.3 Core Configuration Files/1.3.1 - settings.py +34 -0
  119. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.3 Core Configuration Files/1.3.2 - main.py - Base Application.py +70 -0
  120. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.4 Deployment Configuration/1.4.2 - cloudbuild.yaml +26 -0
  121. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/README.md +109 -0
  122. package/expansion-packs/README.md +2 -112
  123. package/expansion-packs/bmad-2d-phaser-game-dev/agent-teams/phaser-2d-nodejs-game-team.yaml +13 -0
  124. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.md +71 -0
  125. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.md +78 -0
  126. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.md +64 -0
  127. package/expansion-packs/bmad-2d-phaser-game-dev/checklists/game-design-checklist.md +201 -0
  128. package/expansion-packs/bmad-2d-phaser-game-dev/checklists/game-story-dod-checklist.md +160 -0
  129. package/expansion-packs/bmad-2d-phaser-game-dev/config.yaml +8 -0
  130. package/expansion-packs/bmad-2d-phaser-game-dev/data/bmad-kb.md +250 -0
  131. package/expansion-packs/bmad-2d-phaser-game-dev/data/development-guidelines.md +647 -0
  132. package/expansion-packs/bmad-2d-phaser-game-dev/tasks/advanced-elicitation.md +110 -0
  133. package/expansion-packs/bmad-2d-phaser-game-dev/tasks/create-game-story.md +216 -0
  134. package/expansion-packs/bmad-2d-phaser-game-dev/tasks/game-design-brainstorming.md +290 -0
  135. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-architecture-tmpl.yaml +613 -0
  136. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-brief-tmpl.yaml +356 -0
  137. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-design-doc-tmpl.yaml +343 -0
  138. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-story-tmpl.yaml +253 -0
  139. package/expansion-packs/bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.yaml +484 -0
  140. package/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-dev-greenfield.yaml +183 -0
  141. package/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-prototype.yaml +175 -0
  142. package/expansion-packs/bmad-2d-unity-game-dev/agent-teams/unity-2d-game-team.yaml +14 -0
  143. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.md +80 -0
  144. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.md +77 -0
  145. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.md +78 -0
  146. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.md +65 -0
  147. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-architect-checklist.md +391 -0
  148. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-change-checklist.md +203 -0
  149. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-design-checklist.md +201 -0
  150. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-story-dod-checklist.md +124 -0
  151. package/expansion-packs/bmad-2d-unity-game-dev/config.yaml +6 -0
  152. package/expansion-packs/bmad-2d-unity-game-dev/data/bmad-kb.md +769 -0
  153. package/expansion-packs/bmad-2d-unity-game-dev/data/development-guidelines.md +586 -0
  154. package/expansion-packs/bmad-2d-unity-game-dev/tasks/advanced-elicitation.md +110 -0
  155. package/expansion-packs/bmad-2d-unity-game-dev/tasks/correct-course-game.md +141 -0
  156. package/expansion-packs/bmad-2d-unity-game-dev/tasks/create-game-story.md +184 -0
  157. package/expansion-packs/bmad-2d-unity-game-dev/tasks/game-design-brainstorming.md +290 -0
  158. package/expansion-packs/bmad-2d-unity-game-dev/tasks/validate-game-story.md +200 -0
  159. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-architecture-tmpl.yaml +1030 -0
  160. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-brief-tmpl.yaml +356 -0
  161. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-design-doc-tmpl.yaml +705 -0
  162. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-story-tmpl.yaml +256 -0
  163. package/expansion-packs/bmad-2d-unity-game-dev/templates/level-design-doc-tmpl.yaml +484 -0
  164. package/expansion-packs/bmad-2d-unity-game-dev/workflows/game-dev-greenfield.yaml +183 -0
  165. package/expansion-packs/bmad-2d-unity-game-dev/workflows/game-prototype.yaml +175 -0
  166. package/expansion-packs/{infrastructure-devops → bmad-infrastructure-devops}/README.md +9 -9
  167. package/expansion-packs/{infrastructure-devops → bmad-infrastructure-devops}/agents/infra-devops-platform.md +30 -18
  168. package/expansion-packs/{infrastructure-devops → bmad-infrastructure-devops}/checklists/infrastructure-checklist.md +1 -1
  169. package/expansion-packs/bmad-infrastructure-devops/config.yaml +9 -0
  170. package/expansion-packs/bmad-infrastructure-devops/data/bmad-kb.md +305 -0
  171. package/expansion-packs/{infrastructure-devops → bmad-infrastructure-devops}/tasks/review-infrastructure.md +4 -5
  172. package/expansion-packs/{infrastructure-devops → bmad-infrastructure-devops}/tasks/validate-infrastructure.md +4 -5
  173. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-architecture-tmpl.yaml +424 -0
  174. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-platform-from-arch-tmpl.yaml +629 -0
  175. package/package.json +74 -42
  176. package/prettier.config.mjs +32 -0
  177. package/release_notes.md +30 -0
  178. package/tools/bmad-npx-wrapper.js +13 -15
  179. package/tools/builders/web-builder.js +544 -15
  180. package/tools/bump-all-versions.js +115 -0
  181. package/tools/bump-expansion-version.js +90 -0
  182. package/tools/cli.js +65 -32
  183. package/tools/flattener/aggregate.js +76 -0
  184. package/tools/flattener/binary.js +80 -0
  185. package/tools/flattener/discovery.js +71 -0
  186. package/tools/flattener/files.js +35 -0
  187. package/tools/flattener/ignoreRules.js +176 -0
  188. package/tools/flattener/main.js +573 -0
  189. package/tools/flattener/projectRoot.js +206 -0
  190. package/tools/flattener/prompts.js +44 -0
  191. package/tools/flattener/stats.helpers.js +395 -0
  192. package/tools/flattener/stats.js +80 -0
  193. package/tools/flattener/test-matrix.js +413 -0
  194. package/tools/flattener/xml.js +88 -0
  195. package/tools/installer/README.md +3 -53
  196. package/tools/installer/bin/bmad.js +475 -90
  197. package/tools/installer/config/ide-agent-config.yaml +58 -0
  198. package/tools/installer/config/install.config.yaml +123 -0
  199. package/tools/installer/lib/config-loader.js +208 -40
  200. package/tools/installer/lib/file-manager.js +258 -55
  201. package/tools/installer/lib/ide-base-setup.js +228 -0
  202. package/tools/installer/lib/ide-setup.js +1265 -253
  203. package/tools/installer/lib/installer.js +1651 -310
  204. package/tools/installer/lib/memory-profiler.js +225 -0
  205. package/tools/installer/lib/module-manager.js +114 -0
  206. package/tools/installer/lib/resource-locator.js +308 -0
  207. package/tools/installer/package.json +25 -24
  208. package/tools/lib/dependency-resolver.js +44 -48
  209. package/tools/lib/yaml-utils.js +29 -0
  210. package/tools/md-assets/web-agent-startup-instructions.md +39 -0
  211. package/tools/preview-release-notes.js +66 -0
  212. package/tools/shared/bannerArt.js +105 -0
  213. package/tools/sync-installer-version.js +7 -9
  214. package/tools/update-expansion-version.js +53 -0
  215. package/tools/upgraders/v3-to-v4-upgrader.js +221 -320
  216. package/tools/version-bump.js +42 -27
  217. package/tools/yaml-format.js +57 -44
  218. package/.bmad-core/agent-teams/team-all.yml +0 -16
  219. package/.bmad-core/agent-teams/team-fullstack.yml +0 -26
  220. package/.bmad-core/agent-teams/team-no-ui.yml +0 -15
  221. package/.bmad-core/agents/analyst.md +0 -59
  222. package/.bmad-core/agents/architect.md +0 -66
  223. package/.bmad-core/agents/bmad-master.md +0 -104
  224. package/.bmad-core/agents/bmad-orchestrator.md +0 -81
  225. package/.bmad-core/agents/dev.md +0 -70
  226. package/.bmad-core/agents/pm.md +0 -59
  227. package/.bmad-core/agents/po.md +0 -60
  228. package/.bmad-core/agents/qa.md +0 -52
  229. package/.bmad-core/agents/sm.md +0 -55
  230. package/.bmad-core/agents/ux-expert.md +0 -66
  231. package/.bmad-core/data/bmad-kb.md +0 -47
  232. package/.bmad-core/schemas/agent-team-schema.yml +0 -153
  233. package/.bmad-core/tasks/advanced-elicitation.md +0 -92
  234. package/.bmad-core/tasks/brainstorming-techniques.md +0 -238
  235. package/.bmad-core/tasks/core-dump.md +0 -74
  236. package/.bmad-core/tasks/create-agent.md +0 -202
  237. package/.bmad-core/tasks/create-doc.md +0 -74
  238. package/.bmad-core/tasks/create-expansion-pack.md +0 -425
  239. package/.bmad-core/tasks/create-next-story.md +0 -206
  240. package/.bmad-core/tasks/create-team.md +0 -229
  241. package/.bmad-core/tasks/doc-migration-task.md +0 -143
  242. package/.bmad-core/tasks/generate-ai-frontend-prompt.md +0 -58
  243. package/.bmad-core/templates/agent-tmpl.md +0 -58
  244. package/.bmad-core/templates/architecture-tmpl.md +0 -771
  245. package/.bmad-core/templates/brownfield-architecture-tmpl.md +0 -542
  246. package/.bmad-core/templates/brownfield-prd-tmpl.md +0 -240
  247. package/.bmad-core/templates/competitor-analysis-tmpl.md +0 -289
  248. package/.bmad-core/templates/expansion-pack-plan-tmpl.md +0 -91
  249. package/.bmad-core/templates/front-end-architecture-tmpl.md +0 -173
  250. package/.bmad-core/templates/front-end-spec-tmpl.md +0 -411
  251. package/.bmad-core/templates/fullstack-architecture-tmpl.md +0 -1016
  252. package/.bmad-core/templates/market-research-tmpl.md +0 -261
  253. package/.bmad-core/templates/prd-tmpl.md +0 -200
  254. package/.bmad-core/templates/project-brief-tmpl.md +0 -228
  255. package/.bmad-core/templates/simple-project-prd-tmpl.md +0 -461
  256. package/.bmad-core/templates/story-tmpl.md +0 -61
  257. package/.bmad-core/templates/web-agent-startup-instructions-template.md +0 -39
  258. package/.bmad-core/utils/agent-switcher.ide.md +0 -112
  259. package/.bmad-core/utils/template-format.md +0 -26
  260. package/.bmad-core/utils/workflow-management.md +0 -224
  261. package/.bmad-core/web-bundles/agents/analyst.txt +0 -1684
  262. package/.bmad-core/web-bundles/agents/architect.txt +0 -3584
  263. package/.bmad-core/web-bundles/agents/bmad-master.txt +0 -9491
  264. package/.bmad-core/web-bundles/agents/bmad-orchestrator.txt +0 -1466
  265. package/.bmad-core/web-bundles/agents/dev.txt +0 -316
  266. package/.bmad-core/web-bundles/agents/qa.txt +0 -129
  267. package/.bmad-core/web-bundles/agents/sm.txt +0 -658
  268. package/.bmad-core/web-bundles/agents/ux-expert.txt +0 -1099
  269. package/.bmad-core/web-bundles/teams/team-all.txt +0 -10757
  270. package/.bmad-core/web-bundles/teams/team-fullstack.txt +0 -10109
  271. package/.bmad-core/web-bundles/teams/team-no-ui.txt +0 -8950
  272. package/.bmad-core/workflows/brownfield-fullstack.yml +0 -116
  273. package/.bmad-core/workflows/brownfield-service.yml +0 -117
  274. package/.bmad-core/workflows/brownfield-ui.yml +0 -127
  275. package/.bmad-core/workflows/greenfield-service.yml +0 -143
  276. package/.bmad-core/workflows/greenfield-ui.yml +0 -172
  277. package/.claude/commands/analyst.md +0 -63
  278. package/.claude/commands/architect.md +0 -70
  279. package/.claude/commands/bmad-master.md +0 -108
  280. package/.claude/commands/bmad-orchestrator.md +0 -85
  281. package/.claude/commands/dev.md +0 -74
  282. package/.claude/commands/pm.md +0 -63
  283. package/.claude/commands/po.md +0 -64
  284. package/.claude/commands/qa.md +0 -56
  285. package/.claude/commands/sm.md +0 -59
  286. package/.claude/commands/ux-expert.md +0 -70
  287. package/.cursor/rules/analyst.mdc +0 -77
  288. package/.cursor/rules/architect.mdc +0 -84
  289. package/.cursor/rules/bmad-master.mdc +0 -122
  290. package/.cursor/rules/bmad-orchestrator.mdc +0 -99
  291. package/.cursor/rules/dev.mdc +0 -88
  292. package/.cursor/rules/pm.mdc +0 -77
  293. package/.cursor/rules/po.mdc +0 -78
  294. package/.cursor/rules/qa.mdc +0 -70
  295. package/.cursor/rules/sm.mdc +0 -73
  296. package/.cursor/rules/ux-expert.mdc +0 -84
  297. package/.github/workflows/release.yml +0 -59
  298. package/.releaserc.json +0 -18
  299. package/.roo/.roomodes +0 -95
  300. package/.roo/README.md +0 -38
  301. package/.vscode/extensions.json +0 -6
  302. package/.windsurf/rules/analyst.md +0 -71
  303. package/.windsurf/rules/architect.md +0 -78
  304. package/.windsurf/rules/bmad-master.md +0 -116
  305. package/.windsurf/rules/bmad-orchestrator.md +0 -93
  306. package/.windsurf/rules/dev.md +0 -82
  307. package/.windsurf/rules/pm.md +0 -71
  308. package/.windsurf/rules/po.md +0 -72
  309. package/.windsurf/rules/qa.md +0 -64
  310. package/.windsurf/rules/sm.md +0 -67
  311. package/.windsurf/rules/ux-expert.md +0 -78
  312. package/docs/bmad-workflow-guide.md +0 -161
  313. package/docs/claude-code-guide.md +0 -119
  314. package/docs/cursor-guide.md +0 -127
  315. package/docs/roo-code-guide.md +0 -140
  316. package/docs/sample-output/simple-fullstack-greenfield/prd.md +0 -42
  317. package/docs/windsurf-guide.md +0 -127
  318. package/expansion-packs/infrastructure-devops/manifest.yml +0 -38
  319. package/expansion-packs/infrastructure-devops/templates/infrastructure-architecture-tmpl.md +0 -415
  320. package/expansion-packs/infrastructure-devops/templates/infrastructure-platform-from-arch-tmpl.md +0 -0
  321. package/tools/installer/config/install.config.yml +0 -139
  322. package/tools/installer/package-lock.json +0 -906
  323. package/tools/installer/templates/claude-commands.md +0 -7
  324. package/tools/installer/templates/cursor-rules.md +0 -22
  325. package/tools/installer/templates/windsurf-rules.md +0 -22
  326. package/tools/semantic-release-sync-installer.js +0 -31
  327. /package/{.bmad-core → bmad-core}/data/technical-preferences.md +0 -0
  328. /package/{.bmad-core → bmad-core}/tasks/brownfield-create-epic.md +0 -0
  329. /package/{.bmad-core → bmad-core}/tasks/brownfield-create-story.md +0 -0
@@ -1,92 +0,0 @@
1
- # Advanced Elicitation Task
2
-
3
- ## Purpose
4
-
5
- - Provide optional reflective and brainstorming actions to enhance content quality
6
- - Enable deeper exploration of ideas through structured elicitation techniques
7
- - Support iterative refinement through multiple analytical perspectives
8
-
9
- ## Task Instructions
10
-
11
- ### 1. Section Context and Review
12
-
13
- [[LLM: When invoked after outputting a section:
14
-
15
- 1. First, provide a brief 1-2 sentence summary of what the user should look for in the section just presented (e.g., "Please review the technology choices for completeness and alignment with your project needs. Pay special attention to version numbers and any missing categories.")
16
-
17
- 2. If the section contains Mermaid diagrams, explain each diagram briefly before offering elicitation options (e.g., "The component diagram shows the main system modules and their interactions. Notice how the API Gateway routes requests to different services.")
18
-
19
- 3. If the section contains multiple distinct items (like multiple components, multiple patterns, etc.), inform the user they can apply elicitation actions to:
20
-
21
- - The entire section as a whole
22
- - Individual items within the section (specify which item when selecting an action)
23
-
24
- 4. Then present the action list as specified below.]]
25
-
26
- ### 2. Ask for Review and Present Action List
27
-
28
- [[LLM: Ask the user to review the drafted section. In the SAME message, inform them that they can suggest additions, removals, or modifications, OR they can select an action by number from the 'Advanced Reflective, Elicitation & Brainstorming Actions'. If there are multiple items in the section, mention they can specify which item(s) to apply the action to. Then, present ONLY the numbered list (0-9) of these actions. Conclude by stating that selecting 9 will proceed to the next section. Await user selection. If an elicitation action (0-8) is chosen, execute it and then re-offer this combined review/elicitation choice. If option 9 is chosen, or if the user provides direct feedback, proceed accordingly.]]
29
-
30
- **Present the numbered list (0-9) with this exact format:**
31
-
32
- ```text
33
- **Advanced Reflective, Elicitation & Brainstorming Actions**
34
- Choose an action (0-9 - 9 to bypass - HELP for explanation of these options):
35
-
36
- 0. Expand or Contract for Audience
37
- 1. Explain Reasoning (CoT Step-by-Step)
38
- 2. Critique and Refine
39
- 3. Analyze Logical Flow and Dependencies
40
- 4. Assess Alignment with Overall Goals
41
- 5. Identify Potential Risks and Unforeseen Issues
42
- 6. Challenge from Critical Perspective (Self or Other Persona)
43
- 7. Explore Diverse Alternatives (ToT-Inspired)
44
- 8. Hindsight is 20/20: The 'If Only...' Reflection
45
- 9. Proceed / No Further Actions
46
- ```
47
-
48
- ### 2. Processing Guidelines
49
-
50
- **Do NOT show:**
51
-
52
- - The full protocol text with `[[LLM: ...]]` instructions
53
- - Detailed explanations of each option unless executing or the user asks, when giving the definition you can modify to tie its relevance
54
- - Any internal template markup
55
-
56
- **After user selection from the list:**
57
-
58
- - Execute the chosen action according to the protocol instructions below
59
- - Ask if they want to select another action or proceed with option 9 once complete
60
- - Continue until user selects option 9 or indicates completion
61
-
62
- ## Action Definitions
63
-
64
- 0. Expand or Contract for Audience
65
- [[LLM: Ask the user whether they want to 'expand' on the content (add more detail, elaborate) or 'contract' it (simplify, clarify, make more concise). Also, ask if there's a specific target audience they have in mind. Once clarified, perform the expansion or contraction from your current role's perspective, tailored to the specified audience if provided.]]
66
-
67
- 1. Explain Reasoning (CoT Step-by-Step)
68
- [[LLM: Explain the step-by-step thinking process, characteristic of your role, that you used to arrive at the current proposal for this content.]]
69
-
70
- 2. Critique and Refine
71
- [[LLM: From your current role's perspective, review your last output or the current section for flaws, inconsistencies, or areas for improvement, and then suggest a refined version reflecting your expertise.]]
72
-
73
- 3. Analyze Logical Flow and Dependencies
74
- [[LLM: From your role's standpoint, examine the content's structure for logical progression, internal consistency, and any relevant dependencies. Confirm if elements are presented in an effective order.]]
75
-
76
- 4. Assess Alignment with Overall Goals
77
- [[LLM: Evaluate how well the current content contributes to the stated overall goals of the document, interpreting this from your specific role's perspective and identifying any misalignments you perceive.]]
78
-
79
- 5. Identify Potential Risks and Unforeseen Issues
80
- [[LLM: Based on your role's expertise, brainstorm potential risks, overlooked edge cases, or unintended consequences related to the current content or proposal.]]
81
-
82
- 6. Challenge from Critical Perspective (Self or Other Persona)
83
- [[LLM: Adopt a critical perspective on the current content. If the user specifies another role or persona (e.g., 'as a customer', 'as [Another Persona Name]'), critique the content or play devil's advocate from that specified viewpoint. If no other role is specified, play devil's advocate from your own current persona's viewpoint, arguing against the proposal or current content and highlighting weaknesses or counterarguments specific to your concerns. This can also randomly include YAGNI when appropriate, such as when trimming the scope of an MVP, the perspective might challenge the need for something to cut MVP scope.]]
84
-
85
- 7. Explore Diverse Alternatives (ToT-Inspired)
86
- [[LLM: From your role's perspective, first broadly brainstorm a range of diverse approaches or solutions to the current topic. Then, from this wider exploration, select and present 2 distinct alternatives, detailing the pros, cons, and potential implications you foresee for each.]]
87
-
88
- 8. Hindsight is 20/20: The 'If Only...' Reflection
89
- [[LLM: In your current persona, imagine it's a retrospective for a project based on the current content. What's the one 'if only we had known/done X...' that your role would humorously or dramatically highlight, along with the imagined consequences?]]
90
-
91
- 9. Proceed / No Further Actions
92
- [[LLM: Acknowledge the user's choice to finalize the current work, accept the AI's last output as is, or move on to the next step without selecting another action from this list. Prepare to proceed accordingly.]]
@@ -1,238 +0,0 @@
1
- # Brainstorming Techniques Task
2
-
3
- This task provides a comprehensive toolkit of creative brainstorming techniques for ideation and innovative thinking. The analyst can use these techniques to facilitate productive brainstorming sessions with users.
4
-
5
- ## Process
6
-
7
- ### 1. Session Setup
8
-
9
- [[LLM: Begin by understanding the brainstorming context and goals. Ask clarifying questions if needed to determine the best approach.]]
10
-
11
- 1. **Establish Context**
12
-
13
- - Understand the problem space or opportunity area
14
- - Identify any constraints or parameters
15
- - Determine session goals (divergent exploration vs. focused ideation)
16
-
17
- 2. **Select Technique Approach**
18
- - Option A: User selects specific techniques
19
- - Option B: Analyst recommends techniques based on context
20
- - Option C: Random technique selection for creative variety
21
- - Option D: Progressive technique flow (start broad, narrow down)
22
-
23
- ### 2. Core Brainstorming Techniques
24
-
25
- #### Creative Expansion Techniques
26
-
27
- 1. **"What If" Scenarios**
28
- [[LLM: Generate provocative what-if questions that challenge assumptions and expand thinking beyond current limitations.]]
29
-
30
- - What if we had unlimited resources?
31
- - What if this problem didn't exist?
32
- - What if we approached this from a child's perspective?
33
- - What if we had to solve this in 24 hours?
34
-
35
- 2. **Analogical Thinking**
36
- [[LLM: Help user draw parallels between their challenge and other domains, industries, or natural systems.]]
37
-
38
- - "How might this work like [X] but for [Y]?"
39
- - Nature-inspired solutions (biomimicry)
40
- - Cross-industry pattern matching
41
- - Historical precedent analysis
42
-
43
- 3. **Reversal/Inversion**
44
- [[LLM: Flip the problem or approach it from the opposite angle to reveal new insights.]]
45
-
46
- - What if we did the exact opposite?
47
- - How could we make this problem worse? (then reverse)
48
- - Start from the end goal and work backward
49
- - Reverse roles or perspectives
50
-
51
- 4. **First Principles Thinking**
52
- [[LLM: Break down to fundamental truths and rebuild from scratch.]]
53
- - What are the absolute fundamentals here?
54
- - What assumptions can we challenge?
55
- - If we started from zero, what would we build?
56
- - What laws of physics/economics/human nature apply?
57
-
58
- #### Structured Ideation Frameworks
59
-
60
- 1. **SCAMPER Method**
61
- [[LLM: Guide through each SCAMPER prompt systematically.]]
62
-
63
- - **S** = Substitute: What can be substituted?
64
- - **C** = Combine: What can be combined or integrated?
65
- - **A** = Adapt: What can be adapted from elsewhere?
66
- - **M** = Modify/Magnify: What can be emphasized or reduced?
67
- - **P** = Put to other uses: What else could this be used for?
68
- - **E** = Eliminate: What can be removed or simplified?
69
- - **R**= Reverse/Rearrange: What can be reversed or reordered?
70
-
71
- 2. **Six Thinking Hats**
72
- [[LLM: Cycle through different thinking modes, spending focused time in each.]]
73
-
74
- - White Hat: Facts and information
75
- - Red Hat: Emotions and intuition
76
- - Black Hat: Caution and critical thinking
77
- - Yellow Hat: Optimism and benefits
78
- - Green Hat: Creativity and alternatives
79
- - Blue Hat: Process and control
80
-
81
- 3. **Mind Mapping**
82
- [[LLM: Create text-based mind maps with clear hierarchical structure.]]
83
-
84
- ```plaintext
85
- Central Concept
86
- ├── Branch 1
87
- │ ├── Sub-idea 1.1
88
- │ └── Sub-idea 1.2
89
- ├── Branch 2
90
- │ ├── Sub-idea 2.1
91
- │ └── Sub-idea 2.2
92
- └── Branch 3
93
- └── Sub-idea 3.1
94
- ```
95
-
96
- #### Collaborative Techniques
97
-
98
- 1. **"Yes, And..." Building**
99
- [[LLM: Accept every idea and build upon it without judgment. Encourage wild ideas and defer criticism.]]
100
-
101
- - Accept the premise of each idea
102
- - Add to it with "Yes, and..."
103
- - Build chains of connected ideas
104
- - Explore tangents freely
105
-
106
- 2. **Brainwriting/Round Robin**
107
- [[LLM: Simulate multiple perspectives by generating ideas from different viewpoints.]]
108
-
109
- - Generate ideas from stakeholder perspectives
110
- - Build on previous ideas in rounds
111
- - Combine unrelated ideas
112
- - Cross-pollinate concepts
113
-
114
- 3. **Random Stimulation**
115
- [[LLM: Use random words, images, or concepts as creative triggers.]]
116
- - Random word association
117
- - Picture/metaphor inspiration
118
- - Forced connections between unrelated items
119
- - Constraint-based creativity
120
-
121
- #### Deep Exploration Techniques
122
-
123
- 1. **Five Whys**
124
- [[LLM: Dig deeper into root causes and underlying motivations.]]
125
-
126
- - Why does this problem exist? → Answer → Why? (repeat 5 times)
127
- - Uncover hidden assumptions
128
- - Find root causes, not symptoms
129
- - Identify intervention points
130
-
131
- 2. **Morphological Analysis**
132
- [[LLM: Break down into parameters and systematically explore combinations.]]
133
-
134
- - List key parameters/dimensions
135
- - Identify possible values for each
136
- - Create combination matrix
137
- - Explore unusual combinations
138
-
139
- 3. **Provocation Technique (PO)**
140
- [[LLM: Make deliberately provocative statements to jar thinking.]]
141
- - PO: Cars have square wheels
142
- - PO: Customers pay us to take products
143
- - PO: The problem solves itself
144
- - Extract useful ideas from provocations
145
-
146
- ### 3. Technique Selection Guide
147
-
148
- [[LLM: Help user select appropriate techniques based on their needs.]]
149
-
150
- **For Initial Exploration:**
151
-
152
- - What If Scenarios
153
- - First Principles
154
- - Mind Mapping
155
-
156
- **For Stuck/Blocked Thinking:**
157
-
158
- - Random Stimulation
159
- - Reversal/Inversion
160
- - Provocation Technique
161
-
162
- **For Systematic Coverage:**
163
-
164
- - SCAMPER
165
- - Morphological Analysis
166
- - Six Thinking Hats
167
-
168
- **For Deep Understanding:**
169
-
170
- - Five Whys
171
- - Analogical Thinking
172
- - First Principles
173
-
174
- **For Team/Collaborative Settings:**
175
-
176
- - Brainwriting
177
- - "Yes, And..."
178
- - Six Thinking Hats
179
-
180
- ### 4. Session Flow Management
181
-
182
- [[LLM: Guide the brainstorming session with appropriate pacing and technique transitions.]]
183
-
184
- 1. **Warm-up Phase** (5-10 min)
185
-
186
- - Start with accessible techniques
187
- - Build creative confidence
188
- - Establish "no judgment" atmosphere
189
-
190
- 2. **Divergent Phase** (20-30 min)
191
-
192
- - Use expansion techniques
193
- - Generate quantity over quality
194
- - Encourage wild ideas
195
-
196
- 3. **Convergent Phase** (15-20 min)
197
-
198
- - Group and categorize ideas
199
- - Identify patterns and themes
200
- - Select promising directions
201
-
202
- 4. **Synthesis Phase** (10-15 min)
203
- - Combine complementary ideas
204
- - Refine and develop concepts
205
- - Prepare summary of insights
206
-
207
- ### 5. Output Format
208
-
209
- [[LLM: Present brainstorming results in an organized, actionable format.]]
210
-
211
- **Session Summary:**
212
-
213
- - Techniques used
214
- - Number of ideas generated
215
- - Key themes identified
216
-
217
- **Idea Categories:**
218
-
219
- 1. **Immediate Opportunities** - Ideas that could be implemented now
220
- 2. **Future Innovations** - Ideas requiring more development
221
- 3. **Moonshots** - Ambitious, transformative ideas
222
- 4. **Insights & Learnings** - Key realizations from the session
223
-
224
- **Next Steps:**
225
-
226
- - Which ideas to explore further
227
- - Recommended follow-up techniques
228
- - Suggested research areas
229
-
230
- ## Important Notes
231
-
232
- - Maintain energy and momentum throughout the session
233
- - Defer judgment - all ideas are valid during generation
234
- - Quantity leads to quality - aim for many ideas
235
- - Build on ideas collaboratively
236
- - Document everything - even "silly" ideas can spark breakthroughs
237
- - Take breaks if energy flags
238
- - End with clear next actions
@@ -1,74 +0,0 @@
1
- # Core Dump Task
2
-
3
- ## Purpose
4
-
5
- To create a concise memory recording file (`.ai/core-dump-n.md`) that captures the essential context of the current agent session, enabling seamless continuation of work in future agent sessions. This task ensures persistent context across agent conversations while maintaining minimal token usage for efficient context loading.
6
-
7
- ## Inputs for this Task
8
-
9
- - Current session conversation history and accomplishments
10
- - Files created, modified, or deleted during the session
11
- - Key decisions made and procedures followed
12
- - Current project state and next logical steps
13
- - User requests and agent responses that shaped the session
14
-
15
- ## Task Execution Instructions
16
-
17
- ### 0. Check Existing Core Dump
18
-
19
- Before proceeding, check if `.ai/core-dump.md` already exists:
20
-
21
- - If file exists, ask user: "Core dump file exists. Should I: 1. Overwrite, 2. Update, 3. Append or 4. Create new?"
22
- - **Overwrite**: Replace entire file with new content
23
- - **Update**: Merge new session info with existing content, updating relevant sections
24
- - **Append**: Add new session as a separate entry while preserving existing content
25
- - **Create New**: Create a new file, appending the next possible -# to the file, such as core-dump-3.md if 1 and 2 already exist.
26
- - If file doesn't exist, proceed with creation of `core-dump-1.md`
27
-
28
- ### 1. Analyze Session Context
29
-
30
- - Review the entire conversation to identify key accomplishments
31
- - Note any specific tasks, procedures, or workflows that were executed
32
- - Identify important decisions made or problems solved
33
- - Capture the user's working style and preferences observed during the session
34
-
35
- ### 2. Document What Was Accomplished
36
-
37
- - **Primary Actions**: List the main tasks completed concisely
38
- - **Story Progress**: For story work, use format "Tasks Complete: 1-6, 8. Next Task Pending: 7, 9"
39
- - **Problem Solving**: Document any challenges encountered and how they were resolved
40
- - **User Communications**: Summarize key user requests, preferences, and discussion points
41
-
42
- ### 3. Record File System Changes (Concise Format)
43
-
44
- - **Files Created**: `filename.ext` (brief purpose/size)
45
- - **Files Modified**: `filename.ext` (what changed)
46
- - **Files Deleted**: `filename.ext` (why removed)
47
- - Focus on essential details, avoid verbose descriptions
48
-
49
- ### 4. Capture Current Project State
50
-
51
- - **Project Progress**: Where the project stands after this session
52
- - **Current Issues**: Any blockers or problems that need resolution
53
- - **Next Logical Steps**: What would be the natural next actions to take
54
-
55
- ### 5. Create/Update Core Dump File
56
-
57
- Based on user's choice from step 0, handle the file accordingly:
58
-
59
- ### 6. Optimize for Minimal Context
60
-
61
- - Keep descriptions concise but informative
62
- - Use abbreviated formats where possible (file sizes, task numbers)
63
- - Focus on actionable information rather than detailed explanations
64
- - Avoid redundant information that can be found in project documentation
65
- - Prioritize information that would be lost without this recording
66
- - Ensure the file can be quickly scanned and understood
67
-
68
- ### 7. Validate Completeness
69
-
70
- - Verify all significant session activities are captured
71
- - Ensure a future agent could understand the current state
72
- - Check that file changes are accurately recorded
73
- - Confirm next steps are clear and actionable
74
- - Verify user communication style and preferences are noted
@@ -1,202 +0,0 @@
1
- # Create Agent Task
2
-
3
- This task guides you through creating a new BMAD agent following the standard template.
4
-
5
- ## Prerequisites
6
-
7
- - Agent template: `.bmad-core/templates/agent-tmpl.md`
8
- - Target directory: `.bmad-core/agents/`
9
-
10
- ## Steps
11
-
12
- ### 1. Gather Agent Information
13
-
14
- Collect the following information from the user:
15
-
16
- - **Agent ID**: Unique identifier (lowercase, hyphens allowed, e.g., `data-analyst`)
17
- - **Agent Name**: Display name (e.g., `Data Analyst`)
18
- - **Agent Title**: Professional title (e.g., `Data Analysis Specialist`)
19
- - **Role Description**: Brief description of the agent's primary role
20
- - **Communication Style**: How the agent communicates (e.g., `analytical, data-driven, clear`)
21
- - **Identity**: Detailed description of who this agent is
22
- - **Focus Areas**: Primary areas of expertise and focus
23
- - **Core Principles**: 3-5 guiding principles for the agent
24
- - **Customization**: Optional specific behaviors or overrides
25
-
26
- ### 2. Define Agent Capabilities
27
-
28
- **IMPORTANT**:
29
-
30
- - If your agent will perform any actions → You MUST create corresponding tasks in `.bmad-core/tasks/`
31
- - If your agent will create any documents → You MUST create templates in `.bmad-core/templates/` AND include the `create-doc` task
32
-
33
- Determine:
34
-
35
- - **Custom Commands**: Agent-specific commands beyond the defaults
36
- - **Required Tasks**: Tasks from `.bmad-core/tasks/` the agent needs
37
- - For any action the agent performs, a corresponding task file must exist
38
- - Always include `create-doc` if the agent creates any documents
39
- - **Required Templates**: Templates from `.bmad-core/templates/` the agent uses
40
- - For any document the agent can create, a template must exist
41
- - **Required Checklists**: Checklists the agent references
42
- - **Required Data**: Data files the agent needs access to
43
- - **Required Utils**: Utility files the agent uses
44
-
45
- ### 3. Handle Missing Dependencies
46
-
47
- **Protocol for Missing Tasks/Templates:**
48
-
49
- 1. Check if each required task/template exists
50
- 2. For any missing items:
51
- - Create a basic version following the appropriate template
52
- - Track what was created in a list
53
- 3. Continue with agent creation
54
- 4. At the end, present a summary of all created items
55
-
56
- **Track Created Items:**
57
-
58
- ```
59
- Created during agent setup:
60
- - Tasks:
61
- - [ ] task-name-1.md
62
- - [ ] task-name-2.md
63
- - Templates:
64
- - [ ] template-name-1.md
65
- - [ ] template-name-2.md
66
- ```
67
-
68
- ### 4. Create Agent File
69
-
70
- 1. Copy the template from `.bmad-core/templates/agent-tmpl.md`
71
- 2. Replace all placeholders with gathered information:
72
-
73
- - `[AGENT_ID]` → agent id
74
- - `[AGENT_NAME]` → agent name
75
- - `[AGENT_TITLE]` → agent title
76
- - `[AGENT_ROLE_DESCRIPTION]` → role description
77
- - `[COMMUNICATION_STYLE]` → communication style
78
- - `[AGENT_IDENTITY_DESCRIPTION]` → identity description
79
- - `[PRIMARY_FOCUS_AREAS]` → focus areas
80
- - `[PRINCIPLE_X]` → core principles
81
- - `[OPTIONAL_CUSTOMIZATION]` → customization (or remove if none)
82
- - `[DEFAULT_MODE_DESCRIPTION]` → description of default chat mode
83
- - `[STARTUP_INSTRUCTIONS]` → what the agent should do on activation
84
- - Add custom commands, tasks, templates, etc.
85
-
86
- 3. Save as `.bmad-core/agents/[agent-id].md`
87
-
88
- ### 4. Validate Agent
89
-
90
- Ensure:
91
-
92
- - All placeholders are replaced
93
- - Dependencies (tasks, templates, etc.) actually exist
94
- - Commands are properly formatted
95
- - YAML structure is valid
96
-
97
- ### 5. Build and Test
98
-
99
- 1. Run `npm run build:agents` to include in builds
100
- 2. Test agent activation and commands
101
- 3. Verify all dependencies load correctly
102
-
103
- ### 6. Final Summary
104
-
105
- Present to the user:
106
-
107
- ```
108
- ✅ Agent Created: [agent-name]
109
- Location: .bmad-core/agents/[agent-id].md
110
-
111
- 📝 Dependencies Created:
112
- Tasks:
113
- - ✅ task-1.md - [brief description]
114
- - ✅ task-2.md - [brief description]
115
-
116
- Templates:
117
- - ✅ template-1.md - [brief description]
118
- - ✅ template-2.md - [brief description]
119
-
120
- ⚠️ Next Steps:
121
- 1. Review and customize the created tasks/templates
122
- 2. Run npm run build:agents
123
- 3. Test the agent thoroughly
124
- ```
125
-
126
- ## Template Reference
127
-
128
- The agent template structure:
129
-
130
- - **activation-instructions**: How the AI should interpret the file
131
- - **agent**: Basic agent metadata
132
- - **persona**: Character and behavior definition
133
- - **startup**: Initial actions on activation
134
- - **commands**: Available commands (always include defaults)
135
- - **dependencies**: Required resources organized by type
136
-
137
- ## Example Usage
138
-
139
- ```yaml
140
- agent:
141
- name: Data Analyst
142
- id: data-analyst
143
- title: Data Analysis Specialist
144
-
145
- persona:
146
- role: Expert in data analysis, visualization, and insights extraction
147
- style: analytical, data-driven, clear, methodical
148
- identity: I am a seasoned data analyst who transforms raw data into actionable insights
149
- focus: data exploration, statistical analysis, visualization, reporting
150
-
151
- core_principles:
152
- - Data integrity and accuracy above all
153
- - Clear communication of complex findings
154
- - Actionable insights over raw numbers
155
- ```
156
-
157
- ## Creating Missing Dependencies
158
-
159
- When a required task or template doesn't exist:
160
-
161
- 1. **For Missing Tasks**: Create using `.bmad-core/templates/task-template.md`
162
-
163
- - Name it descriptively (e.g., `analyze-metrics.md`)
164
- - Define clear steps for the action
165
- - Include any required inputs/outputs
166
-
167
- 2. **For Missing Templates**: Create a basic structure
168
-
169
- - Name it descriptively (e.g., `metrics-report-template.md`)
170
- - Include placeholders for expected content
171
- - Add sections relevant to the document type
172
-
173
- 3. **Always Track**: Keep a list of everything created to report at the end
174
-
175
- ## Important Reminders
176
-
177
- ### Tasks and Templates Requirement
178
-
179
- - **Every agent action needs a task**: If an agent can "analyze data", there must be an `analyze-data.md` task
180
- - **Every document type needs a template**: If an agent can create reports, there must be a `report-template.md`
181
- - **Document creation requires**: Both the template AND the `create-doc` task in dependencies
182
-
183
- ### Example Dependencies
184
-
185
- ```yaml
186
- dependencies:
187
- tasks:
188
- - create-doc # Required if agent creates any documents
189
- - analyze-requirements # Custom task for this agent
190
- - generate-report # Another custom task
191
- templates:
192
- - requirements-doc # Template for requirements documents
193
- - analysis-report # Template for analysis reports
194
- ```
195
-
196
- ## Notes
197
-
198
- - Keep agent definitions focused and specific
199
- - Ensure dependencies are minimal and necessary
200
- - Test thoroughly before distribution
201
- - Follow existing agent patterns for consistency
202
- - Remember: No task = agent can't do it, No template = agent can't create it
@@ -1,74 +0,0 @@
1
- # Create Document from Template Task
2
-
3
- ## Purpose
4
-
5
- - Generate documents from any specified template following embedded instructions from the perspective of the selected agent persona
6
-
7
- ## Instructions
8
-
9
- ### 1. Identify Template and Context
10
-
11
- - Determine which template to use (user-provided or list available for selection to user)
12
-
13
- - Agent-specific templates are listed in the agent's dependencies under `templates`. For each template listed, consider it a document the agent can create. So if an agent has:
14
-
15
- @{example}
16
- dependencies:
17
- templates: - prd-tmpl - architecture-tmpl
18
- @{/example}
19
-
20
- You would offer to create "PRD" and "Architecture" documents when the user asks what you can help with.
21
-
22
- - Gather all relevant inputs, or ask for them, or else rely on user providing necessary details to complete the document
23
- - Understand the document purpose and target audience
24
-
25
- ### 2. Determine Interaction Mode
26
-
27
- Confirm with the user their preferred interaction style:
28
-
29
- - **Incremental:** Work through chunks of the document.
30
- - **YOLO Mode:** Draft complete document making reasonable assumptions in one shot. (Can be entered also after starting incremental by just typing /yolo)
31
-
32
- ### 3. Execute Template
33
-
34
- - Load specified template from `templates#*` or the /templates directory
35
- - Follow ALL embedded LLM instructions within the template
36
- - Process template markup according to `utils#template-format` conventions
37
-
38
- ### 4. Template Processing Rules
39
-
40
- #### CRITICAL: Never display template markup, LLM instructions, or examples to users
41
-
42
- - Replace all {{placeholders}} with actual content
43
- - Execute all [[LLM: instructions]] internally
44
- - Process `<<REPEAT>>` sections as needed
45
- - Evaluate ^^CONDITION^^ blocks and include only if applicable
46
- - Use @{examples} for guidance but never output them
47
-
48
- ### 5. Content Generation
49
-
50
- - **Incremental Mode**: Present each major section for review before proceeding
51
- - **YOLO Mode**: Generate all sections, then review complete document with user
52
- - Apply any elicitation protocols specified in template
53
- - Incorporate user feedback and iterate as needed
54
-
55
- ### 6. Validation
56
-
57
- If template specifies a checklist:
58
-
59
- - Run the appropriate checklist against completed document
60
- - Document completion status for each item
61
- - Address any deficiencies found
62
- - Present validation summary to user
63
-
64
- ### 7. Final Presentation
65
-
66
- - Present clean, formatted content only
67
- - Ensure all sections are complete
68
- - DO NOT truncate or summarize content
69
- - Begin directly with document content (no preamble)
70
- - Include any handoff prompts specified in template
71
-
72
- ## Important Notes
73
-
74
- - Template markup is for AI processing only - never expose to users