bmad-method 6.0.0-alpha.17 → 6.0.0-alpha.19

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 (185) hide show
  1. package/CHANGELOG.md +117 -0
  2. package/package.json +1 -1
  3. package/src/modules/bmgd/_module-installer/installer.js +160 -0
  4. package/src/modules/bmgd/_module-installer/platform-specifics/claude-code.js +23 -0
  5. package/src/modules/bmgd/_module-installer/platform-specifics/windsurf.js +18 -0
  6. package/src/modules/bmgd/agents/game-architect.agent.yaml +23 -8
  7. package/src/modules/bmgd/agents/game-designer.agent.yaml +38 -18
  8. package/src/modules/bmgd/agents/game-dev.agent.yaml +30 -14
  9. package/src/modules/bmgd/agents/game-qa.agent.yaml +64 -0
  10. package/src/modules/bmgd/agents/game-scrum-master.agent.yaml +27 -39
  11. package/src/modules/bmgd/agents/game-solo-dev.agent.yaml +56 -0
  12. package/src/modules/bmgd/docs/README.md +180 -0
  13. package/src/modules/bmgd/docs/agents-guide.md +407 -0
  14. package/src/modules/bmgd/docs/game-types-guide.md +503 -0
  15. package/src/modules/bmgd/docs/glossary.md +294 -0
  16. package/src/modules/bmgd/docs/quick-flow-guide.md +288 -0
  17. package/src/modules/bmgd/docs/quick-start.md +250 -0
  18. package/src/modules/bmgd/docs/troubleshooting.md +259 -0
  19. package/src/modules/bmgd/docs/workflow-overview.jpg +0 -0
  20. package/src/modules/bmgd/docs/workflows-guide.md +463 -0
  21. package/src/modules/bmgd/gametest/knowledge/balance-testing.md +220 -0
  22. package/src/modules/bmgd/gametest/knowledge/certification-testing.md +319 -0
  23. package/src/modules/bmgd/gametest/knowledge/compatibility-testing.md +228 -0
  24. package/src/modules/bmgd/gametest/knowledge/godot-testing.md +376 -0
  25. package/src/modules/bmgd/gametest/knowledge/input-testing.md +315 -0
  26. package/src/modules/bmgd/gametest/knowledge/localization-testing.md +304 -0
  27. package/src/modules/bmgd/gametest/knowledge/multiplayer-testing.md +322 -0
  28. package/src/modules/bmgd/gametest/knowledge/performance-testing.md +204 -0
  29. package/src/modules/bmgd/gametest/knowledge/playtesting.md +384 -0
  30. package/src/modules/bmgd/gametest/knowledge/qa-automation.md +190 -0
  31. package/src/modules/bmgd/gametest/knowledge/regression-testing.md +280 -0
  32. package/src/modules/bmgd/gametest/knowledge/save-testing.md +280 -0
  33. package/src/modules/bmgd/gametest/knowledge/smoke-testing.md +404 -0
  34. package/src/modules/bmgd/gametest/knowledge/test-priorities.md +271 -0
  35. package/src/modules/bmgd/gametest/knowledge/unity-testing.md +383 -0
  36. package/src/modules/bmgd/gametest/knowledge/unreal-testing.md +388 -0
  37. package/src/modules/bmgd/gametest/qa-index.csv +17 -0
  38. package/src/modules/bmgd/module.yaml +25 -9
  39. package/src/modules/bmgd/teams/default-party.csv +2 -0
  40. package/src/modules/bmgd/teams/team-gamedev.yaml +12 -1
  41. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/steps/step-01-init.md +164 -0
  42. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/steps/step-02-context.md +210 -0
  43. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/steps/step-03-ideation.md +289 -0
  44. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/steps/step-04-complete.md +275 -0
  45. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/workflow.md +49 -0
  46. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/workflow.yaml +29 -8
  47. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-01-init.md +223 -0
  48. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-01b-continue.md +151 -0
  49. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-02-vision.md +218 -0
  50. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-03-market.md +218 -0
  51. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-04-fundamentals.md +231 -0
  52. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-05-scope.md +242 -0
  53. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-06-references.md +224 -0
  54. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-07-content.md +282 -0
  55. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-08-complete.md +296 -0
  56. package/src/modules/bmgd/workflows/1-preproduction/game-brief/workflow.md +62 -0
  57. package/src/modules/bmgd/workflows/1-preproduction/game-brief/workflow.yaml +40 -9
  58. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-01-init.md +248 -0
  59. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-01b-continue.md +173 -0
  60. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-02-context.md +332 -0
  61. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-03-platforms.md +245 -0
  62. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-04-vision.md +229 -0
  63. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-05-core-gameplay.md +258 -0
  64. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-06-mechanics.md +249 -0
  65. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-07-game-type.md +266 -0
  66. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-08-progression.md +272 -0
  67. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-09-levels.md +264 -0
  68. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-10-art-audio.md +255 -0
  69. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-11-technical.md +275 -0
  70. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-12-epics.md +284 -0
  71. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-13-metrics.md +250 -0
  72. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-14-complete.md +335 -0
  73. package/src/modules/bmgd/workflows/2-design/gdd/workflow.md +61 -0
  74. package/src/modules/bmgd/workflows/2-design/gdd/workflow.yaml +27 -7
  75. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-01-init.md +228 -0
  76. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-01b-continue.md +163 -0
  77. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-02-foundation.md +262 -0
  78. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-03-story.md +238 -0
  79. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-04-characters.md +297 -0
  80. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-05-world.md +262 -0
  81. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-06-dialogue.md +250 -0
  82. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-07-environmental.md +244 -0
  83. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-08-delivery.md +264 -0
  84. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-09-integration.md +254 -0
  85. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-10-production.md +262 -0
  86. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-11-complete.md +331 -0
  87. package/src/modules/bmgd/workflows/2-design/narrative/workflow.md +57 -0
  88. package/src/modules/bmgd/workflows/2-design/narrative/workflow.yaml +53 -8
  89. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-01-init.md +223 -0
  90. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-01b-continue.md +153 -0
  91. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-02-context.md +262 -0
  92. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-03-starter.md +290 -0
  93. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-04-decisions.md +300 -0
  94. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-05-crosscutting.md +319 -0
  95. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-06-structure.md +304 -0
  96. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-07-patterns.md +349 -0
  97. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-08-validation.md +293 -0
  98. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-09-complete.md +302 -0
  99. package/src/modules/bmgd/workflows/3-technical/game-architecture/workflow.md +55 -0
  100. package/src/modules/bmgd/workflows/3-technical/game-architecture/workflow.yaml +50 -21
  101. package/src/modules/bmgd/workflows/4-production/code-review/checklist.md +23 -0
  102. package/src/modules/bmgd/workflows/4-production/code-review/instructions.xml +225 -0
  103. package/src/modules/bmgd/workflows/4-production/code-review/workflow.yaml +18 -15
  104. package/src/modules/bmgd/workflows/4-production/correct-course/checklist.md +1 -1
  105. package/src/modules/bmgd/workflows/4-production/correct-course/instructions.md +1 -1
  106. package/src/modules/bmgd/workflows/4-production/correct-course/workflow.yaml +11 -6
  107. package/src/modules/bmgd/workflows/4-production/create-story/checklist.md +332 -214
  108. package/src/modules/bmgd/workflows/4-production/create-story/instructions.xml +298 -0
  109. package/src/modules/bmgd/workflows/4-production/create-story/template.md +3 -5
  110. package/src/modules/bmgd/workflows/4-production/create-story/workflow.yaml +12 -7
  111. package/src/modules/bmgd/workflows/4-production/dev-story/checklist.md +65 -23
  112. package/src/modules/bmgd/workflows/4-production/dev-story/instructions.xml +409 -0
  113. package/src/modules/bmgd/workflows/4-production/dev-story/workflow.yaml +13 -3
  114. package/src/modules/bmgd/workflows/4-production/retrospective/instructions.md +4 -4
  115. package/src/modules/bmgd/workflows/4-production/retrospective/workflow.yaml +12 -7
  116. package/src/modules/bmgd/workflows/4-production/sprint-planning/instructions.md +32 -41
  117. package/src/modules/bmgd/workflows/4-production/sprint-planning/sprint-status-template.yaml +13 -13
  118. package/src/modules/bmgd/workflows/4-production/sprint-planning/workflow.yaml +6 -1
  119. package/src/modules/bmgd/workflows/4-production/sprint-status/instructions.md +229 -0
  120. package/src/modules/bmgd/workflows/4-production/sprint-status/workflow.yaml +35 -0
  121. package/src/modules/bmgd/workflows/bmgd-quick-flow/create-tech-spec/instructions.md +140 -0
  122. package/src/modules/bmgd/workflows/bmgd-quick-flow/create-tech-spec/workflow.yaml +27 -0
  123. package/src/modules/bmgd/workflows/bmgd-quick-flow/quick-dev/checklist.md +37 -0
  124. package/src/modules/bmgd/workflows/bmgd-quick-flow/quick-dev/instructions.md +220 -0
  125. package/src/modules/bmgd/workflows/bmgd-quick-flow/quick-dev/workflow.yaml +45 -0
  126. package/src/modules/bmgd/workflows/bmgd-quick-flow/quick-prototype/checklist.md +26 -0
  127. package/src/modules/bmgd/workflows/bmgd-quick-flow/quick-prototype/instructions.md +156 -0
  128. package/src/modules/bmgd/workflows/bmgd-quick-flow/quick-prototype/workflow.yaml +36 -0
  129. package/src/modules/bmgd/workflows/gametest/automate/checklist.md +93 -0
  130. package/src/modules/bmgd/workflows/gametest/automate/instructions.md +317 -0
  131. package/src/modules/bmgd/workflows/gametest/automate/workflow.yaml +50 -0
  132. package/src/modules/bmgd/workflows/gametest/performance/checklist.md +96 -0
  133. package/src/modules/bmgd/workflows/gametest/performance/instructions.md +323 -0
  134. package/src/modules/bmgd/workflows/gametest/performance/performance-template.md +256 -0
  135. package/src/modules/bmgd/workflows/gametest/performance/workflow.yaml +48 -0
  136. package/src/modules/bmgd/workflows/gametest/playtest-plan/checklist.md +93 -0
  137. package/src/modules/bmgd/workflows/gametest/playtest-plan/instructions.md +297 -0
  138. package/src/modules/bmgd/workflows/gametest/playtest-plan/playtest-template.md +208 -0
  139. package/src/modules/bmgd/workflows/gametest/playtest-plan/workflow.yaml +59 -0
  140. package/src/modules/bmgd/workflows/gametest/test-design/checklist.md +98 -0
  141. package/src/modules/bmgd/workflows/gametest/test-design/instructions.md +280 -0
  142. package/src/modules/bmgd/workflows/gametest/test-design/test-design-template.md +205 -0
  143. package/src/modules/bmgd/workflows/gametest/test-design/workflow.yaml +47 -0
  144. package/src/modules/bmgd/workflows/gametest/test-framework/checklist.md +103 -0
  145. package/src/modules/bmgd/workflows/gametest/test-framework/instructions.md +348 -0
  146. package/src/modules/bmgd/workflows/gametest/test-framework/workflow.yaml +48 -0
  147. package/src/modules/bmgd/workflows/gametest/test-review/checklist.md +87 -0
  148. package/src/modules/bmgd/workflows/gametest/test-review/instructions.md +272 -0
  149. package/src/modules/bmgd/workflows/gametest/test-review/test-review-template.md +203 -0
  150. package/src/modules/bmgd/workflows/gametest/test-review/workflow.yaml +48 -0
  151. package/src/modules/bmgd/workflows/workflow-status/init/instructions.md +299 -0
  152. package/src/modules/bmgd/workflows/workflow-status/init/workflow.yaml +29 -0
  153. package/src/modules/bmgd/workflows/workflow-status/instructions.md +395 -0
  154. package/src/modules/bmgd/workflows/workflow-status/paths/gamedev-brownfield.yaml +65 -0
  155. package/src/modules/bmgd/workflows/workflow-status/paths/gamedev-greenfield.yaml +71 -0
  156. package/src/modules/bmgd/workflows/workflow-status/paths/quickflow-brownfield.yaml +29 -0
  157. package/src/modules/bmgd/workflows/workflow-status/paths/quickflow-greenfield.yaml +39 -0
  158. package/src/modules/bmgd/workflows/workflow-status/project-levels.yaml +63 -0
  159. package/src/modules/bmgd/workflows/workflow-status/workflow-status-template.yaml +24 -0
  160. package/src/modules/bmgd/workflows/workflow-status/workflow.yaml +30 -0
  161. package/tools/cli/commands/install.js +9 -0
  162. package/tools/cli/installers/lib/core/installer.js +140 -592
  163. package/tools/cli/installers/lib/modules/manager.js +15 -3
  164. package/tools/cli/lib/agent/compiler.js +99 -0
  165. package/tools/cli/lib/ui.js +78 -27
  166. package/src/modules/bmgd/workflows/2-design/gdd/instructions-gdd.md +0 -502
  167. package/src/modules/bmgd/workflows/4-production/code-review/instructions.md +0 -398
  168. package/src/modules/bmgd/workflows/4-production/create-story/instructions.md +0 -256
  169. package/src/modules/bmgd/workflows/4-production/dev-story/instructions.md +0 -267
  170. package/src/modules/bmgd/workflows/4-production/epic-tech-context/checklist.md +0 -17
  171. package/src/modules/bmgd/workflows/4-production/epic-tech-context/instructions.md +0 -164
  172. package/src/modules/bmgd/workflows/4-production/epic-tech-context/template.md +0 -76
  173. package/src/modules/bmgd/workflows/4-production/epic-tech-context/workflow.yaml +0 -58
  174. package/src/modules/bmgd/workflows/4-production/story-context/checklist.md +0 -16
  175. package/src/modules/bmgd/workflows/4-production/story-context/context-template.xml +0 -34
  176. package/src/modules/bmgd/workflows/4-production/story-context/instructions.md +0 -209
  177. package/src/modules/bmgd/workflows/4-production/story-context/workflow.yaml +0 -63
  178. package/src/modules/bmgd/workflows/4-production/story-done/instructions.md +0 -111
  179. package/src/modules/bmgd/workflows/4-production/story-done/workflow.yaml +0 -28
  180. package/src/modules/bmgd/workflows/4-production/story-ready/instructions.md +0 -117
  181. package/src/modules/bmgd/workflows/4-production/story-ready/workflow.yaml +0 -25
  182. /package/src/modules/bmgd/workflows/1-preproduction/game-brief/{template.md → templates/game-brief-template.md} +0 -0
  183. /package/src/modules/bmgd/workflows/2-design/gdd/{gdd-template.md → templates/gdd-template.md} +0 -0
  184. /package/src/modules/bmgd/workflows/2-design/narrative/{narrative-template.md → templates/narrative-template.md} +0 -0
  185. /package/src/modules/bmgd/workflows/3-technical/game-architecture/{architecture-template.md → templates/architecture-template.md} +0 -0
