bmad-method 4.37.0 → 4.39.0

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 (251) hide show
  1. package/.github/ISSUE_TEMPLATE/bug_report.md +3 -3
  2. package/.github/ISSUE_TEMPLATE/feature_request.md +3 -3
  3. package/.github/workflows/discord.yaml +11 -2
  4. package/.github/workflows/format-check.yaml +42 -0
  5. package/.github/workflows/manual-release.yaml +173 -0
  6. package/.husky/pre-commit +3 -0
  7. package/.vscode/settings.json +26 -1
  8. package/CHANGELOG.md +2 -23
  9. package/README.md +2 -0
  10. package/bmad-core/agent-teams/team-all.yaml +1 -1
  11. package/bmad-core/agents/analyst.md +16 -15
  12. package/bmad-core/agents/architect.md +11 -11
  13. package/bmad-core/agents/bmad-master.md +23 -22
  14. package/bmad-core/agents/bmad-orchestrator.md +13 -17
  15. package/bmad-core/agents/dev.md +14 -11
  16. package/bmad-core/agents/pm.md +15 -14
  17. package/bmad-core/agents/po.md +9 -8
  18. package/bmad-core/agents/qa.md +42 -22
  19. package/bmad-core/agents/sm.md +7 -6
  20. package/bmad-core/agents/ux-expert.md +6 -5
  21. package/bmad-core/core-config.yaml +2 -0
  22. package/bmad-core/data/bmad-kb.md +1 -1
  23. package/bmad-core/data/test-levels-framework.md +146 -0
  24. package/bmad-core/data/test-priorities-matrix.md +172 -0
  25. package/bmad-core/tasks/apply-qa-fixes.md +148 -0
  26. package/bmad-core/tasks/facilitate-brainstorming-session.md +1 -1
  27. package/bmad-core/tasks/nfr-assess.md +343 -0
  28. package/bmad-core/tasks/qa-gate.md +161 -0
  29. package/bmad-core/tasks/review-story.md +234 -74
  30. package/bmad-core/tasks/risk-profile.md +353 -0
  31. package/bmad-core/tasks/test-design.md +174 -0
  32. package/bmad-core/tasks/trace-requirements.md +264 -0
  33. package/bmad-core/templates/architecture-tmpl.yaml +49 -49
  34. package/bmad-core/templates/brainstorming-output-tmpl.yaml +5 -5
  35. package/bmad-core/templates/brownfield-architecture-tmpl.yaml +31 -31
  36. package/bmad-core/templates/brownfield-prd-tmpl.yaml +13 -13
  37. package/bmad-core/templates/competitor-analysis-tmpl.yaml +19 -6
  38. package/bmad-core/templates/front-end-architecture-tmpl.yaml +21 -9
  39. package/bmad-core/templates/front-end-spec-tmpl.yaml +24 -24
  40. package/bmad-core/templates/fullstack-architecture-tmpl.yaml +122 -104
  41. package/bmad-core/templates/market-research-tmpl.yaml +2 -2
  42. package/bmad-core/templates/prd-tmpl.yaml +9 -9
  43. package/bmad-core/templates/project-brief-tmpl.yaml +4 -4
  44. package/bmad-core/templates/qa-gate-tmpl.yaml +102 -0
  45. package/bmad-core/templates/story-tmpl.yaml +12 -12
  46. package/bmad-core/workflows/brownfield-fullstack.yaml +9 -9
  47. package/bmad-core/workflows/brownfield-service.yaml +1 -1
  48. package/bmad-core/workflows/brownfield-ui.yaml +1 -1
  49. package/bmad-core/workflows/greenfield-fullstack.yaml +1 -1
  50. package/bmad-core/workflows/greenfield-service.yaml +1 -1
  51. package/bmad-core/workflows/greenfield-ui.yaml +1 -1
  52. package/common/utils/bmad-doc-template.md +5 -5
  53. package/dist/agents/analyst.txt +1086 -1079
  54. package/dist/agents/architect.txt +1534 -1526
  55. package/dist/agents/bmad-master.txt +646 -632
  56. package/dist/agents/bmad-orchestrator.txt +40 -18
  57. package/dist/agents/dev.txt +158 -19
  58. package/dist/agents/pm.txt +1082 -1107
  59. package/dist/agents/po.txt +314 -332
  60. package/dist/agents/qa.txt +1754 -151
  61. package/dist/agents/sm.txt +88 -98
  62. package/dist/agents/ux-expert.txt +80 -87
  63. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +109 -146
  64. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +75 -86
  65. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +41 -48
  66. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +1903 -1941
  67. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.txt +15 -50
  68. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt +149 -195
  69. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.txt +0 -15
  70. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.txt +20 -37
  71. package/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt +2660 -2752
  72. package/dist/expansion-packs/bmad-creative-writing/agents/beta-reader.txt +871 -0
  73. package/dist/expansion-packs/bmad-creative-writing/agents/book-critic.txt +78 -0
  74. package/dist/expansion-packs/bmad-creative-writing/agents/character-psychologist.txt +839 -0
  75. package/dist/expansion-packs/bmad-creative-writing/agents/cover-designer.txt +85 -0
  76. package/dist/expansion-packs/bmad-creative-writing/agents/dialog-specialist.txt +861 -0
  77. package/dist/expansion-packs/bmad-creative-writing/agents/editor.txt +796 -0
  78. package/dist/expansion-packs/bmad-creative-writing/agents/genre-specialist.txt +927 -0
  79. package/dist/expansion-packs/bmad-creative-writing/agents/narrative-designer.txt +842 -0
  80. package/dist/expansion-packs/bmad-creative-writing/agents/plot-architect.txt +1126 -0
  81. package/dist/expansion-packs/bmad-creative-writing/agents/world-builder.txt +864 -0
  82. package/dist/expansion-packs/bmad-creative-writing/teams/agent-team.txt +5917 -0
  83. package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +25 -27
  84. package/dist/teams/team-all.txt +5541 -3768
  85. package/dist/teams/team-fullstack.txt +3014 -2987
  86. package/dist/teams/team-ide-minimal.txt +2219 -469
  87. package/dist/teams/team-no-ui.txt +2993 -2966
  88. package/docs/enhanced-ide-development-workflow.md +220 -15
  89. package/docs/user-guide.md +271 -18
  90. package/docs/versioning-and-releases.md +122 -44
  91. package/docs/working-in-the-brownfield.md +264 -31
  92. package/eslint.config.mjs +119 -0
  93. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.md +4 -4
  94. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.md +1 -1
  95. package/expansion-packs/bmad-2d-phaser-game-dev/config.yaml +1 -1
  96. package/expansion-packs/bmad-2d-phaser-game-dev/data/development-guidelines.md +26 -28
  97. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-architecture-tmpl.yaml +50 -50
  98. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-brief-tmpl.yaml +23 -23
  99. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-design-doc-tmpl.yaml +24 -24
  100. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-story-tmpl.yaml +42 -42
  101. package/expansion-packs/bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.yaml +65 -65
  102. package/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-dev-greenfield.yaml +5 -5
  103. package/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-prototype.yaml +1 -1
  104. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.md +3 -3
  105. package/expansion-packs/bmad-2d-unity-game-dev/config.yaml +1 -1
  106. package/expansion-packs/bmad-2d-unity-game-dev/data/bmad-kb.md +1 -1
  107. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-brief-tmpl.yaml +23 -23
  108. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-design-doc-tmpl.yaml +63 -63
  109. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-story-tmpl.yaml +20 -20
  110. package/expansion-packs/bmad-2d-unity-game-dev/templates/level-design-doc-tmpl.yaml +65 -65
  111. package/expansion-packs/bmad-2d-unity-game-dev/workflows/game-dev-greenfield.yaml +5 -5
  112. package/expansion-packs/bmad-2d-unity-game-dev/workflows/game-prototype.yaml +1 -1
  113. package/expansion-packs/bmad-creative-writing/README.md +132 -0
  114. package/expansion-packs/bmad-creative-writing/agent-teams/agent-team.yaml +19 -0
  115. package/expansion-packs/bmad-creative-writing/agents/beta-reader.md +91 -0
  116. package/expansion-packs/bmad-creative-writing/agents/book-critic.md +35 -0
  117. package/expansion-packs/bmad-creative-writing/agents/character-psychologist.md +90 -0
  118. package/expansion-packs/bmad-creative-writing/agents/cover-designer.md +41 -0
  119. package/expansion-packs/bmad-creative-writing/agents/dialog-specialist.md +89 -0
  120. package/expansion-packs/bmad-creative-writing/agents/editor.md +90 -0
  121. package/expansion-packs/bmad-creative-writing/agents/genre-specialist.md +92 -0
  122. package/expansion-packs/bmad-creative-writing/agents/narrative-designer.md +90 -0
  123. package/expansion-packs/bmad-creative-writing/agents/plot-architect.md +92 -0
  124. package/expansion-packs/bmad-creative-writing/agents/world-builder.md +91 -0
  125. package/expansion-packs/bmad-creative-writing/checklists/beta-feedback-closure-checklist.md +16 -0
  126. package/expansion-packs/bmad-creative-writing/checklists/character-consistency-checklist.md +16 -0
  127. package/expansion-packs/bmad-creative-writing/checklists/comedic-timing-checklist.md +16 -0
  128. package/expansion-packs/bmad-creative-writing/checklists/cyberpunk-aesthetic-checklist.md +16 -0
  129. package/expansion-packs/bmad-creative-writing/checklists/ebook-formatting-checklist.md +15 -0
  130. package/expansion-packs/bmad-creative-writing/checklists/epic-poetry-meter-checklist.md +16 -0
  131. package/expansion-packs/bmad-creative-writing/checklists/fantasy-magic-system-checklist.md +16 -0
  132. package/expansion-packs/bmad-creative-writing/checklists/foreshadowing-payoff-checklist.md +15 -0
  133. package/expansion-packs/bmad-creative-writing/checklists/genre-tropes-checklist.md +15 -0
  134. package/expansion-packs/bmad-creative-writing/checklists/historical-accuracy-checklist.md +16 -0
  135. package/expansion-packs/bmad-creative-writing/checklists/horror-suspense-checklist.md +16 -0
  136. package/expansion-packs/bmad-creative-writing/checklists/kdp-cover-ready-checklist.md +18 -0
  137. package/expansion-packs/bmad-creative-writing/checklists/line-edit-quality-checklist.md +16 -0
  138. package/expansion-packs/bmad-creative-writing/checklists/marketing-copy-checklist.md +16 -0
  139. package/expansion-packs/bmad-creative-writing/checklists/mystery-clue-trail-checklist.md +16 -0
  140. package/expansion-packs/bmad-creative-writing/checklists/orbital-mechanics-checklist.md +16 -0
  141. package/expansion-packs/bmad-creative-writing/checklists/plot-structure-checklist.md +49 -0
  142. package/expansion-packs/bmad-creative-writing/checklists/publication-readiness-checklist.md +16 -0
  143. package/expansion-packs/bmad-creative-writing/checklists/romance-emotional-beats-checklist.md +16 -0
  144. package/expansion-packs/bmad-creative-writing/checklists/scene-quality-checklist.md +16 -0
  145. package/expansion-packs/bmad-creative-writing/checklists/scifi-technology-plausibility-checklist.md +15 -0
  146. package/expansion-packs/bmad-creative-writing/checklists/sensitivity-representation-checklist.md +16 -0
  147. package/expansion-packs/bmad-creative-writing/checklists/steampunk-gadget-checklist.md +16 -0
  148. package/expansion-packs/bmad-creative-writing/checklists/thriller-pacing-stakes-checklist.md +16 -0
  149. package/expansion-packs/bmad-creative-writing/checklists/timeline-continuity-checklist.md +16 -0
  150. package/expansion-packs/bmad-creative-writing/checklists/world-building-continuity-checklist.md +16 -0
  151. package/expansion-packs/bmad-creative-writing/checklists/ya-appropriateness-checklist.md +16 -0
  152. package/expansion-packs/bmad-creative-writing/config.yaml +11 -0
  153. package/expansion-packs/bmad-creative-writing/data/bmad-kb.md +197 -0
  154. package/expansion-packs/bmad-creative-writing/data/story-structures.md +58 -0
  155. package/expansion-packs/bmad-creative-writing/docs/brief.md +183 -0
  156. package/expansion-packs/bmad-creative-writing/tasks/advanced-elicitation.md +117 -0
  157. package/expansion-packs/bmad-creative-writing/tasks/analyze-reader-feedback.md +16 -0
  158. package/expansion-packs/bmad-creative-writing/tasks/analyze-story-structure.md +55 -0
  159. package/expansion-packs/bmad-creative-writing/tasks/assemble-kdp-package.md +22 -0
  160. package/expansion-packs/bmad-creative-writing/tasks/brainstorm-premise.md +16 -0
  161. package/expansion-packs/bmad-creative-writing/tasks/build-world.md +17 -0
  162. package/expansion-packs/bmad-creative-writing/tasks/character-depth-pass.md +15 -0
  163. package/expansion-packs/bmad-creative-writing/tasks/create-doc.md +101 -0
  164. package/expansion-packs/bmad-creative-writing/tasks/create-draft-section.md +19 -0
  165. package/expansion-packs/bmad-creative-writing/tasks/critical-review.md +19 -0
  166. package/expansion-packs/bmad-creative-writing/tasks/develop-character.md +17 -0
  167. package/expansion-packs/bmad-creative-writing/tasks/execute-checklist.md +93 -0
  168. package/expansion-packs/bmad-creative-writing/tasks/expand-premise.md +16 -0
  169. package/expansion-packs/bmad-creative-writing/tasks/expand-synopsis.md +16 -0
  170. package/expansion-packs/bmad-creative-writing/tasks/final-polish.md +16 -0
  171. package/expansion-packs/bmad-creative-writing/tasks/generate-cover-brief.md +18 -0
  172. package/expansion-packs/bmad-creative-writing/tasks/generate-cover-prompts.md +19 -0
  173. package/expansion-packs/bmad-creative-writing/tasks/generate-scene-list.md +16 -0
  174. package/expansion-packs/bmad-creative-writing/tasks/incorporate-feedback.md +18 -0
  175. package/expansion-packs/bmad-creative-writing/tasks/outline-scenes.md +16 -0
  176. package/expansion-packs/bmad-creative-writing/tasks/provide-feedback.md +17 -0
  177. package/expansion-packs/bmad-creative-writing/tasks/publish-chapter.md +16 -0
  178. package/expansion-packs/bmad-creative-writing/tasks/quick-feedback.md +15 -0
  179. package/expansion-packs/bmad-creative-writing/tasks/select-next-arc.md +16 -0
  180. package/expansion-packs/bmad-creative-writing/tasks/workshop-dialog.md +51 -0
  181. package/expansion-packs/bmad-creative-writing/templates/beta-feedback-form.yaml +96 -0
  182. package/expansion-packs/bmad-creative-writing/templates/chapter-draft-tmpl.yaml +81 -0
  183. package/expansion-packs/bmad-creative-writing/templates/character-profile-tmpl.yaml +92 -0
  184. package/expansion-packs/bmad-creative-writing/templates/cover-design-brief-tmpl.yaml +97 -0
  185. package/expansion-packs/bmad-creative-writing/templates/premise-brief-tmpl.yaml +77 -0
  186. package/expansion-packs/bmad-creative-writing/templates/scene-list-tmpl.yaml +54 -0
  187. package/expansion-packs/bmad-creative-writing/templates/story-outline-tmpl.yaml +96 -0
  188. package/expansion-packs/bmad-creative-writing/templates/world-guide-tmpl.yaml +88 -0
  189. package/expansion-packs/bmad-creative-writing/workflows/book-cover-design-workflow.md +176 -0
  190. package/expansion-packs/bmad-creative-writing/workflows/novel-greenfield-workflow.yaml +58 -0
  191. package/expansion-packs/bmad-creative-writing/workflows/novel-serial-workflow.yaml +51 -0
  192. package/expansion-packs/bmad-creative-writing/workflows/novel-snowflake-workflow.yaml +69 -0
  193. package/expansion-packs/bmad-creative-writing/workflows/novel-writing.yaml +92 -0
  194. package/expansion-packs/bmad-creative-writing/workflows/screenplay-development.yaml +86 -0
  195. package/expansion-packs/bmad-creative-writing/workflows/series-planning.yaml +79 -0
  196. package/expansion-packs/bmad-creative-writing/workflows/short-story-creation.yaml +65 -0
  197. package/expansion-packs/bmad-infrastructure-devops/config.yaml +1 -1
  198. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-architecture-tmpl.yaml +20 -20
  199. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-platform-from-arch-tmpl.yaml +7 -7
  200. package/package.json +62 -39
  201. package/prettier.config.mjs +32 -0
  202. package/sync-version.sh +23 -0
  203. package/tools/bmad-npx-wrapper.js +10 -10
  204. package/tools/builders/web-builder.js +124 -130
  205. package/tools/bump-all-versions.js +42 -33
  206. package/tools/bump-expansion-version.js +23 -16
  207. package/tools/cli.js +10 -12
  208. package/tools/flattener/aggregate.js +10 -10
  209. package/tools/flattener/binary.js +44 -17
  210. package/tools/flattener/discovery.js +19 -18
  211. package/tools/flattener/files.js +6 -6
  212. package/tools/flattener/ignoreRules.js +125 -125
  213. package/tools/flattener/main.js +426 -70
  214. package/tools/flattener/projectRoot.js +186 -25
  215. package/tools/flattener/prompts.js +9 -9
  216. package/tools/flattener/stats.helpers.js +395 -0
  217. package/tools/flattener/stats.js +64 -14
  218. package/tools/flattener/test-matrix.js +413 -0
  219. package/tools/flattener/xml.js +33 -31
  220. package/tools/installer/bin/bmad.js +156 -113
  221. package/tools/installer/config/ide-agent-config.yaml +1 -1
  222. package/tools/installer/config/install.config.yaml +13 -3
  223. package/tools/installer/lib/config-loader.js +46 -42
  224. package/tools/installer/lib/file-manager.js +91 -113
  225. package/tools/installer/lib/ide-base-setup.js +57 -56
  226. package/tools/installer/lib/ide-setup.js +545 -399
  227. package/tools/installer/lib/installer.js +875 -714
  228. package/tools/installer/lib/memory-profiler.js +54 -53
  229. package/tools/installer/lib/module-manager.js +19 -15
  230. package/tools/installer/lib/resource-locator.js +26 -28
  231. package/tools/installer/package.json +19 -19
  232. package/tools/lib/dependency-resolver.js +26 -30
  233. package/tools/lib/yaml-utils.js +7 -7
  234. package/tools/preview-release-notes.js +66 -0
  235. package/tools/shared/bannerArt.js +3 -3
  236. package/tools/sync-installer-version.js +7 -9
  237. package/tools/update-expansion-version.js +14 -15
  238. package/tools/upgraders/v3-to-v4-upgrader.js +203 -294
  239. package/tools/version-bump.js +41 -26
  240. package/tools/yaml-format.js +56 -43
  241. package/.github/workflows/release.yaml +0 -60
  242. package/.releaserc.json +0 -21
  243. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/Complete AI Agent System - Flowchart.svg +0 -102
  244. 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 +0 -13
  245. 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 +0 -13
  246. 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 +0 -25
  247. 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 +0 -34
  248. 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 +0 -70
  249. 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 +0 -26
  250. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/README.md +0 -109
  251. package/tools/semantic-release-sync-installer.js +0 -30
