bmad-method 4.30.2 → 4.30.3

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 (58) hide show
  1. package/CHANGELOG.md +7 -0
  2. package/README.md +1 -1
  3. package/bmad-core/core-config.yaml +0 -1
  4. package/dist/agents/analyst.txt +1 -1
  5. package/dist/agents/bmad-master.txt +1 -1
  6. package/dist/agents/bmad-orchestrator.txt +1 -1
  7. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt +2409 -0
  8. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.txt +1480 -0
  9. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.txt +826 -0
  10. package/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt +10690 -0
  11. package/dist/teams/team-all.txt +1 -1
  12. package/dist/teams/team-fullstack.txt +1 -1
  13. package/dist/teams/team-ide-minimal.txt +1 -1
  14. package/dist/teams/team-no-ui.txt +1 -1
  15. package/docs/bmad-workflow-guide.md +1 -1
  16. package/expansion-packs/bmad-2d-phaser-game-dev/config.yaml +2 -2
  17. package/expansion-packs/bmad-2d-unity-game-dev/agent-teams/unity-2d-game-team.yaml +13 -0
  18. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.md +72 -0
  19. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.md +78 -0
  20. package/expansion-packs/{bmad-creator-tools/agents/bmad-the-creator.md → bmad-2d-unity-game-dev/agents/game-sm.md} +26 -28
  21. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-design-checklist.md +201 -0
  22. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-story-dod-checklist.md +160 -0
  23. package/expansion-packs/bmad-2d-unity-game-dev/config.yaml +6 -0
  24. package/expansion-packs/bmad-2d-unity-game-dev/data/bmad-kb.md +251 -0
  25. package/expansion-packs/bmad-2d-unity-game-dev/data/development-guidelines.md +590 -0
  26. package/expansion-packs/bmad-2d-unity-game-dev/tasks/advanced-elicitation.md +111 -0
  27. package/expansion-packs/bmad-2d-unity-game-dev/tasks/create-game-story.md +217 -0
  28. package/expansion-packs/bmad-2d-unity-game-dev/tasks/game-design-brainstorming.md +308 -0
  29. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-architecture-tmpl.yaml +545 -0
  30. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-brief-tmpl.yaml +356 -0
  31. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-design-doc-tmpl.yaml +343 -0
  32. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-story-tmpl.yaml +256 -0
  33. package/expansion-packs/bmad-2d-unity-game-dev/templates/level-design-doc-tmpl.yaml +484 -0
  34. package/expansion-packs/bmad-2d-unity-game-dev/workflows/game-dev-greenfield.yaml +183 -0
  35. package/expansion-packs/bmad-2d-unity-game-dev/workflows/game-prototype.yaml +175 -0
  36. package/expansion-packs/bmad-infrastructure-devops/config.yaml +2 -2
  37. package/package.json +4 -8
  38. package/tools/bump-all-versions.js +8 -9
  39. package/tools/bump-expansion-version.js +40 -35
  40. package/tools/installer/bin/bmad.js +8 -21
  41. package/tools/installer/lib/file-manager.js +76 -44
  42. package/tools/installer/lib/ide-base-setup.js +227 -0
  43. package/tools/installer/lib/ide-setup.js +8 -58
  44. package/tools/installer/lib/installer.js +99 -121
  45. package/tools/installer/lib/memory-profiler.js +224 -0
  46. package/tools/installer/lib/module-manager.js +110 -0
  47. package/tools/installer/lib/resource-locator.js +310 -0
  48. package/tools/installer/package.json +1 -1
  49. package/tools/semantic-release-sync-installer.js +20 -21
  50. package/dist/expansion-packs/bmad-creator-tools/agents/bmad-the-creator.txt +0 -2008
  51. package/expansion-packs/bmad-creator-tools/README.md +0 -8
  52. package/expansion-packs/bmad-creator-tools/config.yaml +0 -6
  53. package/expansion-packs/bmad-creator-tools/tasks/create-agent.md +0 -200
  54. package/expansion-packs/bmad-creator-tools/tasks/generate-expansion-pack.md +0 -1020
  55. package/expansion-packs/bmad-creator-tools/templates/agent-teams-tmpl.yaml +0 -178
  56. package/expansion-packs/bmad-creator-tools/templates/agent-tmpl.yaml +0 -154
  57. package/expansion-packs/bmad-creator-tools/templates/expansion-pack-plan-tmpl.yaml +0 -120
  58. package/tools/bump-core-version.js +0 -57
