bmad-method 4.39.1 → 4.40.0

package/expansion-packs/bmad-creative-writing/data/story-structures.md

@@ -1,11 +1,15 @@
+<!-- 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%)
@@ -21,7 +25,9 @@
 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
@@ -36,6 +42,7 @@
 12. Return with Elixir
 
 ## Seven-Point Structure
+
 1. Hook
 2. Plot Turn 1
 3. Pinch Point 1
@@ -45,6 +52,7 @@
 7. Resolution
 
 ## Freytag's Pyramid
+
 1. Exposition
 2. Rising Action
 3. Climax
@@ -52,7 +60,8 @@
 5. Denouement
 
 ## Kishōtenketsu (Japanese)
+
 - **Ki**: Introduction
 - **Shō**: Development
 - **Ten**: Twist
-- **Ketsu**: Conclusion
+- **Ketsu**: Conclusion

package/expansion-packs/bmad-creative-writing/docs/brief.md

@@ -1,3 +1,5 @@
+<!-- Powered by BMAD™ Core -->
+
 # Project Brief: BMad Creative Writing Expansion Pack
 
 ## Executive Summary
@@ -7,6 +9,7 @@ The BMad Creative Writing Expansion Pack is a comprehensive AI-powered creative
 ## Problem Statement
 
 Writers face numerous challenges in the modern creative landscape:
+
 - **Process Fragmentation**: Writers juggle multiple tools (word processors, outlining software, character databases, world-building wikis) without integrated workflows
 - **Creative Blocks**: 40% of writers report regular creative blocks that halt productivity for days or weeks
 - **Quality Consistency**: Maintaining consistency across character voices, world-building details, and plot threads becomes exponentially harder as projects grow
@@ -18,6 +21,7 @@ Existing solutions like Scrivener provide organization but lack intelligent assi
 ## Proposed Solution
 
 The BMad Creative Writing Expansion Pack provides a complete AI-augmented writing studio through:
+
 - **10 Specialized Writing Agents**: Each agent masters a specific aspect of craft (plot, character, dialogue, world-building, editing)
 - **Genre-Specific Intelligence**: Agents understand genre conventions and can adapt to sci-fi, fantasy, romance, mystery, thriller contexts
 - **End-to-End Workflows**: From initial premise through KDP-ready packages, workflows guide writers through proven methodologies
@@ -29,12 +33,14 @@ This solution succeeds where others fail by treating creative writing as a profe
 ## Target Users
 
 ### Primary User Segment: Professional Fiction Writers
+
 - **Profile**: Published authors with 1-5 books, primarily self-published through KDP/other platforms
 - **Current Workflow**: Draft in Word/Scrivener, self-edit, hire freelance editors, manage own publishing
 - **Pain Points**: Maintaining series consistency, managing multiple projects, expensive editing costs ($2000-5000 per book)
 - **Goals**: Increase output from 1-2 books/year to 3-4, reduce editing costs by 50%, maintain quality standards
 
 ### Secondary User Segment: Aspiring Writers & Writing Students
+
 - **Profile**: Unpublished writers working on first novel, MFA students, workshop participants
 - **Current Workflow**: Sporadic writing habits, limited structure, heavy reliance on writing groups for feedback
 - **Pain Points**: Lack of structured process, difficulty completing projects, limited access to professional feedback
@@ -43,18 +49,21 @@ This solution succeeds where others fail by treating creative writing as a profe
 ## Goals & Success Metrics
 
 ### Business Objectives
+
 - Achieve 1000 active users within 6 months of launch
 - Generate $50K MRR through subscription model by month 12
 - Establish BMad as the leading AI-powered creative writing methodology
 - Build ecosystem of 50+ community-contributed workflows/agents by year 2
 
 ### User Success Metrics
+
 - Average completion rate for novels increases from 15% to 60%
 - Time from premise to first draft reduced by 40%
 - User-reported satisfaction with AI feedback reaches 85% "helpful or very helpful"
 - 30% of users publish at least one work within first year
 
 ### Key Performance Indicators (KPIs)
+
 - **Monthly Active Writers**: Writers who complete at least 5000 words per month using the system
 - **Workflow Completion Rate**: Percentage of started workflows that reach completion
 - **Agent Utilization**: Average number of different agents used per project
