bmad-method 5.0.0-beta.2 → 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 (131) 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 +0 -11
  9. package/README.md +2 -0
  10. package/bmad-core/agent-teams/team-all.yaml +1 -1
  11. package/bmad-core/agents/bmad-orchestrator.md +1 -1
  12. package/bmad-core/agents/dev.md +4 -4
  13. package/bmad-core/data/bmad-kb.md +1 -1
  14. package/bmad-core/data/test-levels-framework.md +12 -12
  15. package/bmad-core/tasks/facilitate-brainstorming-session.md +1 -1
  16. package/bmad-core/tasks/nfr-assess.md +10 -10
  17. package/bmad-core/tasks/qa-gate.md +23 -23
  18. package/bmad-core/tasks/review-story.md +18 -18
  19. package/bmad-core/tasks/risk-profile.md +25 -25
  20. package/bmad-core/tasks/test-design.md +9 -9
  21. package/bmad-core/tasks/trace-requirements.md +21 -21
  22. package/bmad-core/templates/architecture-tmpl.yaml +49 -49
  23. package/bmad-core/templates/brainstorming-output-tmpl.yaml +5 -5
  24. package/bmad-core/templates/brownfield-architecture-tmpl.yaml +31 -31
  25. package/bmad-core/templates/brownfield-prd-tmpl.yaml +13 -13
  26. package/bmad-core/templates/competitor-analysis-tmpl.yaml +19 -6
  27. package/bmad-core/templates/front-end-architecture-tmpl.yaml +21 -9
  28. package/bmad-core/templates/front-end-spec-tmpl.yaml +24 -24
  29. package/bmad-core/templates/fullstack-architecture-tmpl.yaml +122 -104
  30. package/bmad-core/templates/market-research-tmpl.yaml +2 -2
  31. package/bmad-core/templates/prd-tmpl.yaml +9 -9
  32. package/bmad-core/templates/project-brief-tmpl.yaml +4 -4
  33. package/bmad-core/templates/qa-gate-tmpl.yaml +9 -9
  34. package/bmad-core/templates/story-tmpl.yaml +12 -12
  35. package/bmad-core/workflows/brownfield-fullstack.yaml +9 -9
  36. package/bmad-core/workflows/brownfield-service.yaml +1 -1
  37. package/bmad-core/workflows/brownfield-ui.yaml +1 -1
  38. package/bmad-core/workflows/greenfield-fullstack.yaml +1 -1
  39. package/bmad-core/workflows/greenfield-service.yaml +1 -1
  40. package/bmad-core/workflows/greenfield-ui.yaml +1 -1
  41. package/common/utils/bmad-doc-template.md +5 -5
  42. package/dist/agents/analyst.txt +28 -15
  43. package/dist/agents/architect.txt +220 -190
  44. package/dist/agents/bmad-master.txt +298 -255
  45. package/dist/agents/bmad-orchestrator.txt +1 -1
  46. package/dist/agents/pm.txt +20 -20
  47. package/dist/agents/po.txt +11 -11
  48. package/dist/agents/qa.txt +275 -618
  49. package/dist/agents/sm.txt +11 -11
  50. package/dist/agents/ux-expert.txt +23 -23
  51. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +109 -109
  52. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +75 -77
  53. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +41 -41
  54. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +483 -474
  55. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.txt +1 -1
  56. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt +149 -149
  57. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.txt +20 -20
  58. package/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt +371 -358
  59. package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +25 -25
  60. package/dist/teams/team-all.txt +581 -881
  61. package/dist/teams/team-fullstack.txt +316 -273
  62. package/dist/teams/team-ide-minimal.txt +276 -619
  63. package/dist/teams/team-no-ui.txt +281 -238
  64. package/docs/versioning-and-releases.md +114 -44
  65. package/eslint.config.mjs +119 -0
  66. 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 -26
  67. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.md +4 -4
  68. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.md +1 -1
  69. package/expansion-packs/bmad-2d-phaser-game-dev/data/development-guidelines.md +26 -28
  70. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-architecture-tmpl.yaml +50 -50
  71. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-brief-tmpl.yaml +23 -23
  72. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-design-doc-tmpl.yaml +24 -24
  73. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-story-tmpl.yaml +42 -42
  74. package/expansion-packs/bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.yaml +65 -65
  75. package/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-dev-greenfield.yaml +5 -5
  76. package/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-prototype.yaml +1 -1
  77. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.md +3 -3
  78. package/expansion-packs/bmad-2d-unity-game-dev/data/bmad-kb.md +1 -1
  79. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-brief-tmpl.yaml +23 -23
  80. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-design-doc-tmpl.yaml +63 -63
  81. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-story-tmpl.yaml +20 -20
  82. package/expansion-packs/bmad-2d-unity-game-dev/templates/level-design-doc-tmpl.yaml +65 -65
  83. package/expansion-packs/bmad-2d-unity-game-dev/workflows/game-dev-greenfield.yaml +5 -5
  84. package/expansion-packs/bmad-2d-unity-game-dev/workflows/game-prototype.yaml +1 -1
  85. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-architecture-tmpl.yaml +20 -20
  86. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-platform-from-arch-tmpl.yaml +7 -7
  87. package/package.json +62 -39
  88. package/prettier.config.mjs +32 -0
  89. package/release_notes.md +30 -0
  90. package/tools/bmad-npx-wrapper.js +10 -10
  91. package/tools/builders/web-builder.js +124 -130
  92. package/tools/bump-all-versions.js +42 -33
  93. package/tools/bump-expansion-version.js +23 -16
  94. package/tools/cli.js +10 -12
  95. package/tools/flattener/aggregate.js +10 -10
  96. package/tools/flattener/binary.js +44 -17
  97. package/tools/flattener/discovery.js +19 -18
  98. package/tools/flattener/files.js +6 -6
  99. package/tools/flattener/ignoreRules.js +125 -125
  100. package/tools/flattener/main.js +201 -304
  101. package/tools/flattener/projectRoot.js +75 -73
  102. package/tools/flattener/prompts.js +9 -9
  103. package/tools/flattener/stats.helpers.js +131 -67
  104. package/tools/flattener/stats.js +3 -3
  105. package/tools/flattener/test-matrix.js +201 -193
  106. package/tools/flattener/xml.js +33 -31
  107. package/tools/installer/bin/bmad.js +130 -89
  108. package/tools/installer/config/ide-agent-config.yaml +1 -1
  109. package/tools/installer/config/install.config.yaml +2 -2
  110. package/tools/installer/lib/config-loader.js +46 -42
  111. package/tools/installer/lib/file-manager.js +91 -113
  112. package/tools/installer/lib/ide-base-setup.js +57 -56
  113. package/tools/installer/lib/ide-setup.js +375 -343
  114. package/tools/installer/lib/installer.js +875 -714
  115. package/tools/installer/lib/memory-profiler.js +54 -53
  116. package/tools/installer/lib/module-manager.js +19 -15
  117. package/tools/installer/lib/resource-locator.js +26 -28
  118. package/tools/installer/package.json +19 -19
  119. package/tools/lib/dependency-resolver.js +26 -30
  120. package/tools/lib/yaml-utils.js +7 -7
  121. package/tools/preview-release-notes.js +66 -0
  122. package/tools/shared/bannerArt.js +3 -3
  123. package/tools/sync-installer-version.js +7 -9
  124. package/tools/update-expansion-version.js +14 -15
  125. package/tools/upgraders/v3-to-v4-upgrader.js +203 -294
  126. package/tools/version-bump.js +41 -26
  127. package/tools/yaml-format.js +56 -43
  128. package/.github/workflows/promote-to-stable.yml +0 -144
  129. package/.github/workflows/release.yaml +0 -60
  130. package/.releaserc.json +0 -21
  131. package/tools/semantic-release-sync-installer.js +0 -30