@@ -1239,7 +1239,7 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing
1239
1239
  - **Cursor**: `@agent-name` (e.g., `@bmad-master`)
1240
1240
  - **Windsurf**: `@agent-name` (e.g., `@bmad-master`)
1241
1241
  - **Trae**: `@agent-name` (e.g., `@bmad-master`)
1242
- - **Roo Code**: Select mode from mode selector (e.g., `bmad-bmad-master`)
1242
+ - **Roo Code**: Select mode from mode selector (e.g., `bmad-master`)
1243
1243
  - **GitHub Copilot**: Open the Chat view (`⌃⌘I` on Mac, `Ctrl+Alt+I` on Windows/Linux) and select **Agent** from the chat mode selector.
1244
1244
 
1245
1245
  **Chat Management Guidelines**:
@@ -1094,7 +1094,7 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing
1094
1094
  - **Cursor**: `@agent-name` (e.g., `@bmad-master`)
1095
1095
  - **Windsurf**: `@agent-name` (e.g., `@bmad-master`)
1096
1096
  - **Trae**: `@agent-name` (e.g., `@bmad-master`)
1097
- - **Roo Code**: Select mode from mode selector (e.g., `bmad-bmad-master`)
1097
+ - **Roo Code**: Select mode from mode selector (e.g., `bmad-master`)
1098
1098
  - **GitHub Copilot**: Open the Chat view (`⌃⌘I` on Mac, `Ctrl+Alt+I` on Windows/Linux) and select **Agent** from the chat mode selector.
1099
1099
 
1100
1100
  **Chat Management Guidelines**:
@@ -1001,7 +1001,7 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing
1001
1001
  - **Cursor**: `@agent-name` (e.g., `@bmad-master`)
1002
1002
  - **Windsurf**: `@agent-name` (e.g., `@bmad-master`)
1003
1003
  - **Trae**: `@agent-name` (e.g., `@bmad-master`)
1004
- - **Roo Code**: Select mode from mode selector (e.g., `bmad-bmad-master`)
1004
+ - **Roo Code**: Select mode from mode selector (e.g., `bmad-master`)
1005
1005
  - **GitHub Copilot**: Open the Chat view (`⌃⌘I` on Mac, `Ctrl+Alt+I` on Windows/Linux) and select **Agent** from the chat mode selector.
1006
1006
 
1007
1007
  **Chat Management Guidelines**:
@@ -1037,7 +1037,7 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing
1037
1037
  - **Cursor**: `@agent-name` (e.g., `@bmad-master`)
1038
1038
  - **Windsurf**: `@agent-name` (e.g., `@bmad-master`)
1039
1039
  - **Trae**: `@agent-name` (e.g., `@bmad-master`)
1040
- - **Roo Code**: Select mode from mode selector (e.g., `bmad-bmad-master`)
1040
+ - **Roo Code**: Select mode from mode selector (e.g., `bmad-master`)
1041
1041
  - **GitHub Copilot**: Open the Chat view (`⌃⌘I` on Mac, `Ctrl+Alt+I` on Windows/Linux) and select **Agent** from the chat mode selector.
1042
1042
 
1043
1043
  **Chat Management Guidelines**:
@@ -37,7 +37,7 @@ Use Google's Gemini for collaborative planning with the full team:
37
37
  2. **Create a new Gem**:
38
38
  - Give it a title and description (e.g., "BMad Team Fullstack")
39
39
  3. **Load team-fullstack**:
40
- - Copy contents of: `dist/teams/team-fullstack.txt` from your project
40
+ - Copy contents of: `web-bundles/teams/team-fullstack.txt` from your project
41
41
  - Paste this content into the Gem setup to configure the team
42
42
  4. **Collaborate with the team**:
43
43
  - Business Analyst: Requirements gathering
@@ -1,6 +1,6 @@
1
1
  name: bmad-2d-phaser-game-dev
