bmad-method 4.37.0 → 4.39.1

package/expansion-packs/bmad-creative-writing/tasks/character-depth-pass.md

@@ -0,0 +1,15 @@
+# ------------------------------------------------------------
+# 9. Character Depth Pass
+# ------------------------------------------------------------
+---
+task:
+  id: character-depth-pass
+  name: Character Depth Pass
+  description: Enrich character profiles with backstory and arc details.
+  persona_default: character-psychologist
+inputs:
+  - character-summaries.md
+steps:
+  - For each character, add formative events, internal conflicts, arc milestones.
+output: characters.md
+...

package/expansion-packs/bmad-creative-writing/tasks/create-doc.md

@@ -0,0 +1,101 @@
+# Create Document from Template (YAML Driven)
+
+## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
+
+**THIS IS AN EXECUTABLE WORKFLOW - NOT REFERENCE MATERIAL**
+
+When this task is invoked:
+
+1. **DISABLE ALL EFFICIENCY OPTIMIZATIONS** - This workflow requires full user interaction
+2. **MANDATORY STEP-BY-STEP EXECUTION** - Each section must be processed sequentially with user feedback
+3. **ELICITATION IS REQUIRED** - When `elicit: true`, you MUST use the 1-9 format and wait for user response
+4. **NO SHORTCUTS ALLOWED** - Complete documents cannot be created without following this workflow
+
+**VIOLATION INDICATOR:** If you create a complete document without user interaction, you have violated this workflow.
+
+## Critical: Template Discovery
+
+If a YAML Template has not been provided, list all templates from .bmad-creative-writing/templates or ask the user to provide another.
+
+## CRITICAL: Mandatory Elicitation Format
+
+**When `elicit: true`, this is a HARD STOP requiring user interaction:**
+
+**YOU MUST:**
+
+1. Present section content
+2. Provide detailed rationale (explain trade-offs, assumptions, decisions made)
+3. **STOP and present numbered options 1-9:**
+   - **Option 1:** Always "Proceed to next section"
+   - **Options 2-9:** Select 8 methods from data/elicitation-methods
+   - End with: "Select 1-9 or just type your question/feedback:"
+4. **WAIT FOR USER RESPONSE** - Do not proceed until user selects option or provides feedback
+
+**WORKFLOW VIOLATION:** Creating content for elicit=true sections without user interaction violates this task.
+
+**NEVER ask yes/no questions or use any other format.**
+
+## Processing Flow
+
+1. **Parse YAML template** - Load template metadata and sections
+2. **Set preferences** - Show current mode (Interactive), confirm output file
+3. **Process each section:**
+   - Skip if condition unmet
+   - Check agent permissions (owner/editors) - note if section is restricted to specific agents
+   - Draft content using section instruction
+   - Present content + detailed rationale
+   - **IF elicit: true** → MANDATORY 1-9 options format
+   - Save to file if possible
+4. **Continue until complete**
+
+## Detailed Rationale Requirements
+
+When presenting section content, ALWAYS include rationale that explains:
+
+- Trade-offs and choices made (what was chosen over alternatives and why)
+- Key assumptions made during drafting
+- Interesting or questionable decisions that need user attention
+- Areas that might need validation
+
+## Elicitation Results Flow
+
+After user selects elicitation method (2-9):
+
+1. Execute method from data/elicitation-methods
+2. Present results with insights
+3. Offer options:
+   - **1. Apply changes and update section**
+   - **2. Return to elicitation menu**
+   - **3. Ask any questions or engage further with this elicitation**
+
+## Agent Permissions
+
+When processing sections with agent permission fields:
+
+- **owner**: Note which agent role initially creates/populates the section
+- **editors**: List agent roles allowed to modify the section
+- **readonly**: Mark sections that cannot be modified after creation
+
+**For sections with restricted access:**
+
+- Include a note in the generated document indicating the responsible agent
+- Example: "_(This section is owned by dev-agent and can only be modified by dev-agent)_"
+
+## YOLO Mode
+
+User can type `#yolo` to toggle to YOLO mode (process all sections at once).
+
+## CRITICAL REMINDERS
+
+**❌ NEVER:**
+
+- Ask yes/no questions for elicitation
+- Use any format other than 1-9 numbered options
+- Create new elicitation methods
+
+**✅ ALWAYS:**
+
+- Use exact 1-9 format when elicit: true
+- Select options 2-9 from data/elicitation-methods only
+- Provide detailed rationale explaining decisions
+- End with "Select 1-9 or just type your question/feedback:"

