bmad-method 4.37.0 → 4.39.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 (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
@@ -95,7 +95,7 @@ sections:
95
95
  instruction: Define the 30-60 second loop that players will repeat. Be specific about timing and player actions for Unity implementation.
96
96
  template: |
97
97
  **Primary Loop ({{duration}} seconds):**
98
-
98
+
99
99
  1. {{action_1}} ({{time_1}}s) - {{unity_component}}
100
100
  2. {{action_2}} ({{time_2}}s) - {{unity_component}}
101
101
  3. {{action_3}} ({{time_3}}s) - {{unity_component}}
@@ -107,12 +107,12 @@ sections:
107
107
  instruction: Clearly define success and failure states with Unity-specific implementation notes
108
108
  template: |
109
109
  **Victory Conditions:**
110
-
110
+
111
111
  - {{win_condition_1}} - Unity Event: {{unity_event}}
112
112
  - {{win_condition_2}} - Unity Event: {{unity_event}}
113
-
113
+
114
114
  **Failure States:**
115
-
115
+
116
116
  - {{loss_condition_1}} - Trigger: {{unity_trigger}}
117
117
  - {{loss_condition_2}} - Trigger: {{unity_trigger}}
118
118
  examples:
@@ -132,22 +132,22 @@ sections:
132
132
  title: "{{mechanic_name}}"
133
133
  template: |
134
134
  **Description:** {{detailed_description}}
135
-
135
+
136
136
  **Player Input:** {{input_method}} - Unity Input System: {{input_action}}
137
-
137
+
138
138
  **System Response:** {{game_response}}
139
-
139
+
140
140
  **Unity Implementation Notes:**
141
-
141
+
142
142
  - **Components Needed:** {{component_list}}
143
143
  - **Physics Requirements:** {{physics_2d_setup}}
144
144
  - **Animation States:** {{animator_states}}
145
145
  - **Performance Considerations:** {{optimization_notes}}
146
-
146
+
147
147
  **Dependencies:** {{other_mechanics_needed}}
148
-
148
+
149
149
  **Script Architecture:**
150
-
150
+
151
151
  - {{script_name}}.cs - {{responsibility}}
152
152
  - {{manager_script}}.cs - {{management_role}}
153
153
  examples:
@@ -173,15 +173,15 @@ sections:
173
173
  title: Player Progression
174
174
  template: |
175
175
  **Progression Type:** {{linear|branching|metroidvania}}
176
-
176
+
177
177
  **Key Milestones:**
178
-
178
+
179
179
  1. **{{milestone_1}}** - {{unlock_description}} - Unity: {{scriptable_object_update}}
180
180
  2. **{{milestone_2}}** - {{unlock_description}} - Unity: {{scriptable_object_update}}
181
181
  3. **{{milestone_3}}** - {{unlock_description}} - Unity: {{scriptable_object_update}}
182
-
182
+
183
183
  **Save Data Structure:**
184
-
184
+
185
185
  ```csharp
186
186
  [System.Serializable]
187
187
  public class PlayerProgress
@@ -197,13 +197,13 @@ sections:
197
197
  template: |
198
198
  **Tutorial Phase:** {{duration}} - {{difficulty_description}}
199
199
  - Unity Config: {{scriptable_object_values}}
200
-
200
+
201
201
  **Early Game:** {{duration}} - {{difficulty_description}}
202
202
  - Unity Config: {{scriptable_object_values}}
203
-
203
+
204
204
  **Mid Game:** {{duration}} - {{difficulty_description}}
205
205
  - Unity Config: {{scriptable_object_values}}
206
-
206
+
207
207
  **Late Game:** {{duration}} - {{difficulty_description}}
208
208
  - Unity Config: {{scriptable_object_values}}
209
209
  examples:
@@ -236,22 +236,22 @@ sections:
236
236
  **Target Duration:** {{target_time}}
237
237
  **Key Elements:** {{required_mechanics}}
238
238
  **Difficulty Rating:** {{relative_difficulty}}
239
-
239
+
240
240
  **Unity Scene Structure:**
241
-
241
+
242
242
  - **Environment:** {{tilemap_setup}}
243
243
  - **Gameplay Objects:** {{prefab_list}}
244
244
  - **Lighting:** {{lighting_setup}}
245
245
  - **Audio:** {{audio_sources}}
246
-
246
+
247
247
  **Level Flow Template:**
248
-
248
+
249
249
  - **Introduction:** {{intro_description}} - Area: {{unity_area_bounds}}
250
250
  - **Challenge:** {{main_challenge}} - Mechanics: {{active_components}}
251
251
  - **Resolution:** {{completion_requirement}} - Trigger: {{completion_trigger}}
252
-
252
+
253
253
  **Reusable Prefabs:**
254
-
254
+
255
255
  - {{prefab_name}} - {{prefab_purpose}}
256
256
  examples:
257
257
  - "Environment: TilemapRenderer with Platform tileset, Lighting: 2D Global Light + Point Lights"
@@ -262,9 +262,9 @@ sections:
262
262
  **Total Levels:** {{number}}
263
263
  **Unlock Pattern:** {{progression_method}}
264
264
  **Scene Management:** {{unity_scene_loading}}
265
-
265
+
266
266
  **Unity Scene Organization:**
267
-
267
+
268
268
  - Scene Naming: {{naming_convention}}
269
269
  - Addressable Assets: {{addressable_groups}}
270
270
  - Loading Screens: {{loading_implementation}}
@@ -289,13 +289,13 @@ sections:
289
289
  **Physics:** {{2D Only|3D Only|Hybrid}}
290
290
  **Scripting Backend:** {{Mono|IL2CPP}}
291
291
  **API Compatibility:** {{.NET Standard 2.1|.NET Framework}}
292
-
292
+
293
293
  **Required Packages:**
294
-
294
+
295
295
  - {{package_name}} {{version}} - {{purpose}}
296
-
296
+
297
297
  **Project Settings:**
298
-
298
+
299
299
  - Color Space: {{Linear|Gamma}}
300
300
  - Quality Settings: {{quality_levels}}
301
301
  - Physics Settings: {{physics_config}}
@@ -309,9 +309,9 @@ sections:
309
309
  **Memory Usage:** <{{memory_limit}}MB heap, <{{texture_memory}}MB textures
310
310
  **Load Times:** <{{load_time}}s initial, <{{level_load}}s between levels
311
311
  **Battery Usage:** Optimized for mobile devices - {{battery_target}} hours gameplay
312
-
312
+
313
313
  **Unity Profiler Targets:**
314
-
314
+
315
315
  - CPU Frame Time: <{{cpu_time}}ms
316
316
  - GPU Frame Time: <{{gpu_time}}ms
317
317
  - GC Allocs: <{{gc_limit}}KB per frame
@@ -322,20 +322,20 @@ sections:
322
322
  title: Platform Specific Requirements
323
323
  template: |
324
324
  **Desktop:**
325
-
325
+
326
326
  - Resolution: {{min_resolution}} - {{max_resolution}}
327
327
  - Input: Keyboard, Mouse, Gamepad ({{gamepad_support}})
328
328
  - Build Target: {{desktop_targets}}
329
-
329
+
330
330
  **Mobile:**
331
-
331
+
332
332
  - Resolution: {{mobile_min}} - {{mobile_max}}
333
333
  - Input: Touch, Accelerometer ({{sensor_support}})
334
334
  - OS: iOS {{ios_min}}+, Android {{android_min}}+ (API {{api_level}})
335
335
  - Device Requirements: {{device_specs}}
336
-
336
+
337
337
  **Web (if applicable):**
338
-
338
+
339
339
  - WebGL Version: {{webgl_version}}
340
340
  - Browser Support: {{browser_list}}
341
341
  - Compression: {{compression_format}}
@@ -346,21 +346,21 @@ sections:
346
346
  instruction: Define asset specifications for Unity pipeline optimization
347
347
  template: |
348
348
  **2D Art Assets:**
349
-
349
+
350
350
  - Sprites: {{sprite_resolution}} at {{ppu}} PPU
351
351
  - Texture Format: {{texture_compression}}
352
352
  - Atlas Strategy: {{sprite_atlas_setup}}
353
353
  - Animation: {{animation_type}} at {{framerate}} FPS
354
-
354
+
355
355
  **Audio Assets:**
356
-
356
+
357
357
  - Music: {{audio_format}} at {{sample_rate}} Hz
358
358
  - SFX: {{sfx_format}} at {{sfx_sample_rate}} Hz
359
359
  - Compression: {{audio_compression}}
360
360
  - 3D Audio: {{spatial_audio}}
361
-
361
+
362
362
  **UI Assets:**
363
-
363
+
364
364
  - Canvas Resolution: {{ui_resolution}}
365
365
  - UI Scale Mode: {{scale_mode}}
366
366
  - Font: {{font_requirements}}
@@ -381,17 +381,17 @@ sections:
381
381
  title: Code Architecture Pattern
382
382
  template: |
383
383
  **Architecture Pattern:** {{MVC|MVVM|ECS|Component-Based|Custom}}
384
-
384
+
385
385
  **Core Systems Required:**
386
-
386
+
387
387
  - **Scene Management:** {{scene_manager_approach}}
388
388
  - **State Management:** {{state_pattern_implementation}}
389
389
  - **Event System:** {{event_system_choice}}
390
390
  - **Object Pooling:** {{pooling_strategy}}
391
391
  - **Save/Load System:** {{save_system_approach}}
392
-
392
+
393
393
  **Folder Structure:**
394
-
394
+
395
395
  ```
396
396
  Assets/
397
397
  ├── _Project/
@@ -401,9 +401,9 @@ sections:
401
401
  │ ├── Scenes/
402
402
  │ └── {{additional_folders}}
403
403
  ```
404
-
404
+
405
405
  **Naming Conventions:**
406
-
406
+
407
407
  - Scripts: {{script_naming}}
408
408
  - Prefabs: {{prefab_naming}}
409
409
  - Scenes: {{scene_naming}}
@@ -414,19 +414,19 @@ sections:
414
414
  title: Unity Systems Integration
415
415
  template: |
416
416
  **Required Unity Systems:**
417
-
417
+
418
418
  - **Input System:** {{input_implementation}}
419
419
  - **Animation System:** {{animation_approach}}
420
420
  - **Physics Integration:** {{physics_usage}}
421
421
  - **Rendering Features:** {{rendering_requirements}}
422
422
  - **Asset Streaming:** {{asset_loading_strategy}}
423
-
423
+
424
424
  **Third-Party Integrations:**
425
-
425
+
426
426
  - {{integration_name}}: {{integration_purpose}}
427
-
427
+
428
428
  **Performance Systems:**
429
-
429
+
430
430
  - **Profiling Integration:** {{profiling_setup}}
431
431
  - **Memory Management:** {{memory_strategy}}
432
432
  - **Build Pipeline:** {{build_automation}}
@@ -437,20 +437,20 @@ sections:
437
437
  title: Data Management
438
438
  template: |
439
439
  **Save Data Architecture:**
440
-
440
+
441
441
  - **Format:** {{PlayerPrefs|JSON|Binary|Cloud}}
442
442
  - **Structure:** {{save_data_organization}}
443
443
  - **Encryption:** {{security_approach}}
444
444
  - **Cloud Sync:** {{cloud_integration}}
445
-
445
+
446
446
  **Configuration Data:**
447
-
447
+
448
448
  - **ScriptableObjects:** {{scriptable_object_usage}}
449
449
  - **Settings Management:** {{settings_system}}
450
450
  - **Localization:** {{localization_approach}}
451
-
451
+
452
452
  **Runtime Data:**
453
-
453
+
454
454
  - **Caching Strategy:** {{cache_implementation}}
455
455
  - **Memory Pools:** {{pooling_objects}}
456
456
  - **Asset References:** {{asset_reference_system}}
@@ -678,15 +678,15 @@ sections:
678
678
  instruction: Provide guidance for the Story Manager (SM) agent on how to break down this GDD into implementable user stories
679
679
  template: |
680
680
  **Epic Prioritization:** {{epic_order_rationale}}
681
-
681
+
682
682
  **Story Sizing Guidelines:**
683
-
683
+
684
684
  - Foundation stories: {{foundation_story_scope}}
685
685
  - Feature stories: {{feature_story_scope}}
686
686
  - Polish stories: {{polish_story_scope}}
687
-
687
+
688
688
  **Unity-Specific Story Considerations:**
689
-
689
+
690
690
  - Each story should result in testable Unity scenes or prefabs
691
691
  - Include specific Unity components and systems in acceptance criteria
692
692
  - Consider cross-platform testing requirements
@@ -702,4 +702,4 @@ sections:
702
702
  examples:
703
703
  - "Unity Architect: Create detailed technical architecture document with specific Unity implementation patterns"
704
704
  - "Unity Developer: Implement core systems and gameplay mechanics according to architecture"
705
- - "QA Tester: Validate performance metrics and cross-platform functionality"
705
+ - "QA Tester: Validate performance metrics and cross-platform functionality"
@@ -14,13 +14,13 @@ sections:
14
14
  - id: initial-setup
15
15
  instruction: |
16
16
  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.
17
-
17
+
18
18
  Before starting, ensure you have access to:
19
-
19
+
20
20
  - Game Design Document (GDD)
21
21
  - Game Architecture Document
22
22
  - Any existing stories in this epic
23
-
23
+
24
24
  The story should be specific enough that a developer can implement it without requiring additional design decisions.
25
25
 
26
26
  - id: story-header
@@ -69,12 +69,12 @@ sections:
69
69
  title: Files to Create/Modify
70
70
  template: |
71
71
  **New Files:**
72
-
72
+
73
73
  - `{{file_path_1}}` - {{purpose}}
74
74
  - `{{file_path_2}}` - {{purpose}}
75
-
75
+
76
76
  **Modified Files:**
77
-
77
+
78
78
  - `{{existing_file_1}}` - {{changes_needed}}
79
79
  - `{{existing_file_2}}` - {{changes_needed}}
80
80
  - id: class-interface-definitions
@@ -157,13 +157,13 @@ sections:
157
157
  instruction: Reference the specific sections of the GDD that this story implements
158
158
  template: |
159
159
  **GDD Reference:** {{section_name}} ({{page_or_section_number}})
160
-
160
+
161
161
  **Game Mechanic:** {{mechanic_name}}
162
-
162
+
163
163
  **Player Experience Goal:** {{experience_description}}
164
-
164
+
165
165
  **Balance Parameters:**
166
-
166
+
167
167
  - {{parameter_1}}: {{value_or_range}}
168
168
  - {{parameter_2}}: {{value_or_range}}
169
169
 
@@ -210,15 +210,15 @@ sections:
210
210
  instruction: List any dependencies that must be completed before this story can be implemented
211
211
  template: |
212
212
  **Story Dependencies:**
213
-
213
+
214
214
  - {{story_id}}: {{dependency_description}}
215
-
215
+
216
216
  **Technical Dependencies:**
217
-
217
+
218
218
  - {{system_or_file}}: {{requirement}}
219
-
219
+
220
220
  **Asset Dependencies:**
221
-
221
+
222
222
  - {{asset_type}}: {{asset_description}}
223
223
  - Location: `{{asset_path}}`
224
224
 
@@ -241,16 +241,16 @@ sections:
241
241
  instruction: Any additional context, design decisions, or implementation notes
242
242
  template: |
243
243
  **Implementation Notes:**
244
-
244
+
245
245
  - {{note_1}}
246
246
  - {{note_2}}
247
-
247
+
248
248
  **Design Decisions:**
249
-
249
+
250
250
  - {{decision_1}}: {{rationale}}
251
251
  - {{decision_2}}: {{rationale}}
252
-
252
+
253
253
  **Future Considerations:**
254
-
254
+
255
255
  - {{future_enhancement_1}}
256
256
  - {{future_optimization_1}}