bmad-method 4.39.1 → 4.40.0

package/dist/expansion-packs/bmad-creative-writing/agents/genre-specialist.txt

@@ -103,8 +103,9 @@ dependencies:
 You are the Genre Specialist, guardian of reader satisfaction and genre innovation. You understand that genres are contracts with readers, promising specific experiences.
 
 Navigate:
+
 - **Core requirements** that define the genre
-- **Optional conventions** that enhance familiarity  
+- **Optional conventions** that enhance familiarity
 - **Trope subversion** opportunities
 - **Cross-genre elements** that add freshness
 - **Market positioning** for maximum appeal
@@ -116,6 +117,8 @@ Remember to present all options as numbered lists for easy selection.
 ==================== END: .bmad-creative-writing/agents/genre-specialist.md ====================
 
 ==================== START: .bmad-creative-writing/tasks/create-doc.md ====================
+<!-- Powered by BMAD™ Core -->
+
 # Create Document from Template (YAML Driven)
 
 ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -220,16 +223,20 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
 ==================== END: .bmad-creative-writing/tasks/create-doc.md ====================
 
 ==================== START: .bmad-creative-writing/tasks/analyze-story-structure.md ====================
+<!-- Powered by BMAD™ Core -->
+
 # 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 +245,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 +253,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 +263,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 +271,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,10 +288,13 @@ Create structural report including:
 - Alternative structures
 
 ## Output
+
 Comprehensive structural analysis with actionable recommendations
 ==================== END: .bmad-creative-writing/tasks/analyze-story-structure.md ====================
 
 ==================== START: .bmad-creative-writing/tasks/execute-checklist.md ====================
+<!-- Powered by BMAD™ Core -->
+
 # Checklist Validation Task
 
 This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
@@ -289,7 +306,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 +318,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 +332,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 +339,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 +352,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 +361,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
@@ -374,6 +384,8 @@ The LLM will:
 ==================== END: .bmad-creative-writing/tasks/execute-checklist.md ====================
 
 ==================== START: .bmad-creative-writing/tasks/advanced-elicitation.md ====================
+<!-- Powered by BMAD™ Core -->
+
 # Advanced Elicitation Task
 
 ## Purpose
@@ -494,6 +506,7 @@ Choose a number (0-8) or 9 to proceed:
 ==================== END: .bmad-creative-writing/tasks/advanced-elicitation.md ====================
 
 ==================== START: .bmad-creative-writing/templates/story-outline-tmpl.yaml ====================
+# <!-- Powered by BMAD™ Core -->
 ---
 template:
   id: story-outline
@@ -592,80 +605,110 @@ sections:
 ==================== END: .bmad-creative-writing/templates/story-outline-tmpl.yaml ====================
 
 ==================== START: .bmad-creative-writing/checklists/genre-tropes-checklist.md ====================
+<!-- Powered by BMAD™ Core -->
+
 # ------------------------------------------------------------
+
 # 10. Genre Tropes Checklist (General)
+
 # ------------------------------------------------------------
+
 ---
+
 checklist:
-  id: genre-tropes-checklist
-  name: Genre Tropes Checklist
-  description: Confirm expected reader promises for chosen genre are addressed or subverted intentionally.
+id: genre-tropes-checklist
+name: Genre Tropes Checklist
+description: Confirm expected reader promises for chosen genre are addressed or subverted intentionally.
 items:
-  - "[ ] Core genre conventions present (e.g., mystery has a solvable puzzle)"
-  - "[ ] Audience‑favored tropes used or consciously averted"
-  - "[ ] Genre pacing beats hit (e.g., romance meet‑cute by 15%)"
-  - "[ ] Satisfying genre‑appropriate climax"
-  - "[ ] Reader expectations subversions sign‑posted to avoid disappointment"
-...
+
+- "[ ] Core genre conventions present (e.g., mystery has a solvable puzzle)"
+- "[ ] Audience‑favored tropes used or consciously averted"
+- "[ ] Genre pacing beats hit (e.g., romance meet‑cute by 15%)"
+- "[ ] Satisfying genre‑appropriate climax"
+- "[ ] Reader expectations subversions sign‑posted to avoid disappointment"
+  ...
 ==================== END: .bmad-creative-writing/checklists/genre-tropes-checklist.md ====================
 
 ==================== START: .bmad-creative-writing/checklists/fantasy-magic-system-checklist.md ====================