@@ -14,7 +14,7 @@ sections:
14
14
  - id: initial-setup
15
15
  instruction: |
16
16
  This template creates a comprehensive game brief that serves as the foundation for all subsequent game development work. The brief should capture the essential vision, scope, and requirements needed to create a detailed Game Design Document.
17
-
17
+
18
18
  This brief is typically created early in the ideation process, often after brainstorming sessions, to crystallize the game concept before moving into detailed design.
19
19
 
20
20
  - id: game-vision
@@ -71,7 +71,7 @@ sections:
71
71
  repeatable: true
72
72
  template: |
73
73
  **Core Mechanic: {{mechanic_name}}**
74
-
74
+
75
75
  - **Description:** {{how_it_works}}
76
76
  - **Player Value:** {{why_its_fun}}
77
77
  - **Implementation Scope:** {{complexity_estimate}}
@@ -98,12 +98,12 @@ sections:
98
98
  title: Technical Constraints
99
99
  template: |
100
100
  **Platform Requirements:**
101
-
101
+
102
102
  - Primary: {{platform_1}} - {{requirements}}
103
103
  - Secondary: {{platform_2}} - {{requirements}}
104
-
104
+
105
105
  **Technical Specifications:**
106
-
106
+
107
107
  - Engine: Unity & C#
