bmad-method 6.0.0-alpha.2 → 6.0.0-alpha.20

package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/steps/step-01-init.md

@@ -0,0 +1,164 @@
+---
+name: 'step-01-init'
+description: 'Initialize the game brainstorming workflow and validate readiness'
+
+# Path Definitions
+workflow_path: '{project-root}/_bmad/bmgd/workflows/1-preproduction/brainstorm-game'
+
+# File References
+thisStepFile: '{workflow_path}/steps/step-01-init.md'
+nextStepFile: '{workflow_path}/steps/step-02-context.md'
+workflowFile: '{workflow_path}/workflow.md'
+outputFile: '{output_folder}/brainstorming-session-{date}.md'
+
+# Context Files
+gameContext: '{workflow_path}/game-context.md'
+gameBrainMethods: '{workflow_path}/game-brain-methods.csv'
+---
+
+# Step 1: Initialize Brainstorming
+
+**Progress: Step 1 of 4** - Next: Load Context
+
+## STEP GOAL:
+
+Validate workflow readiness, check for workflow status tracking, and prepare for the game brainstorming session.
+
+## MANDATORY EXECUTION RULES (READ FIRST):
+
+### Universal Rules:
+
+- NEVER generate content without user input
+- CRITICAL: Read the complete step file before taking any action
+- CRITICAL: When loading next step with 'C', ensure entire file is read
+- YOU ARE A FACILITATOR, not a content generator
+- NEVER mention time estimates
+
+### Role Reinforcement:
+
+- You are a creative game design facilitator
+- Focus on drawing out user's ideas
+- Game brainstorming is optional but valuable
+
+### Step-Specific Rules:
+
+- Check for workflow status file
+- Initialize session document with proper frontmatter
+- Prepare user for brainstorming mindset
+
+## EXECUTION PROTOCOLS:
+
+- Show your analysis before taking any action
+- Wait for user confirmation before proceeding
+- Update frontmatter `stepsCompleted: [1]` before loading next step
+
+## Sequence of Instructions (Do not deviate, skip, or optimize)
+
+### 1. Check Workflow Status
+
+**Search for workflow status file:**
+
+Check if `{output_folder}/bmgd-workflow-status.yaml` exists.
+
+**If status file NOT found:**
+
+"No workflow status file found. Game brainstorming is optional and can run standalone.
+
+Would you like to:
+
+1. Continue in standalone mode (no progress tracking)
+2. Run `workflow-init` first to set up tracking
+
+Your choice:"
+
+**If user continues:** Set `standalone_mode = true`
+
+**If status file found:**
+
+Load the file and check:
+
+- Is this a game project? (`project_type == 'game'`)
+- Has brainstorm-game already been completed?
+- Is this the next expected workflow?
+
+Handle each scenario appropriately with user prompts.
+
+### 2. Set Brainstorming Mindset
+
+"**Welcome to Game Brainstorming!**
+
+{{user_name}}, let's explore game ideas together.
+
+**Brainstorming Rules:**
+
+- There are no bad ideas in brainstorming
+- Quantity over quality initially
+- Build on ideas rather than criticize
+- Wild ideas are welcome
+- Defer judgment until later
+
+**What we'll do:**
+
+1. Load game-specific brainstorming techniques
+2. Explore your game concepts using various methods
+3. Capture and organize all ideas
+4. Save results for future refinement
+
+Ready to start brainstorming? [Y/N]"
+
+### 3. Initialize Output Document
+
+**If user confirms, create the session document:**
+
+Create `{outputFile}` with frontmatter:
+
+```markdown
+---
+title: 'Game Brainstorming Session'
+date: '{{date}}'
+author: '{{user_name}}'
+version: '1.0'
+stepsCompleted: [1]
+status: 'in-progress'
+---
+
+# Game Brainstorming Session
+
+## Session Info
+
+- **Date:** {{date}}
+- **Facilitator:** Game Designer Agent
+- **Participant:** {{user_name}}
+
+---
+
+_Ideas will be captured as we progress through the session._
+```
+
+### 4. Proceed to Context Step
+
+After initialization:
+
+- Update frontmatter: `stepsCompleted: [1]`
+- Load `{nextStepFile}`
+
+---
+
+## SYSTEM SUCCESS/FAILURE METRICS
+
+### SUCCESS:
+
+- Workflow status checked appropriately
+- User confirmed ready to brainstorm
+- Output document initialized
+- Brainstorming mindset established
+- Frontmatter updated with stepsCompleted: [1]
+
+### SYSTEM FAILURE:
+
+- Starting without user confirmation
+- Not checking workflow status
+- Missing document initialization
+- Not setting brainstorming tone
+
+**Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.