@@ -108,7 +108,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
108
108
  ## Instructions
109
109
 
110
110
  1. **Initial Assessment**
111
-
112
111
  - If user or the task being run provides a checklist name:
113
112
  - Try fuzzy matching (e.g. "architecture checklist" -> "architect-checklist")
114
113
  - If multiple matches found, ask user to clarify
@@ -121,14 +120,12 @@ If the user asks or does not specify a specific checklist, list the checklists a
121
120
  - All at once (YOLO mode - recommended for checklists, there will be a summary of sections at the end to discuss)
122
121
 
123
122
  2. **Document and Artifact Gathering**
124
-
125
123
  - Each checklist will specify its required documents/artifacts at the beginning
126
124
  - Follow the checklist's specific instructions for what to gather, generally a file can be resolved in the docs folder, if not or unsure, halt and ask or confirm with the user.
127
125
 
128
126
  3. **Checklist Processing**
129
127
 
130
128
  If in interactive mode:
131
-
132
129
  - Work through each section of the checklist one at a time
133
130
  - For each section:
134
131
  - Review all items in the section following instructions for that section embedded in the checklist
@@ -137,7 +134,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
137
134
  - Get user confirmation before proceeding to next section or if any thing major do we need to halt and take corrective action
138
135
 
139
136
  If in YOLO mode:
140
-
141
137
  - Process all sections at once
142
138
  - Create a comprehensive report of all findings
143
139
  - Present the complete analysis to the user
@@ -145,7 +141,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
145
141
  4. **Validation Approach**
146
142
 
147
143
  For each checklist item:
148
-
149
144
  - Read and understand the requirement
150
145
  - Look for evidence in the documentation that satisfies the requirement
151
146
  - Consider both explicit mentions and implicit coverage
@@ -159,7 +154,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
159
154
  5. **Section Analysis**
160
155
 
161
156
  For each section:
162
-
163
157
  - think step by step to calculate pass rate
164
158
  - Identify common themes in failed items
165
159
  - Provide specific recommendations for improvement
@@ -169,7 +163,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
169
163
  6. **Final Report**
170
164
 
171
165
  Prepare a summary that includes:
172
-
173
166
  - Overall checklist completion status
174
167
  - Pass rates by section
175
168
  - List of failed items with context
@@ -357,7 +350,6 @@ The goal is quality delivery, not just checking boxes.]]
357
350
  1. **Requirements Met:**
358
351
 
359
352
  [[LLM: Be specific - list each requirement and whether it's complete. Include game-specific requirements from GDD]]
360
-
361
353
  - [ ] All functional requirements specified in the story are implemented.
362
354
  - [ ] All acceptance criteria defined in the story are met.
363
355
  - [ ] Game Design Document (GDD) requirements referenced in the story are implemented.
@@ -366,7 +358,6 @@ The goal is quality delivery, not just checking boxes.]]
366
358
  2. **Coding Standards & Project Structure:**
