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

package/src/modules/bmgd/workflows/2-design/narrative/steps/step-01-init.md

@@ -0,0 +1,228 @@
+---
+name: 'step-01-init'
+description: 'Initialize narrative workflow, load GDD context, and assess narrative complexity'
+
+# Path Definitions
+workflow_path: '{project-root}/_bmad/bmgd/workflows/2-design/narrative'
+
+# File References
+thisStepFile: '{workflow_path}/steps/step-01-init.md'
+continueStepFile: '{workflow_path}/steps/step-01b-continue.md'
+nextStepFile: '{workflow_path}/steps/step-02-foundation.md'
+workflowFile: '{workflow_path}/workflow.md'
+outputFile: '{output_folder}/narrative-design.md'
+templateFile: '{workflow_path}/templates/narrative-template.md'
+---
+
+# Step 1: Initialize Narrative Workflow
+
+**Progress: Step 1 of 11** - Next: Story Foundation
+
+## STEP GOAL:
+
+Validate workflow readiness, check for existing narrative document, load GDD context, and assess the appropriate level of narrative complexity for this game.
+
+## 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
+- Help users craft THEIR story, not yours
+- Narrative complexity should match the game
+
+### Step-Specific Rules:
+
+- Check for existing narrative before starting fresh
+- Load GDD to understand game context
+- Let user confirm narrative complexity level
+
+## EXECUTION PROTOCOLS:
+
+- Show your analysis before taking any action
+- Wait for user confirmation at each checkpoint
+- 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 found:**
+
+- Load and parse workflow_status section
+- Check status of "narrative" workflow
+- Determine if this is the expected next workflow
+
+**Handle scenarios:**
+
+- If already completed: Ask about overwriting
+- If out of sequence: Warn and confirm continuation
+- Set `standalone_mode` appropriately
+
+### 2. Check for Existing Narrative
+
+**Search for existing narrative document:**
+
+Look for existing narrative files in {output_folder}:
+
+- `*narrative*.md`
+- `*story*.md`
+
+**If existing narrative found:**
+
+"I found an existing narrative document: `{{existing_file}}`
+
+**Options:**
+
+1. **Continue** - Resume from where you left off
+2. **Start Fresh** - Begin a new narrative (will overwrite)
+3. **Review** - Let me review the existing document first
+
+Which would you like to do?"
+
+**Handle selection:**
+
+- If **Continue**: Load `{continueStepFile}`
+- If **Start Fresh**: Continue with step 3
+- If **Review**: Show document summary
+
+### 3. Load GDD Context
+
+**Search for GDD:**
+
+Look for GDD files using patterns:
+
+- `{output_folder}/*gdd*.md`
+- `{output_folder}/*game-design*.md`
+
+**If GDD not found:**
+
+"**Note: GDD Not Found**
+
+The Narrative workflow works best with a completed GDD.
+
+**Options:**
+
+1. Continue without GDD (I'll ask more questions)
+2. Run GDD workflow first: `create-gdd`
+
+Your choice:"
+
+**If GDD found:**
+
+Load and extract:
+
+- `game_type`
+- `game_name`
+- Any existing narrative mentions
+- Core mechanics and themes
+
+### 4. Assess Narrative Complexity
+
+"**Narrative Complexity Assessment**
+
+Let's determine the right depth for your narrative design.
+
+**Narrative Complexity Levels:**
+
+| Level        | Description             | Examples                       |
+| ------------ | ----------------------- | ------------------------------ |
+| **Critical** | Story IS the game       | Visual Novel, Text Adventure   |
+| **Heavy**    | Story drives experience | Story RPG, Narrative Adventure |
+| **Moderate** | Story enhances gameplay | Metroidvania, Horror, Tactics  |
+| **Light**    | Story provides context  | Most action, puzzle, arcade    |
+
+**Based on {{game_type}}, I'd suggest: {{suggested_complexity}}**
+
+What level of narrative complexity does {{game_name}} have?"
+
+### 5. Validate Complexity Choice
+
+**If user selects Light:**
+
+"**Light narrative games usually don't need a full Narrative Design Document.**
+
+Your options:
+
+1. **Proceed anyway** - Create full narrative document
+2. **Quick narrative** - Just the essentials (premise, setting, key characters)
+3. **Expand GDD** - Add narrative sections to existing GDD instead
+
+What would you like to do?"
+
+**Handle selection appropriately.**
+
+### 6. Initialize Output Document
+
+**If proceeding with full narrative:**
+
+Create `{outputFile}` with frontmatter:
+
+```markdown
+---
+title: 'Narrative Design Document'
+project: '{{game_name}}'
+date: '{{date}}'
+author: '{{user_name}}'
+version: '1.0'
+stepsCompleted: [1]
+status: 'in-progress'
+narrativeComplexity: '{{selected_complexity}}'
+gdd: '{{gdd_file}}'
+---
+
+# Narrative Design Document
+
+## {{game_name}}
+
+### Document Status
+
+This narrative document is being created through the BMGD Narrative Workflow.
+
+**Narrative Complexity:** {{selected_complexity}}
+**Steps Completed:** 1 of 11 (Initialize)
+
+---
+
+_Content will be added as we progress through the workflow._
+```
+
+### 7. Proceed to Foundation Step
+
+After initialization:
+
+- Update frontmatter: `stepsCompleted: [1]`
+- Load `{nextStepFile}`
+
+---
+
+## SYSTEM SUCCESS/FAILURE METRICS
+
+### SUCCESS:
+
+- Workflow status checked appropriately
+- Existing narrative check performed
+- GDD loaded and analyzed (if available)
+- Narrative complexity assessed with user
+- Output document initialized with proper frontmatter
+- Frontmatter updated with stepsCompleted: [1]
+
+### SYSTEM FAILURE:
+
+- Starting without complexity assessment
+- Not checking for existing narrative
+- Proceeding without user confirmation
+- Missing frontmatter initialization
+
+**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-01b-continue.md

@@ -0,0 +1,163 @@
+---
+name: 'step-01b-continue'
+description: 'Continue an existing narrative workflow from where it left off'
+
+# Path Definitions
+workflow_path: '{project-root}/_bmad/bmgd/workflows/2-design/narrative'
+
+# File References
+thisStepFile: '{workflow_path}/steps/step-01b-continue.md'
+workflowFile: '{workflow_path}/workflow.md'
+outputFile: '{output_folder}/narrative-design.md'
+
+# Step Files (for routing)
+step02: '{workflow_path}/steps/step-02-foundation.md'
+step03: '{workflow_path}/steps/step-03-story.md'
+step04: '{workflow_path}/steps/step-04-characters.md'
+step05: '{workflow_path}/steps/step-05-world.md'
+step06: '{workflow_path}/steps/step-06-dialogue.md'
+step07: '{workflow_path}/steps/step-07-environmental.md'
+step08: '{workflow_path}/steps/step-08-delivery.md'
+step09: '{workflow_path}/steps/step-09-integration.md'
+step10: '{workflow_path}/steps/step-10-production.md'
+step11: '{workflow_path}/steps/step-11-complete.md'
+---
+
+# Step 1b: Continue Existing Narrative
+
+**Resuming Narrative Workflow**
+
+## STEP GOAL:
+
+Load the existing narrative document, determine progress, and route to the appropriate next step.
+
+## 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
+
+### Step-Specific Rules:
+
+- Parse frontmatter to determine completed steps
+- Present summary of current progress
+- Route to correct next step based on state
+
+## Sequence of Instructions (Do not deviate, skip, or optimize)
+
+### 1. Load Existing Narrative
+
+**Read the existing narrative document:**
+
+Load `{outputFile}` and parse the frontmatter to extract:
+
+- `stepsCompleted` array
+- `status`
+- `project` name
+- `narrativeComplexity`
+- GDD reference
+
+### 2. Analyze Progress
+
+**Determine workflow state:**
+
+Map completed steps to workflow progress:
+
+- Step 1: Initialize
+- Step 2: Foundation (premise, themes, structure)
+- Step 3: Story (beats and pacing)
+- Step 4: Characters (all characters and arcs)
+- Step 5: World (world, history, locations)
+- Step 6: Dialogue (dialogue systems)
+- Step 7: Environmental (environmental storytelling)
+- Step 8: Delivery (narrative delivery methods)
+- Step 9: Integration (gameplay integration)
+- Step 10: Production (scope and planning)
+- Step 11: Complete
+
+**Calculate next step:**
+
+Find the highest completed step and determine the next step file to load.
+
+### 3. Present Continuation Summary
+
+"**Resuming Narrative Workflow**
+
+{{user_name}}, I found your existing narrative for **{{game_name}}**.
+
+**Progress:** Steps completed: {{stepsCompleted}}
+
+**Narrative Complexity:** {{narrativeComplexity}}
+
+**Sections Completed:**
+{{list_of_completed_sections}}
+
+**Current Status:**
+
+- Last completed: {{last_step_name}}
+- Next step: {{next_step_name}} (Step {{next_step_number}} of 11)
+
+Would you like to:
+
+1. **Continue** - Resume from {{next_step_name}}
+2. **Review** - Show me what we've written so far
+3. **Restart Step** - Redo the last completed step
+
+Select an option:"
+
+### 4. Handle User Selection
+
+**If Continue:**
+
+- Load the next step file based on `stepsCompleted`
+
+**If Review:**
+
+- Present summary of all completed sections
+- Show key narrative elements (premise, characters, etc.)
+- Return to continuation options
+
+**If Restart Step:**
+
+- Decrement stepsCompleted to remove last step
+- Load the step file for the step being restarted
+
+### 5. Route to Next Step
+
+Based on next step number, load the appropriate step file:
+
+| Next Step | File     |
+| --------- | -------- |
+| 2         | {step02} |
+| 3         | {step03} |
+| 4         | {step04} |
+| 5         | {step05} |
+| 6         | {step06} |
+| 7         | {step07} |
+| 8         | {step08} |
+| 9         | {step09} |
+| 10        | {step10} |
+| 11        | {step11} |
+
+---
+
+## SYSTEM SUCCESS/FAILURE METRICS
+
+### SUCCESS:
+
+- Existing document loaded and parsed
+- Progress accurately determined
+- User presented with clear options
+- Correct step file loaded based on state
+
+### SYSTEM FAILURE:
+
+- Failing to parse frontmatter correctly
+- Loading wrong step file
+- Not presenting continuation options
+- Overwriting existing progress without confirmation
+
+**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-02-foundation.md

@@ -0,0 +1,262 @@
+---
+name: 'step-02-foundation'
+description: 'Define narrative premise, themes, tone, and story structure'
+
+# Path Definitions
+workflow_path: '{project-root}/_bmad/bmgd/workflows/2-design/narrative'
+
+# File References
+thisStepFile: '{workflow_path}/steps/step-02-foundation.md'
+nextStepFile: '{workflow_path}/steps/step-03-story.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 2: Story Foundation
+
+**Progress: Step 2 of 11** - Next: Story Beats
+
+## STEP GOAL:
+
+Define the narrative foundation: premise, themes, tone/atmosphere, and overall story structure. These elements form the backbone of all narrative content.
+
+## 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
+- Help users articulate THEIR story vision
+- The premise should come from the user
+
+### Step-Specific Rules:
+
+- FORBIDDEN to generate premise without user input
+- Draw out user's ideas through questions
+- Themes should resonate with user's intent
+
+## 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]` before loading next step
+
+## COLLABORATION MENUS (A/P/C):
+
+- **A (Advanced Elicitation)**: Explore themes deeper
+- **P (Party Mode)**: Get perspectives on foundation
+- **C (Continue)**: Save the content and proceed
+
+## Sequence of Instructions (Do not deviate, skip, or optimize)
+
+### 1. Narrative Premise Discovery
+
+"Let's define the narrative foundation for **{{game_name}}**.
+
+**First, the premise - your story's elevator pitch in 2-3 sentences.**
+
+Good premises have:
+
+- A protagonist with a clear goal
+- An obstacle or conflict
+- Stakes (what happens if they fail?)
+
+**Examples:**
+
+- \"A young knight discovers they're the last hope to stop an ancient evil, but must choose between saving the kingdom or their own family.\"
+- \"After a mysterious pandemic, survivors must navigate a world where telling the truth is deadly but lying corrupts your soul.\"
+
+What's the premise for {{game_name}}?"
+
+### 2. Theme Discovery
+
+"**Now let's identify your core themes.**
+
+Themes are the underlying ideas or messages woven throughout the story.
+
+**Common game themes:**
+
+- Redemption, sacrifice, identity
+- Power and corruption
+- Hope vs. despair
+- Nature vs. technology
+- Freedom vs. control
+- Family, loyalty, betrayal
+
+**Questions to consider:**
+
+- What questions does your story ask?
+- What will players think about after playing?
+- What emotions do you want to evoke?
+
+What are 2-4 core themes for {{game_name}}?"
+
+### 3. Tone and Atmosphere Discovery
+
+"**Let's define the tone and atmosphere.**
+
+Tone shapes how the story feels moment-to-moment.
+
+**Tone spectrums:**
+
+- Dark ←→ Lighthearted
+- Serious ←→ Comedic
+- Gritty ←→ Fantastical
+- Intimate ←→ Epic
+- Hopeful ←→ Melancholic
+
+**Atmosphere elements:**
+
+- Visual mood (colors, lighting)
+- Audio mood (music style)
+- Pacing (contemplative vs. urgent)
+- Emotional register
+
+Describe the tone and atmosphere for {{game_name}}:"
+
+### 4. Story Structure Discovery
+
+"**What story structure will you use?**
+
+**Common structures:**
+
+| Structure          | Description                                            |
+| ------------------ | ------------------------------------------------------ |
+| **3-Act**          | Setup → Confrontation → Resolution                     |
+| **Hero's Journey** | Campbell's monomyth (departure, initiation, return)    |
+| **Kishōtenketsu**  | 4-act: Introduction → Development → Twist → Conclusion |
+| **Episodic**       | Self-contained episodes with overarching arc           |
+| **Branching**      | Multiple paths and endings                             |
+| **Freeform**       | Player-driven, emergent narrative                      |
+
+What structure fits {{game_name}}?"
+
+### 5. Act Breakdown
+
+"**Let's break down your story into acts/sections.**
+
+Based on {{selected_structure}}:
+
+{{structure_specific_prompts}}
+
+Describe each act/section for {{game_name}}:"
+
+### 6. Generate Foundation Content
+
+Based on the conversation, prepare the content:
+
+```markdown
+## Story Foundation
+
+### Narrative Premise
+
+{{user_premise}}
+
+### Core Themes
+
+{{themes_list_with_descriptions}}
+
+### Tone and Atmosphere
+
+**Tone:** {{tone_description}}
+
+**Atmosphere:** {{atmosphere_description}}
+
+**Emotional Register:** {{emotional_goals}}
+
+---
+
+## Story Structure
+
+### Structure Type
+
+**{{structure_type}}**
+
+{{structure_description}}
+
+### Act Breakdown
+
+{{act_breakdown_details}}
+```
+
+### 7. Present Content and Menu
+
+Show the generated content to the user and present:
+
+"I've drafted the Story Foundation based on our conversation.
+
+**Here's what I'll add to the document:**
+
+[Show the complete markdown content from step 6]
+
+**Validation Check:**
+
+- Does the premise capture your vision?
+- Do the themes resonate with your intent?
+- Does the structure fit your gameplay?
+
+**Select an Option:**
+[A] Advanced Elicitation - Explore themes and structure deeper
+[P] Party Mode - Get perspectives on foundation
+[C] Continue - Save this and move to Story Beats (Step 3 of 11)"
+
+### 8. 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]`
+- Load `{nextStepFile}`
+
+## CRITICAL STEP COMPLETION NOTE
+
+ONLY WHEN [C continue option] is selected and [foundation content saved with frontmatter updated], will you then load and read fully `{nextStepFile}`.
+
+---
+
+## SYSTEM SUCCESS/FAILURE METRICS
+
+### SUCCESS:
+
+- Premise captured from user input
+- Themes identified and described
+- Tone and atmosphere defined
+- Story structure selected and broken down
+- A/P/C menu presented and handled correctly
+- Frontmatter updated with stepsCompleted: [1, 2]
+
+### SYSTEM FAILURE:
+
+- Generating premise FOR user
+- Generic themes not connected to user's vision
+- Proceeding without structure breakdown
+- 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.