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

package/src/modules/bmgd/workflows/2-design/narrative/steps/step-10-production.md

@@ -0,0 +1,262 @@
+---
+name: 'step-10-production'
+description: 'Plan production scope including writing estimates, localization, and voice acting'
+
+# Path Definitions
+workflow_path: '{project-root}/_bmad/bmgd/workflows/2-design/narrative'
+
+# File References
+thisStepFile: '{workflow_path}/steps/step-10-production.md'
+nextStepFile: '{workflow_path}/steps/step-11-complete.md'
+workflowFile: '{workflow_path}/workflow.md'
+outputFile: '{output_folder}/narrative-design.md'
+
+# Task References
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
+---
+
+# Step 10: Production Planning
+
+**Progress: Step 10 of 11** - Next: Complete
+
+## STEP GOAL:
+
+Plan the production scope for narrative content: writing scope estimates, localization considerations, and voice acting plans.
+
+## 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 narrative design facilitator
+- Production planning ensures realistic scope
+- Help user understand what they're committing to
+
+### Step-Specific Rules:
+
+- FORBIDDEN to estimate scope without user input
+- Help user think through production needs
+- Be realistic about effort required
+
+## 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]` before loading next step
+
+## COLLABORATION MENUS (A/P/C):
+
+- **A (Advanced Elicitation)**: Explore production details
+- **P (Party Mode)**: Get perspectives on scope
+- **C (Continue)**: Save the content and proceed
+
+## Sequence of Instructions (Do not deviate, skip, or optimize)
+
+### 1. Writing Scope Discovery
+
+"**Let's estimate the writing scope for {{game_name}}.**
+
+**Scope elements:**
+
+- **Word count estimate** - Total written content
+- **Scene/chapter count** - Major narrative sections
+- **Dialogue lines** - Approximate line count
+- **Branching complexity** - How much unique content per path?
+
+**For reference:**
+
+- Light narrative game: ~5,000-15,000 words
+- Moderate narrative: ~15,000-50,000 words
+- Heavy narrative: ~50,000-150,000 words
+- Story-driven/Visual novel: 100,000+ words
+
+Estimate your writing scope:"
+
+### 2. Localization Discovery
+
+"**Are you planning localization?**
+
+**Localization considerations:**
+
+- **Target languages** - Which languages?
+- **Cultural adaptation** - What needs to change per region?
+- **Text expansion** - Some languages use 30% more space
+- **UI implications** - Can UI handle longer text?
+- **Audio implications** - Will you dub or subtitle?
+
+Describe your localization plans (or indicate English-only):"
+
+### 3. Voice Acting Discovery
+
+"**What are your voice acting plans?**
+
+**Voice acting scope:**
+
+- **Fully voiced** - All dialogue recorded
+- **Partially voiced** - Key scenes only
+- **Grunts/barks only** - No full dialogue
+- **Text only** - No voice acting
+
+**If voiced:**
+
+- Number of characters needing voices?
+- Approximate dialogue volume?
+- Professional or placeholder voices?
+
+Describe your voice acting approach:"
+
+### 4. Generate Production Content
+
+Based on the conversation, prepare the content:
+
+```markdown
+## Production Planning
+
+### Writing Scope
+
+**Estimated Word Count:** {{word_count}}
+
+**Content Breakdown:**
+
+- Main story: {{main_story_words}}
+- Side content: {{side_content_words}}
+- Environmental/lore: {{lore_words}}
+- UI/system text: {{ui_words}}
+
+**Scene Count:** {{scene_count}}
+
+**Dialogue Lines:** {{line_count}}
+
+**Branching Complexity:**
+{{branching_impact_on_scope}}
+
+---
+
+### Localization
+
+{{if_localizing}}
+**Target Languages:**
+{{language_list}}
+
+**Cultural Adaptation Notes:**
+{{adaptation_needs}}
+
+**Technical Considerations:**
+
+- Text expansion buffer: {{percentage}}
+- UI flexibility: {{notes}}
+- Audio approach: {{dub_or_subtitle}}
+  {{/if_localizing}}
+
+{{if_english_only}}
+**Approach:** English only
+**Future consideration:** {{maybe_later_notes}}
+{{/if_english_only}}
+
+---
+
+### Voice Acting
+
+**Approach:** {{voice_acting_level}}
+
+{{if_voiced}}
+**Characters Needing Voices:** {{character_count}}
+
+**Dialogue Volume:** {{line_count_for_recording}}
+
+**Voice Cast Notes:**
+{{casting_considerations}}
+
+**Recording Approach:**
+{{professional_or_placeholder}}
+{{/if_voiced}}
+
+{{if_not_voiced}}
+**Rationale:** {{why_no_voice}}
+{{/if_not_voiced}}
+```
+
+### 5. Present Content and Menu
+
+Show the generated content to the user and present:
+
+"I've documented the production planning.
+
+**Here's what I'll add to the document:**
+
+[Show the complete markdown content from step 4]
+
+**Production Summary:**
+
+- Writing: ~{{word_count}} words
+- Localization: {{languages_or_none}}
+- Voice acting: {{level}}
+
+**Validation Check:**
+
+- Is scope realistic for your resources?
+- Have you considered all production needs?
+- Are localization needs addressed?
+
+**Select an Option:**
+[A] Advanced Elicitation - Explore production details
+[P] Party Mode - Get perspectives on scope
+[C] Continue - Save this and move to Completion (Step 11 of 11)"
+
+### 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]`
+- Load `{nextStepFile}`
+
+## CRITICAL STEP COMPLETION NOTE
+
+ONLY WHEN [C continue option] is selected and [production content saved with frontmatter updated], will you then load and read fully `{nextStepFile}`.
+
+---
+
+## SYSTEM SUCCESS/FAILURE METRICS
+
+### SUCCESS:
+
+- Writing scope estimated
+- Localization needs addressed
+- Voice acting approach defined
+- Realistic production expectations set
+- A/P/C menu presented and handled correctly
+- Frontmatter updated with stepsCompleted: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
+
+### SYSTEM FAILURE:
+
+- Estimating scope without user input
+- Missing major production considerations
+- Unrealistic expectations set
+- Not presenting A/P/C menu after content
+- 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/narrative/steps/step-11-complete.md

