bmad-method 4.39.0 → 4.39.2

package/dist/expansion-packs/bmad-creative-writing/agents/plot-architect.txt

@@ -103,6 +103,7 @@ dependencies:
 You are the Plot Architect, a master of narrative structure. Your expertise spans classical three-act structure, Save the Cat methodology, the Hero's Journey, and modern narrative innovations. You understand that great stories balance formula with originality.
 
 Think in terms of:
+
 - **Inciting incidents** that disrupt equilibrium
 - **Rising action** that escalates stakes
 - **Midpoint reversals** that shift dynamics
@@ -223,13 +224,15 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
 # Analyze Story Structure
 
 ## Purpose
+
 Perform comprehensive structural analysis of a narrative work to identify strengths, weaknesses, and improvement opportunities.
 
 ## Process
 
 ### 1. Identify Structure Type
+
 - Three-act structure
-- Five-act structure  
+- Five-act structure
 - Hero's Journey
 - Save the Cat beats
 - Freytag's Pyramid
@@ -238,6 +241,7 @@ Perform comprehensive structural analysis of a narrative work to identify streng
 - Non-linear/experimental
 
 ### 2. Map Key Points
+
 - **Opening**: Hook, world establishment, character introduction
 - **Inciting Incident**: What disrupts the status quo?
 - **Plot Point 1**: What locks in the conflict?
@@ -245,7 +249,9 @@ Perform comprehensive structural analysis of a narrative work to identify streng
 - **Plot Point 2**: What raises stakes to maximum?
 - **Climax**: How does central conflict resolve?
 - **Resolution**: What new equilibrium emerges?
+
 ### 3. Analyze Pacing
+
 - Scene length distribution
 - Tension escalation curve
 - Breather moment placement
@@ -253,6 +259,7 @@ Perform comprehensive structural analysis of a narrative work to identify streng
 - Chapter break effectiveness
 
 ### 4. Evaluate Setup/Payoff
+
 - Track all setups (promises to reader)
 - Verify each has satisfying payoff
 - Identify orphaned setups
@@ -260,13 +267,16 @@ Perform comprehensive structural analysis of a narrative work to identify streng
 - Check Chekhov's guns
 
 ### 5. Assess Subplot Integration
+
 - List all subplots
 - Track intersection with main plot
 - Evaluate resolution satisfaction
 - Check thematic reinforcement
 
 ### 6. Generate Report
+
 Create structural report including:
+
 - Structure diagram
 - Pacing chart
 - Problem areas
@@ -274,6 +284,7 @@ Create structural report including:
 - Alternative structures
 
 ## Output
+
 Comprehensive structural analysis with actionable recommendations
 ==================== END: .bmad-creative-writing/tasks/analyze-story-structure.md ====================
 
@@ -289,7 +300,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
 ## Instructions
 
 1. **Initial Assessment**
-
    - If user or the task being run provides a checklist name:
      - Try fuzzy matching (e.g. "plot checklist" -> "plot-structure-checklist")
      - If multiple matches found, ask user to clarify
@@ -302,14 +312,12 @@ If the user asks or does not specify a specific checklist, list the checklists a
      - All at once (YOLO mode - recommended for checklists, there will be a summary of sections at the end to discuss)
 
 2. **Document and Artifact Gathering**
-
    - Each checklist will specify its required documents/artifacts at the beginning
    - Follow the checklist's specific instructions for what to gather, generally a file can be resolved in the docs folder, if not or unsure, halt and ask or confirm with the user.
 
 3. **Checklist Processing**
 
    If in interactive mode:
-
    - Work through each section of the checklist one at a time
    - For each section:
      - Review all items in the section following instructions for that section embedded in the checklist
@@ -318,7 +326,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
      - Get user confirmation before proceeding to next section or if any thing major do we need to halt and take corrective action
 
    If in YOLO mode:
-
    - Process all sections at once
    - Create a comprehensive report of all findings
    - Present the complete analysis to the user
@@ -326,7 +333,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
 4. **Validation Approach**
 
    For each checklist item:
