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
@@ -1265,7 +1265,7 @@ sections:
1265
1265
  instruction: Define the 30-60 second loop that players will repeat. Be specific about timing and player actions for Unity implementation.
1266
1266
  template: |
1267
1267
  **Primary Loop ({{duration}} seconds):**
1268
-
1268
+
1269
1269
  1. {{action_1}} ({{time_1}}s) - {{unity_component}}
1270
1270
  2. {{action_2}} ({{time_2}}s) - {{unity_component}}
1271
1271
  3. {{action_3}} ({{time_3}}s) - {{unity_component}}
@@ -1277,12 +1277,12 @@ sections:
1277
1277
  instruction: Clearly define success and failure states with Unity-specific implementation notes
1278
1278
  template: |
1279
1279
  **Victory Conditions:**
1280
-
1280
+
1281
1281
  - {{win_condition_1}} - Unity Event: {{unity_event}}
1282
1282
  - {{win_condition_2}} - Unity Event: {{unity_event}}
1283
-
1283
+
1284
1284
  **Failure States:**
1285
-
1285
+
1286
1286
  - {{loss_condition_1}} - Trigger: {{unity_trigger}}
1287
1287
  - {{loss_condition_2}} - Trigger: {{unity_trigger}}
1288
1288
  examples:
@@ -1302,22 +1302,22 @@ sections:
1302
1302
  title: "{{mechanic_name}}"
1303
1303
  template: |
1304
1304
  **Description:** {{detailed_description}}
1305
-
1305
+
1306
1306
  **Player Input:** {{input_method}} - Unity Input System: {{input_action}}
1307
-
1307
+
1308
1308
  **System Response:** {{game_response}}
1309
-
1309
+
1310
1310
  **Unity Implementation Notes:**
1311
-
1311
+
1312
1312
  - **Components Needed:** {{component_list}}
1313
1313
  - **Physics Requirements:** {{physics_2d_setup}}
1314
1314
  - **Animation States:** {{animator_states}}
1315
1315
  - **Performance Considerations:** {{optimization_notes}}
1316
-
1316
+
1317
1317
  **Dependencies:** {{other_mechanics_needed}}
1318
-
1318
+
1319
1319
  **Script Architecture:**
1320
-
1320
+
1321
1321
  - {{script_name}}.cs - {{responsibility}}
1322
1322
  - {{manager_script}}.cs - {{management_role}}
1323
1323
  examples:
@@ -1343,15 +1343,15 @@ sections:
1343
1343
  title: Player Progression
1344
1344
  template: |
1345
1345
  **Progression Type:** {{linear|branching|metroidvania}}
1346
-
1346
+
1347
1347
  **Key Milestones:**
1348
-
1348
+
1349
1349
  1. **{{milestone_1}}** - {{unlock_description}} - Unity: {{scriptable_object_update}}
1350
1350
  2. **{{milestone_2}}** - {{unlock_description}} - Unity: {{scriptable_object_update}}
1351
1351
  3. **{{milestone_3}}** - {{unlock_description}} - Unity: {{scriptable_object_update}}
1352
-
1352
+
1353
1353
  **Save Data Structure:**
