bmad-method 4.30.1 → 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.
- package/CHANGELOG.md +14 -0
- package/README.md +1 -1
- package/bmad-core/core-config.yaml +0 -1
- package/bmad-core/data/bmad-kb.md +1 -1
- package/dist/agents/analyst.txt +1 -1
- package/dist/agents/bmad-master.txt +1 -1
- package/dist/agents/bmad-orchestrator.txt +1 -1
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt +2409 -0
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.txt +1480 -0
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.txt +826 -0
- package/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt +10690 -0
- package/dist/teams/team-all.txt +1 -1
- package/dist/teams/team-fullstack.txt +1 -1
- package/dist/teams/team-ide-minimal.txt +1 -1
- package/dist/teams/team-no-ui.txt +1 -1
- package/docs/bmad-workflow-guide.md +2 -2
- package/expansion-packs/bmad-2d-phaser-game-dev/config.yaml +2 -2
- package/expansion-packs/bmad-2d-unity-game-dev/agent-teams/unity-2d-game-team.yaml +13 -0
- package/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.md +72 -0
- package/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.md +78 -0
- package/expansion-packs/{bmad-creator-tools/agents/bmad-the-creator.md → bmad-2d-unity-game-dev/agents/game-sm.md} +26 -28
- package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-design-checklist.md +201 -0
- package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-story-dod-checklist.md +160 -0
- package/expansion-packs/bmad-2d-unity-game-dev/config.yaml +6 -0
- package/expansion-packs/bmad-2d-unity-game-dev/data/bmad-kb.md +251 -0
- package/expansion-packs/bmad-2d-unity-game-dev/data/development-guidelines.md +590 -0
- package/expansion-packs/bmad-2d-unity-game-dev/tasks/advanced-elicitation.md +111 -0
- package/expansion-packs/bmad-2d-unity-game-dev/tasks/create-game-story.md +217 -0
- package/expansion-packs/bmad-2d-unity-game-dev/tasks/game-design-brainstorming.md +308 -0
- package/expansion-packs/bmad-2d-unity-game-dev/templates/game-architecture-tmpl.yaml +545 -0
- package/expansion-packs/bmad-2d-unity-game-dev/templates/game-brief-tmpl.yaml +356 -0
- package/expansion-packs/bmad-2d-unity-game-dev/templates/game-design-doc-tmpl.yaml +343 -0
- package/expansion-packs/bmad-2d-unity-game-dev/templates/game-story-tmpl.yaml +256 -0
- package/expansion-packs/bmad-2d-unity-game-dev/templates/level-design-doc-tmpl.yaml +484 -0
- package/expansion-packs/bmad-2d-unity-game-dev/workflows/game-dev-greenfield.yaml +183 -0
- package/expansion-packs/bmad-2d-unity-game-dev/workflows/game-prototype.yaml +175 -0
- package/expansion-packs/bmad-infrastructure-devops/config.yaml +2 -2
- package/package.json +4 -8
- package/tools/bump-all-versions.js +8 -9
- package/tools/bump-expansion-version.js +40 -35
- package/tools/installer/bin/bmad.js +8 -21
- package/tools/installer/lib/file-manager.js +76 -44
- package/tools/installer/lib/ide-base-setup.js +227 -0
- package/tools/installer/lib/ide-setup.js +14 -60
- package/tools/installer/lib/installer.js +99 -121
- package/tools/installer/lib/memory-profiler.js +224 -0
- package/tools/installer/lib/module-manager.js +110 -0
- package/tools/installer/lib/resource-locator.js +310 -0
- package/tools/installer/package.json +1 -1
- package/tools/semantic-release-sync-installer.js +20 -21
- package/dist/expansion-packs/bmad-creator-tools/agents/bmad-the-creator.txt +0 -2008
- package/expansion-packs/bmad-creator-tools/README.md +0 -8
- package/expansion-packs/bmad-creator-tools/config.yaml +0 -6
- package/expansion-packs/bmad-creator-tools/tasks/create-agent.md +0 -200
- package/expansion-packs/bmad-creator-tools/tasks/generate-expansion-pack.md +0 -1020
- package/expansion-packs/bmad-creator-tools/templates/agent-teams-tmpl.yaml +0 -178
- package/expansion-packs/bmad-creator-tools/templates/agent-tmpl.yaml +0 -154
- package/expansion-packs/bmad-creator-tools/templates/expansion-pack-plan-tmpl.yaml +0 -120
- package/tools/bump-core-version.js +0 -57
package/dist/teams/team-all.txt
CHANGED
|
@@ -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-
|
|
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-
|
|
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-
|
|
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-
|
|
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: `
|
|
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
|
|
@@ -114,7 +114,7 @@ Follow the SM → Dev cycle for systematic story development:
|
|
|
114
114
|
- **Gemini CLI**: `*agent-name` (e.g., `*bmad-master`)
|
|
115
115
|
- **Windsurf**: `@agent-name` (e.g., `@bmad-master`)
|
|
116
116
|
- **Trae**: `@agent-name` (e.g., `@bmad-master`)
|
|
117
|
-
- **Roo Code**: Select mode from mode selector (e.g., `bmad-
|
|
117
|
+
- **Roo Code**: Select mode from mode selector (e.g., `bmad-master`)
|
|
118
118
|
- **GitHub Copilot**: Open the Chat view (`⌃⌘I` on Mac, `Ctrl+Alt+I` on Windows/Linux) and select **Agent** from the chat mode selector.
|
|
119
119
|
|
|
120
120
|
### Chat Management:
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
name: bmad-2d-phaser-game-dev
|
|
2
|
-
version: 1.
|
|
3
|
-
short-title:
|
|
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
|
-
#
|
|
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:
|
|
32
|
-
id:
|
|
33
|
-
title:
|
|
34
|
-
icon:
|
|
35
|
-
whenToUse: Use for
|
|
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:
|
|
39
|
-
style:
|
|
40
|
-
identity:
|
|
41
|
-
focus: Creating
|
|
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
|
-
-
|
|
44
|
-
-
|
|
45
|
-
-
|
|
46
|
-
-
|
|
47
|
-
-
|
|
48
|
-
- Numbered Options Protocol - Always use numbered lists for
|
|
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
|
|
52
|
-
- '*create" -
|
|
53
|
-
- '*
|
|
54
|
-
- '*
|
|
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-
|
|
60
|
-
-
|
|
61
|
-
- advanced-elicitation.md
|
|
62
|
-
- create-deep-research-prompt.md
|
|
58
|
+
- create-game-story.md
|
|
59
|
+
- execute-checklist.md
|
|
63
60
|
templates:
|
|
64
|
-
-
|
|
65
|
-
|
|
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._
|