367
359
 
368
360
  [[LLM: Code quality matters for maintainability. Check Unity-specific patterns and C# standards]]
369
-
370
361
  - [ ] All new/modified code strictly adheres to `Operational Guidelines`.
371
362
  - [ ] All new/modified code aligns with `Project Structure` (Scripts/, Prefabs/, Scenes/, etc.).
372
363
  - [ ] Adherence to `Tech Stack` for Unity version and packages used.
@@ -380,7 +371,6 @@ The goal is quality delivery, not just checking boxes.]]
380
371
  3. **Testing:**
381
372
 
382
373
  [[LLM: Testing proves your code works. Include Unity-specific testing with NUnit and manual testing]]
383
-
384
374
  - [ ] All required unit tests (NUnit) as per the story and testing strategy are implemented.
385
375
  - [ ] All required integration tests (if applicable) are implemented.
386
376
  - [ ] Manual testing performed in Unity Editor for all game functionality.
@@ -392,7 +382,6 @@ The goal is quality delivery, not just checking boxes.]]
392
382
  4. **Functionality & Verification:**
393
383
 
394
384
  [[LLM: Did you actually run and test your code in Unity? Be specific about game mechanics tested]]
395
-
396
385
  - [ ] Functionality has been manually verified in Unity Editor and play mode.