-
    - Read and understand the requirement
    - Look for evidence in the documentation that satisfies the requirement
    - Consider both explicit mentions and implicit coverage
@@ -340,7 +346,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
 5. **Section Analysis**
 
    For each section:
-
    - think step by step to calculate pass rate
    - Identify common themes in failed items
    - Provide specific recommendations for improvement
@@ -350,7 +355,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
 6. **Final Report**
 
    Prepare a summary that includes:
-
    - Overall checklist completion status
    - Pass rates by section
    - List of failed items with context
@@ -816,6 +820,7 @@ sections:
 # Plot Structure Checklist
 
 ## Opening
+
 - [ ] Hook engages within first page
 - [ ] Genre/tone established early
 - [ ] World rules clear
@@ -823,6 +828,7 @@ sections:
 - [ ] Status quo established before disruption
 
 ## Structure Fundamentals
+
 - [ ] Inciting incident by 10-15% mark
 - [ ] Clear story question posed
 - [ ] Stakes established and clear
@@ -830,19 +836,23 @@ sections:
 - [ ] B-story provides thematic counterpoint
 
 ## Rising Action
+
 - [ ] Complications escalate logically
 - [ ] Try-fail cycles build tension
 - [ ] Subplots weave with main plot
 - [ ] False victories/defeats included
 - [ ] Character growth parallels plot
+
 ## Midpoint
+
 - [ ] Major reversal or revelation
-- [ ] Stakes raised significantly  
+- [ ] Stakes raised significantly
 - [ ] Protagonist approach shifts
 - [ ] Time pressure introduced/increased
 - [ ] Point of no return crossed
 
 ## Crisis Building
+
 - [ ] Bad guys close in (internal/external)
 - [ ] Protagonist plans fail
 - [ ] Allies fall away/betray
@@ -850,6 +860,7 @@ sections:
 - [ ] Dark night of soul (character lowest)
 
 ## Climax
+
 - [ ] Protagonist must act (no rescue)
 - [ ] Uses lessons learned
 - [ ] Internal/external conflicts merge
@@ -857,6 +868,7 @@ sections:
 - [ ] Clear win/loss/transformation
 
 ## Resolution
+
 - [ ] New equilibrium established
 - [ ] Loose threads tied
 - [ ] Character growth demonstrated
@@ -868,11 +880,13 @@ sections:
 # Story Structure Patterns
 
 ## Three-Act Structure
+
 - **Act 1 (25%)**: Setup, inciting incident
 - **Act 2 (50%)**: Confrontation, complications
 - **Act 3 (25%)**: Resolution
 
 ## Save the Cat Beats
+
 1. Opening Image (0-1%)
 2. Setup (1-10%)
 3. Theme Stated (5%)
@@ -888,7 +902,9 @@ sections:
 13. Break into Three (80%)
 14. Finale (80-99%)
 15. Final Image (99-100%)
+
 ## Hero's Journey
+
 1. Ordinary World
 2. Call to Adventure
 3. Refusal of Call
@@ -903,6 +919,7 @@ sections:
 12. Return with Elixir
 
 ## Seven-Point Structure
+
 1. Hook
 2. Plot Turn 1
 3. Pinch Point 1
@@ -912,6 +929,7 @@ sections:
 7. Resolution
 
 ## Freytag's Pyramid
+
 1. Exposition
 2. Rising Action
 3. Climax
@@ -919,6 +937,7 @@ sections:
 5. Denouement
 
 ## Kishōtenketsu (Japanese)
+
 - **Ki**: Introduction
 - **Shō**: Development
 - **Ten**: Twist
@@ -1031,24 +1050,28 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating
 ## Templates & Tools
 
 ### Character Development
+
 - Comprehensive character profiles
 - Backstory builders
 - Voice and dialogue patterns
 - Relationship mapping
 
 ### Story Structure
+
 - Three-act outlines
 - Save the Cat beat sheets
 - Hero's Journey mapping
 - Scene-by-scene breakdowns
 
 ### World Building
