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
@@ -0,0 +1,175 @@
1
+ workflow:
2
+ id: unity-game-prototype
3
+ name: Game Prototype Development (Unity)
4
+ description: Fast-track workflow for rapid game prototyping and concept validation. Optimized for game jams, proof-of-concept development, and quick iteration on game mechanics using Unity and C#.
5
+ type: prototype
6
+ project_types:
7
+ - game-jam
8
+ - proof-of-concept
9
+ - mechanic-test
10
+ - technical-demo
11
+ - learning-project
12
+ - rapid-iteration
13
+ prototype_sequence:
14
+ - step: concept_definition
15
+ agent: game-designer
16
+ duration: 15-30 minutes
17
+ creates: concept-summary.md
18
+ notes: Quickly define core game concept, primary mechanic, and target experience. Focus on what makes this game unique and fun.
19
+ - step: rapid_design
20
+ agent: game-designer
21
+ duration: 30-60 minutes
22
+ creates: prototype-spec.md
23
+ requires: concept-summary.md
24
+ optional_steps:
25
+ - quick_brainstorming
26
+ - reference_research
27
+ notes: Create minimal but complete design specification. Focus on core mechanics, basic controls, and success/failure conditions.
28
+ - step: technical_planning
29
+ agent: game-developer
30
+ duration: 15-30 minutes
31
+ creates: prototype-architecture.md
32
+ requires: prototype-spec.md
33
+ notes: Define minimal technical implementation plan. Identify core Unity systems needed and performance constraints.
34
+ - step: implementation_stories
35
+ agent: game-sm
36
+ duration: 30-45 minutes
37
+ creates: prototype-stories/
38
+ requires: prototype-spec.md, prototype-architecture.md
39
+ notes: Create 3-5 focused implementation stories for core prototype features. Each story should be completable in 2-4 hours.
40
+ - step: iterative_development
41
+ agent: game-developer
42
+ duration: varies
43
+ implements: prototype-stories/
44
+ notes: Implement stories in priority order. Test frequently in the Unity Editor and adjust design based on what feels fun. Document discoveries.
45
+ workflow_end:
46
+ action: prototype_evaluation
47
+ notes: "Prototype complete. Evaluate core mechanics, gather feedback, and decide next steps: iterate, expand, or archive."
48
+ game_jam_sequence:
49
+ - step: jam_concept
50
+ agent: game-designer
51
+ duration: 10-15 minutes
52
+ creates: jam-concept.md
53
+ notes: Define game concept based on jam theme. One sentence core mechanic, basic controls, win condition.
54
+ - step: jam_implementation
55
+ agent: game-developer
56
+ duration: varies (jam timeline)
57
+ creates: working-prototype
58
+ requires: jam-concept.md
59
+ notes: Directly implement core mechanic in Unity. No formal stories - iterate rapidly on what's fun. Document major decisions.
60
+ jam_workflow_end:
61
+ action: jam_submission
62
+ notes: Submit to game jam. Capture lessons learned and consider post-jam development if concept shows promise.
63
+ flow_diagram: |
64
+ ```mermaid
65
+ graph TD
66
+ A[Start: Prototype Project] --> B{Development Context?}
67
+ B -->|Standard Prototype| C[game-designer: concept-summary.md]
68
+ B -->|Game Jam| D[game-designer: jam-concept.md]
69
+
70
+ C --> E[game-designer: prototype-spec.md]
71
+ E --> F[game-developer: prototype-architecture.md]
72
+ F --> G[game-sm: create prototype stories]
73
+ G --> H[game-developer: iterative implementation]
74
+ H --> I[Prototype Evaluation]
75
+
76
+ D --> J[game-developer: direct implementation]
77
+ J --> K[Game Jam Submission]
78
+
79
+ E -.-> E1[Optional: quick brainstorming]
80
+ E -.-> E2[Optional: reference research]
81
+
82
+ style I fill:#90EE90
83
+ style K fill:#90EE90
84
+ style C fill:#FFE4B5
85
+ style E fill:#FFE4B5
86
+ style F fill:#FFE4B5
87
+ style G fill:#FFE4B5
88
+ style H fill:#FFE4B5
89
+ style D fill:#FFB6C1
90
+ style J fill:#FFB6C1
91
+ ```
92
+ decision_guidance:
93
+ use_prototype_sequence_when:
94
+ - Learning new game development concepts
95
+ - Testing specific game mechanics
96
+ - Building portfolio pieces
97
+ - Have 1-7 days for development
98
+ - Need structured but fast development
99
+ - Want to validate game concepts before full development
100
+ use_game_jam_sequence_when:
101
+ - Participating in time-constrained game jams
102
+ - Have 24-72 hours total development time
103
+ - Want to experiment with wild or unusual concepts
104
+ - Learning through rapid iteration
105
+ - Building networking/portfolio presence
106
+ prototype_best_practices:
107
+ scope_management:
108
+ - Start with absolute minimum viable gameplay
109
+ - One core mechanic implemented well beats many mechanics poorly
110
+ - Focus on "game feel" over features
111
+ - Cut features ruthlessly to meet timeline
112
+ rapid_iteration:
113
+ - Test the game every 1-2 hours of development in the Unity Editor
114
+ - Ask "Is this fun?" frequently during development
115
+ - Be willing to pivot mechanics if they don't feel good
116
+ - Document what works and what doesn't
117
+ technical_efficiency:
118
+ - Use simple graphics (geometric shapes, basic sprites)
119
+ - Leverage Unity's built-in components heavily
120
+ - Avoid complex custom systems in prototypes
121
+ - Prioritize functional over polished
122
+ prototype_evaluation_criteria:
123
+ core_mechanic_validation:
124
+ - Is the primary mechanic engaging for 30+ seconds?
125
+ - Do players understand the mechanic without explanation?
126
+ - Does the mechanic have depth for extended play?
127
+ - Are there natural difficulty progression opportunities?
128
+ technical_feasibility:
129
+ - Does the prototype run at acceptable frame rates?
130
+ - Are there obvious technical blockers for expansion?
131
+ - Is the codebase clean enough for further development?
132
+ - Are performance targets realistic for full game?
133
+ player_experience:
134
+ - Do testers engage with the game voluntarily?
135
+ - What emotions does the game create in players?
136
+ - Are players asking for "just one more try"?
137
+ - What do players want to see added or changed?
138
+ post_prototype_options:
139
+ iterate_and_improve:
140
+ action: continue_prototyping
141
+ when: Core mechanic shows promise but needs refinement
142
+ next_steps: Create new prototype iteration focusing on identified improvements
143
+ expand_to_full_game:
144
+ action: transition_to_full_development
145
+ when: Prototype validates strong game concept
146
+ next_steps: Use game-dev-greenfield workflow to create full game design and architecture
147
+ pivot_concept:
148
+ action: new_prototype_direction
149
+ when: Current mechanic doesn't work but insights suggest new direction
150
+ next_steps: Apply learnings to new prototype concept
151
+ archive_and_learn:
152
+ action: document_learnings
153
+ when: Prototype doesn't work but provides valuable insights
154
+ next_steps: Document lessons learned and move to next prototype concept
155
+ time_boxing_guidance:
156
+ concept_phase: Maximum 30 minutes - if you can't explain the game simply, simplify it
157
+ design_phase: Maximum 1 hour - focus on core mechanics only
158
+ planning_phase: Maximum 30 minutes - identify critical path to playable prototype
159
+ implementation_phase: Time-boxed iterations - test every 2-4 hours of work
160
+ success_metrics:
161
+ development_velocity:
162
+ - Playable prototype in first day of development
163
+ - Core mechanic demonstrable within 4-6 hours of coding
164
+ - Major iteration cycles completed in 2-4 hour blocks
165
+ learning_objectives:
166
+ - Clear understanding of what makes the mechanic fun (or not)
167
+ - Technical feasibility assessment for full development
168
+ - Player reaction and engagement validation
169
+ - Design insights for future development
170
+ handoff_prompts:
171
+ concept_to_design: Game concept defined. Create minimal design specification focusing on core mechanics and player experience.
172
+ design_to_technical: Design specification ready. Create technical implementation plan for rapid prototyping.
173
+ technical_to_stories: Technical plan complete. Create focused implementation stories for prototype development.
174
+ stories_to_implementation: Stories ready. Begin iterative implementation with frequent playtesting and design validation.
175
+ prototype_to_evaluation: Prototype playable. Evaluate core mechanics, gather feedback, and determine next development steps.
@@ -2,11 +2,11 @@
2
2
 