package/expansion-packs/bmad-creative-writing/tasks/create-draft-section.md

@@ -0,0 +1,19 @@
+# ------------------------------------------------------------
+# 4. Create Draft Section (Chapter)
+# ------------------------------------------------------------
+---
+task:
+  id: create-draft-section
+  name: Create Draft Section
+  description: Draft a complete chapter or scene using the chapter-draft-tmpl.
+  persona_default: editor
+inputs:
+  - story-outline.md | snowflake-outline.md | scene-list.md | release-plan.md
+parameters:
+  chapter_number: integer
+steps:
+  - Extract scene beats for the chapter.
+  - Draft chapter using template placeholders.
+  - Highlight dialogue blocks for later polishing.
+output: chapter-{{chapter_number}}-draft.md
+...

package/expansion-packs/bmad-creative-writing/tasks/critical-review.md

@@ -0,0 +1,19 @@
+# ------------------------------------------------------------
+# Critical Review Task
+# ------------------------------------------------------------
+---
+task:
+  id: critical-review
+  name: Critical Review
+  description: Comprehensive professional critique using critic-review-tmpl and rubric checklist.
+  persona_default: book-critic
+inputs:
+  - manuscript file (e.g., draft-manuscript.md or chapter file)
+steps:
+  - If audience/genre not provided, prompt user for details.
+  - Read manuscript (or excerpt) for holistic understanding.
+  - Fill **critic-review-tmpl** with category scores and commentary.
+  - Execute **checklists/critic-rubric-checklist** to spot omissions; revise output if any boxes unchecked.
+  - Present final review to user.
+output: critic-review.md
+...

package/expansion-packs/bmad-creative-writing/tasks/develop-character.md

@@ -0,0 +1,17 @@
+# ------------------------------------------------------------
+# 3. Develop Character
+# ------------------------------------------------------------
+---
+task:
+  id: develop-character
+  name: Develop Character
+  description: Produce rich character profiles with goals, flaws, arcs, and voice notes.
+  persona_default: character-psychologist
+inputs:
+  - concept-brief.md
+steps:
+  - Identify protagonist(s), antagonist(s), key side characters.
+  - For each, fill character-profile-tmpl.
+  - Offer advanced‑elicitation for each profile.
+output: characters.md
+...

package/expansion-packs/bmad-creative-writing/tasks/execute-checklist.md

@@ -0,0 +1,93 @@
+# 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.
+
+## Available Checklists
+
+If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the {root}/checklists folder to select the appropriate one to run.
+
+## 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
+     - Load the appropriate checklist from {root}/checklists/
+   - If no checklist specified:
+     - Ask the user which checklist they want to use
+     - Present the available options from the files in the checklists folder
+   - Confirm if they want to work through the checklist:
+     - Section by section (interactive mode - very time consuming)
+     - 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
+     - Check each item against the relevant documentation or artifacts as appropriate
+     - Present summary of findings for that section, highlighting warnings, errors and non applicable items (rationale for non-applicability).
+     - 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
+
+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
+   - Aside from this, follow all checklist llm instructions
+   - Mark items as:
+     - ✅ PASS: Requirement clearly met
+     - ❌ FAIL: Requirement not met or insufficient coverage
+     - ⚠️ PARTIAL: Some aspects covered but needs improvement
+     - N/A: Not applicable to this case
+
+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
+   - In interactive mode, discuss findings with user
+   - Document any user decisions or explanations
+
+6. **Final Report**
+
+   Prepare a summary that includes:
+
+   - Overall checklist completion status
+   - Pass rates by section
+   - List of failed items with context
+   - Specific recommendations for improvement
+   - Any sections or items marked as N/A with justification
+
+## Checklist Execution Methodology
+
+Each checklist now contains embedded LLM prompts and instructions that will:
+
+1. **Guide thorough thinking** - Prompts ensure deep analysis of each section
+2. **Request specific artifacts** - Clear instructions on what documents/access is needed
+3. **Provide contextual guidance** - Section-specific prompts for better validation
+4. **Generate comprehensive reports** - Final summary with detailed findings
+
+The LLM will:
+
+- Execute the complete checklist validation
+- Present a final report with pass/fail rates and key findings
+- Offer to provide detailed analysis of any section, especially those with warnings or failures

