bmad-stella 1.0.0

package/expansion-packs/bmad-creative-writing/data/bmad-kb.md

@@ -0,0 +1,209 @@
+<!-- Powered by BMAD™ Core -->
+
+# BMad Creative Writing Knowledge Base
+
+## Overview
+
+BMad Creative Writing Extension adapts the BMad-Method framework for fiction writing, narrative design, and creative storytelling projects. This extension provides specialized agents, workflows, and tools designed specifically for creative writers.
+
+### Key Features
+
+- **Specialized Writing Agents**: Plot architects, character psychologists, world builders, and more
+- **Complete Writing Workflows**: From premise to publication-ready manuscript
+- **Genre-Specific Support**: Tailored checklists and templates for various genres
+- **Publishing Integration**: KDP-ready formatting and cover design support
+- **Interactive Development**: Elicitation-driven character and plot development
+
+### When to Use BMad Creative Writing
+
+- **Novel Writing**: Complete novels from concept to final draft
+- **Screenplay Development**: Industry-standard screenplay formatting
+- **Short Story Creation**: Focused narrative development
+- **Series Planning**: Multi-book continuity management
+- **Interactive Fiction**: Branching narrative design
+- **Publishing Preparation**: KDP and eBook formatting
+
+## How BMad Creative Writing Works
+
+### The Core Method
+
+BMad Creative Writing transforms you into a "Creative Director" - orchestrating specialized AI agents through the creative process:
+
+1. **You Create, AI Supports**: You provide creative vision; agents handle structure and consistency
+2. **Specialized Agents**: Each agent masters one aspect (plot, character, dialogue, etc.)
+3. **Structured Workflows**: Proven narrative patterns guide your creative process
+4. **Iterative Refinement**: Multiple passes ensure quality and coherence
+
+### The Three-Phase Approach
+
+#### Phase 1: Ideation & Planning
+
+- Brainstorm premises and concepts
+- Develop character profiles and backstories
+- Build worlds and settings
+- Create comprehensive story outlines
+
+#### Phase 2: Drafting & Development
+
+- Generate scene-by-scene content
+- Workshop dialogue and voice
+- Maintain consistency across chapters
+- Track character arcs and plot threads
+
+#### Phase 3: Revision & Polish
+
+- Beta reader simulation and feedback
+- Line editing and style refinement
+- Genre compliance checking
+- Publication preparation
+
+## Agent Specializations
+
+### Core Writing Team
+
+- **Plot Architect**: Story structure, pacing, narrative arcs
+- **Character Psychologist**: Deep character development, motivation
+- **World Builder**: Settings, cultures, consistent universes
+- **Editor**: Style, grammar, narrative flow
+- **Beta Reader**: Reader perspective simulation
+
+### Specialist Agents
+
+- **Dialog Specialist**: Natural dialogue, voice distinction
+- **Narrative Designer**: Interactive storytelling, branching paths
+- **Genre Specialist**: Genre conventions, market awareness
+- **Book Critic**: Professional literary analysis
+- **Cover Designer**: Visual storytelling, KDP compliance
+
+## Writing Workflows
+
+### Novel Development
+
+1. **Premise Development**: Brainstorm and expand initial concept
+2. **World Building**: Create setting and environment
+3. **Character Creation**: Develop protagonist, antagonist, supporting cast
+4. **Story Architecture**: Three-act structure, scene breakdown
+5. **Chapter Drafting**: Sequential scene development
+6. **Dialog Pass**: Voice refinement and authenticity
+7. **Beta Feedback**: Simulated reader responses
+8. **Final Polish**: Professional editing pass
+
+### Screenplay Workflow
+
+- Industry-standard formatting
+- Visual storytelling emphasis
+- Dialogue-driven narrative
+- Scene/location optimization
+
+### Series Planning
+
+- Multi-book continuity tracking
+- Character evolution across volumes
+- World expansion management
+- Overarching plot coordination
+
+## 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
+- Beta feedback forms
+
+## Genre Support
+
+### Built-in Genre Checklists
+
+- Fantasy & Sci-Fi
+- Romance & Thriller
+- Mystery & Horror
+- Literary Fiction
+- Young Adult
+
+Each genre includes:
+
+- Trope management
+- Reader expectations
+- Market positioning
+- Style guidelines
+
+## 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
+4. Get distance between drafts
+
+## Integration with Core BMad
+
+The Creative Writing extension maintains compatibility with core BMad features:
+
+- Uses standard agent format
+- Supports slash commands
+- Integrates with workflows
+- Shares elicitation methods
+- Compatible with YOLO mode
+
+## Quick Start Commands
+
+- `*help` - Show available agent commands
+- `*create-outline` - Start story structure
+- `*create-profile` - Develop character
+- `*analyze-structure` - Review plot mechanics
+- `*workshop-dialog` - Refine character voices
+- `*yolo` - Toggle fast-drafting mode
+
+## Tips for Success
+
+1. **Trust the Process**: Follow workflows even when inspired
+2. **Use Elicitation**: Deep-dive when stuck
+3. **Layer Development**: Build story in passes
+4. **Track Everything**: Use templates to maintain consistency
+5. **Iterate Freely**: First drafts are for discovery
+
+Remember: BMad Creative Writing provides structure to liberate creativity, not constrain it.

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