3
3
  ## Overview
4
4
 
5
- This expansion pack extends BMAD Method with comprehensive infrastructure and DevOps capabilities. It's designed for teams that need to define, implement, and manage cloud infrastructure alongside their application development.
5
+ This expansion pack extends BMad Method with comprehensive infrastructure and DevOps capabilities. It's designed for teams that need to define, implement, and manage cloud infrastructure alongside their application development.
6
6
 
7
7
  ## Purpose
8
8
 
9
- While the core BMAD flow focuses on getting from business requirements to development (Analyst → PM → Architect → SM → Dev), many projects require sophisticated infrastructure planning and implementation. This expansion pack adds:
9
+ While the core BMad flow focuses on getting from business requirements to development (Analyst → PM → Architect → SM → Dev), many projects require sophisticated infrastructure planning and implementation. This expansion pack adds:
10
10
 
11
11
  - Infrastructure architecture design capabilities
12
12
  - Platform engineering implementation workflows
@@ -28,7 +28,7 @@ Install this expansion pack when your project requires:
28
28
 
29
29
  ### Agents
30
30
 
31
- - `devops.yml` - DevOps and Platform Engineering agent configuration
31
+ - `devops.yaml` - DevOps and Platform Engineering agent configuration
32
32
 
33
33
  ### Personas