108
108
  - Performance Target: {{fps_target}} FPS on {{target_device}}
109
109
  - Memory Budget: <{{memory_limit}}MB
@@ -141,10 +141,10 @@ sections:
141
141
  title: Competitive Analysis
142
142
  template: |
143
143
  **Direct Competitors:**
144
-
144
+
145
145
  - {{competitor_1}}: {{strengths_and_weaknesses}}
146
146
  - {{competitor_2}}: {{strengths_and_weaknesses}}
147
-
147
+
148
148
  **Differentiation Strategy:**
149
149
  {{how_we_differ_and_why_thats_valuable}}
150
150
  - id: market-opportunity
@@ -168,16 +168,16 @@ sections:
168
168
  title: Content Categories
169
169
  template: |
170
170
  **Core Content:**
171
-
171
+
172
172
  - {{content_type_1}}: {{quantity_and_description}}
173
173
  - {{content_type_2}}: {{quantity_and_description}}
174
-
174
+
175
175
  **Optional Content:**
176
-
176
+
177
177
  - {{optional_content_type}}: {{quantity_and_description}}
178
-
178
+
179
179
  **Replay Elements:**
180
-
180
+
181
181
  - {{replayability_features}}
182
182
  - id: difficulty-accessibility
183
183
  title: Difficulty and Accessibility
@@ -244,13 +244,13 @@ sections:
244
244
  title: Player Experience Metrics
245
245
  template: |
246
246
  **Engagement Goals:**
247
-
247
+
248
248
  - Tutorial completion rate: >{{percentage}}%
249
249
  - Average session length: {{duration}} minutes
250
250
  - Player retention: D1 {{d1}}%, D7 {{d7}}%, D30 {{d30}}%
251
-
251
+
252
252
  **Quality Benchmarks:**
253
-
253
+
254
254
  - Player satisfaction: >{{rating}}/10
255
255
  - Completion rate: >{{percentage}}%
256
256
  - Technical performance: {{fps_target}} FPS consistent
@@ -258,13 +258,13 @@ sections:
258
258
  title: Development Metrics
259
259
  template: |
260
260
  **Technical Targets:**
261
-
261
+
262
262
  - Zero critical bugs at launch
263
263
  - Performance targets met on all platforms
264
264
  - Load times under {{seconds}}s
265
-
265
+
266
266
  **Process Goals:**
267
-
267
+
268
268
  - Development timeline adherence
269
269
  - Feature scope completion
270
270
  - Quality assurance standards
@@ -273,7 +273,7 @@ sections:
273
273
  condition: has_business_goals
274
274
  template: |
275
275
  **Commercial Goals:**
276
-
276
+
277
277
  - {{revenue_target}} in first {{time_period}}
278
278
  - {{user_acquisition_target}} players in first {{time_period}}
279
279
  - {{retention_target}} monthly active users
@@ -326,12 +326,12 @@ sections:
326
326
  title: Validation Plan
327
327
  template: |
328
328
  **Concept Testing:**
329
-
329
+
330
330
  - {{validation_method_1}} - {{timeline}}
331
331
  - {{validation_method_2}} - {{timeline}}
332
-
332
+
333
333
  **Prototype Testing:**
334
-
334
+
335
335
  - {{testing_approach}} - {{timeline}}
336
336
  - {{feedback_collection_method}} - {{timeline}}
337
337
 
@@ -353,4 +353,4 @@ sections:
353
353
  type: table
354
354
  template: |
355
355
  | Date | Version | Description | Author |
356
- | :--- | :------ | :---------- | :----- |
356
+ | :--- | :------ | :---------- | :----- |
@@ -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}}