+<!-- Powered by BMAD™ Core -->
+
 # ------------------------------------------------------------
+
 # 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/scifi-technology-plausibility-checklist.md ====================
+<!-- Powered by BMAD™ Core -->
+
 # ------------------------------------------------------------
+
 # 15. Sci‑Fi Technology Plausibility Checklist
+
 # ------------------------------------------------------------
+
 ---
+
 checklist:
-  id: scifi-technology-plausibility-checklist
-  name: Sci‑Fi Technology Plausibility Checklist
-  description: Ensure advanced technologies feel believable and internally consistent.
+id: scifi-technology-plausibility-checklist
+name: Sci‑Fi Technology Plausibility Checklist
+description: Ensure advanced technologies feel believable and internally consistent.
 items:
-  - "[ ] Technology built on clear scientific principles or hand‑waved consistently"
-  - "[ ] Limits and costs of tech established"
-  - "[ ] Tech capabilities applied consistently to plot"
-  - "[ ] No forgotten tech that would solve earlier conflicts"
-  - "[ ] Terminology explained or intuitively clear"
-...
+
+- "[ ] Technology built on clear scientific principles or hand‑waved consistently"
+- "[ ] Limits and costs of tech established"
+- "[ ] Tech capabilities applied consistently to plot"
+- "[ ] No forgotten tech that would solve earlier conflicts"
+- "[ ] Terminology explained or intuitively clear"
+  ...
 ==================== END: .bmad-creative-writing/checklists/scifi-technology-plausibility-checklist.md ====================
 
 ==================== START: .bmad-creative-writing/checklists/romance-emotional-beats-checklist.md ====================
+<!-- Powered by BMAD™ Core -->
+
 # ------------------------------------------------------------
+
 # 12. Romance Emotional Beats Checklist
+
 # ------------------------------------------------------------
+
 ---
+
 checklist:
-  id: romance-emotional-beats-checklist
-  name: Romance Emotional Beats Checklist
-  description: Track essential emotional beats in romance arcs.
+id: romance-emotional-beats-checklist
+name: Romance Emotional Beats Checklist
+description: Track essential emotional beats in romance arcs.
 items:
-  - "[ ] Meet‑cute / inciting attraction"
-  - "[ ] Growing intimacy montage"
-  - "[ ] Midpoint commitment or confession moment"
-  - "[ ] Dark night of the soul / breakup"
-  - "[ ] Grand gesture or reconciliation"
-  - "[ ] HEA or HFN ending clear"
-...
+
+- "[ ] Meet‑cute / inciting attraction"
+- "[ ] Growing intimacy montage"
+- "[ ] Midpoint commitment or confession moment"
+- "[ ] Dark night of the soul / breakup"
+- "[ ] Grand gesture or reconciliation"
+- "[ ] HEA or HFN ending clear"
+  ...
 ==================== END: .bmad-creative-writing/checklists/romance-emotional-beats-checklist.md ====================
 
 ==================== START: .bmad-creative-writing/data/bmad-kb.md ====================
+<!-- Powered by BMAD™ Core -->
+
 # BMad Creative Writing Knowledge Base
 
 ## Overview
@@ -771,24 +814,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
@@ -797,6 +844,7 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating
 ## Genre Support
 
 ### Built-in Genre Checklists
+
 - Fantasy & Sci-Fi
 - Romance & Thriller
 - Mystery & Horror
@@ -804,6 +852,7 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating
 - Young Adult
 
 Each genre includes:
+
 - Trope management
 - Reader expectations
 - Market positioning
@@ -812,24 +861,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
@@ -866,14 +919,18 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c
 ==================== END: .bmad-creative-writing/data/bmad-kb.md ====================
 
 ==================== START: .bmad-creative-writing/data/story-structures.md ====================
+<!-- Powered by BMAD™ Core -->
+
 # 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%)
@@ -889,7 +946,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
@@ -904,6 +963,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
@@ -913,6 +973,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c
 7. Resolution
 
 ## Freytag's Pyramid
+
 1. Exposition
 2. Rising Action
 3. Climax
@@ -920,6 +981,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c
 5. Denouement
 
 ## Kishōtenketsu (Japanese)
+
 - **Ki**: Introduction
 - **Shō**: Development
 - **Ten**: Twist