34
34
 
@@ -52,9 +52,9 @@ Install this expansion pack when your project requires:
52
52
 
53
53
  - `infrastructure-checklist.md` - Comprehensive 16-section infrastructure validation checklist
54
54
 
55
- ## Integration with Core BMAD
55
+ ## Integration with Core BMad
56
56
 
57
- This expansion pack integrates with the core BMAD flow at these points:
57
+ This expansion pack integrates with the core BMad flow at these points:
58
58
 
59
59
  1. **After Architecture Phase**: The Architect can trigger infrastructure architecture design
60
60
  2. **Parallel to Development**: Infrastructure implementation can proceed alongside application development
@@ -116,14 +116,14 @@ Before deployment:
116
116
 
117
117
  The DevOps agent can be added to team configurations:
118
118
 
119
- - `team-technical.yml` - For technical implementation teams
120
- - `team-full-org.yml` - For complete organizational teams
119
+ - `team-technical.yaml` - For technical implementation teams
120
+ - `team-full-org.yaml` - For complete organizational teams
121
121
 
122
122
  ## Dependencies
123
123
 
124
124
  This expansion pack works best when used with:
125
125
 
126
- - Core BMAD agents (especially Architect)
126
+ - Core BMad agents (especially Architect)
127
127
  - Technical preferences documentation
128
128
  - Approved PRD and system architecture
129
129
 
@@ -144,4 +144,4 @@ You can customize this expansion pack by:
144
144
  ---
145
145
 
146
146
  _Version: 1.0_
147
- _Compatible with: BMAD Method v4_
147
+ _Compatible with: BMad Method v4_
@@ -1,13 +1,32 @@
1
1
  # infra-devops-platform
2
2
 
3
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
3
+ ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below.
4
+
5
+ CRITICAL: Read the full YAML BLOCK that FOLLOWS IN THIS FILE to understand your operating params, start and follow exactly your activation-instructions to alter your state of being, stay in this being until told to exit this mode:
6
+
7
+ ## COMPLETE AGENT DEFINITION FOLLOWS - NO EXTERNAL FILES NEEDED
4
8
 