1354
-
1354
+
1355
1355
  ```csharp
1356
1356
  [System.Serializable]
1357
1357
  public class PlayerProgress
@@ -1367,13 +1367,13 @@ sections:
1367
1367
  template: |
1368
1368
  **Tutorial Phase:** {{duration}} - {{difficulty_description}}
1369
1369
  - Unity Config: {{scriptable_object_values}}
1370
-
1370
+
1371
1371
  **Early Game:** {{duration}} - {{difficulty_description}}
1372
1372
  - Unity Config: {{scriptable_object_values}}
1373
-
1373
+
1374
1374
  **Mid Game:** {{duration}} - {{difficulty_description}}
1375
1375
  - Unity Config: {{scriptable_object_values}}
1376
-
1376
+
1377
1377
  **Late Game:** {{duration}} - {{difficulty_description}}
1378
1378
  - Unity Config: {{scriptable_object_values}}
1379
1379
  examples:
@@ -1406,22 +1406,22 @@ sections:
1406
1406
  **Target Duration:** {{target_time}}
1407
1407
  **Key Elements:** {{required_mechanics}}
1408
1408
  **Difficulty Rating:** {{relative_difficulty}}
1409
-
1409
+
1410
1410
  **Unity Scene Structure:**
1411
-
1411
+
1412
1412
  - **Environment:** {{tilemap_setup}}
1413
1413
  - **Gameplay Objects:** {{prefab_list}}
1414
1414
  - **Lighting:** {{lighting_setup}}
1415
1415
  - **Audio:** {{audio_sources}}
1416
-
1416
+
1417
1417
  **Level Flow Template:**
1418
-
1418
+
1419
1419
  - **Introduction:** {{intro_description}} - Area: {{unity_area_bounds}}
1420
1420
  - **Challenge:** {{main_challenge}} - Mechanics: {{active_components}}
1421
1421
  - **Resolution:** {{completion_requirement}} - Trigger: {{completion_trigger}}
1422
-
1422
+
1423
1423
  **Reusable Prefabs:**
1424
-
1424
+
1425
1425
  - {{prefab_name}} - {{prefab_purpose}}
1426
1426
  examples:
1427
1427
  - "Environment: TilemapRenderer with Platform tileset, Lighting: 2D Global Light + Point Lights"
@@ -1432,9 +1432,9 @@ sections:
1432
1432
  **Total Levels:** {{number}}
1433
1433
  **Unlock Pattern:** {{progression_method}}
1434
1434
  **Scene Management:** {{unity_scene_loading}}
1435
-
1435
+
1436
1436
  **Unity Scene Organization:**
1437
-
1437
+
1438
1438
  - Scene Naming: {{naming_convention}}
1439
1439
  - Addressable Assets: {{addressable_groups}}
1440
1440
  - Loading Screens: {{loading_implementation}}
@@ -1459,13 +1459,13 @@ sections:
1459
1459
  **Physics:** {{2D Only|3D Only|Hybrid}}
1460
1460
  **Scripting Backend:** {{Mono|IL2CPP}}
1461
1461
  **API Compatibility:** {{.NET Standard 2.1|.NET Framework}}
1462
-
1462
+
1463
1463
  **Required Packages:**
1464
-
1464
+
1465
1465
  - {{package_name}} {{version}} - {{purpose}}
1466
-
1466
+
1467
1467
  **Project Settings:**
1468
-
1468
+
1469
1469
  - Color Space: {{Linear|Gamma}}
1470
1470
  - Quality Settings: {{quality_levels}}
1471
1471
  - Physics Settings: {{physics_config}}
@@ -1479,9 +1479,9 @@ sections:
1479
1479
  **Memory Usage:** <{{memory_limit}}MB heap, <{{texture_memory}}MB textures
1480
1480
  **Load Times:** <{{load_time}}s initial, <{{level_load}}s between levels
1481
1481
  **Battery Usage:** Optimized for mobile devices - {{battery_target}} hours gameplay
1482
-
1482
+
1483
1483
  **Unity Profiler Targets:**
1484
-
1484
+
1485
1485
  - CPU Frame Time: <{{cpu_time}}ms
1486
1486
  - GPU Frame Time: <{{gpu_time}}ms
1487
1487
  - GC Allocs: <{{gc_limit}}KB per frame
@@ -1492,20 +1492,20 @@ sections:
1492
1492
  title: Platform Specific Requirements
1493
1493
  template: |
1494
1494
  **Desktop:**
1495
-
1495
+
1496
1496
  - Resolution: {{min_resolution}} - {{max_resolution}}
1497
1497
  - Input: Keyboard, Mouse, Gamepad ({{gamepad_support}})
1498
1498
  - Build Target: {{desktop_targets}}
1499
-
1499
+
1500
1500
  **Mobile:**
1501
-
1501
+
1502
1502
  - Resolution: {{mobile_min}} - {{mobile_max}}
1503
1503
  - Input: Touch, Accelerometer ({{sensor_support}})
1504
1504
  - OS: iOS {{ios_min}}+, Android {{android_min}}+ (API {{api_level}})
1505
1505
  - Device Requirements: {{device_specs}}
1506
-
1506
+
1507
1507
  **Web (if applicable):**
1508
-
1508
+
1509
1509
  - WebGL Version: {{webgl_version}}
1510
1510
  - Browser Support: {{browser_list}}
1511
1511
  - Compression: {{compression_format}}
@@ -1516,21 +1516,21 @@ sections:
1516
1516
  instruction: Define asset specifications for Unity pipeline optimization
1517
1517
  template: |
1518
1518
  **2D Art Assets:**
1519
-
1519
+
1520
1520
  - Sprites: {{sprite_resolution}} at {{ppu}} PPU
1521
1521
  - Texture Format: {{texture_compression}}
1522
1522
  - Atlas Strategy: {{sprite_atlas_setup}}
1523
1523
  - Animation: {{animation_type}} at {{framerate}} FPS
1524
-
1524
+
1525
1525
  **Audio Assets:**
1526
-
1526
+
1527
1527
  - Music: {{audio_format}} at {{sample_rate}} Hz
1528
1528
  - SFX: {{sfx_format}} at {{sfx_sample_rate}} Hz
1529
1529
  - Compression: {{audio_compression}}
1530
1530
  - 3D Audio: {{spatial_audio}}
1531
-
1531
+
1532
1532
  **UI Assets:**
1533
-
1533
+
1534
1534
  - Canvas Resolution: {{ui_resolution}}
1535
1535
  - UI Scale Mode: {{scale_mode}}
1536
1536
  - Font: {{font_requirements}}
@@ -1551,17 +1551,17 @@ sections:
1551
1551
  title: Code Architecture Pattern
1552
1552
  template: |
1553
1553
  **Architecture Pattern:** {{MVC|MVVM|ECS|Component-Based|Custom}}
1554
-
1554
+
1555
1555
  **Core Systems Required:**
1556
-
1556
+
1557
1557
  - **Scene Management:** {{scene_manager_approach}}
1558
1558
  - **State Management:** {{state_pattern_implementation}}
1559
1559
  - **Event System:** {{event_system_choice}}
1560
1560
  - **Object Pooling:** {{pooling_strategy}}
1561
1561
  - **Save/Load System:** {{save_system_approach}}
1562
-
1562
+
1563
1563
  **Folder Structure:**
1564
-
1564
+
1565
1565
  ```