@@ -63,6 +72,7 @@ This solution succeeds where others fail by treating creative writing as a profe
 ## MVP Scope
 
 ### Core Features (Must Have)
+
 - **Agent System Core**: All 10 writing agents fully functional with clear command interfaces
 - **Novel Writing Workflow**: Complete greenfield novel workflow from premise to draft
 - **Basic Editor Integration**: VSCode/cursor integration for writing environment
@@ -70,6 +80,7 @@ This solution succeeds where others fail by treating creative writing as a profe
 - **Checkpoint System**: Save/restore project state at any workflow stage
 
 ### Out of Scope for MVP
+
 - Visual world-building tools or maps
 - Collaborative multi-author features
 - Direct publishing API integrations
@@ -78,24 +89,29 @@ This solution succeeds where others fail by treating creative writing as a profe
 - Translation capabilities
 
 ### MVP Success Criteria
+
 The MVP succeeds if 100 beta users can complete a 50,000-word novel draft using the system with 80%+ reporting the experience as "significantly better" than their previous process.
 
 ## Post-MVP Vision
 
 ### Phase 2 Features
+
 - **Series Management**: Tools for maintaining continuity across book series
 - **Publishing Pipeline**: Direct integration with KDP, Draft2Digital, IngramSpark
 - **Collaboration Mode**: Multiple writers/editors working on same project
 - **Custom Agent Training**: Users can train agents on their own published works for style consistency
 
 ### Long-term Vision
+
 Within 2 years, BMad Creative Writing becomes the industry standard for AI-augmented creative writing, with specialized variants for:
+
 - Academic writing (thesis, dissertations)
 - Technical documentation
 - Game narrative design
 - Interactive fiction/visual novels
 
 ### Expansion Opportunities
+
 - **BMad Writing Certification**: Professional certification program for AI-augmented writers
 - **Agency Partnerships**: White-label solution for literary agencies and publishing houses
 - **Educational Integration**: Curriculum packages for creative writing programs
@@ -104,17 +120,20 @@ Within 2 years, BMad Creative Writing becomes the industry standard for AI-augme
 ## Technical Considerations
 
 ### Platform Requirements
+
 - **Target Platforms:** Windows, macOS, Linux (via CLI initially)
 - **Browser/OS Support:** Modern browsers for web interface (Chrome 90+, Firefox 88+, Safari 14+)
 - **Performance Requirements:** Handle 100K+ word documents with <100ms response time for agent interactions
 
 ### Technology Preferences
+
 - **Frontend:** React/Next.js for web interface, maintaining VSCode extension
 - **Backend:** Node.js/Python hybrid for agent orchestration
 - **Database:** PostgreSQL for manuscript storage, Redis for session state
 - **Hosting/Infrastructure:** AWS/GCP with CDN for global distribution
 
 ### Architecture Considerations
+
 - **Repository Structure:** Monorepo with packages for agents, workflows, templates, and core
 - **Service Architecture:** Microservices for agent execution, monolithic API gateway
 - **Integration Requirements:** LLM providers (OpenAI, Anthropic, local models), version control (Git), cloud storage
@@ -123,12 +142,14 @@ Within 2 years, BMad Creative Writing becomes the industry standard for AI-augme
 ## Constraints & Assumptions
 
 ### Constraints
+
 - **Budget:** $50K initial development budget, $5K/month operational
 - **Timeline:** MVP launch in 3 months, Phase 2 in 6 months
 - **Resources:** 2 full-time developers, 1 part-time writer/tester
 - **Technical:** Must work within token limits of current LLMs, no custom model training initially
 
 ### Key Assumptions
+
 - Writers are comfortable with markdown-based writing environments
 - Target users have reliable internet connectivity for AI agent interactions
 - The creative writing market is ready for AI-augmented tools (not viewing them as "cheating")
@@ -138,18 +159,21 @@ Within 2 years, BMad Creative Writing becomes the industry standard for AI-augme
 ## Risks & Open Questions
 
 ### Key Risks
+
 - **Market Resistance:** Traditional writing community may reject AI assistance as "inauthentic"
 - **LLM Dependency:** Reliance on third-party LLM providers creates availability and cost risks
 - **Quality Variance:** AI feedback quality may vary significantly based on genre/style
 - **Copyright Concerns:** Unclear legal status of AI-assisted creative works in some jurisdictions
 
 ### Open Questions