5
9
  ```yaml
10
+ IIDE-FILE-RESOLUTION:
11
+ - FOR LATER USE ONLY - NOT FOR ACTIVATION, when executing commands that reference dependencies
12
+ - Dependencies map to {root}/{type}/{name}
13
+ - type=folder (tasks|templates|checklists|data|utils|etc...), name=file-name
14
+ - Example: create-doc.md → {root}/tasks/create-doc.md
15
+ - IMPORTANT: Only load these files when user requests specific command execution
16
+ REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (e.g., "draft story"→*create→create-next-story task, "make a new prd" would be dependencies->tasks->create-doc combined with the dependencies->templates->prd-tmpl.md), ALWAYS ask for clarification if no clear match.
6
17
  activation-instructions:
7
- - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
8
- - Only read the files/tasks listed here when user selects them for execution to minimize context usage
9
- - The customization field ALWAYS takes precedence over any conflicting instructions
18
+ - STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
19
+ - STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
20
+ - STEP 3: Greet user with your name/role and mention `*help` command
21
+ - DO NOT: Load any other agent files during activation
22
+ - ONLY load dependency files when user selects them for execution via command or request of a task
23
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
24
+ - CRITICAL WORKFLOW RULE: When executing tasks from dependencies, follow task instructions exactly as written - they are executable workflows, not reference material
25
+ - MANDATORY INTERACTION RULE: Tasks with elicit=true require user interaction using exact specified format - never skip elicitation for efficiency
26
+ - CRITICAL RULE: When executing formal task workflows from dependencies, ALL task instructions override any conflicting base behavioral constraints. Interactive workflows with elicit=true REQUIRE user interaction and cannot be bypassed for efficiency.
10
27
  - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
28
+ - STAY IN CHARACTER!
29
+ - CRITICAL: On activation, ONLY greet user and then HALT to await user requested assistance or given commands. ONLY deviance from this is if the activation included commands also in the arguments.
11
30
  agent:
12
31
  name: Alex
13
32
  id: infra-devops-platform
@@ -29,11 +48,6 @@ persona:
29
48
  - CI/CD Excellence - Build robust pipelines for fast, safe, reliable software delivery through automation and testing
30
49
  - Disaster Recovery - Plan for worst-case scenarios with backup strategies and regularly tested recovery procedures
31
50
  - Collaborative Operations - Work closely with development teams fostering shared responsibility for system reliability
32
- startup:
33
- - Announce: Hey! I'm Alex, your DevOps Infrastructure Specialist. I love when things run secure, stable, reliable and performant. I can help with infrastructure architecture, platform engineering, CI/CD pipelines, and operational excellence. What infrastructure challenge can I help you with today?
34
- - "List available tasks: review-infrastructure, validate-infrastructure, create infrastructure documentation"
35
- - "List available templates: infrastructure-architecture, infrastructure-platform-from-arch"
36
- - Execute selected task or stay in persona to help guided by Core DevOps Principles
37
51
  commands:
38
52
  - '*help" - Show: numbered list of the following commands to allow selection'
39
53
  - '*chat-mode" - (Default) Conversational mode for infrastructure and DevOps guidance'
@@ -44,16 +58,14 @@ commands:
44
58
  - '*exit" - Say goodbye as Alex, the DevOps Infrastructure Specialist, and then abandon inhabiting this persona'
45
59
  dependencies:
46
60
  tasks:
47
- - create-doc
48
- - review-infrastructure
49
- - validate-infrastructure
61
+ - create-doc.md
62
+ - review-infrastructure.md
63
+ - validate-infrastructure.md
50
64
  templates:
51
- - infrastructure-architecture-tmpl
52
- - infrastructure-platform-from-arch-tmpl
65
+ - infrastructure-architecture-tmpl.yaml
66
+ - infrastructure-platform-from-arch-tmpl.yaml
53
67
  checklists:
54
- - infrastructure-checklist
68
+ - infrastructure-checklist.md
55
69
  data:
56
- - technical-preferences
57
- utils:
58
- - template-format
70
+ - technical-preferences.md
59
71
  ```
@@ -270,7 +270,7 @@ This checklist serves as a comprehensive framework for validating infrastructure
270
270
  - [ ] Business stakeholders informed of changes
271
271
  - [ ] Feedback loops established for continuous improvement
272
272
 
273
- ## 11. BMAD WORKFLOW INTEGRATION
273
+ ## 11. BMad WORKFLOW INTEGRATION
274
274
 
