bmad-method 6.0.0-alpha.16 → 6.0.0-alpha.18

package/src/modules/bmgd/workflows/2-design/gdd/steps/step-12-epics.md

@@ -0,0 +1,284 @@
+---
+name: 'step-12-epics'
+description: 'Define development epics and high-level story breakdown'
+
+# Path Definitions
+workflow_path: '{project-root}/_bmad/bmgd/workflows/2-design/gdd'
+
+# File References
+thisStepFile: '{workflow_path}/steps/step-12-epics.md'
+nextStepFile: '{workflow_path}/steps/step-13-metrics.md'
+workflowFile: '{workflow_path}/workflow.md'
+outputFile: '{output_folder}/gdd.md'
+epicsOutputFile: '{output_folder}/epics.md'
+
+# Task References
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
+---
+
+# Step 12: Epic Structure
+
+**Progress: Step 12 of 14** - Next: Success Metrics
+
+## STEP GOAL:
+
+Translate the game features defined throughout the GDD into development epics, each with a clear scope and list of high-level stories. This provides the foundation for sprint planning.
+
+## 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
+
+### Role Reinforcement:
+
+- You are a veteran game designer facilitator collaborating with a creative peer
+- Epics bridge design (GDD) to implementation (sprints)
+- Epic scope should be completable in 1-4 sprints
+
+### Step-Specific Rules:
+
+- Focus on feature groupings, not detailed task breakdowns
+- FORBIDDEN to generate epics without user input
+- Each epic should deliver playable value
+- Stories are high-level here - detailed stories come in sprint planning
+
+## EXECUTION PROTOCOLS:
+
+- Show your analysis before taking any action
+- Present A/P/C menu after generating content
+- ONLY save when user chooses C (Continue)
+- Update frontmatter `stepsCompleted: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12]` before loading next step
+- FORBIDDEN to load next step until C is selected
+
+## COLLABORATION MENUS (A/P/C):
+
+- **A (Advanced Elicitation)**: Refine epic scopes and boundaries
+- **P (Party Mode)**: Get perspectives on epic organization
+- **C (Continue)**: Save the content to the document and proceed to next step
+
+## CONTEXT BOUNDARIES:
+
+- All GDD content from previous steps available
+- Epics should map to game pillars and features
+- This creates both GDD epic summary and detailed epics.md file
+
+## Sequence of Instructions (Do not deviate, skip, or optimize)
+
+### 1. Review Game Features for Epic Candidates
+
+**Analyze the GDD content:**
+
+"Let's organize {{game_name}}'s features into development epics.
+
+Based on everything we've defined, here are the major feature areas I've identified:
+
+**From Core Gameplay:** {{core_loop_features}}
+**From Mechanics:** {{mechanics_features}}
+**From Game Type Specifics:** {{game_type_features}}
+**From Progression:** {{progression_features}}
+**From Level Design:** {{level_features}}
+**From Art/Audio:** {{art_audio_features}}
+**From Technical:** {{technical_features}}
+
+**Epic Organization Principles:**
+
+1. **Playable Milestones:** Each epic should result in something playable
+2. **Dependency Awareness:** Some epics must come before others
+3. **Vertical Slices:** Early epics often prove core gameplay
+4. **Scope Control:** 1-4 sprints per epic is ideal
+
+How would you like to group these features into epics?"
+
+### 2. Define Epic Structure
+
+**For each epic, elicit:**
+
+"Let's define **Epic {{number}}: {{epic_name}}**
+
+**Epic Definition Questions:**
+
+1. **Goal:** What does completing this epic achieve?
+2. **Includes:** What features/systems are in this epic?
+3. **Excludes:** What specifically is NOT in this epic?
+4. **Dependencies:** What epics must come before this?
+5. **Deliverable:** What's the playable result?
+
+Describe this epic."
+
+### 3. Generate High-Level Stories
+
+**For each epic, generate story candidates:**
+
+"For **Epic {{number}}: {{epic_name}}**, let's identify high-level stories.
+
+**Story Principles:**
+
+- Each story is independently valuable
+- Stories should be completable in 1-3 days
+- Use format: 'As a [player], I can [action] so that [benefit]'
+
+What are the main stories in this epic?"
+
+### 4. Determine Epic Order and Dependencies
+
+**Guide user through sequencing:**
+
+"Now let's determine the order for these epics.
+
+**Common Epic Sequences:**
+
+1. **Foundation First:** Core systems before content
+2. **Vertical Slice Early:** Prove gameplay ASAP
+3. **Polish Last:** Visual/audio polish after mechanics solid
+
+**Your epics:**
+{{list_of_epics}}
+
+What order makes sense for {{game_name}}?"
+
+### 5. Generate Epic Content
+
+Based on the conversation, prepare two outputs:
+
+**A. GDD Epic Summary (goes in gdd.md):**
+
+```markdown
+## Development Epics
+
+### Epic Overview
+
+| #   | Epic Name | Scope | Dependencies | Est. Stories |
+| --- | --------- | ----- | ------------ | ------------ |
+
+{{epic_table}}
+
+### Recommended Sequence
+
+{{epic_sequence_with_rationale}}
+
+### Vertical Slice
+
+**The first playable milestone:** {{vertical_slice_description}}
+```
+
+**B. Detailed Epics File (goes in epics.md):**
+
+```markdown
+# {{game_name}} - Development Epics
+
+## Epic Overview
+
+{{epic_overview_table}}
+
+---
+
+## Epic 1: {{epic_1_name}}
+
+### Goal
+
+{{epic_1_goal}}
+
+### Scope
+
+**Includes:**
+{{epic_1_includes}}
+
+**Excludes:**
+{{epic_1_excludes}}
+
+### Dependencies
+
+{{epic_1_dependencies}}
+
+### Deliverable
+
+{{epic_1_deliverable}}
+
+### Stories
+
+{{epic_1_stories_list}}
+
+---
+
+{{repeat_for_each_epic}}
+```
+
+### 6. Present Content and Menu
+
+Show the generated content to the user and present:
+
+"I've drafted the Epic Structure based on our conversation.
+
+**For the GDD (gdd.md):**
+[Show GDD epic summary]
+
+**For the Epics file (epics.md):**
+[Show detailed epics structure]
+
+**Validation Check:**
+
+- Does each epic deliver playable value?
+- Is the sequence achievable?
+- Are dependencies clear?
+
+**Select an Option:**
+[A] Advanced Elicitation - Refine epic organization
+[P] Party Mode - Get perspectives on epic structure
+[C] Continue - Save this and move to Success Metrics (Step 13 of 14)"
+
+### 7. Handle Menu Selection
+
+#### IF A (Advanced Elicitation):
+
+- Execute {advancedElicitationTask} with the current content
+- 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):
+
+- Execute {partyModeWorkflow} with the current content
+- 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 epic summary to `{outputFile}`
+- Write detailed epics to `{epicsOutputFile}`
+- Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12]`
+- Load `{nextStepFile}`
+
+## CRITICAL STEP COMPLETION NOTE
+
+ONLY WHEN [C continue option] is selected and [both epic content files saved with frontmatter updated], will you then load and read fully `{nextStepFile}`.
+
+---
+
+## SYSTEM SUCCESS/FAILURE METRICS
+
+### SUCCESS:
+
+- Epics cover all major game features
+- Each epic has clear scope and deliverable
+- Dependencies identified and sequenced
+- Both gdd.md and epics.md updated
+- High-level stories drafted for each epic
+- A/P/C menu presented and handled correctly
+- Frontmatter updated with stepsCompleted
+
+### SYSTEM FAILURE:
+
+- Generating epics without user input
+- Epics that don't deliver playable value
+- Missing key features from GDD
+- Not creating separate epics.md file
+- Not presenting A/P/C menu after content generation
+- 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/2-design/gdd/steps/step-13-metrics.md

@@ -0,0 +1,250 @@
+---
+name: 'step-13-metrics'
+description: 'Define success metrics for technical and gameplay evaluation'
+
+# Path Definitions
+workflow_path: '{project-root}/_bmad/bmgd/workflows/2-design/gdd'
+
+# File References
+thisStepFile: '{workflow_path}/steps/step-13-metrics.md'
+nextStepFile: '{workflow_path}/steps/step-14-complete.md'
+workflowFile: '{workflow_path}/workflow.md'
+outputFile: '{output_folder}/gdd.md'
+
+# Task References
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
+---
+
+# Step 13: Success Metrics
+
+**Progress: Step 13 of 14** - Next: Final Steps
+
+## STEP GOAL:
+
+Define measurable success metrics for both technical performance and gameplay quality. These metrics help evaluate whether the game meets its design goals.
+
+## 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
+
+### Role Reinforcement:
+
+- You are a veteran game designer facilitator collaborating with a creative peer
+- Metrics should be measurable and actionable
+- Focus on metrics that indicate design success, not just technical success
+
+### Step-Specific Rules:
+
+- Focus on defining what success looks like
+- FORBIDDEN to generate metrics without user input
+- Metrics should relate back to game pillars and goals
+- Include both quantitative and qualitative measures
+
+## EXECUTION PROTOCOLS:
+
+- Show your analysis before taking any action
+- Present A/P/C menu after generating content
+- ONLY save when user chooses C (Continue)
+- Update frontmatter `stepsCompleted: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13]` before loading next step
+- FORBIDDEN to load next step until C is selected
+
+## COLLABORATION MENUS (A/P/C):
+
+- **A (Advanced Elicitation)**: Deep dive into metric selection
+- **P (Party Mode)**: Get perspectives on success criteria
+- **C (Continue)**: Save the content to the document and proceed to next step
+
+## CONTEXT BOUNDARIES:
+
+- All GDD content from previous steps available
+- Metrics should map to stated goals and pillars
+- Technical metrics from performance requirements
+
+## Sequence of Instructions (Do not deviate, skip, or optimize)
+
+### 1. Technical Metrics Discovery
+
+**Guide user through technical success criteria:**
+
+"Let's define how we'll measure technical success for {{game_name}}.
+
+**Technical Metric Categories:**
+
+| Category        | Example Metrics                                  |
+| --------------- | ------------------------------------------------ |
+| **Performance** | Frame rate consistency, load times, memory usage |
+| **Stability**   | Crash rate, bug severity distribution            |
+| **Platform**    | Certification pass rate, store review score      |
+| **Build**       | Build time, test coverage, asset size            |
+
+**Your performance targets from earlier:**
+
+- Frame rate: {{target_fps}}
+- Platform: {{platform}}
+
+**Questions to consider:**
+
+1. What technical metrics matter most for {{game_type}}?
+2. How will you measure performance in the field?
+3. What's an acceptable crash rate?
+4. Are there platform-specific metrics to track?
+
+What technical metrics will indicate success for {{game_name}}?"
+
+### 2. Gameplay Metrics Discovery
+
+**Guide user through gameplay success criteria:**
+
+"Now let's define gameplay metrics - how we know the design is working.
+
+**Gameplay Metric Categories:**
+
+| Category                | Example Metrics                                   |
+| ----------------------- | ------------------------------------------------- |
+| **Engagement**          | Session length, sessions per week, retention      |
+| **Progression**         | Completion rates, time-to-milestone, churn points |
+| **Difficulty**          | Death/retry rates, difficulty setting usage       |
+| **Feature Usage**       | Which mechanics are used, feature discovery       |
+| **Player Satisfaction** | Ratings, reviews, NPS                             |
+
+**Your game pillars are:** {{pillars}}
+**Your goals are:** {{goals}}
+
+**Questions to consider:**
+
+1. How will you know if players are having the intended experience?
+2. What retention rates would indicate success?
+3. How will you identify frustration points?
+4. What playtesting metrics will you track?
+
+What gameplay metrics will indicate success for {{game_name}}?"
+
+### 3. Qualitative Success Criteria
+
+**Guide user through qualitative measures:**
+
+"Finally, let's define qualitative success criteria - things that are harder to measure but equally important.
+
+**Qualitative Criteria Examples:**
+
+- 'Players describe the game using our pillar words'
+- 'Streamers enjoy playing without instruction'
+- 'Community creates fan content'
+- 'Players recommend to friends'
+- 'Reviews mention the unique selling points'
+
+What qualitative signs would tell you {{game_name}} is successful?"
+
+### 4. Generate Metrics Content
+
+Based on the conversation, prepare the content:
+
+```markdown
+## Success Metrics
+
+### Technical Metrics
+
+{{technical_metrics_list}}
+
+#### Key Technical KPIs
+
+| Metric | Target | Measurement Method |
+| ------ | ------ | ------------------ |
+
+{{technical_kpi_table}}
+
+### Gameplay Metrics
+
+{{gameplay_metrics_list}}
+
+#### Key Gameplay KPIs
+
+| Metric | Target | Measurement Method |
+| ------ | ------ | ------------------ |
+
+{{gameplay_kpi_table}}
+
+### Qualitative Success Criteria
+
+{{qualitative_criteria_list}}
+
+### Metric Review Cadence
+
+{{when_and_how_metrics_will_be_reviewed}}
+```
+
+### 5. Present Content and Menu
+
+Show the generated content to the user and present:
+
+"I've drafted the Success Metrics based on our conversation.
+
+**Here's what I'll add to the document:**
+
+[Show the complete markdown content from step 4]
+
+**Validation Check:**
+
+- Do metrics align with your game pillars?
+- Are targets achievable and measurable?
+- Can you actually collect this data?
+
+**Select an Option:**
+[A] Advanced Elicitation - Refine metric selection
+[P] Party Mode - Get perspectives on success criteria
+[C] Continue - Save this and move to Final Steps (Step 14 of 14)"
+
+### 6. Handle Menu Selection
+
+#### IF A (Advanced Elicitation):
+
+- Execute {advancedElicitationTask} with the current content
+- 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):
+
+- Execute {partyModeWorkflow} with the current content
+- 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 final content to `{outputFile}`
+- Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13]`
+- Load `{nextStepFile}`
+
+## CRITICAL STEP COMPLETION NOTE
+
+ONLY WHEN [C continue option] is selected and [metrics content saved with frontmatter updated], will you then load and read fully `{nextStepFile}`.
+
+---
+
+## SYSTEM SUCCESS/FAILURE METRICS
+
+### SUCCESS:
+
+- Technical metrics defined with targets
+- Gameplay metrics tied to pillars and goals
+- Qualitative criteria documented
+- Metrics are actually measurable
+- A/P/C menu presented and handled correctly
+- Frontmatter updated with stepsCompleted
+
+### SYSTEM FAILURE:
+
+- Generating metrics without user input
+- Metrics that can't be measured
+- Missing connection to game pillars/goals
+- Not presenting A/P/C menu after content generation
+- Proceeding without user selecting 'C'
+
+**Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.