@@ -0,0 +1,331 @@
+---
+name: 'step-11-complete'
+description: 'Complete the narrative workflow with final summary, visualizations, and handoff'
+
+# Path Definitions
+workflow_path: '{project-root}/_bmad/bmgd/workflows/2-design/narrative'
+
+# File References
+thisStepFile: '{workflow_path}/steps/step-11-complete.md'
+workflowFile: '{workflow_path}/workflow.md'
+outputFile: '{output_folder}/narrative-design.md'
+
+# Handoff References
+architectureWorkflow: '{project-root}/_bmad/bmgd/workflows/3-technical/game-architecture/workflow.yaml'
+---
+
+# Step 11: Complete
+
+**Progress: Step 11 of 11** - Narrative Design Complete!
+
+## STEP GOAL:
+
+Generate final visualizations (character relationships, timeline), capture references, update workflow status, and provide clear handoff guidance.
+
+## MANDATORY EXECUTION RULES (READ FIRST):
+
+### Universal Rules:
+
+- NEVER generate content without user input
+- CRITICAL: Read the complete step file before taking any action
+- YOU ARE A FACILITATOR, not a content generator
+- NEVER mention time estimates
+
+### Role Reinforcement:
+
+- You are a narrative design facilitator
+- This is the final step - ensure completeness
+- Provide actionable next steps
+
+### Step-Specific Rules:
+
+- Generate relationship map from characters defined
+- Generate timeline from story beats
+- Capture any references user wants to note
+
+## EXECUTION PROTOCOLS:
+
+- Show your analysis before taking any action
+- Generate final visualizations
+- Update frontmatter `stepsCompleted: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11]`
+- Present completion summary and next steps
+
+## Sequence of Instructions (Do not deviate, skip, or optimize)
+
+### 1. Generate Character Relationship Map
+
+**Create text-based relationship visualization:**
+
+Based on all characters documented, generate:
+
+```markdown
+## Appendix: Character Relationships
+
+### Relationship Map
+```
+
+                    [ANTAGONIST]
+                         |
+                    (opposes)
+                         |
+    [MENTOR] ---(guides)--- [PROTAGONIST] ---(allies)--- [COMPANION]
+                         |
+                    (romantic)
+                         |
+                  [LOVE INTEREST]
+
+```
+
+### Relationship Key
+
+- {{character_1}} → {{character_2}}: {{relationship_type}}
+- {{character_2}} → {{character_3}}: {{relationship_type}}
+{{continue_for_all_relationships}}
+```
+
+### 2. Generate Story Timeline
+
+**Create timeline visualization:**
+
+Based on story beats documented, generate:
+
+```markdown
+## Appendix: Story Timeline
+
+### Chronological Events
+```
+
+[BACKSTORY]
+|
+v
+[ACT 1: SETUP]
+├── {{beat_1}}
+├── {{beat_2}}
+└── {{inciting_incident}}
+|
+v
+[ACT 2: CONFRONTATION]
+├── {{beat_3}}
+├── {{midpoint}}
+├── {{beat_4}}
+└── {{crisis}}
+|
+v
+[ACT 3: RESOLUTION]
+├── {{climax}}
+└── {{resolution}}
+
+```
+
+### Timeline Notes
+
+{{any_timeline_clarifications}}
+```
+
+### 3. References Discovery
+
+"**Do you have any references or inspirations to note?**
+
+This helps future writers understand your vision:
+
+- Books, movies, games that inspired you
+- Reference materials for tone/style
+- Mood boards or concept art references
+- Theme or narrative references
+
+What references should be documented? (or 'none'):"
+
+### 4. Finalize Document
+
+**Update the document with final content:**
+
+Add relationship map and timeline to document.
+
+**Final frontmatter:**
+
+```yaml
+---
+title: 'Narrative Design Document'
+project: '{{game_name}}'
+date: '{{date}}'
+author: '{{user_name}}'
+version: '1.0'
+stepsCompleted: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11]
+status: 'complete'
+narrativeComplexity: '{{complexity}}'
+---
+```
+
+### 5. Update Workflow Status
+
+**If not in standalone mode:**
+
+Load `{output_folder}/bmm-workflow-status.yaml` and:
+
+- Update `narrative` status to the output file path
+- Preserve all comments and structure
+- Determine next workflow in sequence
+
+### 6. Present Completion Summary
+
+"**Narrative Design Complete!**
+
+{{user_name}}, the Narrative Design Document for **{{game_name}}** is complete!
+
+**Narrative Summary:**
+
+- **Premise:** {{premise_summary}}
+- **Themes:** {{themes_list}}
+- **Characters:** {{character_count}} ({{protagonist_count}} protagonist, {{antagonist_count}} antagonist, {{supporting_count}} supporting)
+- **Story Structure:** {{structure_type}}
+- **Writing Scope:** ~{{word_count}} words
+
+**Sections Completed:**
+
+1. Story Foundation (premise, themes, structure)
+2. Story Beats (major moments, pacing)
+3. Characters (all characters and arcs)
+4. World Building (setting, history, locations)
+5. Dialogue Framework (style, key conversations)
+6. Environmental Storytelling (visual, audio, documents)
+7. Narrative Delivery (cutscenes, in-game, endings)
+8. Gameplay Integration (gating, agency)
+9. Production Planning (scope, localization, voice)
+10. Appendices (relationships, timeline)
+
+**Document saved to:** `{outputFile}`
+
+Do you want to review or adjust anything before we finalize?"
+
+### 7. Handle Review Requests
+
+**If user wants to review:**
+
+"Which would you like to review?
+
+1. Story Foundation
+2. Story Beats
+3. Characters
+4. World Building
+5. Dialogue
+6. Environmental Storytelling
+7. Narrative Delivery
+8. Gameplay Integration
+9. Production Planning
+10. Full Document
+
+Select a section:"
+
+### 8. Present Next Steps Menu
+
+"**Recommended Next Steps:**
+
+1. **Technical Architecture** - Define how narrative systems will be implemented
+   - Workflow: `create-architecture`
+   - Input: GDD + Narrative Design
+   - Output: Technical architecture document
+
+2. **Create Script/Screenplay** - Write the actual dialogue and scenes
+   - This is done outside the workflow
+   - Use the Narrative Design as your blueprint
+
+3. **Review with Team** - Share with collaborators for feedback
+
+4. **Exit Workflow**
+
+**Which would you like to do next?**
+
+1. Start Architecture workflow
+2. Review the narrative document
+3. Exit workflow"
+
+### 9. Handle User Selection
+
+Based on user choice:
+
+**If 1 (Architecture):**
+
+- Confirm document is saved
+- Provide handoff guidance
+- Note narrative will inform technical decisions
+
+**If 2 (Review):**
+
+- Present full document or requested section
+- Return to next steps menu
+
+**If 3 (Exit):**
+
+- Confirm document is saved and complete
+- Exit workflow gracefully
+
+### 10. Final Completion Message
+
+"**Narrative Design Complete!**
+
+**Deliverables:**
+
+- Narrative design saved to: `{outputFile}`
+- {{character_count}} characters documented
+- {{beat_count}} story beats mapped
+- {{location_count}} locations defined
+
+{{#if standalone_mode != true}}
+**Status Updated:**
+
+- Progress tracking updated: narrative marked complete
+- Next recommended: Architecture workflow
+  {{/if}}
+
+**Your Narrative Is Ready For:**
+
+- Script/screenplay writing
+- Technical implementation planning
+- Team review and iteration
+- Production scheduling
+
+Excellent work crafting the narrative for {{game_name}}, {{user_name}}!"
+
+---
+
+## SYSTEM SUCCESS/FAILURE METRICS
+
+### SUCCESS:
+
+- Relationship map generated
+- Timeline generated
+- References captured
+- All content saved to document
+- Workflow status updated (if tracking)
+- Frontmatter shows all 11 steps completed
+- User has clear next steps
+
+### SYSTEM FAILURE:
+
+- Missing visualizations
+- Incomplete document
+- Status not updated when tracking
+- No clear next steps provided
+- User left without guidance
+
+**Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.
+
+---
+
+## Narrative Design Workflow Complete
+
+The Narrative Design workflow creates comprehensive narrative documentation through 11 collaborative steps:
+
+1. **Initialize** - Validate readiness, assess complexity
+2. **Foundation** - Premise, themes, tone, structure
+3. **Story** - Beats and pacing
+4. **Characters** - All characters and arcs
+5. **World** - Setting, history, factions, locations
+6. **Dialogue** - Style and systems
+7. **Environmental** - Environmental storytelling
+8. **Delivery** - Narrative delivery methods
+9. **Integration** - Gameplay-narrative connection
+10. **Production** - Scope and planning
+11. **Complete** - Visualizations and handoff
+
+This step-file architecture ensures consistent, thorough narrative design with user collaboration at every step.

package/src/modules/bmgd/workflows/2-design/narrative/workflow.md

@@ -0,0 +1,57 @@
+# Narrative Design Workflow
+
+**Comprehensive narrative design for story-driven games**
+
+## Overview
+
+This workflow creates detailed narrative content for games with significant story elements. It covers story structure, character development, world-building, dialogue systems, environmental storytelling, and production planning.
+
+## Workflow Structure
+
+The workflow uses a step-file architecture for modular, stateful execution:
+
+1. **Step 1: Initialize** - Validate readiness, load GDD, assess narrative complexity
+2. **Step 1b: Continue** - Resume existing narrative work
+3. **Step 2: Foundation** - Define premise, themes, tone, and story structure
+4. **Step 3: Story** - Map story beats and pacing
+5. **Step 4: Characters** - Develop all characters and their arcs
+6. **Step 5: World** - Build world, history, factions, and locations
+7. **Step 6: Dialogue** - Define dialogue style and systems
+8. **Step 7: Environmental** - Plan environmental storytelling
+9. **Step 8: Delivery** - Design narrative delivery methods
+10. **Step 9: Integration** - Plan gameplay-narrative integration
+11. **Step 10: Production** - Scope, localization, and voice acting
+12. **Step 11: Complete** - Final summary and handoff
+
+## State Tracking
+
+Progress is tracked in the narrative document frontmatter:
+
+```yaml
+stepsCompleted: [1, 2, 3, ...] # Array of completed step numbers
+```
+
+## Starting the Workflow
+
+To begin, load and execute step-01-init.md:
+
+```
+{workflow_path}/steps/step-01-init.md
+```
+
+## Critical Rules
+
+- **NEVER** generate narrative content without user input
+- **ALWAYS** facilitate user creativity - help them craft THEIR story
+- **NEVER** mention time estimates
+- **ALWAYS** present options and wait for user selection
+- **FOLLOW** the step sequence exactly - no skipping or optimizing
+
+## Agent Role
+
+You are a narrative design facilitator:
+
+- Draw out the user's story vision
+- Help weave user's ideas into cohesive narrative
+- Focus on what the user wants to create
+- The goal is for users to feel THEY crafted the narrative