package/expansion-packs/bmad-creative-writing/tasks/expand-premise.md

@@ -0,0 +1,16 @@
+# ------------------------------------------------------------
+# 7. Expand Premise (Snowflake Step 2)
+# ------------------------------------------------------------
+---
+task:
+  id: expand-premise
+  name: Expand Premise
+  description: Turn a 1‑sentence idea into a 1‑paragraph summary.
+  persona_default: plot-architect
+inputs:
+  - premise.txt
+steps:
+  - Ask for genre confirmation.
+  - Draft one paragraph (~5 sentences) covering protagonist, conflict, stakes.
+output: premise-paragraph.md
+...

package/expansion-packs/bmad-creative-writing/tasks/expand-synopsis.md

@@ -0,0 +1,16 @@
+# ------------------------------------------------------------
+# 8. Expand Synopsis (Snowflake Step 4)
+# ------------------------------------------------------------
+---
+task:
+  id: expand-synopsis
+  name: Expand Synopsis
+  description: Build a 1‑page synopsis from the paragraph summary.
+  persona_default: plot-architect
+inputs:
+  - premise-paragraph.md
+steps:
+  - Outline three‑act structure in prose.
+  - Keep under 700 words.
+output: synopsis.md
+...

package/expansion-packs/bmad-creative-writing/tasks/final-polish.md

@@ -0,0 +1,16 @@
+# ------------------------------------------------------------
+# 14. Final Polish
+# ------------------------------------------------------------
+---
+task:
+  id: final-polish
+  name: Final Polish
+  description: Line‑edit for style, clarity, grammar.
+  persona_default: editor
+inputs:
+  - chapter-dialog.md | polished-manuscript.md
+steps:
+  - Correct grammar and tighten prose.
+  - Ensure consistent voice.
+output: chapter-final.md | final-manuscript.md
+...

package/expansion-packs/bmad-creative-writing/tasks/generate-cover-brief.md

@@ -0,0 +1,18 @@
+# ------------------------------------------------------------
+# tasks/generate-cover-brief.md
+# ------------------------------------------------------------
+---
+task:
+  id: generate-cover-brief
+  name: Generate Cover Brief
+  description: Interactive questionnaire that captures all creative and technical parameters for the cover.
+  persona_default: cover-designer
+steps:
+  - Ask for title, subtitle, author name, series info.
+  - Ask for genre, target audience, comparable titles.
+  - Ask for trim size (e.g., 6"x9"), page count, paper color.
+  - Ask for mood keywords, primary imagery, color palette.
+  - Ask what should appear on back cover (blurb, reviews, author bio, ISBN location).
+  - Fill cover-design-brief-tmpl with collected info.
+output: cover-brief.md
+...

package/expansion-packs/bmad-creative-writing/tasks/generate-cover-prompts.md

@@ -0,0 +1,19 @@
+# ------------------------------------------------------------
+# tasks/generate-cover-prompts.md
+# ------------------------------------------------------------
+---
+task:
+  id: generate-cover-prompts
+  name: Generate Cover Prompts
+  description: Produce AI image generator prompts for front cover artwork plus typography guidance.
+  persona_default: cover-designer
+inputs:
+  - cover-brief.md
+steps:
+  - Extract mood, genre, imagery from brief.
+  - Draft 3‑5 alternative stable diffusion / DALL·E prompts (include style, lens, color keywords).
+  - Specify safe negative prompts.
+  - Provide font pairing suggestions (Google Fonts) matching genre.
+  - Output prompts and typography guidance to cover-prompts.md.
+output: cover-prompts.md
+...