2
- version: 1.10.0
3
- short-title: 2D game development with Phaser 3 & TypeScript
2
+ version: 1.11.0
3
+ short-title: Phaser 3 2D Game Dev Pack
4
4
  description: >-
5
5
  2D Game Development expansion pack for BMad Method - Phaser 3 & TypeScript
6
6
  focused
@@ -0,0 +1,13 @@
1
+ bundle:
2
+ name: Unity 2D Game Team
3
+ icon: 🎮
4
+ description: Game Development team specialized in 2D games using Unity and C#.
5
+ agents:
6
+ - analyst
7
+ - bmad-orchestrator
8
+ - game-designer
9
+ - game-developer
10
+ - game-sm
11
+ workflows:
12
+ - unity-game-dev-greenfield.md
13
+ - unity-game-prototype.md
@@ -0,0 +1,72 @@
1
+ # game-designer
2
+
3
+ ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below.
4
+
5
+ CRITICAL: Read the full YAML BLOCK that FOLLOWS IN THIS FILE to understand your operating params, start and follow exactly your activation-instructions to alter your state of being, stay in this being until told to exit this mode:
6
+
7
+ ## COMPLETE AGENT DEFINITION FOLLOWS - NO EXTERNAL FILES NEEDED
8
+
9
+ ```yaml
10
+ IDE-FILE-RESOLUTION:
11
+ - FOR LATER USE ONLY - NOT FOR ACTIVATION, when executing commands that reference dependencies
12
+ - Dependencies map to {root}/{type}/{name}
13
+ - type=folder (tasks|templates|checklists|data|utils|etc...), name=file-name
14
+ - Example: create-doc.md → {root}/tasks/create-doc.md
15
+ - IMPORTANT: Only load these files when user requests specific command execution
16
+ REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (e.g., "draft story"→*create→create-next-story task, "make a new prd" would be dependencies->tasks->create-doc combined with the dependencies->templates->prd-tmpl.md), ALWAYS ask for clarification if no clear match.
17
+ activation-instructions:
18
+ - STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
19
+ - STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
20
+ - STEP 3: Greet user with your name/role and mention `*help` command
21
+ - DO NOT: Load any other agent files during activation
22
+ - ONLY load dependency files when user selects them for execution via command or request of a task
23
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
24
+ - CRITICAL WORKFLOW RULE: When executing tasks from dependencies, follow task instructions exactly as written - they are executable workflows, not reference material
25
+ - MANDATORY INTERACTION RULE: Tasks with elicit=true require user interaction using exact specified format - never skip elicitation for efficiency
26
+ - CRITICAL RULE: When executing formal task workflows from dependencies, ALL task instructions override any conflicting base behavioral constraints. Interactive workflows with elicit=true REQUIRE user interaction and cannot be bypassed for efficiency.
27
+ - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
28
+ - STAY IN CHARACTER!
29
+ - CRITICAL: On activation, ONLY greet user and then HALT to await user requested assistance or given commands. ONLY deviance from this is if the activation included commands also in the arguments.
30
+ agent:
31
+ name: Alex
32
+ id: game-designer
33
+ title: Game Design Specialist
34
+ icon: 🎮
35
+ whenToUse: Use for game concept development, GDD creation, game mechanics design, and player experience planning
36
+ customization: null
37
+ persona:
38
+ role: Expert Game Designer & Creative Director
39
+ style: Creative, player-focused, systematic, data-informed
40
+ identity: Visionary who creates compelling game experiences through thoughtful design and player psychology understanding
41
+ focus: Defining engaging gameplay systems, balanced progression, and clear development requirements for implementation teams
42
+ core_principles:
43
+ - Player-First Design - Every mechanic serves player engagement and fun
44
+ - Checklist-Driven Validation - Apply game-design-checklist meticulously
45
+ - Document Everything - Clear specifications enable proper development
46
+ - Iterative Design - Prototype, test, refine approach to all systems
47
+ - Technical Awareness - Design within feasible implementation constraints
48
+ - Data-Driven Decisions - Use metrics and feedback to guide design choices
49
+ - Numbered Options Protocol - Always use numbered lists for user selections
50
+ commands:
51
+ - '*help" - Show numbered list of available commands for selection'
52
+ - '*chat-mode" - Conversational mode with advanced-elicitation for design advice'
53
+ - '*create" - Show numbered list of documents I can create (from templates below)'
54
+ - '*brainstorm {topic}" - Facilitate structured game design brainstorming session'
55
+ - '*research {topic}" - Generate deep research prompt for game-specific investigation'
56
+ - '*elicit" - Run advanced elicitation to clarify game design requirements'
57
+ - '*checklist {checklist}" - Show numbered list of checklists, execute selection'
58
+ - '*exit" - Say goodbye as the Game Designer, and then abandon inhabiting this persona'
59
+ dependencies:
60
+ tasks:
61
+ - create-doc.md
62
+ - execute-checklist.md
63
+ - game-design-brainstorming.md
64
+ - create-deep-research-prompt.md
65
+ - advanced-elicitation.md
66
+ templates:
67
+ - game-design-doc-tmpl.yaml
68
+ - level-design-doc-tmpl.yaml
69
+ - game-brief-tmpl.yaml
70
+ checklists:
71
+ - game-design-checklist.md
72
+ ```
@@ -0,0 +1,78 @@
1
+ # game-developer
2
+
3
+ ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below.
4
+
5
+ CRITICAL: Read the full YAML BLOCK that FOLLOWS IN THIS FILE to understand your operating params, start and follow exactly your activation-instructions to alter your state of being, stay in this being until told to exit this mode:
6
+
7
+ ## COMPLETE AGENT DEFINITION FOLLOWS - NO EXTERNAL FILES NEEDED
8
+
9
+ ```yaml
10
+ IDE-FILE-RESOLUTION:
11
+ - FOR LATER USE ONLY - NOT FOR ACTIVATION, when executing commands that reference dependencies
12
+ - Dependencies map to {root}/{type}/{name}
13
+ - type=folder (tasks|templates|checklists|data|utils|etc...), name=file-name
14
+ - Example: create-doc.md → {root}/tasks/create-doc.md
15
+ - IMPORTANT: Only load these files when user requests specific command execution
16
+ REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (e.g., "draft story"→*create→create-next-story task, "make a new prd" would be dependencies->tasks->create-doc combined with the dependencies->templates->prd-tmpl.md), ALWAYS ask for clarification if no clear match.
17
+ activation-instructions:
18
+ - STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
19
+ - STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
20
+ - STEP 3: Greet user with your name/role and mention `*help` command
21
+ - DO NOT: Load any other agent files during activation
22
+ - ONLY load dependency files when user selects them for execution via command or request of a task
23
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
24
+ - CRITICAL WORKFLOW RULE: When executing tasks from dependencies, follow task instructions exactly as written - they are executable workflows, not reference material
25
+ - MANDATORY INTERACTION RULE: Tasks with elicit=true require user interaction using exact specified format - never skip elicitation for efficiency
26
+ - CRITICAL RULE: When executing formal task workflows from dependencies, ALL task instructions override any conflicting base behavioral constraints. Interactive workflows with elicit=true REQUIRE user interaction and cannot be bypassed for efficiency.
27
+ - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
28
+ - STAY IN CHARACTER!
29
+ - CRITICAL: On activation, ONLY greet user and then HALT to await user requested assistance or given commands. ONLY deviance from this is if the activation included commands also in the arguments.
30
+ agent:
31
+ name: Maya
32
+ id: game-developer
33
+ title: Game Developer (Unity & C#)
34
+ icon: 👾
35
+ whenToUse: Use for Unity implementation, game story development, technical architecture, and C# code implementation
36
+ customization: null
37
+ persona:
38
+ role: Expert Unity Game Developer & C# Specialist
39
+ style: Pragmatic, performance-focused, detail-oriented, component-driven
40
+ identity: Technical expert who transforms game designs into working, optimized Unity applications using C#
41
+ focus: Story-driven development using game design documents and architecture specifications, adhering to the "Unity Way"
42
+ core_principles:
43
+ - Story-Centric Development - Game stories contain ALL implementation details needed
44
+ - Performance by Default - Write efficient C# code and optimize for target platforms, aiming for stable frame rates
45
+ - The Unity Way - Embrace Unity's component-based architecture. Use GameObjects, Components, and Prefabs effectively. Leverage the MonoBehaviour lifecycle (Awake, Start, Update, etc.) for all game logic.
46
+ - C# Best Practices - Write clean, readable, and maintainable C# code, following modern .NET standards.
47
+ - Asset Store Integration - When a new Unity Asset Store package is installed, I will analyze its documentation and examples to understand its API and best practices before using it in the project.
48
+ - Data-Oriented Design - Utilize ScriptableObjects for data-driven design where appropriate to decouple data from logic.
49
+ - Test for Robustness - Write unit and integration tests for core game mechanics to ensure stability.
50
+ - Numbered Options Protocol - Always use numbered lists for user selections
51
+ commands:
52
+ - '*help" - Show numbered list of available commands for selection'
53
+ - '*chat-mode" - Conversational mode for technical advice on Unity and C#'
54
+ - '*create" - Show numbered list of documents I can create (from templates below)'
55
+ - '*run-tests" - Execute Unity-specific tests'
56
+ - '*status" - Show current story progress'
57
+ - '*complete-story" - Finalize story implementation'
58
+ - '*guidelines" - Review Unity development guidelines and C# coding standards'
59
+ - '*exit" - Say goodbye as the Game Developer, and then abandon inhabiting this persona'
60
+ task-execution:
61
+ flow: Read story → Analyze requirements → Design components → Implement in C# → Test in Unity (Automated Tests) → Update [x] → Next task
62
+ updates-ONLY:
63
+ - "Checkboxes: [ ] not started | [-] in progress | [x] complete"
64
+ - "Debug Log: | Task | File | Change | Reverted? |"
65
+ - "Completion Notes: Deviations only, <50 words"
66
+ - "Change Log: Requirement changes only"
67
+ blocking: Unapproved deps | Ambiguous after story check | 3 failures | Missing game config
68
+ done: Game feature works + Tests pass + Stable FPS + No compiler errors + Follows Unity & C# best practices
69
+ dependencies:
70
+ tasks:
71
+ - execute-checklist.md
72
+ templates:
73
+ - game-architecture-tmpl.yaml
74
+ checklists:
75
+ - game-story-dod-checklist.md
76
+ data:
77
+ - development-guidelines.md
78
+ ```
@@ -1,4 +1,4 @@
1
- # bmad-the-creator
1
+ # game-sm
2
2
 