@@ -0,0 +1,67 @@
+<!-- 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%)
+4. Catalyst (10%)
+5. Debate (10-20%)
+6. Break into Two (20%)
+7. B Story (22%)
+8. Fun and Games (20-50%)
+9. Midpoint (50%)
+10. Bad Guys Close In (50-75%)
+11. All Is Lost (75%)
+12. Dark Night of Soul (75-80%)
+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
+4. Meeting Mentor
+5. Crossing Threshold
+6. Tests, Allies, Enemies
+7. Approach to Cave
+8. Ordeal
+9. Reward
+10. Road Back
+11. Resurrection
+12. Return with Elixir
+
+## Seven-Point Structure
+
+1. Hook
+2. Plot Turn 1
+3. Pinch Point 1
+4. Midpoint
+5. Pinch Point 2
+6. Plot Turn 2
+7. Resolution
+
+## Freytag's Pyramid
+
+1. Exposition
+2. Rising Action
+3. Climax
+4. Falling Action
+5. Denouement
+
+## Kishōtenketsu (Japanese)
+
+- **Ki**: Introduction
+- **Shō**: Development
+- **Ten**: Twist
+- **Ketsu**: Conclusion

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

@@ -0,0 +1,212 @@
+<!-- Powered by BMAD™ Core -->
+
+# Project Brief: BMad Creative Writing Expansion Pack
+
+## Executive Summary
+
+The BMad Creative Writing Expansion Pack is a comprehensive AI-powered creative writing framework that provides specialized agents, workflows, and tools for fiction writers, screenwriters, and narrative designers. It transforms the BMad methodology into a complete creative writing studio, enabling writers to leverage AI assistance across the entire creative process from ideation to publication-ready manuscripts. The system targets both aspiring and professional writers who want to maintain creative control while accelerating their writing process through intelligent automation and structured workflows.
+
+## 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
+- **Publishing Complexity**: Self-publishing requires mastery of formatting, cover design, and package assembly - technical skills many writers lack
+- **Feedback Loops**: Getting quality beta feedback is slow, expensive, and often arrives too late in the process
+
+Existing solutions like Scrivener provide organization but lack intelligent assistance. AI writing tools like ChatGPT lack structure and specialized workflows. The market needs a solution that combines structured methodology with AI intelligence specifically tuned for creative writing.
+
+## 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
+- **Quality Assurance System**: 27 specialized checklists ensure consistency, continuity, and publication readiness
+- **Modular Architecture**: Writers can use individual agents, complete workflows, or custom combinations based on their needs
+
+This solution succeeds where others fail by treating creative writing as a professional craft requiring specialized tools, not generic text generation.
+
+## 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
+- **Goals**: Complete first manuscript, develop professional writing habits, learn craft fundamentals through practice
+
+## 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
+- **Publishing Success Rate**: Percentage of completed manuscripts that get published
+
+## 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
+- **Template System**: All 8 core templates (character, scene, outline, etc.) operational
+- **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
+- Mobile/tablet applications
+- AI voice synthesis for audiobook creation
+- 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
+- **IP Development**: Tools for adapting novels to screenplays, games, graphic novels
+
+## 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
+- **Security/Compliance:** End-to-end encryption for manuscripts, GDPR compliance, no training on user content
+
+## 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")
+- Current LLM capabilities are sufficient for nuanced creative feedback
+- Users will pay $20-50/month for professional writing tools
+
+## 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
+- Pricing sensitivity analysis for different user segments
+
+## 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
+- AI Writing Tools Comparative Analysis
+
+## 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
+4. Create demo video showing complete novel chapter creation
+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.

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