package/expansion-packs/bmad-creative-writing/tasks/generate-scene-list.md

@@ -0,0 +1,16 @@
+# ------------------------------------------------------------
+# 10. Generate Scene List
+# ------------------------------------------------------------
+---
+task:
+  id: generate-scene-list
+  name: Generate Scene List
+  description: Break synopsis into a numbered list of scenes.
+  persona_default: plot-architect
+inputs:
+  - synopsis.md | story-outline.md
+steps:
+  - Identify key beats.
+  - Fill scene-list-tmpl table.
+output: scene-list.md
+...

package/expansion-packs/bmad-creative-writing/tasks/incorporate-feedback.md

@@ -0,0 +1,18 @@
+# ------------------------------------------------------------
+# 6. Incorporate Feedback
+# ------------------------------------------------------------
+---
+task:
+  id: incorporate-feedback
+  name: Incorporate Feedback
+  description: Merge beta feedback into manuscript; accept, reject, or revise.
+  persona_default: editor
+inputs:
+  - draft-manuscript.md
+  - beta-notes.md
+steps:
+  - Summarize actionable changes.
+  - Apply revisions inline.
+  - Mark resolved comments.
+output: polished-manuscript.md
+...

package/expansion-packs/bmad-creative-writing/tasks/outline-scenes.md

@@ -0,0 +1,16 @@
+# ------------------------------------------------------------
+# 11. Outline Scenes
+# ------------------------------------------------------------
+---
+task:
+  id: outline-scenes
+  name: Outline Scenes
+  description: Group scene list into chapters with act structure.
+  persona_default: plot-architect
+inputs:
+  - scene-list.md
+steps:
+  - Assign scenes to chapters.
+  - Produce snowflake-outline.md with headings per chapter.
+output: snowflake-outline.md
+...

package/expansion-packs/bmad-creative-writing/tasks/provide-feedback.md

@@ -0,0 +1,17 @@
+# ------------------------------------------------------------
+# 5. Provide Feedback (Beta)
+# ------------------------------------------------------------
+---
+task:
+  id: provide-feedback
+  name: Provide Feedback (Beta)
+  description: Simulate beta‑reader feedback using beta-feedback-form-tmpl.
+  persona_default: beta-reader
+inputs:
+  - draft-manuscript.md | chapter-draft.md
+steps:
+  - Read provided text.
+  - Fill feedback form objectively.
+  - Save as beta-notes.md or chapter-notes.md.
+output: beta-notes.md
+...

package/expansion-packs/bmad-creative-writing/tasks/publish-chapter.md

@@ -0,0 +1,16 @@
+# ------------------------------------------------------------
+# 15. Publish Chapter
+# ------------------------------------------------------------
+---
+task:
+  id: publish-chapter
+  name: Publish Chapter
+  description: Format and log a chapter release.
+  persona_default: editor
+inputs:
+  - chapter-final.md
+steps:
+  - Generate front/back matter as needed.
+  - Append entry to publication-log.md (date, URL).
+output: publication-log.md
+...

package/expansion-packs/bmad-creative-writing/tasks/quick-feedback.md

@@ -0,0 +1,15 @@
+# ------------------------------------------------------------
+# 13. Quick Feedback (Serial)
+# ------------------------------------------------------------
+---
+task:
+  id: quick-feedback
+  name: Quick Feedback (Serial)
+  description: Fast beta feedback focused on pacing and hooks.
+  persona_default: beta-reader
+inputs:
+  - chapter-dialog.md
+steps:
+  - Use condensed beta-feedback-form.
+output: chapter-notes.md
+...

package/expansion-packs/bmad-creative-writing/tasks/select-next-arc.md

@@ -0,0 +1,16 @@
+# ------------------------------------------------------------
+# 12. Select Next Arc (Serial)
+# ------------------------------------------------------------
+---
+task:
+  id: select-next-arc
+  name: Select Next Arc
+  description: Choose the next 2–4‑chapter arc for serial publication.
+  persona_default: plot-architect
+inputs:
+  - retrospective data (retro.md) | snowflake-outline.md
+steps:
+  - Analyze reader feedback.
+  - Update release-plan.md with upcoming beats.
+output: release-plan.md
+...