+
 - Should we support real-time collaboration or focus on single-author workflows?
 - How do we handle explicit content that may violate LLM provider policies?
 - What's the optimal balance between prescriptive workflows and creative freedom?
 - Should agents have "personalities" or remain neutral tools?
 
 ### Areas Needing Further Research
+
 - Optimal prompt engineering for maintaining consistent character voices
 - Integration possibilities with existing writing tools (Scrivener, Ulysses)
 - Market segmentation between genre writers (romance, sci-fi) vs literary fiction
@@ -158,13 +182,16 @@ Within 2 years, BMad Creative Writing becomes the industry standard for AI-augme
 ## Appendices
 
 ### A. Research Summary
+
 Based on analysis of competing tools:
+
 - **Sudowrite**: Strong on prose generation, weak on structure ($20/month)
 - **NovelAI**: Focused on continuation, lacks comprehensive workflows ($15/month)
 - **Scrivener**: Excellent organization, no AI capabilities ($50 one-time)
 - **Market Gap**: No solution combines structured methodology with specialized AI agents
 
 ### B. References
+
 - BMad Core Documentation: [internal docs]
 - Creative Writing Market Report 2024
 - Self-Publishing Author Survey Results
@@ -173,6 +200,7 @@ Based on analysis of competing tools:
 ## Next Steps
 
 ### Immediate Actions
+
 1. Finalize agent command interfaces and test with 5 beta writers
 2. Complete novel-greenfield-workflow with full template integration
 3. Set up development environment with proper CI/CD pipeline
@@ -180,4 +208,5 @@ Based on analysis of competing tools:
 5. Recruit 20 beta testers from writing communities
 
 ### PM Handoff
-This Project Brief provides the full context for BMad Creative Writing Expansion Pack. Please start in 'PRD Generation Mode', review the brief thoroughly to work with the user to create the PRD section by section as the template indicates, asking for any necessary clarification or suggesting improvements.
+
+This Project Brief provides the full context for BMad Creative Writing Expansion Pack. Please start in 'PRD Generation Mode', review the brief thoroughly to work with the user to create the PRD section by section as the template indicates, asking for any necessary clarification or suggesting improvements.

package/expansion-packs/bmad-creative-writing/tasks/advanced-elicitation.md

@@ -1,3 +1,5 @@
+<!-- Powered by BMAD™ Core -->
+
 # Advanced Elicitation Task
 
 ## Purpose
@@ -114,4 +116,4 @@ Choose a number (0-8) or 9 to proceed:
 - **Be Concise**: Focus on actionable insights, not lengthy explanations
 - **Stay Relevant**: Tie all elicitation back to the specific content being analyzed
 - **Identify Personas**: For multi-persona methods, clearly identify which viewpoint is speaking
-- **Maintain Flow**: Keep the process moving efficiently
+- **Maintain Flow**: Keep the process moving efficiently

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

@@ -1,16 +1,23 @@
+<!-- Powered by BMAD™ Core -->
+
 # ------------------------------------------------------------
+
 # 16. Analyze Reader Feedback
+
 # ------------------------------------------------------------
+
 ---
+
 task:
-  id: analyze-reader-feedback
-  name: Analyze Reader Feedback
-  description: Summarize reader comments, identify trends, update story bible.
-  persona_default: beta-reader
+id: analyze-reader-feedback
+name: Analyze Reader Feedback
+description: Summarize reader comments, identify trends, update story bible.
+persona_default: beta-reader
 inputs:
-  - publication-log.md
-steps:
-  - Cluster comments by theme.
-  - Suggest course corrections.
-output: retro.md
-...
+
+- publication-log.md
+  steps:
+- Cluster comments by theme.
+- Suggest course corrections.
+  output: retro.md
+  ...

package/expansion-packs/bmad-creative-writing/tasks/analyze-story-structure.md

@@ -1,13 +1,17 @@
+<!-- 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
@@ -16,6 +20,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?
@@ -23,7 +28,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
@@ -31,6 +38,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
@@ -38,13 +46,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
@@ -52,4 +63,5 @@ Create structural report including:
 - Alternative structures
 
 ## Output
-Comprehensive structural analysis with actionable recommendations
+
+Comprehensive structural analysis with actionable recommendations