@@ -0,0 +1,210 @@
1
+ ---
2
+ name: 'step-02-context'
3
+ description: 'Load game-specific brainstorming context and techniques'
4
+
5
+ # Path Definitions
6
+ workflow_path: '{project-root}/_bmad/bmgd/workflows/1-preproduction/brainstorm-game'
7
+
8
+ # File References
9
+ thisStepFile: '{workflow_path}/steps/step-02-context.md'
10
+ nextStepFile: '{workflow_path}/steps/step-03-ideation.md'
11
+ workflowFile: '{workflow_path}/workflow.md'
12
+ outputFile: '{output_folder}/brainstorming-session-{date}.md'
13
+
14
+ # Context Files
15
+ gameContext: '{workflow_path}/game-context.md'
16
+ gameBrainMethods: '{workflow_path}/game-brain-methods.csv'
17
+ coreBrainstorming: '{project-root}/_bmad/core/workflows/brainstorming/workflow.yaml'
18
+ ---
19
+
20
+ # Step 2: Load Context
21
+
22
+ **Progress: Step 2 of 4** - Next: Ideation Session
23
+
24
+ ## STEP GOAL:
25
+
26
+ Load game-specific brainstorming context and techniques to guide the ideation session. Merge game techniques with core brainstorming methods.
27
+
28
+ ## MANDATORY EXECUTION RULES (READ FIRST):
29
+
30
+ ### Universal Rules:
31
+
32
+ - NEVER generate content without user input
33
+ - CRITICAL: Read the complete step file before taking any action
34
+ - CRITICAL: When loading next step with 'C', ensure entire file is read
35
+ - YOU ARE A FACILITATOR, not a content generator
36
+ - NEVER mention time estimates
37
+
38
+ ### Role Reinforcement:
39
+
40
+ - You are a creative game design facilitator
41
+ - Game-specific techniques enhance standard brainstorming
42
+ - Understand various ideation methods deeply
43
+
44
+ ### Step-Specific Rules:
45
+
46
+ - Load all context files completely
47
+ - Present technique options to user
48
+ - Let user select preferred approach
49
+
50
+ ## EXECUTION PROTOCOLS:
51
+
52
+ - Show your analysis before taking any action
53
+ - Present A/P/C menu after context loaded
54
+ - ONLY proceed when user chooses C (Continue)
55
+ - Update frontmatter `stepsCompleted: [1, 2]` before loading next step
56
+
57
+ ## COLLABORATION MENUS (A/P/C):
58
+
59
+ - **A (Advanced Elicitation)**: Explore technique combinations
60
+ - **P (Party Mode)**: Get perspectives on approaches
61
+ - **C (Continue)**: Confirm context and proceed
62
+
63
+ ## Sequence of Instructions (Do not deviate, skip, or optimize)
64
+
65
+ ### 1. Load Game Context
66
+
67
+ **Load the game context document:**
68
+
69
+ Read `{gameContext}` to understand:
70
+
71
+ - Focus areas for game ideation
72
+ - Key considerations for game design
73
+ - Recommended techniques
74
+ - Output structure guidance
75
+
76
+ ### 2. Load Game Brain Methods
77
+
78
+ **Load game-specific techniques:**
79
+
80
+ Read `{gameBrainMethods}` CSV to load:
81
+
82
+ - MDA Framework exploration
83
+ - Core loop brainstorming
84
+ - Player fantasy mining
85
+ - Genre mashup
86
+ - And other game-specific methods
87
+
88
+ ### 3. Present Available Techniques
89
+
90
+ "**Game Brainstorming Techniques Loaded!**
91
+
92
+ I've loaded game-specific brainstorming methods:
93
+
94
+ **Conceptual Techniques:**
95
+
96
+ - **MDA Framework** - Mechanics, Dynamics, Aesthetics exploration
97
+ - **Player Fantasy Mining** - What fantasy does the player fulfill?
98
+ - **Core Loop Design** - Define the central gameplay loop
99
+ - **Genre Mashup** - Combine unexpected genres
100
+
101
+ **Experience Techniques:**
102
+
103
+ - **Emotion Mapping** - Target emotions throughout gameplay
104
+ - **Moment Design** - Plan memorable peak moments
105
+ - **Flow Analysis** - Balance challenge and skill
106
+
107
+ **Practical Techniques:**
108
+
109
+ - **Constraint Box** - Creative limits spark innovation
110
+ - **Reference Blending** - Combine inspiration sources
111
+ - **What If Scenarios** - Explore radical possibilities
112
+
113
+ **How would you like to brainstorm?**
114
+
115
+ 1. **Guided** - I'll walk you through techniques one by one
116
+ 2. **Selective** - Choose specific techniques to use
117
+ 3. **Freeform** - Open exploration with techniques as needed
118
+ 4. **YOLO** - Let me drive the session with all techniques
119
+
120
+ Your preference:"
121
+
122
+ ### 4. Capture User Preference
123
+
124
+ **Based on selection:**
125
+
126
+ - **Guided**: Prepare structured technique sequence
127
+ - **Selective**: Present technique menu for selection
128
+ - **Freeform**: Prepare all techniques for on-demand use
129
+ - **YOLO**: Plan comprehensive technique coverage
130
+
131
+ ### 5. Generate Context Section
132
+
133
+ Based on the conversation, prepare the content:
134
+
135
+ ```markdown
136
+ ## Brainstorming Approach
137
+
138
+ **Selected Mode:** {{selected_mode}}
139
+
140
+ **Techniques Available:**
141
+ {{technique_list}}
142
+
143
+ **Focus Areas:**
144
+ {{focus_areas_from_context}}
145
+ ```
146
+
147
+ ### 6. Present Content and Menu
148
+
149
+ Show the loaded context and present:
150
+
151
+ "I've prepared the brainstorming context.
152
+
153
+ **Here's what I'll add to the document:**
154
+
155
+ [Show the complete markdown content from step 5]
156
+
157
+ **Ready to start ideation?**
158
+
159
+ **Select an Option:**
160
+ [A] Advanced Elicitation - Explore technique combinations
161
+ [P] Party Mode - Get perspectives on approaches
162
+ [C] Continue - Save this and move to Ideation Session (Step 3 of 4)"
163
+
164
+ ### 7. Handle Menu Selection
165
+
166
+ #### IF A (Advanced Elicitation):
167
+
168
+ - Explore technique combinations and synergies
169
+ - Ask user: "Accept these changes? (y/n)"
170
+ - If yes: Update content, return to A/P/C menu
171
+ - If no: Keep original, return to A/P/C menu
172
+
173
+ #### IF P (Party Mode):
174
+
175
+ - Get multiple perspectives on brainstorming approaches
176
+ - Ask user: "Accept these changes? (y/n)"
177
+ - If yes: Update content, return to A/P/C menu
178
+ - If no: Keep original, return to A/P/C menu
179
+
180
+ #### IF C (Continue):
181
+
182
+ - Append the context section to `{outputFile}`
183
+ - Update frontmatter: `stepsCompleted: [1, 2]`
184
+ - Load `{nextStepFile}`
185
+
186
+ ## CRITICAL STEP COMPLETION NOTE
187
+
188
+ ONLY WHEN [C continue option] is selected and [context saved with frontmatter updated], will you then load and read fully `{nextStepFile}`.
189
+
190
+ ---
191
+
192
+ ## SYSTEM SUCCESS/FAILURE METRICS
193
+
194
+ ### SUCCESS:
195
+
196
+ - Game context loaded completely
197
+ - Game brain methods loaded from CSV
198
+ - Techniques presented clearly
199
+ - User selected brainstorming approach
200
+ - A/P/C menu presented and handled correctly
201
+ - Frontmatter updated with stepsCompleted: [1, 2]
202
+
203
+ ### SYSTEM FAILURE:
204
+
205
+ - Not loading context files
206
+ - Proceeding without user technique selection
207
+ - Not presenting A/P/C menu after context
208
+ - Proceeding without user selecting 'C'
209
+
210
+ **Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.
@@ -0,0 +1,289 @@
1
+ ---
2
+ name: 'step-03-ideation'
3
+ description: 'Execute the brainstorming session with game-specific techniques'
4
+
5
+ # Path Definitions
6
+ workflow_path: '{project-root}/_bmad/bmgd/workflows/1-preproduction/brainstorm-game'
7
+
8
+ # File References
9
+ thisStepFile: '{workflow_path}/steps/step-03-ideation.md'
10
+ nextStepFile: '{workflow_path}/steps/step-04-complete.md'
11
+ workflowFile: '{workflow_path}/workflow.md'
12
+ outputFile: '{output_folder}/brainstorming-session-{date}.md'
13
+
14
+ # Core Brainstorming Reference
15
+ coreBrainstorming: '{project-root}/_bmad/core/workflows/brainstorming/workflow.yaml'
16
+
17
+ # Task References
18
+ advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
19
+ partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
20
+ ---
21
+
22
+ # Step 3: Ideation Session
23
+
24
+ **Progress: Step 3 of 4** - Next: Complete Session
25
+
26
+ ## STEP GOAL:
27
+
28
+ Facilitate the actual brainstorming session using selected techniques. Capture all ideas, concepts, and insights generated during the session.
29
+
30
+ ## MANDATORY EXECUTION RULES (READ FIRST):
31
+
32
+ ### Universal Rules:
33
+
34
+ - NEVER generate content without user input
35
+ - CRITICAL: Read the complete step file before taking any action
36
+ - CRITICAL: When loading next step with 'C', ensure entire file is read
37
+ - YOU ARE A FACILITATOR, not a content generator
38
+ - NEVER mention time estimates
39
+
40
+ ### Role Reinforcement:
41
+
42
+ - You are a creative game design facilitator
43
+ - Draw out user's ideas - don't generate for them
44
+ - Use techniques to unlock creativity
45
+ - ALL ideas are valid during brainstorming
46
+
47
+ ### Step-Specific Rules:
48
+
49
+ - Apply selected techniques from Step 2
50
+ - Capture EVERY idea, no matter how wild
51
+ - Build on ideas rather than criticize
52
+ - User drives the ideation; you facilitate
53
+
54
+ ## EXECUTION PROTOCOLS:
55
+
56
+ - Show your analysis before taking any action
57
+ - Present A/P/C menu after ideation session
58
+ - ONLY proceed when user chooses C (Continue)
59
+ - Update frontmatter `stepsCompleted: [1, 2, 3]` before loading next step
60
+
61
+ ## COLLABORATION MENUS (A/P/C):
62
+
63
+ - **A (Advanced Elicitation)**: Dig deeper into promising ideas
64
+ - **P (Party Mode)**: Get multiple perspectives on concepts
65
+ - **C (Continue)**: Save ideas and complete session
66
+
67
+ ## Sequence of Instructions (Do not deviate, skip, or optimize)
68
+
69
+ ### 1. Begin Ideation Session
70
+
71
+ **Start the brainstorming:**
72
+
73
+ "**Let's Start Brainstorming!**
74
+
75
+ Based on your selected approach ({{selected_mode}}), let's explore game ideas.
76
+
77
+ **First Question:**
78
+ What kind of game experience are you drawn to?
79
+
80
+ Think about:
81
+
82
+ - A feeling you want players to have
83
+ - A mechanic you find compelling
84
+ - A theme or setting that excites you
85
+ - A problem you want to solve through games
86
+
87
+ Share whatever comes to mind:"
88
+
89
+ ### 2. Apply Selected Techniques
90
+
91
+ **Based on mode selected in Step 2:**
92
+
93
+ **For Guided Mode:**
94
+ Walk through each technique sequentially:
95
+
96
+ 1. **Player Fantasy Mining**
97
+ "What fantasy does your player want to fulfill? Being a hero? Building an empire? Surviving? Exploring? Describe the core fantasy."
98
+
99
+ 2. **Core Loop Brainstorming**
100
+ "What's the central action players repeat? Think: [Action] → [Reward/Feedback] → [Motivation to continue]"
101
+
102
+ 3. **MDA Framework**
103
+ "Let's explore: What Aesthetics (emotions)? What Dynamics (behaviors)? What Mechanics enable them?"
104
+
105
+ 4. **Genre Mashup**
106
+ "What two unexpected genres could combine? Example: 'Puzzle + Horror' = tension through problem-solving"
107
+
108
+ **For Selective Mode:**
109
+ Present technique menu, execute chosen techniques.
110
+
111
+ **For Freeform Mode:**
112
+ Follow user's exploration, introduce techniques when relevant.
113
+
114
+ **For YOLO Mode:**
115
+ Drive comprehensive exploration using all techniques.
116
+
117
+ ### 3. Capture Ideas Throughout
118
+
119
+ **For EACH idea generated:**
120
+
121
+ Add to running list:
122
+
123
+ ```markdown
124
+ ### Idea: {{idea_title}}
125
+
126
+ **Source Technique:** {{technique_used}}
127
+ **Description:** {{idea_description}}
128
+ **Potential:** {{quick_assessment}}
129
+ **Build-on ideas:** {{related_concepts}}
130
+ ```
131
+
132
+ ### 4. Probe for Depth
133
+
134
+ **Throughout the session:**
135
+
136
+ Use probing questions:
137
+
138
+ - "What makes that exciting to you?"
139
+ - "How would that feel moment-to-moment?"
140
+ - "What's the twist that makes it unique?"
141
+ - "What game does this remind you of, and how is it different?"
142
+ - "What would the 'aha' moment be?"
143
+
144
+ ### 5. Build Idea Connections
145
+
146
+ **As ideas accumulate:**
147
+
148
+ "I'm noticing some connections:
149
+
150
+ - {{idea_1}} and {{idea_2}} share {{common_element}}
151
+ - {{idea_3}} could be the 'twist' for {{idea_4}}
152
+
153
+ Should we explore these combinations?"
154
+
155
+ ### 6. Session Checkpoint
156
+
157
+ **After sufficient ideation:**
158
+
159
+ "**Brainstorming Progress**
160
+
161
+ We've generated {{idea_count}} ideas so far:
162
+
163
+ **Top Concepts:**
164
+ {{summary_of_strongest_ideas}}
165
+
166
+ **Themes Emerging:**
167
+ {{recurring_themes}}
168
+
169
+ **Would you like to:**
170
+
171
+ 1. Continue exploring (more techniques)
172
+ 2. Deep dive into a specific concept
173
+ 3. Wrap up and save what we have
174
+
175
+ Your choice:"
176
+
177
+ ### 7. Generate Ideation Section
178
+
179
+ Based on all ideas captured, prepare the content:
180
+
181
+ ```markdown
182
+ ## Ideas Generated
183
+
184
+ ### Concept 1: {{concept_name}}
185
+
186
+ {{full_concept_description}}
187
+
188
+ **Core Elements:**
189
+
190
+ - {{element_1}}
191
+ - {{element_2}}
192
+
193
+ **Questions to Explore:**
194
+
195
+ - {{question_1}}
196
+ - {{question_2}}
197
+
198
+ ---
199
+
200
+ ### Concept 2: {{concept_name}}
201
+
202
+ {{repeat_structure}}
203
+
204
+ ---
205
+
206
+ ## Themes and Patterns
207
+
208
+ {{observed_themes}}
209
+
210
+ ## Promising Combinations
211
+
212
+ {{combination_ideas}}
213
+
214
+ ## Raw Ideas List
215
+
216
+ {{all_ideas_bullet_points}}
217
+ ```
218
+
219
+ ### 8. Present Content and Menu
220
+
221
+ Show the generated content to the user and present:
222
+
223
+ "**Ideation Session Summary**
224
+
225
+ Here's everything we captured:
226
+
227
+ [Show the complete markdown content from step 7]
228
+
229
+ **Session Stats:**
230
+
231
+ - Ideas generated: {{count}}
232
+ - Concepts developed: {{count}}
233
+ - Themes identified: {{count}}
234
+
235
+ **Select an Option:**
236
+ [A] Advanced Elicitation - Dig deeper into promising ideas
237
+ [P] Party Mode - Get multiple perspectives on concepts
238
+ [C] Continue - Save ideas and complete session (Step 4 of 4)"
239
+
240
+ ### 9. Handle Menu Selection
241
+
242
+ #### IF A (Advanced Elicitation):
243
+
244
+ - Deep dive into selected concepts
245
+ - Ask user: "Accept these additions? (y/n)"
246
+ - If yes: Update content, return to A/P/C menu
247
+ - If no: Keep original, return to A/P/C menu
248
+
249
+ #### IF P (Party Mode):
250
+
251
+ - Get diverse perspectives on concepts
252
+ - Ask user: "Accept these perspectives? (y/n)"
253
+ - If yes: Update content, return to A/P/C menu
254
+ - If no: Keep original, return to A/P/C menu
255
+
256
+ #### IF C (Continue):
257
+
258
+ - Append the ideation section to `{outputFile}`
259
+ - Update frontmatter: `stepsCompleted: [1, 2, 3]`
260
+ - Load `{nextStepFile}`
261
+
262
+ ## CRITICAL STEP COMPLETION NOTE
263
+
264
+ ONLY WHEN [C continue option] is selected and [ideation content saved with frontmatter updated], will you then load and read fully `{nextStepFile}`.
265
+
266
+ ---
267
+
268
+ ## SYSTEM SUCCESS/FAILURE METRICS
269
+
270
+ ### SUCCESS:
271
+
272
+ - User drove the ideation
273
+ - Multiple techniques applied
274
+ - All ideas captured without judgment
275
+ - Connections and themes identified
276
+ - Ideas organized and summarized
277
+ - A/P/C menu presented and handled correctly
278
+ - Frontmatter updated with stepsCompleted: [1, 2, 3]
279
+
280
+ ### SYSTEM FAILURE:
281
+
282
+ - Generating ideas FOR the user instead of WITH them
283
+ - Dismissing or criticizing ideas during session
284
+ - Not capturing all ideas
285
+ - Rushing through techniques
286
+ - Not presenting A/P/C menu after ideation
287
+ - Proceeding without user selecting 'C'
288
+
289
+ **Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.