package/expansion-packs/bmad-creative-writing/tasks/workshop-dialog.md

@@ -0,0 +1,51 @@
+# Workshop Dialog
+
+## Purpose
+Refine dialog for authenticity, character voice, and dramatic effectiveness.
+
+## Process
+
+### 1. Voice Audit
+For each character, assess:
+- Vocabulary level and word choice
+- Sentence structure preferences
+- Speech rhythms and patterns
+- Catchphrases or verbal tics
+- Educational/cultural markers
+- Emotional expression style
+
+### 2. Subtext Analysis
+For each exchange:
+- What's being said directly
+- What's really being communicated
+- Power dynamics at play
+- Emotional undercurrents
+- Character objectives
+- Obstacles to directness
+
+### 3. Flow Enhancement
+- Remove unnecessary dialogue tags
+- Vary attribution methods
+- Add action beats
+- Incorporate silence/pauses
+- Balance dialog with narrative
+- Ensure natural interruptions
+### 4. Conflict Injection
+Where dialog lacks tension:
+- Add opposing goals
+- Insert misunderstandings
+- Create subtext conflicts
+- Use indirect responses
+- Build through escalation
+- Add environmental pressure
+
+### 5. Polish Pass
+- Read aloud for rhythm
+- Check period authenticity
+- Verify character consistency
+- Eliminate on-the-nose dialog
+- Strengthen opening/closing lines
+- Add distinctive character markers
+
+## Output
+Refined dialog with stronger voices and dramatic impact

package/expansion-packs/bmad-creative-writing/templates/beta-feedback-form.yaml

@@ -0,0 +1,96 @@
+---
+template:
+  id: beta-feedback-form-tmpl
+  name: Beta Feedback Form
+  version: 1.0
+  description: Structured questionnaire for beta readers
+  output:
+    format: markdown
+    filename: "beta-feedback-{{reader_name}}.md"
+
+workflow:
+  elicitation: true
+  allow_skip: true
+
+sections:
+  - id: reader_info
+    title: Reader Information
+    instruction: |
+      Collect reader details:
+      - Reader name
+      - Reading experience level
+      - Genre preferences
+      - Date of feedback
+    elicit: true
+
+  - id: overall_impressions
+    title: Overall Impressions
+    instruction: |
+      Gather general reactions:
+      - What worked well overall
+      - What confused or bored you
+      - Most memorable moments
+      - Overall rating (1-10)
+    elicit: true
+
+  - id: characters
+    title: Character Feedback
+    instruction: |
+      Evaluate character development:
+      - Favorite character and why
+      - Least engaging character and why
+      - Character believability
+      - Character arc satisfaction
+      - Dialogue authenticity
+    elicit: true
+
+  - id: plot_pacing
+    title: Plot & Pacing
+    instruction: |
+      Assess story structure:
+      - High-point scenes
+      - Slowest sections
+      - Plot holes or confusion
+      - Pacing issues
+      - Predictability concerns
+    elicit: true
+
+  - id: world_setting
+    title: World & Setting
+    instruction: |
+      Review world-building:
+      - Setting clarity
+      - World consistency
+      - Immersion level
+      - Description balance
+    elicit: true
+
+  - id: emotional_response
+    title: Emotional Response
+    instruction: |
+      Document emotional impact:
+      - Strong emotions felt
+      - Scenes that moved you
+      - Connection to characters
+      - Satisfaction with ending
+    elicit: true
+
+  - id: technical_issues
+    title: Technical Issues
+    instruction: |
+      Note any technical problems:
+      - Grammar/spelling errors
+      - Continuity issues
+      - Formatting problems
+      - Confusing passages
+    elicit: true
+
+  - id: suggestions
+    title: Final Suggestions
+    instruction: |
+      Provide improvement recommendations:
+      - Top three improvements needed
+      - Would you recommend to others
+      - Comparison to similar books
+      - Additional comments
+    elicit: true