+
 - Setting documentation
 - Magic/technology systems
 - Cultural development
 - Timeline tracking
 
 ### Publishing Support
+
 - KDP formatting guidelines
 - Cover design briefs
 - Marketing copy templates
@@ -1057,6 +1080,7 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating
 ## Genre Support
 
 ### Built-in Genre Checklists
+
 - Fantasy & Sci-Fi
 - Romance & Thriller
 - Mystery & Horror
@@ -1064,6 +1088,7 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating
 - Young Adult
 
 Each genre includes:
+
 - Trope management
 - Reader expectations
 - Market positioning
@@ -1072,24 +1097,28 @@ Each genre includes:
 ## Best Practices
 
 ### Character Development
+
 1. Start with internal conflict
 2. Build from wound/lie/want/need
 3. Create unique voice patterns
 4. Track arc progression
 
 ### Plot Construction
+
 1. Begin with clear story question
 2. Escalate stakes progressively
 3. Plant setup/payoff pairs
 4. Balance pacing with character moments
 
 ### World Building
+
 1. Maintain internal consistency
 2. Show through character experience
 3. Build only what serves story
 4. Track all established rules
 
 ### Revision Process
+
 1. Complete draft before major edits
 2. Address structure before prose
 3. Read dialogue aloud

package/dist/expansion-packs/bmad-creative-writing/agents/world-builder.txt

@@ -102,6 +102,7 @@ dependencies:
 You are the World Builder, creator of immersive universes. You understand that great settings are characters in their own right, influencing every aspect of the story.
 
 Consider:
+
 - **Geography shapes culture** shapes character
 - **History creates conflicts** that drive plot
 - **Rules and limitations** create dramatic tension
@@ -220,22 +221,27 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
 
 ==================== START: .bmad-creative-writing/tasks/build-world.md ====================
 # ------------------------------------------------------------
+
 # 2. Build World
+
 # ------------------------------------------------------------
+
 ---
+
 task:
-  id: build-world
-  name: Build World
-  description: Create a concise world guide covering geography, cultures, magic/tech, and history.
-  persona_default: world-builder
+id: build-world
+name: Build World
+description: Create a concise world guide covering geography, cultures, magic/tech, and history.
+persona_default: world-builder
 inputs:
-  - concept-brief.md
-steps:
-  - Summarize key themes from concept.
-  - Draft World Guide using world-guide-tmpl.
-  - Execute tasks#advanced-elicitation.
-output: world-guide.md
-...
+
+- concept-brief.md
+  steps:
+- Summarize key themes from concept.
+- Draft World Guide using world-guide-tmpl.
+- Execute tasks#advanced-elicitation.
+  output: world-guide.md
+  ...
 ==================== END: .bmad-creative-writing/tasks/build-world.md ====================
 
 ==================== START: .bmad-creative-writing/tasks/execute-checklist.md ====================
@@ -250,7 +256,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
 ## Instructions
 
 1. **Initial Assessment**
-
    - If user or the task being run provides a checklist name:
      - Try fuzzy matching (e.g. "plot checklist" -> "plot-structure-checklist")
      - If multiple matches found, ask user to clarify
@@ -263,14 +268,12 @@ If the user asks or does not specify a specific checklist, list the checklists a
      - All at once (YOLO mode - recommended for checklists, there will be a summary of sections at the end to discuss)
 
 2. **Document and Artifact Gathering**
-
    - Each checklist will specify its required documents/artifacts at the beginning
    - Follow the checklist's specific instructions for what to gather, generally a file can be resolved in the docs folder, if not or unsure, halt and ask or confirm with the user.
 
 3. **Checklist Processing**
 
    If in interactive mode:
-
    - Work through each section of the checklist one at a time
    - For each section:
      - Review all items in the section following instructions for that section embedded in the checklist
@@ -279,7 +282,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
      - Get user confirmation before proceeding to next section or if any thing major do we need to halt and take corrective action
 
    If in YOLO mode:
-
    - Process all sections at once
    - Create a comprehensive report of all findings
    - Present the complete analysis to the user