package/expansion-packs/bmad-creative-writing/tasks/assemble-kdp-package.md

@@ -1,22 +1,29 @@
+<!-- Powered by BMAD™ Core -->
+
 # ------------------------------------------------------------
+
 # tasks/assemble-kdp-package.md
+
 # ------------------------------------------------------------
+
 ---
+
 task:
-  id: assemble-kdp-package
-  name: Assemble KDP Cover Package
-  description: Compile final instructions, assets list, and compliance checklist for Amazon KDP upload.
-  persona_default: cover-designer
+id: assemble-kdp-package
+name: Assemble KDP Cover Package
+description: Compile final instructions, assets list, and compliance checklist for Amazon KDP upload.
+persona_default: cover-designer
 inputs:
-  - cover-brief.md
-  - cover-prompts.md
-steps:
-  - Calculate full‑wrap cover dimensions (front, spine, back) using trim size & page count.
-  - List required bleed and margin values.
-  - Provide layout diagram (ASCII or Mermaid) labeling zones.
-  - Insert ISBN placeholder or user‑supplied barcode location.
-  - Populate back‑cover content sections (blurb, reviews, author bio).
-  - Export combined PDF instructions (design-package.md) with link placeholders for final JPEG/PNG.
-  - Execute kdp-cover-ready-checklist; flag any unmet items.
-output: design-package.md
-...
+
+- cover-brief.md
+- cover-prompts.md
+  steps:
+- Calculate full‑wrap cover dimensions (front, spine, back) using trim size & page count.
+- List required bleed and margin values.
+- Provide layout diagram (ASCII or Mermaid) labeling zones.
+- Insert ISBN placeholder or user‑supplied barcode location.
+- Populate back‑cover content sections (blurb, reviews, author bio).
+- Export combined PDF instructions (design-package.md) with link placeholders for final JPEG/PNG.
+- Execute kdp-cover-ready-checklist; flag any unmet items.
+  output: design-package.md
+  ...

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

@@ -1,16 +1,23 @@
+<!-- Powered by BMAD™ Core -->
+
 # ------------------------------------------------------------
+
 # 1. Brainstorm Premise
+
 # ------------------------------------------------------------
+
 ---
+
 task:
-  id: brainstorm-premise
-  name: Brainstorm Premise
-  description: Rapidly generate and refine one‑sentence log‑line ideas for a new novel or story.
-  persona_default: plot-architect
+id: brainstorm-premise
+name: Brainstorm Premise
+description: Rapidly generate and refine one‑sentence log‑line ideas for a new novel or story.
+persona_default: plot-architect
 steps:
-  - Ask genre, tone, and any must‑have elements.
-  - Produce 5–10 succinct log‑lines (max 35 words each).
-  - Invite user to select or combine.
-  - Refine the chosen premise into a single powerful sentence.
-output: premise.txt
-...
+
+- Ask genre, tone, and any must‑have elements.
+- Produce 5–10 succinct log‑lines (max 35 words each).
+- Invite user to select or combine.
+- Refine the chosen premise into a single powerful sentence.
+  output: premise.txt
+  ...

package/expansion-packs/bmad-creative-writing/tasks/build-world.md

@@ -1,17 +1,24 @@
+<!-- Powered by BMAD™ Core -->
+
 # ------------------------------------------------------------
+
 # 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
+  ...

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

@@ -1,15 +1,22 @@
+<!-- Powered by BMAD™ Core -->
+
 # ------------------------------------------------------------
+
 # 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
+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
-...
+
+- 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

@@ -1,3 +1,5 @@
+<!-- Powered by BMAD™ Core -->
+
 # Create Document from Template (YAML Driven)
 
 ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -98,4 +100,4 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
 - 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:"
+- End with "Select 1-9 or just type your question/feedback:"

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

@@ -1,19 +1,26 @@
+<!-- Powered by BMAD™ Core -->
+
 # ------------------------------------------------------------
+
 # 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
+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:
+
+- 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
-...
+  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

@@ -1,19 +1,26 @@
+<!-- Powered by BMAD™ Core -->
+
 # ------------------------------------------------------------
+
 # 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
+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
-...
+
+- 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

@@ -1,17 +1,24 @@
+<!-- Powered by BMAD™ Core -->
+
 # ------------------------------------------------------------
+
 # 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
+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
-...
+
+- 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
+  ...