1566
1566
  Assets/
1567
1567
  ├── _Project/
@@ -1571,9 +1571,9 @@ sections:
1571
1571
  │ ├── Scenes/
1572
1572
  │ └── {{additional_folders}}
1573
1573
  ```
1574
-
1574
+
1575
1575
  **Naming Conventions:**
1576
-
1576
+
1577
1577
  - Scripts: {{script_naming}}
1578
1578
  - Prefabs: {{prefab_naming}}
1579
1579
  - Scenes: {{scene_naming}}
@@ -1584,19 +1584,19 @@ sections:
1584
1584
  title: Unity Systems Integration
1585
1585
  template: |
1586
1586
  **Required Unity Systems:**
1587
-
1587
+
1588
1588
  - **Input System:** {{input_implementation}}
1589
1589
  - **Animation System:** {{animation_approach}}
1590
1590
  - **Physics Integration:** {{physics_usage}}
1591
1591
  - **Rendering Features:** {{rendering_requirements}}
1592
1592
  - **Asset Streaming:** {{asset_loading_strategy}}
1593
-
1593
+
1594
1594
  **Third-Party Integrations:**
1595
-
1595
+
1596
1596
  - {{integration_name}}: {{integration_purpose}}
1597
-
1597
+
1598
1598
  **Performance Systems:**
1599
-
1599
+
1600
1600
  - **Profiling Integration:** {{profiling_setup}}
1601
1601
  - **Memory Management:** {{memory_strategy}}
1602
1602
  - **Build Pipeline:** {{build_automation}}
@@ -1607,20 +1607,20 @@ sections:
1607
1607
  title: Data Management
1608
1608
  template: |
1609
1609
  **Save Data Architecture:**
1610
-
1610
+
1611
1611
  - **Format:** {{PlayerPrefs|JSON|Binary|Cloud}}
1612
1612
  - **Structure:** {{save_data_organization}}
1613
1613
  - **Encryption:** {{security_approach}}
1614
1614
  - **Cloud Sync:** {{cloud_integration}}
1615
-
1615
+
1616
1616
  **Configuration Data:**
1617
-
1617
+
1618
1618
  - **ScriptableObjects:** {{scriptable_object_usage}}
1619
1619
  - **Settings Management:** {{settings_system}}
1620
1620
  - **Localization:** {{localization_approach}}
1621
-
1621
+
1622
1622
  **Runtime Data:**
1623
-
1623
+
1624
1624
  - **Caching Strategy:** {{cache_implementation}}
1625
1625
  - **Memory Pools:** {{pooling_objects}}
1626
1626
  - **Asset References:** {{asset_reference_system}}
@@ -1848,15 +1848,15 @@ sections:
1848
1848
  instruction: Provide guidance for the Story Manager (SM) agent on how to break down this GDD into implementable user stories
1849
1849
  template: |
1850
1850
  **Epic Prioritization:** {{epic_order_rationale}}
1851
-
1851
+
1852
1852
  **Story Sizing Guidelines:**
1853
-
1853
+
1854
1854
  - Foundation stories: {{foundation_story_scope}}
1855
1855
  - Feature stories: {{feature_story_scope}}
1856
1856
  - Polish stories: {{polish_story_scope}}
1857
-
1857
+
1858
1858
  **Unity-Specific Story Considerations:**
1859
-
1859
+
1860
1860
  - Each story should result in testable Unity scenes or prefabs
1861
1861
  - Include specific Unity components and systems in acceptance criteria
1862
1862
  - Consider cross-platform testing requirements
@@ -1892,7 +1892,7 @@ sections:
1892
1892
  - id: initial-setup
1893
1893
  instruction: |
1894
1894
  This template creates comprehensive level design documentation that guides both content creation and technical implementation. This document should provide enough detail for developers to create level loading systems and for designers to create specific levels.
1895
-
1895
+
1896
1896
  If available, review: Game Design Document (GDD), Game Architecture Document. This document should align with the game mechanics and technical systems defined in those documents.
1897
1897
 
1898
1898
  - id: introduction
@@ -1900,7 +1900,7 @@ sections:
1900
1900
  instruction: Establish the purpose and scope of level design for this game
1901
1901
  content: |
1902
1902
  This document defines the level design framework for {{game_title}}, providing guidelines for creating engaging, balanced levels that support the core gameplay mechanics defined in the Game Design Document.
1903
-
1903
+
1904
1904
  This framework ensures consistency across all levels while providing flexibility for creative level design within established technical and design constraints.
1905
1905
  sections:
1906
1906
  - id: change-log
@@ -1947,29 +1947,29 @@ sections:
1947
1947
  title: "{{category_name}} Levels"
1948
1948
  template: |
1949
1949
  **Purpose:** {{gameplay_purpose}}
1950
-
1950
+
1951
1951
  **Target Duration:** {{min_time}} - {{max_time}} minutes
1952
-
1952
+
1953
1953
  **Difficulty Range:** {{difficulty_scale}}
1954
-
1954
+
1955
1955
  **Key Mechanics Featured:**
1956
-
1956
+
1957
1957
  - {{mechanic_1}} - {{usage_description}}
1958
1958
  - {{mechanic_2}} - {{usage_description}}
1959
-
1959
+
1960
1960
  **Player Objectives:**
1961
-
1961
+
1962
1962
  - Primary: {{primary_objective}}
1963
1963
  - Secondary: {{secondary_objective}}
1964
1964
  - Hidden: {{secret_objective}}
1965
-
1965
+
1966
1966
  **Success Criteria:**
1967
-
1967
+
1968
1968
  - {{completion_requirement_1}}
1969
1969
  - {{completion_requirement_2}}
1970
-
1970
+
1971
1971
  **Technical Requirements:**
1972
-
1972
+
1973
1973
  - Maximum entities: {{entity_limit}}
1974
1974
  - Performance target: {{fps_target}} FPS
1975
1975
  - Memory budget: {{memory_limit}}MB
@@ -1984,11 +1984,11 @@ sections:
1984
1984
  instruction: Based on GDD requirements, define the overall level organization
1985
1985
  template: |
1986
1986
  **Organization Type:** {{linear|hub_world|open_world}}
1987
-
1987
+
1988
1988
  **Total Level Count:** {{number}}
1989
-
1989
+
1990
1990
  **World Breakdown:**
1991
-
1991
+
1992
1992
  - World 1: {{level_count}} levels - {{theme}} - {{difficulty_range}}
1993
1993
  - World 2: {{level_count}} levels - {{theme}} - {{difficulty_range}}
1994
1994
  - World 3: {{level_count}} levels - {{theme}} - {{difficulty_range}}
@@ -2023,7 +2023,7 @@ sections:
2023
2023
  instruction: Define how players access new levels
2024
2024
  template: |
2025
2025
  **Progression Gates:**
2026
-
2026
+
2027
2027
  - Linear progression: Complete previous level
2028
2028
  - Star requirements: {{star_count}} stars to unlock
2029
2029
  - Skill gates: Demonstrate {{skill_requirement}}
@@ -2038,17 +2038,17 @@ sections:
2038
2038
  instruction: Define all environmental components that can be used in levels
2039
2039
  template: |
2040
2040
  **Terrain Types:**
2041
-
2041
+
2042
2042
  - {{terrain_1}}: {{properties_and_usage}}
2043
2043
  - {{terrain_2}}: {{properties_and_usage}}
2044
-
2044
+
2045
2045
  **Interactive Objects:**
2046
-
2046
+
2047
2047
  - {{object_1}}: {{behavior_and_purpose}}
2048
2048
  - {{object_2}}: {{behavior_and_purpose}}
2049
-
2049
+
2050
2050
  **Hazards and Obstacles:**
2051
-
2051
+
2052
2052
  - {{hazard_1}}: {{damage_and_behavior}}
2053
2053
  - {{hazard_2}}: {{damage_and_behavior}}
2054
2054
  - id: collectibles-rewards
@@ -2056,18 +2056,18 @@ sections:
2056
2056
  instruction: Define all collectible items and their placement rules
2057
2057
  template: |
2058
2058
  **Collectible Types:**
2059
-
2059
+
2060
2060
  - {{collectible_1}}: {{value_and_purpose}}
2061
2061
  - {{collectible_2}}: {{value_and_purpose}}
2062
-
2062
+
2063
2063
  **Placement Guidelines:**
2064
-
2064
+
2065
2065
  - Mandatory collectibles: {{placement_rules}}
2066
2066
  - Optional collectibles: {{placement_rules}}
2067
2067
  - Secret collectibles: {{placement_rules}}
2068
-
2068
+
2069
2069
  **Reward Distribution:**
2070
-
2070
+
2071
2071
  - Easy to find: {{percentage}}%
2072
2072
  - Moderate challenge: {{percentage}}%
2073
2073
  - High skill required: {{percentage}}%
@@ -2076,18 +2076,18 @@ sections:
2076
2076
  instruction: Define how enemies should be placed and balanced in levels
2077
2077
  template: |
2078
2078
  **Enemy Categories:**
2079
-
2079
+
2080
2080
  - {{enemy_type_1}}: {{behavior_and_usage}}
2081
2081
  - {{enemy_type_2}}: {{behavior_and_usage}}
2082
-
2082
+
2083
2083
  **Placement Principles:**
2084
-
2084
+
2085
2085
  - Introduction encounters: {{guideline}}
2086
2086
  - Standard encounters: {{guideline}}
2087
2087
  - Challenge encounters: {{guideline}}
2088
-
2088
+
2089
2089
  **Difficulty Scaling:**
2090
-
2090
+
2091
2091
  - Enemy count progression: {{scaling_rule}}
2092
2092
  - Enemy type introduction: {{pacing_rule}}
2093
2093
  - Encounter complexity: {{complexity_rule}}
@@ -2100,14 +2100,14 @@ sections:
2100
2100
  title: Level Layout Principles
2101
2101
  template: |
2102
2102
  **Spatial Design:**
2103
-
2103
+
2104
2104
  - Grid size: {{grid_dimensions}}
2105
2105
  - Minimum path width: {{width_units}}
2106
2106
  - Maximum vertical distance: {{height_units}}
2107
2107
  - Safe zones placement: {{safety_guidelines}}
2108
-
2108
+
2109
2109
  **Navigation Design:**
2110
-
2110
+
2111
2111
  - Clear path indication: {{visual_cues}}
2112
2112
  - Landmark placement: {{landmark_rules}}
2113
2113
  - Dead end avoidance: {{dead_end_policy}}
@@ -2117,13 +2117,13 @@ sections:
2117
2117
  instruction: Define how to control the rhythm and pace of gameplay within levels
2118
2118
  template: |
2119
2119
  **Action Sequences:**
2120
-
2120
+
2121
2121
  - High intensity duration: {{max_duration}}
2122
2122
  - Rest period requirement: {{min_rest_time}}
2123
2123
  - Intensity variation: {{pacing_pattern}}
2124
-
2124
+
2125
2125
  **Learning Sequences:**
2126
-
2126
+
2127
2127
  - New mechanic introduction: {{teaching_method}}
2128
2128
  - Practice opportunity: {{practice_duration}}
2129
2129
  - Skill application: {{application_context}}
@@ -2132,14 +2132,14 @@ sections:
2132
2132
  instruction: Define how to create appropriate challenges for each level type
2133
2133
  template: |
2134
2134
  **Challenge Types:**
2135
-
2135
+
2136
2136
  - Execution challenges: {{skill_requirements}}
2137
2137
  - Puzzle challenges: {{complexity_guidelines}}
2138
2138
  - Time challenges: {{time_pressure_rules}}
2139
2139
  - Resource challenges: {{resource_management}}
2140
-
2140
+
2141
2141
  **Difficulty Calibration:**
2142
-
2142
+
2143
2143
  - Skill check frequency: {{frequency_guidelines}}
2144
2144
  - Failure recovery: {{retry_mechanics}}
2145
2145
  - Hint system integration: {{help_system}}
@@ -2153,7 +2153,7 @@ sections:
2153
2153
  instruction: Define how level data should be structured for implementation
2154
2154
  template: |
2155
2155
  **Level File Format:**
2156
-
2156
+
2157
2157
  - Data format: {{json|yaml|custom}}
2158
2158
  - File naming: `level_{{world}}_{{number}}.{{extension}}`
2159
2159
  - Data organization: {{structure_description}}
@@ -2191,14 +2191,14 @@ sections:
2191
2191
  instruction: Define how level assets are organized and loaded
2192
2192
  template: |
2193
2193
  **Tilemap Requirements:**
2194
-
2194
+
2195
2195
  - Tile size: {{tile_dimensions}}px
2196
2196
  - Tileset organization: {{tileset_structure}}
2197
2197
  - Layer organization: {{layer_system}}
2198
2198
  - Collision data: {{collision_format}}
2199
-
2199
+
2200
2200
  **Audio Integration:**
2201
-
2201
+
2202
2202
  - Background music: {{music_requirements}}
2203
2203
  - Ambient sounds: {{ambient_system}}
2204
2204
  - Dynamic audio: {{dynamic_audio_rules}}
@@ -2207,19 +2207,19 @@ sections:
2207
2207
  instruction: Define performance requirements for level systems
2208
2208
  template: |
2209
2209
  **Entity Limits:**
2210
-
2210
+
2211
2211
  - Maximum active entities: {{entity_limit}}
2212
2212
  - Maximum particles: {{particle_limit}}
2213
2213
  - Maximum audio sources: {{audio_limit}}
2214
-
2214
+
2215
2215
  **Memory Management:**
2216
-
2216
+
2217
2217
  - Texture memory budget: {{texture_memory}}MB
2218
2218
  - Audio memory budget: {{audio_memory}}MB
2219
2219
  - Level loading time: <{{load_time}}s
2220
-
2220
+
2221
2221
  **Culling and LOD:**
2222
-
2222
+
2223
2223
  - Off-screen culling: {{culling_distance}}
2224
2224
  - Level-of-detail rules: {{lod_system}}
2225
2225
  - Asset streaming: {{streaming_requirements}}
@@ -2232,13 +2232,13 @@ sections:
2232
2232
  title: Automated Testing
2233
2233
  template: |
2234
2234
  **Performance Testing:**
2235
-
2235
+
2236
2236
  - Frame rate validation: Maintain {{fps_target}} FPS
2237
2237
  - Memory usage monitoring: Stay under {{memory_limit}}MB
2238
2238
  - Loading time verification: Complete in <{{load_time}}s
2239
-
2239
+
2240
2240
  **Gameplay Testing:**
2241
-
2241
+
2242
2242
  - Completion path validation: All objectives achievable
2243
2243
  - Collectible accessibility: All items reachable
2244
2244
  - Softlock prevention: No unwinnable states
@@ -2266,14 +2266,14 @@ sections:
2266
2266
  title: Balance Validation
2267
2267
  template: |
2268
2268
  **Metrics Collection:**
2269
-
2269
+
2270
2270
  - Completion rate: Target {{completion_percentage}}%
2271
2271
  - Average completion time: {{target_time}} ± {{variance}}
2272
2272
  - Death count per level: <{{max_deaths}}
2273
2273
  - Collectible discovery rate: {{discovery_percentage}}%
2274
-
2274
+
2275
2275
  **Iteration Guidelines:**
2276
-
2276
+
2277
2277
  - Adjustment criteria: {{criteria_for_changes}}
2278
2278
  - Testing sample size: {{minimum_testers}}
2279
2279
  - Validation period: {{testing_duration}}
@@ -2286,14 +2286,14 @@ sections:
2286
2286
  title: Design Phase
2287
2287
  template: |
2288
2288
  **Concept Development:**
2289
-
2289
+
2290
2290
  1. Define level purpose and goals
2291
2291
  2. Create rough layout sketch
2292
2292
  3. Identify key mechanics and challenges
2293
2293
  4. Estimate difficulty and duration
2294
-
2294
+
2295
2295
  **Documentation Requirements:**
2296
-
2296
+
2297
2297
  - Level design brief
2298
2298
  - Layout diagrams
2299
2299
  - Mechanic integration notes
@@ -2302,15 +2302,15 @@ sections:
2302
2302
  title: Implementation Phase
2303
2303
  template: |
2304
2304
  **Technical Implementation:**
2305
-
2305
+
2306
2306
  1. Create level data file
2307
2307
  2. Build tilemap and layout
2308
2308
  3. Place entities and objects
2309
2309
  4. Configure level logic and triggers
2310
2310
  5. Integrate audio and visual effects
2311
-
2311
+
2312
2312
  **Quality Assurance:**
2313
-
2313
+
2314
2314
  1. Automated testing execution
2315
2315
  2. Internal playtesting
2316
2316
  3. Performance validation
@@ -2319,14 +2319,14 @@ sections:
2319
2319
  title: Integration Phase
2320
2320
  template: |
2321
2321
  **Game Integration:**
2322
-
2322
+
2323
2323
  1. Level progression integration
2324
2324
  2. Save system compatibility
2325
2325
  3. Analytics integration
2326
2326
  4. Achievement system integration
2327
-
2327
+
2328
2328
  **Final Validation:**
2329
-
2329
+
2330
2330
  1. Full game context testing
2331
2331
  2. Performance regression testing
2332
2332
  3. Platform compatibility verification
@@ -2379,7 +2379,7 @@ sections:
2379
2379
  - id: initial-setup
2380
2380
  instruction: |
2381
2381
  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.
2382
-
2382
+
2383
2383
  This brief is typically created early in the ideation process, often after brainstorming sessions, to crystallize the game concept before moving into detailed design.
2384
2384
 
2385
2385
  - id: game-vision
@@ -2436,7 +2436,7 @@ sections:
2436
2436
  repeatable: true
2437
2437
  template: |
2438
2438
  **Core Mechanic: {{mechanic_name}}**
2439
-
2439
+
2440
2440
  - **Description:** {{how_it_works}}
2441
2441
  - **Player Value:** {{why_its_fun}}
2442
2442
  - **Implementation Scope:** {{complexity_estimate}}
@@ -2463,12 +2463,12 @@ sections:
2463
2463
  title: Technical Constraints
2464
2464
  template: |
2465
2465
  **Platform Requirements:**
2466
-
2466
+
2467
2467
  - Primary: {{platform_1}} - {{requirements}}
2468
2468
  - Secondary: {{platform_2}} - {{requirements}}
2469
-
2469
+
2470
2470
  **Technical Specifications:**
2471
-
2471
+
2472
2472
  - Engine: Unity & C#
2473
2473
  - Performance Target: {{fps_target}} FPS on {{target_device}}
2474
2474
  - Memory Budget: <{{memory_limit}}MB
@@ -2506,10 +2506,10 @@ sections:
2506
2506
  title: Competitive Analysis
2507
2507
  template: |
2508
2508
  **Direct Competitors:**
2509
-
2509
+
2510
2510
  - {{competitor_1}}: {{strengths_and_weaknesses}}
2511
2511
  - {{competitor_2}}: {{strengths_and_weaknesses}}
2512
-
2512
+
2513
2513
  **Differentiation Strategy:**
2514
2514
  {{how_we_differ_and_why_thats_valuable}}
2515
2515
  - id: market-opportunity
@@ -2533,16 +2533,16 @@ sections:
2533
2533
  title: Content Categories
2534
2534
  template: |
2535
2535
  **Core Content:**
2536
-
2536
+
2537
2537
  - {{content_type_1}}: {{quantity_and_description}}
2538
2538
  - {{content_type_2}}: {{quantity_and_description}}
2539
-
2539
+
2540
2540
  **Optional Content:**
2541
-
2541
+
2542
2542
  - {{optional_content_type}}: {{quantity_and_description}}
2543
-
2543
+
2544
2544
  **Replay Elements:**
2545
-
2545
+
2546
2546
  - {{replayability_features}}
2547
2547
  - id: difficulty-accessibility
2548
2548
  title: Difficulty and Accessibility
@@ -2609,13 +2609,13 @@ sections:
2609
2609
  title: Player Experience Metrics
2610
2610
  template: |
2611
2611
  **Engagement Goals:**
2612
-
2612
+
2613
2613
  - Tutorial completion rate: >{{percentage}}%
2614
2614
  - Average session length: {{duration}} minutes
2615
2615
  - Player retention: D1 {{d1}}%, D7 {{d7}}%, D30 {{d30}}%
2616
-
2616
+
2617
2617
  **Quality Benchmarks:**
2618
-
2618
+
2619
2619
  - Player satisfaction: >{{rating}}/10
2620
2620
  - Completion rate: >{{percentage}}%
2621
2621
  - Technical performance: {{fps_target}} FPS consistent
@@ -2623,13 +2623,13 @@ sections:
2623
2623
  title: Development Metrics
2624
2624
  template: |
2625
2625
  **Technical Targets:**
2626
-
2626
+
2627
2627
  - Zero critical bugs at launch
2628
2628
  - Performance targets met on all platforms
2629
2629
  - Load times under {{seconds}}s
2630
-
2630
+
2631
2631
  **Process Goals:**
2632
-
2632
+
2633
2633
  - Development timeline adherence
2634
2634
  - Feature scope completion
2635
2635
  - Quality assurance standards
@@ -2638,7 +2638,7 @@ sections:
2638
2638
  condition: has_business_goals
2639
2639
  template: |
2640
2640
  **Commercial Goals:**
2641
-
2641
+
2642
2642
  - {{revenue_target}} in first {{time_period}}
2643
2643
  - {{user_acquisition_target}} players in first {{time_period}}
2644
2644
  - {{retention_target}} monthly active users
@@ -2691,12 +2691,12 @@ sections:
2691
2691
  title: Validation Plan
2692
2692
  template: |
2693
2693
  **Concept Testing:**
2694
-
2694
+
2695
2695
  - {{validation_method_1}} - {{timeline}}
2696
2696
  - {{validation_method_2}} - {{timeline}}
2697
-
2697
+
2698
2698
  **Prototype Testing:**
2699
-
2699
+
2700
2700
  - {{testing_approach}} - {{timeline}}
2701
2701
  - {{feedback_collection_method}} - {{timeline}}
2702
2702
 
@@ -3384,7 +3384,7 @@ Use the `shard-doc` task or `@kayvan/markdown-tree-parser` tool for automatic ga
3384
3384
 
3385
3385
  - **Claude Code**: `/bmad2du/game-designer`, `/bmad2du/game-developer`, `/bmad2du/game-sm`, `/bmad2du/game-architect`
3386
3386
  - **Cursor**: `@bmad2du/game-designer`, `@bmad2du/game-developer`, `@bmad2du/game-sm`, `@bmad2du/game-architect`
3387
- - **Windsurf**: `@bmad2du/game-designer`, `@bmad2du/game-developer`, `@bmad2du/game-sm`, `@bmad2du/game-architect`
3387
+ - **Windsurf**: `/bmad2du/game-designer`, `/bmad2du/game-developer`, `/bmad2du/game-sm`, `/bmad2du/game-architect`
3388
3388
  - **Trae**: `@bmad2du/game-designer`, `@bmad2du/game-developer`, `@bmad2du/game-sm`, `@bmad2du/game-architect`
3389
3389
  - **Roo Code**: Select mode from mode selector with bmad2du prefix
3390
3390
  - **GitHub Copilot**: Open the Chat view (`⌃⌘I` on Mac, `Ctrl+Alt+I` on Windows/Linux) and select the appropriate game agent.