397
386
  - [ ] Game mechanics work as specified in the GDD.
398
387
  - [ ] Player controls and input handling work correctly.
@@ -405,7 +394,6 @@ The goal is quality delivery, not just checking boxes.]]
405
394
  5. **Story Administration:**
406
395
 
407
396
  [[LLM: Documentation helps the next developer. Include Unity-specific implementation notes]]
408
-
409
397
  - [ ] All tasks within the story file are marked as complete.
410
398
  - [ ] Any clarifications or decisions made during development are documented.
411
399
  - [ ] Unity-specific implementation details documented (scene changes, prefab modifications).
@@ -415,7 +403,6 @@ The goal is quality delivery, not just checking boxes.]]
415
403
  6. **Dependencies, Build & Configuration:**
416
404
 
417
405
  [[LLM: Build issues block everyone. Ensure Unity project builds for all target platforms]]
418
-
419
406
  - [ ] Unity project builds successfully without errors.
420
407
  - [ ] Project builds for all target platforms (desktop/mobile as specified).
421
408
  - [ ] Any new Unity packages or Asset Store items were pre-approved OR approved by user.
@@ -427,7 +414,6 @@ The goal is quality delivery, not just checking boxes.]]
427
414
  7. **Game-Specific Quality:**
428
415
 
429
416
  [[LLM: Game quality matters. Check performance, game feel, and player experience]]