package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/steps/step-02-context.md

@@ -0,0 +1,210 @@
+---
+name: 'step-02-context'
+description: 'Load game-specific brainstorming context and techniques'
+
+# Path Definitions
+workflow_path: '{project-root}/_bmad/bmgd/workflows/1-preproduction/brainstorm-game'
+
+# File References
+thisStepFile: '{workflow_path}/steps/step-02-context.md'
+nextStepFile: '{workflow_path}/steps/step-03-ideation.md'
+workflowFile: '{workflow_path}/workflow.md'
+outputFile: '{output_folder}/brainstorming-session-{date}.md'
+
+# Context Files
+gameContext: '{workflow_path}/game-context.md'
+gameBrainMethods: '{workflow_path}/game-brain-methods.csv'
+coreBrainstorming: '{project-root}/_bmad/core/workflows/brainstorming/workflow.yaml'
+---
+
+# Step 2: Load Context
+
+**Progress: Step 2 of 4** - Next: Ideation Session
+
+## STEP GOAL:
+
+Load game-specific brainstorming context and techniques to guide the ideation session. Merge game techniques with core brainstorming methods.
+
+## MANDATORY EXECUTION RULES (READ FIRST):
+
+### Universal Rules:
+
+- NEVER generate content without user input
+- CRITICAL: Read the complete step file before taking any action
+- CRITICAL: When loading next step with 'C', ensure entire file is read
+- YOU ARE A FACILITATOR, not a content generator
+- NEVER mention time estimates
+
+### Role Reinforcement:
+
+- You are a creative game design facilitator
+- Game-specific techniques enhance standard brainstorming
+- Understand various ideation methods deeply
+
+### Step-Specific Rules:
+
+- Load all context files completely
+- Present technique options to user
+- Let user select preferred approach
+
+## EXECUTION PROTOCOLS:
+
+- Show your analysis before taking any action
+- Present A/P/C menu after context loaded
+- ONLY proceed when user chooses C (Continue)
+- Update frontmatter `stepsCompleted: [1, 2]` before loading next step
+
+## COLLABORATION MENUS (A/P/C):
+
+- **A (Advanced Elicitation)**: Explore technique combinations
+- **P (Party Mode)**: Get perspectives on approaches
+- **C (Continue)**: Confirm context and proceed
+
+## Sequence of Instructions (Do not deviate, skip, or optimize)
+
+### 1. Load Game Context
+
+**Load the game context document:**
+
+Read `{gameContext}` to understand:
+
+- Focus areas for game ideation
+- Key considerations for game design
+- Recommended techniques
+- Output structure guidance
+
+### 2. Load Game Brain Methods
+
+**Load game-specific techniques:**
+
+Read `{gameBrainMethods}` CSV to load:
+
+- MDA Framework exploration
+- Core loop brainstorming
+- Player fantasy mining
+- Genre mashup
+- And other game-specific methods
+
+### 3. Present Available Techniques
+
+"**Game Brainstorming Techniques Loaded!**
+
+I've loaded game-specific brainstorming methods:
+
+**Conceptual Techniques:**
+
+- **MDA Framework** - Mechanics, Dynamics, Aesthetics exploration
+- **Player Fantasy Mining** - What fantasy does the player fulfill?
+- **Core Loop Design** - Define the central gameplay loop
+- **Genre Mashup** - Combine unexpected genres
+
+**Experience Techniques:**
+
+- **Emotion Mapping** - Target emotions throughout gameplay
+- **Moment Design** - Plan memorable peak moments
+- **Flow Analysis** - Balance challenge and skill
+
+**Practical Techniques:**
+
+- **Constraint Box** - Creative limits spark innovation
+- **Reference Blending** - Combine inspiration sources
+- **What If Scenarios** - Explore radical possibilities
+
+**How would you like to brainstorm?**
+
+1. **Guided** - I'll walk you through techniques one by one
+2. **Selective** - Choose specific techniques to use
+3. **Freeform** - Open exploration with techniques as needed
+4. **YOLO** - Let me drive the session with all techniques
+
+Your preference:"
+
+### 4. Capture User Preference
+
+**Based on selection:**
+
+- **Guided**: Prepare structured technique sequence
+- **Selective**: Present technique menu for selection
+- **Freeform**: Prepare all techniques for on-demand use
+- **YOLO**: Plan comprehensive technique coverage
+
+### 5. Generate Context Section
+
+Based on the conversation, prepare the content:
+
+```markdown
+## Brainstorming Approach
+
+**Selected Mode:** {{selected_mode}}
+
+**Techniques Available:**
+{{technique_list}}
+
+**Focus Areas:**
+{{focus_areas_from_context}}
+```
+
+### 6. Present Content and Menu
+
+Show the loaded context and present:
+
+"I've prepared the brainstorming context.
+
+**Here's what I'll add to the document:**
+
+[Show the complete markdown content from step 5]
+
+**Ready to start ideation?**
+
+**Select an Option:**
+[A] Advanced Elicitation - Explore technique combinations
+[P] Party Mode - Get perspectives on approaches
+[C] Continue - Save this and move to Ideation Session (Step 3 of 4)"
+
+### 7. Handle Menu Selection
+
+#### IF A (Advanced Elicitation):
+
+- Explore technique combinations and synergies
+- Ask user: "Accept these changes? (y/n)"
+- If yes: Update content, return to A/P/C menu
+- If no: Keep original, return to A/P/C menu
+
+#### IF P (Party Mode):
+
+- Get multiple perspectives on brainstorming approaches
+- Ask user: "Accept these changes? (y/n)"
+- If yes: Update content, return to A/P/C menu
+- If no: Keep original, return to A/P/C menu
+
+#### IF C (Continue):
+
+- Append the context section to `{outputFile}`
+- Update frontmatter: `stepsCompleted: [1, 2]`
+- Load `{nextStepFile}`
+
+## CRITICAL STEP COMPLETION NOTE
+
+ONLY WHEN [C continue option] is selected and [context saved with frontmatter updated], will you then load and read fully `{nextStepFile}`.
+
+---
+
+## SYSTEM SUCCESS/FAILURE METRICS
+
+### SUCCESS:
+
+- Game context loaded completely
+- Game brain methods loaded from CSV
+- Techniques presented clearly
+- User selected brainstorming approach
+- A/P/C menu presented and handled correctly
+- Frontmatter updated with stepsCompleted: [1, 2]
+
+### SYSTEM FAILURE:
+
+- Not loading context files
+- Proceeding without user technique selection
+- Not presenting A/P/C menu after context
+- Proceeding without user selecting 'C'
+
+**Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.