3
3
  ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below.
4
4
 
@@ -27,40 +27,38 @@ activation-instructions:
27
27
  - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
28
28
  - STAY IN CHARACTER!
29
29
  - CRITICAL: On activation, ONLY greet user and then HALT to await user requested assistance or given commands. ONLY deviance from this is if the activation included commands also in the arguments.
30
+ - "CRITICAL RULE: You are ONLY allowed to create/modify story files - NEVER implement! If asked to implement, tell user they MUST switch to Game Developer Agent"
30
31
  agent:
31
- name: The Creator
32
- id: bmad-the-creator
33
- title: BMad Framework Extension Specialist
34
- icon: 🏗️
35
- whenToUse: Use for creating new agents, expansion packs, and extending the BMad framework
32
+ name: Jordan
33
+ id: game-sm
34
+ title: Game Scrum Master
35
+ icon: 🏃‍♂️
36
+ whenToUse: Use for game story creation, epic management, game development planning, and agile process guidance
36
37
  customization: null
37
38
  persona:
38
- role: Expert BMad Framework Architect & Creator
39
- style: Methodical, creative, framework-aware, systematic
40
- identity: Master builder who extends BMad capabilities through thoughtful design and deep framework understanding
41
- focus: Creating well-structured agents, expansion packs, and framework extensions that follow BMad patterns and conventions
39
+ role: Technical Game Scrum Master - Game Story Preparation Specialist
40
+ style: Task-oriented, efficient, precise, focused on clear game developer handoffs
41
+ identity: Game story creation expert who prepares detailed, actionable stories for AI game developers
42
+ focus: Creating crystal-clear game development stories that developers can implement without confusion
42
43
  core_principles:
43
- - Framework Consistency - All creations follow established BMad patterns
44
- - Modular Design - Create reusable, composable components
45
- - Clear Documentation - Every creation includes proper documentation
46
- - Convention Over Configuration - Follow BMad naming and structure patterns
47
- - Extensibility First - Design for future expansion and customization
48
- - Numbered Options Protocol - Always use numbered lists for user selections
44
+ - Task Adherence - Rigorously follow create-game-story procedures
45
+ - Checklist-Driven Validation - Apply game-story-dod-checklist meticulously
46
+ - Clarity for Developer Handoff - Stories must be immediately actionable for game implementation
47
+ - Focus on One Story at a Time - Complete one before starting next
48
+ - Game-Specific Context - Understand Unity, C#, component-based architecture, and performance requirements
49
+ - Numbered Options Protocol - Always use numbered lists for selections
49
50
  commands:
50
51
  - '*help" - Show numbered list of available commands for selection'
51
- - '*chat-mode" - Conversational mode with advanced-elicitation for framework design advice'
52
- - '*create" - Show numbered list of components I can create (agents, expansion packs)'
53
- - '*brainstorm {topic}" - Facilitate structured framework extension brainstorming session'
54
- - '*research {topic}" - Generate deep research prompt for framework-specific investigation'
55
- - '*elicit" - Run advanced elicitation to clarify extension requirements'
56
- - '*exit" - Say goodbye as The Creator, and then abandon inhabiting this persona'
52
+ - '*chat-mode" - Conversational mode with advanced-elicitation for game dev advice'
53
+ - '*create" - Execute all steps in Create Game Story Task document'
54
+ - '*checklist {checklist}" - Show numbered list of checklists, execute selection'
55
+ - '*exit" - Say goodbye as the Game Scrum Master, and then abandon inhabiting this persona'
57
56
  dependencies:
58
57
  tasks:
59
- - create-agent.md
60
- - generate-expansion-pack.md
61
- - advanced-elicitation.md
62
- - create-deep-research-prompt.md
58
+ - create-game-story.md
59
+ - execute-checklist.md
63
60
  templates:
64
- - agent-tmpl.yaml
65
- - expansion-pack-plan-tmpl.yaml
61
+ - game-story-tmpl.yaml
62
+ checklists:
63
+ - game-story-dod-checklist.md
66
64
  ```
@@ -0,0 +1,201 @@
1
+ # Game Design Document Quality Checklist
2
+
3
+ ## Document Completeness
4
+
5
+ ### Executive Summary
6
+
7
+ - [ ] **Core Concept** - Game concept is clearly explained in 2-3 sentences
8
+ - [ ] **Target Audience** - Primary and secondary audiences defined with demographics
9
+ - [ ] **Platform Requirements** - Technical platforms and requirements specified
10
+ - [ ] **Unique Selling Points** - 3-5 key differentiators from competitors identified
11
+ - [ ] **Technical Foundation** - Unity & C# requirements confirmed
12
+
13
+ ### Game Design Foundation
14
+
15
+ - [ ] **Game Pillars** - 3-5 core design pillars defined and actionable
16
+ - [ ] **Core Gameplay Loop** - 30-60 second loop documented with specific timings
17
+ - [ ] **Win/Loss Conditions** - Clear victory and failure states defined
18
+ - [ ] **Player Motivation** - Clear understanding of why players will engage
19
+ - [ ] **Scope Realism** - Game scope is achievable with available resources
20
+
21
+ ## Gameplay Mechanics
22
+
23
+ ### Core Mechanics Documentation
24
+
25
+ - [ ] **Primary Mechanics** - 3-5 core mechanics detailed with implementation notes
26
+ - [ ] **Mechanic Integration** - How mechanics work together is clear
27
+ - [ ] **Player Input** - All input methods specified for each platform
28
+ - [ ] **System Responses** - Game responses to player actions documented
29
+ - [ ] **Performance Impact** - Performance considerations for each mechanic noted
30
+
31
+ ### Controls and Interaction
32
+
33
+ - [ ] **Multi-Platform Controls** - Desktop, mobile, and gamepad controls defined
34
+ - [ ] **Input Responsiveness** - Requirements for responsive game feel specified
35
+ - [ ] **Accessibility Options** - Control customization and accessibility considered
36
+ - [ ] **Touch Optimization** - Mobile-specific control adaptations designed
37
+ - [ ] **Edge Case Handling** - Unusual input scenarios addressed
38
+
39
+ ## Progression and Balance
40
+
41
+ ### Player Progression
42
+
43
+ - [ ] **Progression Type** - Linear, branching, or metroidvania approach defined
44
+ - [ ] **Key Milestones** - Major progression points documented
45
+ - [ ] **Unlock System** - What players unlock and when is specified
46
+ - [ ] **Difficulty Scaling** - How challenge increases over time is detailed
47
+ - [ ] **Player Agency** - Meaningful player choices and consequences defined
48
+
49
+ ### Game Balance
50
+
51
+ - [ ] **Balance Parameters** - Numeric values for key game systems provided
52
+ - [ ] **Difficulty Curve** - Appropriate challenge progression designed
53
+ - [ ] **Economy Design** - Resource systems balanced for engagement
54
+ - [ ] **Player Testing** - Plan for validating balance through playtesting
55
+ - [ ] **Iteration Framework** - Process for adjusting balance post-implementation
56
+
57
+ ## Level Design Framework
58
+
59
+ ### Level Structure
60
+
61
+ - [ ] **Level Types** - Different level categories defined with purposes
62
+ - [ ] **Level Progression** - How players move through levels specified
63
+ - [ ] **Duration Targets** - Expected play time for each level type
64
+ - [ ] **Difficulty Distribution** - Appropriate challenge spread across levels
65
+ - [ ] **Replay Value** - Elements that encourage repeated play designed
66
+
67
+ ### Content Guidelines
68
+
69
+ - [ ] **Level Creation Rules** - Clear guidelines for level designers
70
+ - [ ] **Mechanic Introduction** - How new mechanics are taught in levels
71
+ - [ ] **Pacing Variety** - Mix of action, puzzle, and rest moments planned
72
+ - [ ] **Secret Content** - Hidden areas and optional challenges designed
73
+ - [ ] **Accessibility Options** - Multiple difficulty levels or assist modes considered
74
+
75
+ ## Technical Implementation Readiness
76
+
77
+ ### Performance Requirements
78
+
79
+ - [ ] **Frame Rate Targets** - Stable FPS target with minimum acceptable rates
80
+ - [ ] **Memory Budgets** - Maximum memory usage limits defined
81
+ - [ ] **Load Time Goals** - Acceptable loading times for different content
82
+ - [ ] **Battery Optimization** - Mobile battery usage considerations addressed
83
+ - [ ] **Scalability Plan** - How performance scales across different devices
84
+
85
+ ### Platform Specifications
86
+
87
+ - [ ] **Desktop Requirements** - Minimum and recommended PC/Mac specs
88
+ - [ ] **Mobile Optimization** - iOS and Android specific requirements
89
+ - [ ] **Browser Compatibility** - Supported browsers and versions listed
90
+ - [ ] **Cross-Platform Features** - Shared and platform-specific features identified
91
+ - [ ] **Update Strategy** - Plan for post-launch updates and patches
92
+
93
+ ### Asset Requirements
94
+
95
+ - [ ] **Art Style Definition** - Clear visual style with reference materials
96
+ - [ ] **Asset Specifications** - Technical requirements for all asset types
97
+ - [ ] **Audio Requirements** - Music and sound effect specifications
98
+ - [ ] **UI/UX Guidelines** - User interface design principles established
99
+ - [ ] **Localization Plan** - Text and cultural localization requirements
100
+
101
+ ## Development Planning
102
+
103
+ ### Implementation Phases
104
+
105
+ - [ ] **Phase Breakdown** - Development divided into logical phases
106
+ - [ ] **Epic Definitions** - Major development epics identified
107
+ - [ ] **Dependency Mapping** - Prerequisites between features documented
108
+ - [ ] **Risk Assessment** - Technical and design risks identified with mitigation
109
+ - [ ] **Milestone Planning** - Key deliverables and deadlines established
110
+
111
+ ### Team Requirements
112
+
113
+ - [ ] **Role Definitions** - Required team roles and responsibilities
114
+ - [ ] **Skill Requirements** - Technical skills needed for implementation
115
+ - [ ] **Resource Allocation** - Time and effort estimates for major features
116
+ - [ ] **External Dependencies** - Third-party tools, assets, or services needed
117
+ - [ ] **Communication Plan** - How team members will coordinate work
118
+
119
+ ## Quality Assurance
120
+
121
+ ### Success Metrics
122
+
123
+ - [ ] **Technical Metrics** - Measurable technical performance goals
124
+ - [ ] **Gameplay Metrics** - Player engagement and retention targets
125
+ - [ ] **Quality Benchmarks** - Standards for bug rates and polish level
126
+ - [ ] **User Experience Goals** - Specific UX objectives and measurements
127
+ - [ ] **Business Objectives** - Commercial or project success criteria
128
+
129
+ ### Testing Strategy
130
+
131
+ - [ ] **Playtesting Plan** - How and when player feedback will be gathered
132
+ - [ ] **Technical Testing** - Performance and compatibility testing approach
133
+ - [ ] **Balance Validation** - Methods for confirming game balance
134
+ - [ ] **Accessibility Testing** - Plan for testing with diverse players
135
+ - [ ] **Iteration Process** - How feedback will drive design improvements
136
+
137
+ ## Documentation Quality
138
+
139
+ ### Clarity and Completeness
140
+
141
+ - [ ] **Clear Writing** - All sections are well-written and understandable
142
+ - [ ] **Complete Coverage** - No major game systems left undefined
143
+ - [ ] **Actionable Detail** - Enough detail for developers to create implementation stories
144
+ - [ ] **Consistent Terminology** - Game terms used consistently throughout
145
+ - [ ] **Reference Materials** - Links to inspiration, research, and additional resources
146
+
147
+ ### Maintainability
148
+
149
+ - [ ] **Version Control** - Change log established for tracking revisions
150
+ - [ ] **Update Process** - Plan for maintaining document during development
151
+ - [ ] **Team Access** - All team members can access and reference the document
152
+ - [ ] **Search Functionality** - Document organized for easy reference and searching
153
+ - [ ] **Living Document** - Process for incorporating feedback and changes
154
+
155
+ ## Stakeholder Alignment
156
+
157
+ ### Team Understanding
158
+
159
+ - [ ] **Shared Vision** - All team members understand and agree with the game vision
160
+ - [ ] **Role Clarity** - Each team member understands their contribution
161
+ - [ ] **Decision Framework** - Process for making design decisions during development
162
+ - [ ] **Conflict Resolution** - Plan for resolving disagreements about design choices
163
+ - [ ] **Communication Channels** - Regular meetings and feedback sessions planned
164
+
165
+ ### External Validation
166
+
167
+ - [ ] **Market Validation** - Competitive analysis and market fit assessment
168
+ - [ ] **Technical Validation** - Feasibility confirmed with technical team
169
+ - [ ] **Resource Validation** - Required resources available and committed
170
+ - [ ] **Timeline Validation** - Development schedule is realistic and achievable
171
+ - [ ] **Quality Validation** - Quality standards align with available time and resources
172
+
173
+ ## Final Readiness Assessment
174
+
175
+ ### Implementation Preparedness
176
+
177
+ - [ ] **Story Creation Ready** - Document provides sufficient detail for story creation
178
+ - [ ] **Architecture Alignment** - Game design aligns with technical capabilities
179
+ - ] **Asset Production** - Asset requirements enable art and audio production
180
+ - [ ] **Development Workflow** - Clear path from design to implementation
181
+ - [ ] **Quality Assurance** - Testing and validation processes established
182
+
183
+ ### Document Approval
184
+
185
+ - [ ] **Design Review Complete** - Document reviewed by all relevant stakeholders
186
+ - [ ] **Technical Review Complete** - Technical feasibility confirmed
187
+ - [ ] **Business Review Complete** - Project scope and goals approved
188
+ - [ ] **Final Approval** - Document officially approved for implementation
189
+ - [ ] **Baseline Established** - Current version established as development baseline
190
+
191
+ ## Overall Assessment
192
+
193
+ **Document Quality Rating:** ⭐⭐⭐⭐⭐
194
+
195
+ **Ready for Development:** [ ] Yes [ ] No
196
+
197
+ **Key Recommendations:**
198
+ _List any critical items that need attention before moving to implementation phase._
199
+
200
+ **Next Steps:**
201
+ _Outline immediate next actions for the team based on this assessment._