430
-
431
417
  - [ ] Frame rate meets target (30/60 FPS) on all platforms.
432
418
  - [ ] Memory usage within acceptable limits.
433
419
  - [ ] Game feel and responsiveness meet design requirements.
@@ -439,7 +425,6 @@ The goal is quality delivery, not just checking boxes.]]
439
425
  8. **Documentation (If Applicable):**
440
426
 
441
427
  [[LLM: Good documentation prevents future confusion. Include Unity-specific docs]]
442
-
443
428
  - [ ] Code documentation (XML comments) for public APIs complete.
444
429
  - [ ] Unity component documentation in Inspector updated.
445
430
  - [ ] User-facing documentation updated, if changes impact players.
@@ -286,7 +286,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
286
286
  ## Instructions
287
287
 
288
288
  1. **Initial Assessment**
289
-
290
289
  - If user or the task being run provides a checklist name:
291
290
  - Try fuzzy matching (e.g. "architecture checklist" -> "architect-checklist")
292
291
  - If multiple matches found, ask user to clarify
@@ -299,14 +298,12 @@ If the user asks or does not specify a specific checklist, list the checklists a
299
298
  - All at once (YOLO mode - recommended for checklists, there will be a summary of sections at the end to discuss)
300
299
 
301
300
  2. **Document and Artifact Gathering**