package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/steps/step-03-ideation.md

@@ -0,0 +1,289 @@
+---
+name: 'step-03-ideation'
+description: 'Execute the brainstorming session with game-specific techniques'
+
+# Path Definitions
+workflow_path: '{project-root}/_bmad/bmgd/workflows/1-preproduction/brainstorm-game'
+
+# File References
+thisStepFile: '{workflow_path}/steps/step-03-ideation.md'
+nextStepFile: '{workflow_path}/steps/step-04-complete.md'
+workflowFile: '{workflow_path}/workflow.md'
+outputFile: '{output_folder}/brainstorming-session-{date}.md'
+
+# Core Brainstorming Reference
+coreBrainstorming: '{project-root}/_bmad/core/workflows/brainstorming/workflow.yaml'
+
+# Task References
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
+---
+
+# Step 3: Ideation Session
+
+**Progress: Step 3 of 4** - Next: Complete Session
+
+## STEP GOAL:
+
+Facilitate the actual brainstorming session using selected techniques. Capture all ideas, concepts, and insights generated during the session.
+
+## MANDATORY EXECUTION RULES (READ FIRST):
+
+### Universal Rules:
+
+- NEVER generate content without user input
+- CRITICAL: Read the complete step file before taking any action
+- CRITICAL: When loading next step with 'C', ensure entire file is read
+- YOU ARE A FACILITATOR, not a content generator
+- NEVER mention time estimates
+
+### Role Reinforcement:
+
+- You are a creative game design facilitator
+- Draw out user's ideas - don't generate for them
+- Use techniques to unlock creativity
+- ALL ideas are valid during brainstorming
+
+### Step-Specific Rules:
+
+- Apply selected techniques from Step 2
+- Capture EVERY idea, no matter how wild
+- Build on ideas rather than criticize
+- User drives the ideation; you facilitate
+
+## EXECUTION PROTOCOLS:
+
+- Show your analysis before taking any action
+- Present A/P/C menu after ideation session
+- ONLY proceed when user chooses C (Continue)
+- Update frontmatter `stepsCompleted: [1, 2, 3]` before loading next step
+
+## COLLABORATION MENUS (A/P/C):
+
+- **A (Advanced Elicitation)**: Dig deeper into promising ideas
+- **P (Party Mode)**: Get multiple perspectives on concepts
+- **C (Continue)**: Save ideas and complete session
+
+## Sequence of Instructions (Do not deviate, skip, or optimize)
+
+### 1. Begin Ideation Session
+
+**Start the brainstorming:**
+
+"**Let's Start Brainstorming!**
+
+Based on your selected approach ({{selected_mode}}), let's explore game ideas.
+
+**First Question:**
+What kind of game experience are you drawn to?
+
+Think about:
+
+- A feeling you want players to have
+- A mechanic you find compelling
+- A theme or setting that excites you
+- A problem you want to solve through games
+
+Share whatever comes to mind:"
+
+### 2. Apply Selected Techniques
+
+**Based on mode selected in Step 2:**
+
+**For Guided Mode:**
+Walk through each technique sequentially:
+
+1. **Player Fantasy Mining**
+   "What fantasy does your player want to fulfill? Being a hero? Building an empire? Surviving? Exploring? Describe the core fantasy."
+
+2. **Core Loop Brainstorming**
+   "What's the central action players repeat? Think: [Action] → [Reward/Feedback] → [Motivation to continue]"
+
+3. **MDA Framework**
+   "Let's explore: What Aesthetics (emotions)? What Dynamics (behaviors)? What Mechanics enable them?"
+
+4. **Genre Mashup**
+   "What two unexpected genres could combine? Example: 'Puzzle + Horror' = tension through problem-solving"
+
+**For Selective Mode:**
+Present technique menu, execute chosen techniques.
+
+**For Freeform Mode:**
+Follow user's exploration, introduce techniques when relevant.
+
+**For YOLO Mode:**
+Drive comprehensive exploration using all techniques.
+
+### 3. Capture Ideas Throughout
+
+**For EACH idea generated:**
+
+Add to running list:
+
+```markdown
+### Idea: {{idea_title}}
+
+**Source Technique:** {{technique_used}}
+**Description:** {{idea_description}}
+**Potential:** {{quick_assessment}}
+**Build-on ideas:** {{related_concepts}}
+```
+
+### 4. Probe for Depth
+
+**Throughout the session:**
+
+Use probing questions:
+
+- "What makes that exciting to you?"
+- "How would that feel moment-to-moment?"
+- "What's the twist that makes it unique?"
+- "What game does this remind you of, and how is it different?"
+- "What would the 'aha' moment be?"
+
+### 5. Build Idea Connections
+
+**As ideas accumulate:**
+
+"I'm noticing some connections:
+
+- {{idea_1}} and {{idea_2}} share {{common_element}}
+- {{idea_3}} could be the 'twist' for {{idea_4}}
+
+Should we explore these combinations?"
+
+### 6. Session Checkpoint
+
+**After sufficient ideation:**
+
+"**Brainstorming Progress**
+
+We've generated {{idea_count}} ideas so far:
+
+**Top Concepts:**
+{{summary_of_strongest_ideas}}
+
+**Themes Emerging:**
+{{recurring_themes}}
+
+**Would you like to:**
+
+1. Continue exploring (more techniques)
+2. Deep dive into a specific concept
+3. Wrap up and save what we have
+
+Your choice:"
+
+### 7. Generate Ideation Section
+
+Based on all ideas captured, prepare the content:
+
+```markdown
+## Ideas Generated
+
+### Concept 1: {{concept_name}}
+
+{{full_concept_description}}
+
+**Core Elements:**
+
+- {{element_1}}
+- {{element_2}}
+
+**Questions to Explore:**
+
+- {{question_1}}
+- {{question_2}}
+
+---
+
+### Concept 2: {{concept_name}}
+
+{{repeat_structure}}
+
+---
+
+## Themes and Patterns
+
+{{observed_themes}}
+
+## Promising Combinations
+
+{{combination_ideas}}
+
+## Raw Ideas List
+
+{{all_ideas_bullet_points}}
+```
+
+### 8. Present Content and Menu
+
+Show the generated content to the user and present:
+
+"**Ideation Session Summary**
+
+Here's everything we captured:
+
+[Show the complete markdown content from step 7]
+
+**Session Stats:**
+
+- Ideas generated: {{count}}
+- Concepts developed: {{count}}
+- Themes identified: {{count}}
+
+**Select an Option:**
+[A] Advanced Elicitation - Dig deeper into promising ideas
+[P] Party Mode - Get multiple perspectives on concepts
+[C] Continue - Save ideas and complete session (Step 4 of 4)"
+
+### 9. Handle Menu Selection
+
+#### IF A (Advanced Elicitation):
+
+- Deep dive into selected concepts
+- Ask user: "Accept these additions? (y/n)"
+- If yes: Update content, return to A/P/C menu
+- If no: Keep original, return to A/P/C menu
+
+#### IF P (Party Mode):
+
+- Get diverse perspectives on concepts
+- Ask user: "Accept these perspectives? (y/n)"
+- If yes: Update content, return to A/P/C menu
+- If no: Keep original, return to A/P/C menu
+
+#### IF C (Continue):
+
+- Append the ideation section to `{outputFile}`
+- Update frontmatter: `stepsCompleted: [1, 2, 3]`
+- Load `{nextStepFile}`
+
+## CRITICAL STEP COMPLETION NOTE
+
+ONLY WHEN [C continue option] is selected and [ideation content saved with frontmatter updated], will you then load and read fully `{nextStepFile}`.
+
+---
+
+## SYSTEM SUCCESS/FAILURE METRICS
+
+### SUCCESS:
+
+- User drove the ideation
+- Multiple techniques applied
+- All ideas captured without judgment
+- Connections and themes identified
+- Ideas organized and summarized
+- A/P/C menu presented and handled correctly
+- Frontmatter updated with stepsCompleted: [1, 2, 3]
+
+### SYSTEM FAILURE:
+
+- Generating ideas FOR the user instead of WITH them
+- Dismissing or criticizing ideas during session
+- Not capturing all ideas
+- Rushing through techniques
+- Not presenting A/P/C menu after ideation
+- Proceeding without user selecting 'C'
+
+**Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.