275
275
  ### 11.1 Development Agent Alignment
276
276
 
@@ -0,0 +1,9 @@
1
+ name: bmad-infrastructure-devops
2
+ version: 1.11.0
3
+ short-title: Infrastructure DevOps Pack
4
+ description: >-
5
+ This expansion pack extends BMad Method with comprehensive infrastructure and
6
+ DevOps capabilities. It's designed for teams that need to define, implement,
7
+ and manage cloud infrastructure alongside their application development.
8
+ author: Brian (BMad)
9
+ slashPrefix: bmadInfraDevOps
@@ -0,0 +1,305 @@
1
+ # BMad Infrastructure DevOps Expansion Pack Knowledge Base
2
+
3
+ ## Overview
4
+
5
+ The BMad Infrastructure DevOps expansion pack extends the BMad Method framework with comprehensive infrastructure and DevOps capabilities. It enables teams to design, implement, validate, and maintain modern cloud-native infrastructure alongside their application development efforts.
6
+
7
+ **Version**: 1.7.0
8
+ **BMad Compatibility**: v4+
9
+ **Author**: Brian (BMad)
10
+
11
+ ## Core Purpose
12
+
13
+ This expansion pack addresses the critical need for systematic infrastructure planning and implementation in modern software projects. It provides:
14
+
15
+ - Structured approach to infrastructure architecture design
16
+ - Platform engineering implementation guidance
17
+ - Comprehensive validation and review processes
18
+ - Integration with core BMad development workflows
19
+ - Support for cloud-native and traditional infrastructure patterns
20
+
21
+ ## When to Use This Expansion Pack
22
+
23
+ Use the BMad Infrastructure DevOps expansion pack when your project involves:
24
+
25
+ - **Cloud Infrastructure Design**: AWS, Azure, GCP, or multi-cloud architectures
26
+ - **Kubernetes and Container Orchestration**: Container platform design and implementation
27
+ - **Infrastructure as Code**: Terraform, CloudFormation, Pulumi implementations
28
+ - **GitOps Workflows**: ArgoCD, Flux, or similar continuous deployment patterns
29
+ - **Platform Engineering**: Building internal developer platforms and self-service capabilities
30
+ - **Service Mesh Implementation**: Istio, Linkerd, or similar service mesh architectures
31
+ - **DevOps Transformation**: Establishing or improving DevOps practices and culture
32
+
33
+ ## Key Components
34
+
35
+ ### 1. DevOps Agent: Alex
36
+
37
+ **Role**: DevOps Infrastructure Specialist
38
+ **Experience**: 15+ years in infrastructure and platform engineering
39
+
40
+ **Core Principles**:
41
+
42
+ - Infrastructure as Code (IaC) First
43
+ - Automation and Repeatability
44
+ - Reliability and Scalability
45
+ - Security by Design
46
+ - Cost Optimization
47
+ - Developer Experience Focus
48
+
49
+ **Commands**:
50
+
51
+ - `*help` - Display available commands and capabilities
52
+ - `*chat-mode` - Interactive conversation mode for infrastructure discussions
53
+ - `*create-doc` - Generate infrastructure documentation from templates
54
+ - `*review-infrastructure` - Conduct systematic infrastructure review
55
+ - `*validate-infrastructure` - Validate infrastructure against comprehensive checklist
56
+ - `*checklist` - Access the 16-section infrastructure validation checklist
57
+ - `*exit` - Return to normal context
58
+
59
+ ### 2. Infrastructure Templates
60
+
61
+ #### Infrastructure Architecture Template
62
+
63
+ **Purpose**: Design comprehensive infrastructure architecture
64
+ **Key Sections**:
65
+
66
+ - Infrastructure Overview (providers, regions, environments)
67
+ - Infrastructure as Code approach and tooling
68
+ - Network Architecture with visual diagrams
69
+ - Compute Resources planning
70
+ - Security Architecture design
71
+ - Monitoring and Observability strategy
72
+ - CI/CD Pipeline architecture
73
+ - Disaster Recovery planning
74
+ - BMad Integration points
75
+
76
+ #### Platform Implementation Template
77
+
78
+ **Purpose**: Implement platform infrastructure based on approved architecture
79
+ **Key Sections**:
80
+
81
+ - Foundation Infrastructure Layer
82
+ - Container Platform (Kubernetes) setup
83
+ - GitOps Workflow implementation
84
+ - Service Mesh configuration
85
+ - Developer Experience Platform
86
+ - Security hardening procedures
87
+ - Platform validation and testing
88
+
89
+ ### 3. Tasks
90
+
91
+ #### Review Infrastructure Task
92
+
93
+ **Purpose**: Systematic infrastructure review process
94
+ **Features**:
95
+
96
+ - Incremental or rapid assessment modes
97
+ - Architectural escalation for complex issues
98
+ - Advanced elicitation for deep analysis
99
+ - Prioritized findings and recommendations
100
+ - Integration with BMad Architecture phase
101
+
102
+ #### Validate Infrastructure Task
103
+
104
+ **Purpose**: Comprehensive infrastructure validation
105
+ **Features**:
106
+
107
+ - 16-section validation checklist
108
+ - Architecture Design Review Gate
109
+ - Compliance percentage tracking
110
+ - Remediation planning
111
+ - BMad integration assessment
112
+
113
+ ### 4. Infrastructure Validation Checklist
114
+
115
+ A comprehensive 16-section checklist covering:
116
+
117
+ **Foundation Infrastructure (Sections 1-12)**:
118
+
119
+ 1. Security Foundation - IAM, encryption, compliance
120
+ 2. Infrastructure as Code - Version control, testing, documentation
121
+ 3. Resilience & High Availability - Multi-AZ, failover, SLAs
122
+ 4. Backup & Disaster Recovery - Strategies, testing, RTO/RPO
123
+ 5. Monitoring & Observability - Metrics, logging, alerting
124
+ 6. Performance & Scalability - Auto-scaling, load testing
125
+ 7. Infrastructure Operations - Patching, maintenance, runbooks
126
+ 8. CI/CD Infrastructure - Pipelines, environments, deployments
127
+ 9. Networking & Connectivity - Architecture, security, DNS
128
+ 10. Compliance & Governance - Standards, auditing, policies
129
+ 11. BMad Integration - Agent support, workflow alignment
130
+ 12. Architecture Documentation - Diagrams, decisions, maintenance
131
+
132
+ **Platform Engineering (Sections 13-16)**: 13. Container Platform - Kubernetes setup, RBAC, networking 14. GitOps Workflows - Repository structure, deployment patterns 15. Service Mesh - Traffic management, security, observability 16. Developer Experience - Self-service, documentation, tooling
133
+
134
+ ## Integration with BMad Flow
135
+
136
+ ### Workflow Integration Points
137
+
138
+ 1. **After Architecture Phase**: Infrastructure design begins after application architecture is defined
139
+ 2. **Parallel to Development**: Infrastructure implementation runs alongside application development
140
+ 3. **Before Production**: Infrastructure validation gates before production deployment
141
+ 4. **Continuous Operation**: Ongoing infrastructure reviews and improvements
142
+
143
+ ### Agent Collaboration
144
+
145
+ - **With Architect (Sage)**: Joint planning sessions, design reviews, architectural alignment
146
+ - **With Developer (Blake)**: Platform capabilities, development environment setup
147
+ - **With Product Manager (Finley)**: Infrastructure requirements, cost considerations
148
+ - **With Creator Agents**: Infrastructure for creative workflows and asset management
149
+
150
+ ## Best Practices
151
+
152
+ ### Infrastructure Design
153
+
154
+ 1. **Start with Requirements**: Understand application needs before designing infrastructure
155
+ 2. **Design for Scale**: Plan for 10x growth from day one
156
+ 3. **Security First**: Implement defense in depth at every layer
157
+ 4. **Cost Awareness**: Balance performance with budget constraints
158
+ 5. **Document Everything**: Maintain comprehensive documentation
159
+
160
+ ### Implementation Approach
161
+
162
+ 1. **Incremental Rollout**: Deploy infrastructure in stages with validation gates
163
+ 2. **Automation Focus**: Automate repetitive tasks and deployments
164
+ 3. **Testing Strategy**: Include infrastructure testing in CI/CD pipelines
165
+ 4. **Monitoring Setup**: Implement observability before production
166
+ 5. **Team Training**: Ensure team understanding of infrastructure
167
+
168
+ ### Validation Process
169
+
170
+ 1. **Regular Reviews**: Schedule periodic infrastructure assessments
171
+ 2. **Checklist Compliance**: Maintain high compliance with validation checklist
172
+ 3. **Performance Baselines**: Establish and monitor performance metrics
173
+ 4. **Security Audits**: Regular security assessments and penetration testing
174
+ 5. **Cost Optimization**: Monthly cost reviews and optimization
175
+
176
+ ## Common Use Cases
177
+
178
+ ### 1. New Project Infrastructure
179
+
180
+ **Scenario**: Starting a new cloud-native application
181
+ **Process**:
182
+
183
+ 1. Use Infrastructure Architecture template for design
184
+ 2. Review with Architect agent
185
+ 3. Implement using Platform Implementation template
186
+ 4. Validate with comprehensive checklist
187
+ 5. Deploy incrementally with monitoring
188
+
189
+ ### 2. Infrastructure Modernization
190
+
191
+ **Scenario**: Migrating legacy infrastructure to cloud
192
+ **Process**:
193
+
194
+ 1. Review existing infrastructure
195
+ 2. Design target architecture
196
+ 3. Plan migration phases
197
+ 4. Implement with validation gates
198
+ 5. Monitor and optimize
199
+
200
+ ### 3. Platform Engineering Initiative
201
+
202
+ **Scenario**: Building internal developer platform
203
+ **Process**:
204
+
205
+ 1. Assess developer needs
206
+ 2. Design platform architecture
207
+ 3. Implement Kubernetes/GitOps foundation
208
+ 4. Build self-service capabilities
209
+ 5. Enable developer adoption
210
+
211
+ ### 4. Multi-Cloud Strategy
212
+
213
+ **Scenario**: Implementing multi-cloud architecture
214
+ **Process**:
215
+
216
+ 1. Define cloud strategy and requirements
217
+ 2. Design cloud-agnostic architecture
218
+ 3. Implement with IaC abstraction
219
+ 4. Validate cross-cloud functionality
220
+ 5. Establish unified monitoring
221
+
222
+ ## Advanced Features
223
+
224
+ ### GitOps Workflows
225
+
226
+ - **Repository Structure**: Organized by environment and application
227
+ - **Deployment Patterns**: Progressive delivery, canary deployments
228
+ - **Secret Management**: External secrets operator integration
229
+ - **Policy Enforcement**: OPA/Gatekeeper for compliance
230
+
231
+ ### Service Mesh Capabilities
232
+
233
+ - **Traffic Management**: Load balancing, circuit breaking, retries
234
+ - **Security**: mTLS, authorization policies
235
+ - **Observability**: Distributed tracing, service maps
236
+ - **Multi-Cluster**: Cross-cluster communication
237
+
238
+ ### Developer Self-Service
239
+
240
+ - **Portal Features**: Resource provisioning, environment management
241
+ - **API Gateway**: Centralized API management
242
+ - **Documentation**: Automated API docs, runbooks
243
+ - **Tooling**: CLI tools, IDE integrations
244
+
245
+ ## Troubleshooting Guide
246
+
247
+ ### Common Issues
248
+
249
+ 1. **Infrastructure Drift**
250
+ - Solution: Implement drift detection in IaC pipelines
251
+ - Prevention: Restrict manual changes, enforce GitOps
252
+
253
+ 2. **Cost Overruns**
254
+ - Solution: Implement cost monitoring and alerts
255
+ - Prevention: Resource tagging, budget limits
256
+
257
+ 3. **Performance Problems**
258
+ - Solution: Review monitoring data, scale resources
259
+ - Prevention: Load testing, capacity planning
260
+
261
+ 4. **Security Vulnerabilities**
262
+ - Solution: Immediate patching, security reviews
263
+ - Prevention: Automated scanning, compliance checks
264
+
265
+ ## Metrics and KPIs
266
+
267
+ ### Infrastructure Metrics
268
+
269
+ - **Availability**: Target 99.9%+ uptime
270
+ - **Performance**: Response time < 100ms
271
+ - **Cost Efficiency**: Cost per transaction trending down
272
+ - **Security**: Zero critical vulnerabilities
273
+ - **Automation**: 90%+ automated deployments
274
+
275
+ ### Platform Metrics
276
+
277
+ - **Developer Satisfaction**: NPS > 50
278
+ - **Self-Service Adoption**: 80%+ platform usage
279
+ - **Deployment Frequency**: Multiple per day
280
+ - **Lead Time**: < 1 hour from commit to production
281
+ - **MTTR**: < 30 minutes for incidents
282
+
283
+ ## Future Enhancements
284
+
285
+ ### Planned Features
286
+
287
+ 1. **AI-Driven Optimization**: Automated infrastructure tuning
288
+ 2. **Enhanced Security**: Zero-trust architecture templates
289
+ 3. **Edge Computing**: Support for edge infrastructure patterns
290
+ 4. **Sustainability**: Carbon footprint optimization
291
+ 5. **Advanced Compliance**: Industry-specific compliance templates
292
+
293
+ ### Integration Roadmap
294
+
295
+ 1. **Cloud Provider APIs**: Direct integration with AWS, Azure, GCP
296
+ 2. **IaC Tools**: Native support for Terraform, Pulumi
297
+ 3. **Monitoring Platforms**: Integration with Datadog, New Relic
298
+ 4. **Security Tools**: SIEM and vulnerability scanner integration
299
+ 5. **Cost Management**: FinOps platform integration
300
+
301
+ ## Conclusion
302
+
303
+ The BMad Infrastructure DevOps expansion pack provides a comprehensive framework for modern infrastructure and platform engineering. By following its structured approach and leveraging the provided tools and templates, teams can build reliable, scalable, and secure infrastructure that accelerates application delivery while maintaining operational excellence.
304
+
305
+ For support and updates, refer to the main BMad Method documentation or contact the BMad community.
@@ -32,7 +32,6 @@ To conduct a thorough review of existing infrastructure to identify improvement
32
32
  ### 3. Conduct Systematic Review