302
-
303
301
  - Each checklist will specify its required documents/artifacts at the beginning
304
302
  - Follow the checklist's specific instructions for what to gather, generally a file can be resolved in the docs folder, if not or unsure, halt and ask or confirm with the user.
305
303
 
306
304
  3. **Checklist Processing**
307
305
 
308
306
  If in interactive mode:
309
-
310
307
  - Work through each section of the checklist one at a time
311
308
  - For each section:
312
309
  - Review all items in the section following instructions for that section embedded in the checklist
@@ -315,7 +312,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
315
312
  - Get user confirmation before proceeding to next section or if any thing major do we need to halt and take corrective action
316
313
 
317
314
  If in YOLO mode:
318
-
319
315
  - Process all sections at once
320
316
  - Create a comprehensive report of all findings
321
317
  - Present the complete analysis to the user
@@ -323,7 +319,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
323
319
  4. **Validation Approach**
324
320
 
325
321
  For each checklist item:
326
-
327
322
  - Read and understand the requirement
328
323
  - Look for evidence in the documentation that satisfies the requirement
329
324
  - Consider both explicit mentions and implicit coverage
@@ -337,7 +332,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
337
332
  5. **Section Analysis**
338
333
 
339
334
  For each section:
340
-
341
335
  - think step by step to calculate pass rate
342
336
  - Identify common themes in failed items
343
337
  - Provide specific recommendations for improvement
@@ -347,7 +341,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
347
341
  6. **Final Report**
348
342
 
349
343
  Prepare a summary that includes:
350
-
351
344
  - Overall checklist completion status
352
345
  - Pass rates by section
353
346
  - List of failed items with context
@@ -387,7 +380,6 @@ The LLM will:
387
380
  ### 1. Initial Setup & Mode Selection
388
381
 
389
382
  - **Acknowledge Task & Inputs:**
390
-
391
383
  - Confirm with the user that the "Game Development Correct Course Task" is being initiated.
392
384
  - Verify the change trigger (e.g., performance issue, platform constraint, gameplay feedback, technical blocker).
393
385
  - Confirm access to relevant game artifacts:
@@ -408,7 +400,6 @@ The LLM will:
408
400
  ### 2. Execute Game Development Checklist Analysis
409
401
 
410
402
  - Systematically work through the game-change-checklist sections:
411
-
412
403
  1. **Change Context & Game Impact**
413
404
  2. **Feature/System Impact Analysis**
414
405
  3. **Technical Artifact Conflict Resolution**
@@ -433,7 +424,6 @@ The LLM will:
433
424
  Based on the analysis and agreed path forward:
434
425
 
435
426
  - **Identify affected game artifacts requiring updates:**
436
-
437
427
  - GDD sections (mechanics, systems, progression)
438
428
  - Technical specifications (architecture, performance targets)
439
429
  - Unity-specific configurations (build settings, quality settings)
@@ -442,7 +432,6 @@ Based on the analysis and agreed path forward:
442
432
  - Platform-specific adaptations
443
433
 
444
434
  - **Draft explicit changes for each artifact:**
445
-
446
435
  - **Game Stories:** Revise story text, Unity-specific acceptance criteria, technical constraints
447
436
  - **Technical Specs:** Update architecture diagrams, component hierarchies, performance budgets
448
437
  - **Unity Configurations:** Propose settings changes, optimization strategies, platform variants
@@ -462,14 +451,12 @@ Based on the analysis and agreed path forward:
462
451
  - Create a comprehensive proposal document containing:
463
452
 
464
453
  **A. Change Summary:**
465
-
466
454
  - Original issue (performance, gameplay, technical constraint)
467
455
  - Game systems affected
468
456
  - Platform/performance implications
469
457
  - Chosen solution approach
470
458
 
471
459
  **B. Technical Impact Analysis:**
472
-
473
460
  - Unity architecture changes needed
474
461
  - Performance implications (with metrics)
475
462
  - Platform compatibility effects
@@ -477,14 +464,12 @@ Based on the analysis and agreed path forward:
477
464
  - Third-party dependency impacts
478
465
 
479
466
  **C. Specific Proposed Edits:**