@@ -287,7 +289,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
 4. **Validation Approach**
 
    For each checklist item:
-
    - Read and understand the requirement
    - Look for evidence in the documentation that satisfies the requirement
    - Consider both explicit mentions and implicit coverage
@@ -301,7 +302,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
 5. **Section Analysis**
 
    For each section:
-
    - think step by step to calculate pass rate
    - Identify common themes in failed items
    - Provide specific recommendations for improvement
@@ -311,7 +311,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
 6. **Final Report**
 
    Prepare a summary that includes:
-
    - Overall checklist completion status
    - Pass rates by section
    - List of failed items with context
@@ -547,59 +546,74 @@ sections:
 
 ==================== START: .bmad-creative-writing/checklists/world-building-continuity-checklist.md ====================
 # ------------------------------------------------------------
+
 # 2. World‑Building Continuity Checklist
+
 # ------------------------------------------------------------
+
 ---
+
 checklist:
-  id: world-building-continuity-checklist
-  name: World‑Building Continuity Checklist
-  description: Ensure geography, cultures, tech/magic rules, and timeline stay coherent.
+id: world-building-continuity-checklist
+name: World‑Building Continuity Checklist
+description: Ensure geography, cultures, tech/magic rules, and timeline stay coherent.
 items:
-  - "[ ] Map geography referenced consistently"
-  - "[ ] Cultural customs/laws remain uniform"
-  - "[ ] Magic/tech limitations not violated"
-  - "[ ] Historical dates/events match world‑guide"
-  - "[ ] Economics/politics align scene to scene"
-  - "[ ] Travel times/distances are plausible"
-...
+
+- "[ ] Map geography referenced consistently"
+- "[ ] Cultural customs/laws remain uniform"
+- "[ ] Magic/tech limitations not violated"
+- "[ ] Historical dates/events match world‑guide"
+- "[ ] Economics/politics align scene to scene"
+- "[ ] Travel times/distances are plausible"
+  ...
 ==================== END: .bmad-creative-writing/checklists/world-building-continuity-checklist.md ====================
 
 ==================== START: .bmad-creative-writing/checklists/fantasy-magic-system-checklist.md ====================
 # ------------------------------------------------------------
+
 # 17. Fantasy Magic System Consistency Checklist
+
 # ------------------------------------------------------------
+
 ---
+
 checklist:
-  id: fantasy-magic-system-checklist
-  name: Fantasy Magic System Consistency Checklist
-  description: Keep magical rules, costs, and exceptions coherent.
+id: fantasy-magic-system-checklist
+name: Fantasy Magic System Consistency Checklist
+description: Keep magical rules, costs, and exceptions coherent.
 items:
-  - "[ ] Core source and rules defined"
-  - "[ ] Limitations create plot obstacles"
-  - "[ ] Costs or risks for using magic stated"
-  - "[ ] No last‑minute power with no foreshadowing"
-  - "[ ] Societal impact of magic reflected in setting"
-  - "[ ] Rule exceptions justified and rare"
-...
+
+- "[ ] Core source and rules defined"
+- "[ ] Limitations create plot obstacles"
+- "[ ] Costs or risks for using magic stated"
+- "[ ] No last‑minute power with no foreshadowing"
+- "[ ] Societal impact of magic reflected in setting"
+- "[ ] Rule exceptions justified and rare"
+  ...
 ==================== END: .bmad-creative-writing/checklists/fantasy-magic-system-checklist.md ====================
 
 ==================== START: .bmad-creative-writing/checklists/steampunk-gadget-checklist.md ====================
 # ------------------------------------------------------------
+
 # 25. Steampunk Gadget Plausibility Checklist
+
 # ------------------------------------------------------------
+
 ---
+
 checklist:
-  id: steampunk-gadget-checklist
-  name: Steampunk Gadget Plausibility Checklist
-  description: Verify brass‑and‑steam inventions obey pseudo‑Victorian tech logic.
+id: steampunk-gadget-checklist
+name: Steampunk Gadget Plausibility Checklist
+description: Verify brass‑and‑steam inventions obey pseudo‑Victorian tech logic.
 items:
-  - "[ ] Power source explained (steam, clockwork, pneumatics)"
-  - "[ ] Materials era‑appropriate (brass, wood, iron)"
-  - "[ ] Gear ratios or pressure levels plausible for function"
-  - "[ ] Airship lift calculated vs envelope size"
-  - "[ ] Aesthetic details (rivets, gauges) consistent"
-  - "[ ] No modern plastics/electronics unless justified"
-...
+
+- "[ ] Power source explained (steam, clockwork, pneumatics)"
+- "[ ] Materials era‑appropriate (brass, wood, iron)"
+- "[ ] Gear ratios or pressure levels plausible for function"
+- "[ ] Airship lift calculated vs envelope size"
+- "[ ] Aesthetic details (rivets, gauges) consistent"
+- "[ ] No modern plastics/electronics unless justified"
+  ...
 ==================== END: .bmad-creative-writing/checklists/steampunk-gadget-checklist.md ====================
 
 ==================== START: .bmad-creative-writing/data/bmad-kb.md ====================
@@ -708,24 +722,28 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating
 ## Templates & Tools
 
 ### Character Development
+
 - Comprehensive character profiles
 - Backstory builders
 - Voice and dialogue patterns
 - Relationship mapping
 
 ### Story Structure
+
 - Three-act outlines
 - Save the Cat beat sheets
 - Hero's Journey mapping
 - Scene-by-scene breakdowns
 
 ### World Building
+
 - Setting documentation
 - Magic/technology systems
 - Cultural development
 - Timeline tracking
 
 ### Publishing Support
+
 - KDP formatting guidelines
 - Cover design briefs
 - Marketing copy templates
@@ -734,6 +752,7 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating
 ## Genre Support
 
 ### Built-in Genre Checklists
+
 - Fantasy & Sci-Fi
 - Romance & Thriller
 - Mystery & Horror
@@ -741,6 +760,7 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating
 - Young Adult
 
 Each genre includes:
+
 - Trope management
 - Reader expectations
 - Market positioning
@@ -749,24 +769,28 @@ Each genre includes:
 ## Best Practices
 
 ### Character Development
+
 1. Start with internal conflict
 2. Build from wound/lie/want/need
 3. Create unique voice patterns
 4. Track arc progression
 
 ### Plot Construction
+
 1. Begin with clear story question
 2. Escalate stakes progressively
 3. Plant setup/payoff pairs
 4. Balance pacing with character moments
 
 ### World Building
+
 1. Maintain internal consistency
 2. Show through character experience
 3. Build only what serves story
 4. Track all established rules
 
 ### Revision Process
+
 1. Complete draft before major edits
 2. Address structure before prose
 3. Read dialogue aloud
@@ -806,11 +830,13 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c
 # Story Structure Patterns
 
 ## Three-Act Structure
+
 - **Act 1 (25%)**: Setup, inciting incident
 - **Act 2 (50%)**: Confrontation, complications
 - **Act 3 (25%)**: Resolution
 
 ## Save the Cat Beats
+
 1. Opening Image (0-1%)
 2. Setup (1-10%)
 3. Theme Stated (5%)
@@ -826,7 +852,9 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c
 13. Break into Three (80%)
 14. Finale (80-99%)
 15. Final Image (99-100%)
+
 ## Hero's Journey
+
 1. Ordinary World
 2. Call to Adventure
 3. Refusal of Call
@@ -841,6 +869,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c
 12. Return with Elixir
 
 ## Seven-Point Structure
+
 1. Hook
 2. Plot Turn 1
 3. Pinch Point 1
@@ -850,6 +879,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c
 7. Resolution
 
 ## Freytag's Pyramid
+
 1. Exposition
 2. Rising Action
 3. Climax
@@ -857,6 +887,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c
 5. Denouement
 
 ## Kishōtenketsu (Japanese)
+
 - **Ki**: Introduction
 - **Shō**: Development
 - **Ten**: Twist