33
33
 
34
34
  - **If "Incremental Mode" was selected:**
35
-
36
35
  - For each section of the infrastructure checklist:
37
36
  - **a. Present Section Focus:** Explain what aspects of infrastructure this section reviews
38
37
  - **b. Work Through Items:** Examine each checklist item against current infrastructure
@@ -55,13 +54,13 @@ To conduct a thorough review of existing infrastructure to identify improvement
55
54
  - Create an improvement roadmap with suggested timelines
56
55
  - Highlight cost optimization opportunities
57
56
 
58
- ### 5. BMAD Integration Assessment
57
+ ### 5. BMad Integration Assessment
59
58
 
60
- - Evaluate how current infrastructure supports other BMAD agents:
59
+ - Evaluate how current infrastructure supports other BMad agents:
61
60
  - **Development Support:** Assess how infrastructure enables Frontend Dev (Mira), Backend Dev (Enrique), and Full Stack Dev workflows
62
61
  - **Product Alignment:** Verify infrastructure supports PRD requirements from Product Owner (Oli)
63
62
  - **Architecture Compliance:** Check if implementation follows Architect (Alphonse) decisions
64
- - Document any gaps in BMAD integration
63
+ - Document any gaps in BMad integration
65
64
 
66
65
  ### 6. Architectural Escalation Assessment
67
66
 
@@ -133,7 +132,7 @@ A comprehensive infrastructure review report that includes:
133
132
  2. **Prioritized findings** with severity ratings
134
133
  3. **Detailed recommendations** with effort/impact estimates
135
134
  4. **Cost optimization opportunities**
136
- 5. **BMAD integration assessment**
135
+ 5. **BMad integration assessment**
137
136
  6. **Architectural escalation assessment** with clear escalation recommendations
138
137
  7. **Action plan** for critical improvements and architectural work
139
138
  8. **Escalation documentation** for Architect Agent collaboration (if applicable)