@@ -0,0 +1,119 @@
+<!-- Powered by BMAD™ Core -->
+
+# Advanced Elicitation Task
+
+## Purpose
+
+- Provide optional reflective and brainstorming actions to enhance content quality
+- Enable deeper exploration of ideas through structured elicitation techniques
+- Support iterative refinement through multiple analytical perspectives
+- Usable during template-driven document creation or any chat conversation
+
+## Usage Scenarios
+
+### Scenario 1: Template Document Creation
+
+After outputting a section during document creation:
+
+1. **Section Review**: Ask user to review the drafted section
+2. **Offer Elicitation**: Present 9 carefully selected elicitation methods
+3. **Simple Selection**: User types a number (0-8) to engage method, or 9 to proceed
+4. **Execute & Loop**: Apply selected method, then re-offer choices until user proceeds
+
+### Scenario 2: General Chat Elicitation
+
+User can request advanced elicitation on any agent output:
+
+- User says "do advanced elicitation" or similar
+- Agent selects 9 relevant methods for the context
+- Same simple 0-9 selection process
+
+## Task Instructions
+
+### 1. Intelligent Method Selection
+
+**Context Analysis**: Before presenting options, analyze:
+
+- **Content Type**: Technical specs, user stories, architecture, requirements, etc.
+- **Complexity Level**: Simple, moderate, or complex content
+- **Stakeholder Needs**: Who will use this information
+- **Risk Level**: High-impact decisions vs routine items
+- **Creative Potential**: Opportunities for innovation or alternatives
+
+**Method Selection Strategy**:
+
+1. **Always Include Core Methods** (choose 3-4):
+   - Expand or Contract for Audience
+   - Critique and Refine
+   - Identify Potential Risks
+   - Assess Alignment with Goals
+
+2. **Context-Specific Methods** (choose 4-5):
+   - **Technical Content**: Tree of Thoughts, ReWOO, Meta-Prompting
+   - **User-Facing Content**: Agile Team Perspective, Stakeholder Roundtable
+   - **Creative Content**: Innovation Tournament, Escape Room Challenge
+   - **Strategic Content**: Red Team vs Blue Team, Hindsight Reflection
+
+3. **Always Include**: "Proceed / No Further Actions" as option 9
+
+### 2. Section Context and Review
+
+When invoked after outputting a section:
+
+1. **Provide Context Summary**: Give a brief 1-2 sentence summary of what the user should look for in the section just presented
+
+2. **Explain Visual Elements**: If the section contains diagrams, explain them briefly before offering elicitation options
+
+3. **Clarify Scope Options**: If the section contains multiple distinct items, inform the user they can apply elicitation actions to:
+   - The entire section as a whole
+   - Individual items within the section (specify which item when selecting an action)
+
+### 3. Present Elicitation Options
+
+**Review Request Process:**
+
+- Ask the user to review the drafted section
+- In the SAME message, inform them they can suggest direct changes OR select an elicitation method
+- Present 9 intelligently selected methods (0-8) plus "Proceed" (9)
+- Keep descriptions short - just the method name
+- Await simple numeric selection
+
+**Action List Presentation Format:**
+
+```text
+**Advanced Elicitation Options**
+Choose a number (0-8) or 9 to proceed:
+
+0. [Method Name]
+1. [Method Name]
+2. [Method Name]
+3. [Method Name]
+4. [Method Name]
+5. [Method Name]
+6. [Method Name]
+7. [Method Name]
+8. [Method Name]
+9. Proceed / No Further Actions
+```
+
+**Response Handling:**
+
+- **Numbers 0-8**: Execute the selected method, then re-offer the choice
+- **Number 9**: Proceed to next section or continue conversation
+- **Direct Feedback**: Apply user's suggested changes and continue
+
+### 4. Method Execution Framework
+
+**Execution Process:**
+
+1. **Retrieve Method**: Access the specific elicitation method from the elicitation-methods data file
+2. **Apply Context**: Execute the method from your current role's perspective
+3. **Provide Results**: Deliver insights, critiques, or alternatives relevant to the content
+4. **Re-offer Choice**: Present the same 9 options again until user selects 9 or gives direct feedback
+
+**Execution Guidelines:**
+
+- **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

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

@@ -0,0 +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
+inputs:
+
+- 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

@@ -0,0 +1,67 @@
+<!-- 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
+- Hero's Journey
+- Save the Cat beats
+- Freytag's Pyramid
+- Kishōtenketsu
+- In medias res
+- 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?
+- **Midpoint**: What reversal/revelation occurs?
+- **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
+- Action/reflection balance
+- Chapter break effectiveness
+
+### 4. Evaluate Setup/Payoff
+
+- Track all setups (promises to reader)
+- Verify each has satisfying payoff
+- Identify orphaned setups
+- Find unsupported payoffs
+- 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
+- Suggested fixes
+- Alternative structures
+
+## Output
+
+Comprehensive structural analysis with actionable recommendations