480
-
481
467
  - For each game story: "Change Story GS-X.Y from: [old] To: [new]"
482
468
  - For technical specs: "Update Unity Architecture Section X: [changes]"
483
469
  - For GDD: "Modify [Feature] in Section Y: [updates]"
484
470
  - For configurations: "Change [Setting] from [old_value] to [new_value]"
485
471
 
486
472
  **D. Implementation Considerations:**
487
-
488
473
  - Required Unity version updates
489
474
  - Asset reimport needs
490
475
  - Shader recompilation requirements
@@ -496,7 +481,6 @@ Based on the analysis and agreed path forward:
496
481
  - Provide the finalized document to the user
497
482
 
498
483
  - **Based on change scope:**
499
-
500
484
  - **Minor adjustments (can be handled in current sprint):**
501
485
  - Confirm task completion
502
486
  - Suggest handoff to game-dev agent for implementation
@@ -510,7 +494,6 @@ Based on the analysis and agreed path forward:
510
494
  ## Output Deliverables
511
495
 
512
496
  - **Primary:** "Game Development Change Proposal" document containing:
513
-
514
497
  - Game-specific change analysis
515
498
  - Technical impact assessment with Unity context
516
499
  - Platform and performance considerations
@@ -541,13 +524,13 @@ sections:
541
524
  - id: initial-setup
542
525
  instruction: |
543
526
  This template creates detailed game development stories that are immediately actionable by game developers. Each story should focus on a single, implementable feature that contributes to the overall game functionality.
544
-
527
+
545
528
  Before starting, ensure you have access to:
546
-
529
+
547
530
  - Game Design Document (GDD)
548
531
  - Game Architecture Document
549
532
  - Any existing stories in this epic
550
-
533
+
551
534
  The story should be specific enough that a developer can implement it without requiring additional design decisions.
552
535
 
553
536
  - id: story-header
@@ -596,12 +579,12 @@ sections:
596
579
  title: Files to Create/Modify
597
580
  template: |
598
581
  **New Files:**
599
-
582
+
600
583
  - `{{file_path_1}}` - {{purpose}}
601
584
  - `{{file_path_2}}` - {{purpose}}
602
-
585
+
603
586
  **Modified Files:**
604
-
587
+
605
588
  - `{{existing_file_1}}` - {{changes_needed}}
606
589
  - `{{existing_file_2}}` - {{changes_needed}}
607
590
  - id: class-interface-definitions
@@ -684,13 +667,13 @@ sections:
684
667
  instruction: Reference the specific sections of the GDD that this story implements
685
668
  template: |
686
669
  **GDD Reference:** {{section_name}} ({{page_or_section_number}})
687
-
670
+
688
671
  **Game Mechanic:** {{mechanic_name}}
689
-
672
+
690
673
  **Player Experience Goal:** {{experience_description}}
691
-
674
+
692
675
  **Balance Parameters:**
693
-
676
+
694
677
  - {{parameter_1}}: {{value_or_range}}
695
678
  - {{parameter_2}}: {{value_or_range}}
696
679
 
@@ -737,15 +720,15 @@ sections:
737
720
  instruction: List any dependencies that must be completed before this story can be implemented
738
721
  template: |
739
722
  **Story Dependencies:**
740
-
723
+
741
724
  - {{story_id}}: {{dependency_description}}
742
-
725
+
743
726
  **Technical Dependencies:**
744
-
727
+
745
728
  - {{system_or_file}}: {{requirement}}
746
-
729
+
747
730
  **Asset Dependencies:**
748
-
731
+
749
732
  - {{asset_type}}: {{asset_description}}
750
733
  - Location: `{{asset_path}}`
751
734
 
@@ -768,17 +751,17 @@ sections:
768
751
  instruction: Any additional context, design decisions, or implementation notes
769
752
  template: |
770
753
  **Implementation Notes:**
771
-
754
+
772
755
  - {{note_1}}
773
756
  - {{note_2}}
774
-
757
+
775
758
  **Design Decisions:**
776
-
759
+
777
760
  - {{decision_1}}: {{rationale}}
778
761
  - {{decision_2}}: {{rationale}}
779
-
762
+
780
763
  **Future Considerations:**
781
-
764
+
782
765
  - {{future_enhancement_1}}
783
766
  - {{future_optimization_1}}
784
767
  ==================== END: .bmad-2d-unity-game-dev/templates/game-story-tmpl.yaml ====================