bmad-method 6.0.0-alpha.0 → 6.0.0-alpha.10

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

@@ -0,0 +1,139 @@
+# Narrative Design Workflow Validation Checklist
+
+**Purpose**: Validate narrative design outputs are complete, cohesive, and ready for implementation.
+
+**Scope**: Story-driven games and applications (follows GDD workflow)
+
+**Expected Output**: narrative-design.md
+
+---
+
+## 1. Output File Exists
+
+- [ ] narrative-design.md created in output folder
+- [ ] GDD.md exists (narrative workflow requires GDD first)
+- [ ] No unfilled {{template_variables}}
+
+---
+
+## 2. Story Foundation
+
+### Core Elements
+
+- [ ] **Narrative premise** clearly stated (elevator pitch, 2-3 sentences)
+- [ ] **Core themes** identified (2-4 meaningful themes)
+- [ ] **Tone and atmosphere** established
+- [ ] Premise is compelling and fits game type
+
+### Story Structure
+
+- [ ] **Story structure chosen** (3-act, hero's journey, branching, etc.)
+- [ ] **Acts/sections broken down** with clear progression
+- [ ] **Major story beats** documented (key moments that drive narrative)
+- [ ] Structure fits narrative complexity level
+
+---
+
+## 3. Characters
+
+### Protagonist(s)
+
+- [ ] Background and motivation explained
+- [ ] Character arc defined (how they change)
+- [ ] Internal and external conflicts identified
+
+### Antagonist(s)
+
+- [ ] Motivation clear (why they oppose protagonist)
+- [ ] Goals and methods explained
+- [ ] Not one-dimensional
+
+### Supporting Cast
+
+- [ ] Major supporting characters documented
+- [ ] Each has distinct role in story
+- [ ] Character relationships mapped
+
+### Character Arcs
+
+- [ ] Major characters have starting → transformation → ending states
+- [ ] Arc progression makes sense
+
+---
+
+## 4. World and Lore
+
+- [ ] **World setting** defined (time, place, world type)
+- [ ] **World rules** explained (magic, technology, society)
+- [ ] **History and backstory** documented
+- [ ] Key locations described with narrative significance
+
+---
+
+## 5. Dialogue and Delivery
+
+### Dialogue Framework
+
+- [ ] Dialogue style established
+- [ ] Key conversations identified
+- [ ] Branching dialogue system described (if applicable)
+
+### Narrative Delivery
+
+- [ ] Cutscenes/cinematics approach defined
+- [ ] In-game storytelling methods explained
+- [ ] Optional vs. required content distinguished
+- [ ] Multiple endings documented (if applicable)
+
+---
+
+## 6. Gameplay Integration
+
+- [ ] **Narrative-gameplay harmony** addressed (how story and mechanics connect)
+- [ ] **Story gates** explained (how narrative controls progression)
+- [ ] **Player agency** level defined (can player affect story?)
+- [ ] Integration doesn't fight game design
+
+---
+
+## 7. Production Scope
+
+- [ ] **Writing scope** estimated (word count, scene count, dialogue lines)
+- [ ] Scope realistic for project level
+- [ ] Localization considerations noted (if applicable)
+- [ ] Voice acting plans documented (if applicable)
+
+---
+
+## 8. Consistency with GDD
+
+- [ ] Narrative aligns with GDD game design
+- [ ] Tone matches GDD art/audio direction
+- [ ] Story supports game mechanics (doesn't contradict)
+- [ ] No conflicts between narrative and gameplay
+
+---
+
+## 9. Critical Failures (Auto-Fail)
+
+- [ ] ❌ **No GDD** (narrative workflow requires GDD first)
+- [ ] ❌ **No character arcs** (protagonist has no development)
+- [ ] ❌ **No story beats** (major moments not identified)
+- [ ] ❌ **Contradicts GDD** (narrative fights game design)
+
+---
+
+## Validation Notes
+
+**Document any findings:**
+
+- Narrative strength: [Compelling / Interesting / Adequate / Weak]
+- Strengths:
+- Issues to address:
+- Recommended actions:
+
+**Ready for solutioning?** [Yes / No - explain]
+
+---
+
+_Adapt based on narrative complexity level (Critical/Heavy/Moderate/Light)._

package/src/modules/{bmm/workflows/2-plan → bmgd/workflows/2-design}/narrative/instructions-narrative.md

@@ -2,11 +2,51 @@
 
 <workflow>
 
-<critical>The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.md</critical>
+<critical>The workflow execution engine is governed by: {project_root}/{bmad_folder}/core/tasks/workflow.xml</critical>
 <critical>You MUST have already completed the GDD workflow</critical>
+<critical>Communicate all responses in {communication_language}</critical>
 <critical>This workflow creates detailed narrative content for story-driven games</critical>
 <critical>Uses narrative_template for output</critical>
 <critical>If users mention gameplay mechanics, note them but keep focus on narrative</critical>
+<critical>Facilitate good brainstorming techniques throughout with the user, pushing them to come up with much of the narrative you will help weave together. The goal is for the user to feel that they crafted the narrative and story arc unless they push you to do it all or indicate YOLO</critical>
+<critical>⚠️ CHECKPOINT PROTOCOL: After EVERY <template-output> tag, you MUST follow workflow.xml substep 2c: SAVE content to file immediately → SHOW checkpoint separator (━━━━━━━━━━━━━━━━━━━━━━━) → DISPLAY generated content → PRESENT options [a]Advanced Elicitation/[c]Continue/[p]Party-Mode/[y]YOLO → WAIT for user response. Never batch saves or skip checkpoints.</critical>
+
+<step n="0" goal="Check for workflow status" tag="workflow-status">
+<action>Check if {output_folder}/bmm-workflow-status.yaml exists</action>
+
+<check if="status file not found">
+  <output>No workflow status file found. Narrative workflow is optional - you can continue without status tracking.</output>
+  <action>Set standalone_mode = true</action>
+</check>
+
+<check if="status file found">
+  <action>Load the FULL file: {output_folder}/bmm-workflow-status.yaml</action>
+  <action>Parse workflow_status section</action>
+  <action>Check status of "narrative" workflow</action>
+  <action>Get project_level from YAML metadata</action>
+  <action>Find first non-completed workflow (next expected workflow)</action>
+
+  <check if="narrative status is file path (already completed)">
+    <output>⚠️ Narrative Design Document already completed: {{narrative status}}</output>
+    <ask>Re-running will overwrite the existing narrative document. Continue? (y/n)</ask>
+    <check if="n">
+      <output>Exiting. Use workflow-status to see your next step.</output>
+      <action>Exit workflow</action>
+    </check>
+  </check>
+
+  <check if="narrative is not the next expected workflow (latter items are completed already in the list)">
+    <output>⚠️ Next expected workflow: {{next_workflow}}. Narrative is out of sequence.</output>
+    <ask>Continue with Narrative Design anyway? (y/n)</ask>
+    <check if="n">
+      <output>Exiting. Run {{next_workflow}} instead.</output>
+      <action>Exit workflow</action>
+    </check>
+  </check>
+
+<action>Set standalone_mode = false</action>
+</check>
+</step>
 
 <step n="1" goal="Load GDD context and assess narrative complexity">
 
@@ -26,7 +66,7 @@ Your game type ({{game_type}}) suggests **{{suggested_complexity}}**. Confirm or
 
 <action>Set narrative_complexity</action>
 
-<check>If complexity == "Light":</check>
+<check if="complexity == Light">
 <ask>Light narrative games usually don't need a full Narrative Design Document. Are you sure you want to continue?
 
 - GDD story sections may be sufficient
@@ -37,6 +77,8 @@ Your choice:</ask>
 
 <action>Load narrative_template from workflow.yaml</action>
 
+</check>
+
 </step>
 
 <step n="2" goal="Define narrative premise and themes">
@@ -102,7 +144,6 @@ For 3-Act:
 Describe each act/section for your game:</ask>
 
 <template-output>act_breakdown</template-output>
-<elicit-required/>
 
 </step>
 
@@ -121,7 +162,6 @@ Format:
 Your story beats:</ask>
 
 <template-output>story_beats</template-output>
-<elicit-required/>
 
 <ask>Describe the pacing and flow of your narrative.
 
@@ -154,7 +194,6 @@ For each protagonist include:
 Your protagonist(s):</ask>
 
 <template-output>protagonists</template-output>
-<elicit-required/>
 
 </step>
 
@@ -192,7 +231,6 @@ For each character include:
 Your supporting characters:</ask>
 
 <template-output>supporting_characters</template-output>
-<elicit-required/>
 
 </step>
 
@@ -240,7 +278,6 @@ Your world:</ask>
 Your history:</ask>
 
 <template-output>history_backstory</template-output>
-<elicit-required/>
 
 </step>
 
@@ -304,8 +341,8 @@ Your key conversations:</ask>
 
 <template-output>key_conversations</template-output>
 
-<check>If game has branching dialogue:</check>
-<ask>Describe your branching dialogue system.
+<check if="game has branching dialogue">
+  <ask>Describe your branching dialogue system.
 
 - How many branches/paths?
 - What determines branches? (stats, choices, flags)
@@ -315,6 +352,7 @@ Your key conversations:</ask>
 Your branching system:</ask>
 
 <template-output>branching_dialogue</template-output>
+</check>
 
 </step>
 
@@ -397,8 +435,8 @@ Your optional content:</ask>
 
 <template-output>optional_content</template-output>
 
-<check>If multiple endings:</check>
-<ask>Describe your ending structure.
+<check if="multiple endings">
+  <ask>Describe your ending structure.
 
 - How many endings?
 - What determines ending? (choices, stats, completion)
@@ -408,6 +446,7 @@ Your optional content:</ask>
 Your endings:</ask>
 
 <template-output>multiple_endings</template-output>
+</check>
 
 </step>
 
@@ -503,7 +542,9 @@ Your references:</ask>
 
 <template-output>references</template-output>
 
-<ask>Narrative Design complete! Next steps:
+<ask>**✅ Narrative Design Complete, {user_name}!**
+
+Next steps:
 
 1. Proceed to solutioning (technical architecture)
 2. Create detailed script/screenplay (outside workflow)
@@ -514,4 +555,50 @@ Which would you like?</ask>
 
 </step>
 
+<step n="17" goal="Update status if tracking enabled" tag="workflow-status">
+
+<check if="standalone_mode != true">
+  <action>Load the FULL file: {output_folder}/bmm-workflow-status.yaml</action>
+  <action>Find workflow_status key "narrative"</action>
+  <critical>ONLY write the file path as the status value - no other text, notes, or metadata</critical>
+  <action>Update workflow_status["narrative"] = "{output_folder}/bmm-narrative-{{game_name}}-{{date}}.md"</action>
+  <action>Save file, preserving ALL comments and structure including STATUS DEFINITIONS</action>
+
+<action>Find first non-completed workflow in workflow_status (next workflow to do)</action>
+<action>Determine next agent from path file based on next workflow</action>
+</check>
+
+<output>**✅ Narrative Design Complete, {user_name}!**
+
+**Narrative Document:**
+
+- Narrative design saved to {output_folder}/bmm-narrative-{{game_name}}-{{date}}.md
+
+{{#if standalone_mode != true}}
+**Status Updated:**
+
+- Progress tracking updated: narrative marked complete
+- Next workflow: {{next_workflow}}
+  {{else}}
+  **Note:** Running in standalone mode (no progress tracking)
+  {{/if}}
+
+**Next Steps:**
+
+{{#if standalone_mode != true}}
+
+- **Next workflow:** {{next_workflow}} ({{next_agent}} agent)
+- **Optional:** Review narrative with writing team or stakeholders
+
+Check status anytime with: `workflow-status`
+{{else}}
+Since no workflow is in progress:
+
+- Review narrative design with team
+- Refer to the BMM workflow guide if unsure what to do next
+- Or run `workflow-init` to create a workflow path and get guided next steps
+  {{/if}}
+  </output>
+  </step>
+
 </workflow>

package/src/modules/{bmm/workflows/2-plan → bmgd/workflows/2-design}/narrative/narrative-template.md

@@ -16,7 +16,7 @@
 
 {{core_themes}}
 
-### Tone & Atmosphere
+### Tone and Atmosphere
 
 {{tone_atmosphere}}
 
@@ -38,7 +38,7 @@
 
 {{story_beats}}
 
-### Pacing & Flow
+### Pacing and Flow
 
 {{pacing_flow}}
 
@@ -64,17 +64,17 @@
 
 ---
 
-## World & Lore
+## World and Lore
 
 ### World Overview
 
 {{world_overview}}
 
-### History & Backstory
+### History and Backstory
 
 {{history_backstory}}
 
-### Factions & Organizations
+### Factions and Organizations
 
 {{factions_organizations}}
 
@@ -102,7 +102,7 @@
 
 {{branching_dialogue}}
 
-### Voice & Characterization
+### Voice and Characterization
 
 {{voice_characterization}}
 
@@ -130,7 +130,7 @@
 
 ## Narrative Delivery
 
-### Cutscenes & Cinematics
+### Cutscenes and Cinematics
 
 {{cutscenes}}
 
@@ -190,6 +190,6 @@
 
 {{timeline}}
 
-### References & Inspirations
+### References and Inspirations
 
 {{references}}

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

@@ -0,0 +1,32 @@
+# Narrative Design Workflow
+name: narrative
+description: "Narrative design workflow for story-driven games and applications. Creates comprehensive narrative documentation including story structure, character arcs, dialogue systems, and narrative implementation guidance."
+author: "BMad"
+
+# Critical variables from config
+config_source: "{project-root}/{bmad_folder}/bmgd/config.yaml"
+output_folder: "{config_source}:output_folder"
+user_name: "{config_source}:user_name"
+communication_language: "{config_source}:communication_language"
+document_output_language: "{config_source}:document_output_language"
+game_dev_experience: "{config_source}:game_dev_experience"
+date: system-generated
+
+# Workflow components
+installed_path: "{project-root}/{bmad_folder}/bmgd/workflows/2-design/narrative"
+instructions: "{installed_path}/instructions-narrative.md"
+template: "{installed_path}/narrative-template.md"
+
+# Output configuration
+default_output_file: "{output_folder}/narrative-design.md"
+
+standalone: true
+
+web_bundle:
+  name: "narrative"
+  description: "Narrative design workflow for story-driven games and applications. Creates comprehensive narrative documentation including story structure, character arcs, dialogue systems, and narrative implementation guidance."
+  author: "BMad"
+  instructions: "{bmad_folder}/bmgd/workflows/2-design/narrative/instructions-narrative.md"
+  web_bundle_files:
+    - "{bmad_folder}/bmgd/workflows/2-design/narrative/instructions-narrative.md"
+    - "{bmad_folder}/bmgd/workflows/2-design/narrative/narrative-template.md"