diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index d3e5414e..fe988154 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -206,4 +206,4 @@ Each commit should represent one logical change: ## License -By contributing to this project, you agree that your contributions will be licensed under the same license as the project. +By contributing to this project, you agree that your contributions will be licensed under the MIT License. diff --git a/LICENSE b/LICENSE index ab5acd81..1a775d75 100644 --- a/LICENSE +++ b/LICENSE @@ -1,6 +1,6 @@ MIT License -Copyright (c) 2025 Brian AKA BMad AKA BMad Code +Copyright (c) 2025 BMad Code, LLC Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal @@ -19,3 +19,8 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +TRADEMARK NOTICE: +BMAD™ and BMAD-METHOD™ are trademarks of BMad Code, LLC. The use of these +trademarks in this software does not grant any rights to use the trademarks +for any other purpose. diff --git a/README.md b/README.md index 0d182dba..d828da28 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# BMad-Method: Universal AI Agent Framework +# BMAD-METHOD™: Universal AI Agent Framework [![Version](https://img.shields.io/npm/v/bmad-method?color=blue&label=version)](https://www.npmjs.com/package/bmad-method) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) @@ -11,11 +11,11 @@ Foundations in Agentic Agile Driven Development, known as the Breakthrough Metho **[Join our Discord Community](https://discord.gg/gk8jAdXWmj)** - A growing community for AI enthusiasts! Get help, share ideas, explore AI agents & frameworks, collaborate on tech projects, enjoy hobbies, and help each other succeed. Whether you're stuck on BMad, building your own agents, or just want to chat about the latest in AI - we're here for you! **Some mobile and VPN may have issue joining the discord, this is a discord issue - if the invite does not work, try from your own internet or another network, or non-VPN.** -⭐ **If you find this project helpful or useful, please give it a star in the upper right hand corner!** It helps others discover BMad-Method and you will be notified of updates! +⭐ **If you find this project helpful or useful, please give it a star in the upper right hand corner!** It helps others discover BMAD-METHOD™ and you will be notified of updates! ## Overview -**BMad Method's Two Key Innovations:** +**BMAD-METHOD™'s Two Key Innovations:** **1. Agentic Planning:** Dedicated agents (Analyst, PM, Architect) collaborate with you to create detailed, consistent PRDs and Architecture documents. Through advanced prompt engineering and human-in-the-loop refinement, these planning agents produce comprehensive specifications that go far beyond generic AI task generation. @@ -49,7 +49,7 @@ This two-phase approach eliminates both **planning inconsistency** and **context ## Important: Keep Your BMad Installation Updated -**Stay up-to-date effortlessly!** If you already have BMad-Method installed in your project, simply run: +**Stay up-to-date effortlessly!** If you already have BMAD-METHOD™ installed in your project, simply run: ```bash npx bmad-method install @@ -110,11 +110,11 @@ npm run install:bmad # build and install all to a destination folder ## 🌟 Beyond Software Development - Expansion Packs -BMad's natural language framework works in ANY domain. Expansion packs provide specialized AI agents for creative writing, business strategy, health & wellness, education, and more. Also expansion packs can expand the core BMad-Method with specific functionality that is not generic for all cases. [See the Expansion Packs Guide](docs/expansion-packs.md) and learn to create your own! +BMAD™'s natural language framework works in ANY domain. Expansion packs provide specialized AI agents for creative writing, business strategy, health & wellness, education, and more. Also expansion packs can expand the core BMAD-METHOD™ with specific functionality that is not generic for all cases. [See the Expansion Packs Guide](docs/expansion-packs.md) and learn to create your own! ## Codebase Flattener Tool -The BMad-Method includes a powerful codebase flattener tool designed to prepare your project files for AI model consumption. This tool aggregates your entire codebase into a single XML file, making it easy to share your project context with AI assistants for analysis, debugging, or development assistance. +The BMAD-METHOD™ includes a powerful codebase flattener tool designed to prepare your project files for AI model consumption. This tool aggregates your entire codebase into a single XML file, making it easy to share your project context with AI assistants for analysis, debugging, or development assistance. ### Features @@ -157,7 +157,7 @@ The tool will display progress and provide a comprehensive summary: 📊 File breakdown: 142 text, 14 binary, 0 errors ``` -The generated XML file contains your project's text-based source files in a structured format that AI models can easily parse and understand, making it perfect for code reviews, architecture discussions, or getting AI assistance with your BMad-Method projects. +The generated XML file contains your project's text-based source files in a structured format that AI models can easily parse and understand, making it perfect for code reviews, architecture discussions, or getting AI assistance with your BMAD-METHOD™ projects. #### Advanced Usage & Options @@ -216,6 +216,10 @@ The generated XML file contains your project's text-based source files in a stru MIT License - see [LICENSE](LICENSE) for details. +## Trademark Notice + +BMAD™ and BMAD-METHOD™ are trademarks of BMad Code, LLC. All rights reserved. + [![Contributors](https://contrib.rocks/image?repo=bmadcode/bmad-method)](https://github.com/bmadcode/bmad-method/graphs/contributors) Built with ❤️ for the AI-assisted development community diff --git a/bmad-core/agent-teams/team-all.yaml b/bmad-core/agent-teams/team-all.yaml index 7503a0a7..1f3a671c 100644 --- a/bmad-core/agent-teams/team-all.yaml +++ b/bmad-core/agent-teams/team-all.yaml @@ -1,3 +1,4 @@ +# bundle: name: Team All icon: 👥 diff --git a/bmad-core/agent-teams/team-fullstack.yaml b/bmad-core/agent-teams/team-fullstack.yaml index e75a7201..531f5e7e 100644 --- a/bmad-core/agent-teams/team-fullstack.yaml +++ b/bmad-core/agent-teams/team-fullstack.yaml @@ -1,3 +1,4 @@ +# bundle: name: Team Fullstack icon: 🚀 diff --git a/bmad-core/agent-teams/team-ide-minimal.yaml b/bmad-core/agent-teams/team-ide-minimal.yaml index 51c843ee..f2dbec3e 100644 --- a/bmad-core/agent-teams/team-ide-minimal.yaml +++ b/bmad-core/agent-teams/team-ide-minimal.yaml @@ -1,3 +1,4 @@ +# bundle: name: Team IDE Minimal icon: ⚡ diff --git a/bmad-core/agent-teams/team-no-ui.yaml b/bmad-core/agent-teams/team-no-ui.yaml index a8cd4924..96ab3e3e 100644 --- a/bmad-core/agent-teams/team-no-ui.yaml +++ b/bmad-core/agent-teams/team-no-ui.yaml @@ -1,3 +1,4 @@ +# bundle: name: Team No UI icon: 🔧 diff --git a/bmad-core/agents/analyst.md b/bmad-core/agents/analyst.md index 64dc4f09..6dea41c9 100644 --- a/bmad-core/agents/analyst.md +++ b/bmad-core/agents/analyst.md @@ -1,3 +1,5 @@ + + # analyst ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below. diff --git a/bmad-core/agents/architect.md b/bmad-core/agents/architect.md index a5601d97..4814d59e 100644 --- a/bmad-core/agents/architect.md +++ b/bmad-core/agents/architect.md @@ -1,3 +1,5 @@ + + # architect ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below. diff --git a/bmad-core/agents/bmad-master.md b/bmad-core/agents/bmad-master.md index f6dadee1..3aeb3b63 100644 --- a/bmad-core/agents/bmad-master.md +++ b/bmad-core/agents/bmad-master.md @@ -1,3 +1,5 @@ + + # BMad Master ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below. diff --git a/bmad-core/agents/bmad-orchestrator.md b/bmad-core/agents/bmad-orchestrator.md index a32daaef..f4ed590a 100644 --- a/bmad-core/agents/bmad-orchestrator.md +++ b/bmad-core/agents/bmad-orchestrator.md @@ -1,3 +1,5 @@ + + # BMad Web Orchestrator ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below. diff --git a/bmad-core/agents/dev.md b/bmad-core/agents/dev.md index 19a67ec1..f04c438c 100644 --- a/bmad-core/agents/dev.md +++ b/bmad-core/agents/dev.md @@ -1,3 +1,5 @@ + + # dev ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below. diff --git a/bmad-core/agents/pm.md b/bmad-core/agents/pm.md index 18a92cba..1f8fc203 100644 --- a/bmad-core/agents/pm.md +++ b/bmad-core/agents/pm.md @@ -1,3 +1,5 @@ + + # pm ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below. diff --git a/bmad-core/agents/po.md b/bmad-core/agents/po.md index 629b8455..a1c3be8b 100644 --- a/bmad-core/agents/po.md +++ b/bmad-core/agents/po.md @@ -1,3 +1,5 @@ + + # po ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below. diff --git a/bmad-core/agents/qa.md b/bmad-core/agents/qa.md index 6ffde53f..6d787635 100644 --- a/bmad-core/agents/qa.md +++ b/bmad-core/agents/qa.md @@ -1,3 +1,5 @@ + + # qa ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below. diff --git a/bmad-core/agents/sm.md b/bmad-core/agents/sm.md index df19221d..bca0c4f5 100644 --- a/bmad-core/agents/sm.md +++ b/bmad-core/agents/sm.md @@ -1,3 +1,5 @@ + + # sm ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below. diff --git a/bmad-core/agents/ux-expert.md b/bmad-core/agents/ux-expert.md index e20fd384..47f36b23 100644 --- a/bmad-core/agents/ux-expert.md +++ b/bmad-core/agents/ux-expert.md @@ -1,3 +1,5 @@ + + # ux-expert ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below. diff --git a/bmad-core/checklists/architect-checklist.md b/bmad-core/checklists/architect-checklist.md index 40786945..03507f59 100644 --- a/bmad-core/checklists/architect-checklist.md +++ b/bmad-core/checklists/architect-checklist.md @@ -1,3 +1,5 @@ + + # Architect Solution Validation Checklist This checklist serves as a comprehensive framework for the Architect to validate the technical design and architecture before development execution. The Architect should systematically work through each item, ensuring the architecture is robust, scalable, secure, and aligned with the product requirements. diff --git a/bmad-core/checklists/change-checklist.md b/bmad-core/checklists/change-checklist.md index 14686b02..9bb457be 100644 --- a/bmad-core/checklists/change-checklist.md +++ b/bmad-core/checklists/change-checklist.md @@ -1,3 +1,5 @@ + + # Change Navigation Checklist **Purpose:** To systematically guide the selected Agent and user through the analysis and planning required when a significant change (pivot, tech issue, missing requirement, failed story) is identified during the BMad workflow. diff --git a/bmad-core/checklists/pm-checklist.md b/bmad-core/checklists/pm-checklist.md index 9eb17980..6b0408a1 100644 --- a/bmad-core/checklists/pm-checklist.md +++ b/bmad-core/checklists/pm-checklist.md @@ -1,3 +1,5 @@ + + # Product Manager (PM) Requirements Checklist This checklist serves as a comprehensive framework to ensure the Product Requirements Document (PRD) and Epic definitions are complete, well-structured, and appropriately scoped for MVP development. The PM should systematically work through each item during the product definition process. diff --git a/bmad-core/checklists/po-master-checklist.md b/bmad-core/checklists/po-master-checklist.md index bd591e19..d0c7aeca 100644 --- a/bmad-core/checklists/po-master-checklist.md +++ b/bmad-core/checklists/po-master-checklist.md @@ -1,3 +1,5 @@ + + # Product Owner (PO) Master Validation Checklist This checklist serves as a comprehensive framework for the Product Owner to validate project plans before development execution. It adapts intelligently based on project type (greenfield vs brownfield) and includes UI/UX considerations when applicable. diff --git a/bmad-core/checklists/story-dod-checklist.md b/bmad-core/checklists/story-dod-checklist.md index 62855f6c..7ed54760 100644 --- a/bmad-core/checklists/story-dod-checklist.md +++ b/bmad-core/checklists/story-dod-checklist.md @@ -1,3 +1,5 @@ + + # Story Definition of Done (DoD) Checklist ## Instructions for Developer Agent diff --git a/bmad-core/checklists/story-draft-checklist.md b/bmad-core/checklists/story-draft-checklist.md index e39e0657..ff4a8fe2 100644 --- a/bmad-core/checklists/story-draft-checklist.md +++ b/bmad-core/checklists/story-draft-checklist.md @@ -1,3 +1,5 @@ + + # Story Draft Checklist The Scrum Master should use this checklist to validate that each story contains sufficient context for a developer agent to implement it successfully, while assuming the dev agent has reasonable capabilities to figure things out. diff --git a/bmad-core/core-config.yaml b/bmad-core/core-config.yaml index f94d5810..5564b6a5 100644 --- a/bmad-core/core-config.yaml +++ b/bmad-core/core-config.yaml @@ -1,3 +1,4 @@ +# markdownExploder: true qa: qaLocation: docs/qa diff --git a/bmad-core/data/bmad-kb.md b/bmad-core/data/bmad-kb.md index 92ff765c..04d3b5f9 100644 --- a/bmad-core/data/bmad-kb.md +++ b/bmad-core/data/bmad-kb.md @@ -1,8 +1,10 @@ -# BMad Knowledge Base + + +# BMAD™ Knowledge Base ## Overview -BMad-Method (Breakthrough Method of Agile AI-driven Development) is a framework that combines AI agents with Agile development methodologies. The v4 system introduces a modular architecture with improved dependency management, bundle optimization, and support for both web and IDE environments. +BMAD-METHOD™ (Breakthrough Method of Agile AI-driven Development) is a framework that combines AI agents with Agile development methodologies. The v4 system introduces a modular architecture with improved dependency management, bundle optimization, and support for both web and IDE environments. ### Key Features @@ -101,7 +103,7 @@ npx bmad-method install - **Roo Code**: Web-based IDE with agent support - **GitHub Copilot**: VS Code extension with AI peer programming assistant -**Note for VS Code Users**: BMad-Method assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMad agents. The installer includes built-in support for Cline and Roo. +**Note for VS Code Users**: BMAD-METHOD™ assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMad agents. The installer includes built-in support for Cline and Roo. **Verify Installation**: @@ -109,7 +111,7 @@ npx bmad-method install - IDE-specific integration files created - All agent commands/rules/modes available -**Remember**: At its core, BMad-Method is about mastering and harnessing prompt engineering. Any IDE with AI agent support can use BMad - the framework provides the structured prompts and workflows that make AI development effective +**Remember**: At its core, BMAD-METHOD™ is about mastering and harnessing prompt engineering. Any IDE with AI agent support can use BMad - the framework provides the structured prompts and workflows that make AI development effective ### Environment Selection Guide @@ -353,7 +355,7 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing ### System Overview -The BMad-Method is built around a modular architecture centered on the `bmad-core` directory, which serves as the brain of the entire system. This design enables the framework to operate effectively in both IDE environments (like Cursor, VS Code) and web-based AI interfaces (like ChatGPT, Gemini). +The BMAD-METHOD™ is built around a modular architecture centered on the `bmad-core` directory, which serves as the brain of the entire system. This design enables the framework to operate effectively in both IDE environments (like Cursor, VS Code) and web-based AI interfaces (like ChatGPT, Gemini). ### Key Architectural Components @@ -708,7 +710,7 @@ Use the `shard-doc` task or `@kayvan/markdown-tree-parser` tool for automatic sh - **Keep conversations focused** - One agent, one task per conversation - **Review everything** - Always review and approve before marking complete -## Contributing to BMad-Method +## Contributing to BMAD-METHOD™ ### Quick Contribution Guidelines @@ -740,7 +742,7 @@ For full details, see `CONTRIBUTING.md`. Key points: ### What Are Expansion Packs? -Expansion packs extend BMad-Method beyond traditional software development into ANY domain. They provide specialized agent teams, templates, and workflows while keeping the core framework lean and focused on development. +Expansion packs extend BMAD-METHOD™ beyond traditional software development into ANY domain. They provide specialized agent teams, templates, and workflows while keeping the core framework lean and focused on development. ### Why Use Expansion Packs? diff --git a/bmad-core/data/brainstorming-techniques.md b/bmad-core/data/brainstorming-techniques.md index 3b17b2ec..0912f8e9 100644 --- a/bmad-core/data/brainstorming-techniques.md +++ b/bmad-core/data/brainstorming-techniques.md @@ -1,3 +1,5 @@ + + # Brainstorming Techniques Data ## Creative Expansion diff --git a/bmad-core/data/elicitation-methods.md b/bmad-core/data/elicitation-methods.md index ec657a8b..b0e34749 100644 --- a/bmad-core/data/elicitation-methods.md +++ b/bmad-core/data/elicitation-methods.md @@ -1,3 +1,5 @@ + + # Elicitation Methods Data ## Core Reflective Methods diff --git a/bmad-core/data/technical-preferences.md b/bmad-core/data/technical-preferences.md index 2eb79b4d..7f3e1905 100644 --- a/bmad-core/data/technical-preferences.md +++ b/bmad-core/data/technical-preferences.md @@ -1,3 +1,5 @@ + + # User-Defined Preferred Patterns and Preferences None Listed diff --git a/bmad-core/data/test-levels-framework.md b/bmad-core/data/test-levels-framework.md index 57b49003..2c4cf48f 100644 --- a/bmad-core/data/test-levels-framework.md +++ b/bmad-core/data/test-levels-framework.md @@ -1,3 +1,5 @@ + + # Test Levels Framework Comprehensive guide for determining appropriate test levels (unit, integration, E2E) for different scenarios. diff --git a/bmad-core/data/test-priorities-matrix.md b/bmad-core/data/test-priorities-matrix.md index 7463ef9b..14532592 100644 --- a/bmad-core/data/test-priorities-matrix.md +++ b/bmad-core/data/test-priorities-matrix.md @@ -1,3 +1,5 @@ + + # Test Priorities Matrix Guide for prioritizing test scenarios based on risk, criticality, and business impact. diff --git a/bmad-core/tasks/advanced-elicitation.md b/bmad-core/tasks/advanced-elicitation.md index 2876a846..f9bb9688 100644 --- a/bmad-core/tasks/advanced-elicitation.md +++ b/bmad-core/tasks/advanced-elicitation.md @@ -1,3 +1,5 @@ + + # Advanced Elicitation Task ## Purpose diff --git a/bmad-core/tasks/apply-qa-fixes.md b/bmad-core/tasks/apply-qa-fixes.md index 478eab7b..ffbb9556 100644 --- a/bmad-core/tasks/apply-qa-fixes.md +++ b/bmad-core/tasks/apply-qa-fixes.md @@ -1,3 +1,5 @@ + + # apply-qa-fixes Implement fixes based on QA results (gate and assessments) for a specific story. This task is for the Dev agent to systematically consume QA outputs and apply code/test changes while only updating allowed sections in the story file. diff --git a/bmad-core/tasks/brownfield-create-epic.md b/bmad-core/tasks/brownfield-create-epic.md index 7390d5a7..9a23e84d 100644 --- a/bmad-core/tasks/brownfield-create-epic.md +++ b/bmad-core/tasks/brownfield-create-epic.md @@ -1,3 +1,5 @@ + + # Create Brownfield Epic Task ## Purpose diff --git a/bmad-core/tasks/brownfield-create-story.md b/bmad-core/tasks/brownfield-create-story.md index 5984001d..72247821 100644 --- a/bmad-core/tasks/brownfield-create-story.md +++ b/bmad-core/tasks/brownfield-create-story.md @@ -1,3 +1,5 @@ + + # Create Brownfield Story Task ## Purpose diff --git a/bmad-core/tasks/correct-course.md b/bmad-core/tasks/correct-course.md index 9251b9fc..78e68ac7 100644 --- a/bmad-core/tasks/correct-course.md +++ b/bmad-core/tasks/correct-course.md @@ -1,3 +1,5 @@ + + # Correct Course Task ## Purpose diff --git a/bmad-core/tasks/create-brownfield-story.md b/bmad-core/tasks/create-brownfield-story.md index 0ff1f54c..d7160709 100644 --- a/bmad-core/tasks/create-brownfield-story.md +++ b/bmad-core/tasks/create-brownfield-story.md @@ -1,3 +1,5 @@ + + # Create Brownfield Story Task ## Purpose diff --git a/bmad-core/tasks/create-deep-research-prompt.md b/bmad-core/tasks/create-deep-research-prompt.md index 29ce373b..50ea88b4 100644 --- a/bmad-core/tasks/create-deep-research-prompt.md +++ b/bmad-core/tasks/create-deep-research-prompt.md @@ -1,3 +1,5 @@ + + # Create Deep Research Prompt Task This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation. diff --git a/bmad-core/tasks/create-next-story.md b/bmad-core/tasks/create-next-story.md index c7205c87..d6ffc752 100644 --- a/bmad-core/tasks/create-next-story.md +++ b/bmad-core/tasks/create-next-story.md @@ -1,3 +1,5 @@ + + # Create Next Story Task ## Purpose diff --git a/bmad-core/tasks/document-project.md b/bmad-core/tasks/document-project.md index ee33c301..300fea11 100644 --- a/bmad-core/tasks/document-project.md +++ b/bmad-core/tasks/document-project.md @@ -1,3 +1,5 @@ + + # Document an Existing Project ## Purpose diff --git a/bmad-core/tasks/facilitate-brainstorming-session.md b/bmad-core/tasks/facilitate-brainstorming-session.md index ce9fb25d..3cbe9cf6 100644 --- a/bmad-core/tasks/facilitate-brainstorming-session.md +++ b/bmad-core/tasks/facilitate-brainstorming-session.md @@ -1,6 +1,8 @@ ---- +## + docOutputLocation: docs/brainstorming-session-results.md template: '{root}/templates/brainstorming-output-tmpl.yaml' + --- # Facilitate Brainstorming Session Task diff --git a/bmad-core/tasks/generate-ai-frontend-prompt.md b/bmad-core/tasks/generate-ai-frontend-prompt.md index 7966d0c0..85950bd2 100644 --- a/bmad-core/tasks/generate-ai-frontend-prompt.md +++ b/bmad-core/tasks/generate-ai-frontend-prompt.md @@ -1,3 +1,5 @@ + + # Create AI Frontend Prompt Task ## Purpose diff --git a/bmad-core/tasks/index-docs.md b/bmad-core/tasks/index-docs.md index bf47d28c..cb551b23 100644 --- a/bmad-core/tasks/index-docs.md +++ b/bmad-core/tasks/index-docs.md @@ -1,3 +1,5 @@ + + # Index Documentation Task ## Purpose diff --git a/bmad-core/tasks/kb-mode-interaction.md b/bmad-core/tasks/kb-mode-interaction.md index be731330..dd6c939c 100644 --- a/bmad-core/tasks/kb-mode-interaction.md +++ b/bmad-core/tasks/kb-mode-interaction.md @@ -1,3 +1,5 @@ + + # KB Mode Interaction Task ## Purpose diff --git a/bmad-core/tasks/nfr-assess.md b/bmad-core/tasks/nfr-assess.md index c3f87874..337ef075 100644 --- a/bmad-core/tasks/nfr-assess.md +++ b/bmad-core/tasks/nfr-assess.md @@ -1,3 +1,5 @@ + + # nfr-assess Quick NFR validation focused on the core four: security, performance, reliability, maintainability. diff --git a/bmad-core/tasks/qa-gate.md b/bmad-core/tasks/qa-gate.md index b8511c9b..446864c2 100644 --- a/bmad-core/tasks/qa-gate.md +++ b/bmad-core/tasks/qa-gate.md @@ -1,3 +1,5 @@ + + # qa-gate Create or update a quality gate decision file for a story based on review findings. diff --git a/bmad-core/tasks/review-story.md b/bmad-core/tasks/review-story.md index 12882ea7..8360e443 100644 --- a/bmad-core/tasks/review-story.md +++ b/bmad-core/tasks/review-story.md @@ -1,3 +1,5 @@ + + # review-story Perform a comprehensive test architecture review with quality gate decision. This adaptive, risk-aware review creates both a story update and a detailed gate file. diff --git a/bmad-core/tasks/risk-profile.md b/bmad-core/tasks/risk-profile.md index 00b06ad9..30389cc1 100644 --- a/bmad-core/tasks/risk-profile.md +++ b/bmad-core/tasks/risk-profile.md @@ -1,3 +1,5 @@ + + # risk-profile Generate a comprehensive risk assessment matrix for a story implementation using probability × impact analysis. diff --git a/bmad-core/tasks/shard-doc.md b/bmad-core/tasks/shard-doc.md index aa9e95bb..900616a8 100644 --- a/bmad-core/tasks/shard-doc.md +++ b/bmad-core/tasks/shard-doc.md @@ -1,3 +1,5 @@ + + # Document Sharding Task ## Purpose diff --git a/bmad-core/tasks/test-design.md b/bmad-core/tasks/test-design.md index 7c0fcd5d..6f569d89 100644 --- a/bmad-core/tasks/test-design.md +++ b/bmad-core/tasks/test-design.md @@ -1,3 +1,5 @@ + + # test-design Create comprehensive test scenarios with appropriate test level recommendations for story implementation. diff --git a/bmad-core/tasks/trace-requirements.md b/bmad-core/tasks/trace-requirements.md index eee43263..faf135e9 100644 --- a/bmad-core/tasks/trace-requirements.md +++ b/bmad-core/tasks/trace-requirements.md @@ -1,3 +1,5 @@ + + # trace-requirements Map story requirements to test cases using Given-When-Then patterns for comprehensive traceability. diff --git a/bmad-core/tasks/validate-next-story.md b/bmad-core/tasks/validate-next-story.md index 6ac49a1c..fb7688d9 100644 --- a/bmad-core/tasks/validate-next-story.md +++ b/bmad-core/tasks/validate-next-story.md @@ -1,3 +1,5 @@ + + # Validate Next Story Task ## Purpose diff --git a/bmad-core/templates/architecture-tmpl.yaml b/bmad-core/templates/architecture-tmpl.yaml index 103f645a..f5d508aa 100644 --- a/bmad-core/templates/architecture-tmpl.yaml +++ b/bmad-core/templates/architecture-tmpl.yaml @@ -1,3 +1,4 @@ +# template: id: architecture-template-v2 name: Architecture Document diff --git a/bmad-core/templates/brainstorming-output-tmpl.yaml b/bmad-core/templates/brainstorming-output-tmpl.yaml index e1151fee..e6e962fe 100644 --- a/bmad-core/templates/brainstorming-output-tmpl.yaml +++ b/bmad-core/templates/brainstorming-output-tmpl.yaml @@ -153,4 +153,4 @@ sections: content: | --- - *Session facilitated using the BMAD-METHOD brainstorming framework* + *Session facilitated using the BMAD-METHOD™ brainstorming framework* diff --git a/bmad-core/templates/brownfield-architecture-tmpl.yaml b/bmad-core/templates/brownfield-architecture-tmpl.yaml index 066ebbd5..259c6161 100644 --- a/bmad-core/templates/brownfield-architecture-tmpl.yaml +++ b/bmad-core/templates/brownfield-architecture-tmpl.yaml @@ -1,3 +1,4 @@ +# template: id: brownfield-architecture-template-v2 name: Brownfield Enhancement Architecture diff --git a/bmad-core/templates/brownfield-prd-tmpl.yaml b/bmad-core/templates/brownfield-prd-tmpl.yaml index 1feef7ea..3df90c5e 100644 --- a/bmad-core/templates/brownfield-prd-tmpl.yaml +++ b/bmad-core/templates/brownfield-prd-tmpl.yaml @@ -1,3 +1,4 @@ +# template: id: brownfield-prd-template-v2 name: Brownfield Enhancement PRD diff --git a/bmad-core/templates/competitor-analysis-tmpl.yaml b/bmad-core/templates/competitor-analysis-tmpl.yaml index a6a599ac..64070e06 100644 --- a/bmad-core/templates/competitor-analysis-tmpl.yaml +++ b/bmad-core/templates/competitor-analysis-tmpl.yaml @@ -1,3 +1,4 @@ +# template: id: competitor-analysis-template-v2 name: Competitive Analysis Report diff --git a/bmad-core/templates/front-end-architecture-tmpl.yaml b/bmad-core/templates/front-end-architecture-tmpl.yaml index eb7f3da8..4ef2db43 100644 --- a/bmad-core/templates/front-end-architecture-tmpl.yaml +++ b/bmad-core/templates/front-end-architecture-tmpl.yaml @@ -1,3 +1,4 @@ +# template: id: frontend-architecture-template-v2 name: Frontend Architecture Document diff --git a/bmad-core/templates/front-end-spec-tmpl.yaml b/bmad-core/templates/front-end-spec-tmpl.yaml index af56c9f3..1cb8179a 100644 --- a/bmad-core/templates/front-end-spec-tmpl.yaml +++ b/bmad-core/templates/front-end-spec-tmpl.yaml @@ -1,3 +1,4 @@ +# template: id: frontend-spec-template-v2 name: UI/UX Specification diff --git a/bmad-core/templates/fullstack-architecture-tmpl.yaml b/bmad-core/templates/fullstack-architecture-tmpl.yaml index 94d30458..a5d2c1d3 100644 --- a/bmad-core/templates/fullstack-architecture-tmpl.yaml +++ b/bmad-core/templates/fullstack-architecture-tmpl.yaml @@ -1,3 +1,4 @@ +# template: id: fullstack-architecture-template-v2 name: Fullstack Architecture Document diff --git a/bmad-core/templates/market-research-tmpl.yaml b/bmad-core/templates/market-research-tmpl.yaml index 4ba50d2a..2b08aabe 100644 --- a/bmad-core/templates/market-research-tmpl.yaml +++ b/bmad-core/templates/market-research-tmpl.yaml @@ -1,3 +1,4 @@ +# template: id: market-research-template-v2 name: Market Research Report diff --git a/bmad-core/templates/prd-tmpl.yaml b/bmad-core/templates/prd-tmpl.yaml index c14607b5..804f6d45 100644 --- a/bmad-core/templates/prd-tmpl.yaml +++ b/bmad-core/templates/prd-tmpl.yaml @@ -1,3 +1,4 @@ +# template: id: prd-template-v2 name: Product Requirements Document diff --git a/bmad-core/templates/project-brief-tmpl.yaml b/bmad-core/templates/project-brief-tmpl.yaml index 1a888c61..311690a7 100644 --- a/bmad-core/templates/project-brief-tmpl.yaml +++ b/bmad-core/templates/project-brief-tmpl.yaml @@ -1,3 +1,4 @@ +# template: id: project-brief-template-v2 name: Project Brief diff --git a/bmad-core/templates/qa-gate-tmpl.yaml b/bmad-core/templates/qa-gate-tmpl.yaml index 8ba1f4e5..60f1ac2f 100644 --- a/bmad-core/templates/qa-gate-tmpl.yaml +++ b/bmad-core/templates/qa-gate-tmpl.yaml @@ -1,3 +1,4 @@ +# template: id: qa-gate-template-v1 name: Quality Gate Decision diff --git a/bmad-core/templates/story-tmpl.yaml b/bmad-core/templates/story-tmpl.yaml index 5f7b78c1..6f3e33cc 100644 --- a/bmad-core/templates/story-tmpl.yaml +++ b/bmad-core/templates/story-tmpl.yaml @@ -1,3 +1,4 @@ +# template: id: story-template-v2 name: Story Document diff --git a/bmad-core/workflows/brownfield-fullstack.yaml b/bmad-core/workflows/brownfield-fullstack.yaml index 33ea1637..6a7d7d87 100644 --- a/bmad-core/workflows/brownfield-fullstack.yaml +++ b/bmad-core/workflows/brownfield-fullstack.yaml @@ -1,3 +1,4 @@ +# workflow: id: brownfield-fullstack name: Brownfield Full-Stack Enhancement diff --git a/bmad-core/workflows/brownfield-service.yaml b/bmad-core/workflows/brownfield-service.yaml index 711277ee..e2af23de 100644 --- a/bmad-core/workflows/brownfield-service.yaml +++ b/bmad-core/workflows/brownfield-service.yaml @@ -1,3 +1,4 @@ +# workflow: id: brownfield-service name: Brownfield Service/API Enhancement diff --git a/bmad-core/workflows/brownfield-ui.yaml b/bmad-core/workflows/brownfield-ui.yaml index 6daa2c98..4a9ffd76 100644 --- a/bmad-core/workflows/brownfield-ui.yaml +++ b/bmad-core/workflows/brownfield-ui.yaml @@ -1,3 +1,4 @@ +# workflow: id: brownfield-ui name: Brownfield UI/Frontend Enhancement diff --git a/bmad-core/workflows/greenfield-fullstack.yaml b/bmad-core/workflows/greenfield-fullstack.yaml index 3ec57cca..1425d9f2 100644 --- a/bmad-core/workflows/greenfield-fullstack.yaml +++ b/bmad-core/workflows/greenfield-fullstack.yaml @@ -1,3 +1,4 @@ +# workflow: id: greenfield-fullstack name: Greenfield Full-Stack Application Development diff --git a/bmad-core/workflows/greenfield-service.yaml b/bmad-core/workflows/greenfield-service.yaml index 769f8240..c30c0132 100644 --- a/bmad-core/workflows/greenfield-service.yaml +++ b/bmad-core/workflows/greenfield-service.yaml @@ -1,3 +1,4 @@ +# workflow: id: greenfield-service name: Greenfield Service/API Development diff --git a/bmad-core/workflows/greenfield-ui.yaml b/bmad-core/workflows/greenfield-ui.yaml index 52d7f3af..2b3e5f46 100644 --- a/bmad-core/workflows/greenfield-ui.yaml +++ b/bmad-core/workflows/greenfield-ui.yaml @@ -1,3 +1,4 @@ +# workflow: id: greenfield-ui name: Greenfield UI/Frontend Development diff --git a/common/tasks/create-doc.md b/common/tasks/create-doc.md index bb02e4ba..a3d62b44 100644 --- a/common/tasks/create-doc.md +++ b/common/tasks/create-doc.md @@ -1,3 +1,5 @@ + + # Create Document from Template (YAML Driven) ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️ diff --git a/common/tasks/execute-checklist.md b/common/tasks/execute-checklist.md index 4ff83f79..0b26e04c 100644 --- a/common/tasks/execute-checklist.md +++ b/common/tasks/execute-checklist.md @@ -1,3 +1,5 @@ + + # 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. diff --git a/common/utils/bmad-doc-template.md b/common/utils/bmad-doc-template.md index 7f6f3c89..0bd6b9ac 100644 --- a/common/utils/bmad-doc-template.md +++ b/common/utils/bmad-doc-template.md @@ -1,3 +1,5 @@ + + # BMad Document Template Specification ## Overview diff --git a/common/utils/workflow-management.md b/common/utils/workflow-management.md index 1e7f60c8..344d880f 100644 --- a/common/utils/workflow-management.md +++ b/common/utils/workflow-management.md @@ -1,3 +1,5 @@ + + # Workflow Management Enables BMad orchestrator to manage and execute team workflows. diff --git a/dist/agents/analyst.txt b/dist/agents/analyst.txt index 05235fb5..03be8d8b 100644 --- a/dist/agents/analyst.txt +++ b/dist/agents/analyst.txt @@ -104,6 +104,7 @@ dependencies: ==================== END: .bmad-core/agents/analyst.md ==================== ==================== START: .bmad-core/tasks/advanced-elicitation.md ==================== + # Advanced Elicitation Task ## Purpose @@ -224,6 +225,7 @@ Choose a number (0-8) or 9 to proceed: ==================== END: .bmad-core/tasks/advanced-elicitation.md ==================== ==================== START: .bmad-core/tasks/create-deep-research-prompt.md ==================== + # Create Deep Research Prompt Task This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation. @@ -505,6 +507,7 @@ CRITICAL: collaborate with the user to develop specific, actionable research que ==================== END: .bmad-core/tasks/create-deep-research-prompt.md ==================== ==================== START: .bmad-core/tasks/create-doc.md ==================== + # Create Document from Template (YAML Driven) ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️ @@ -609,6 +612,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once). ==================== END: .bmad-core/tasks/create-doc.md ==================== ==================== START: .bmad-core/tasks/document-project.md ==================== + # Document an Existing Project ## Purpose @@ -955,6 +959,7 @@ Apply the advanced elicitation task after major sections to refine based on user ==================== END: .bmad-core/tasks/document-project.md ==================== ==================== START: .bmad-core/tasks/facilitate-brainstorming-session.md ==================== + --- docOutputLocation: docs/brainstorming-session-results.md template: '.bmad-core/templates/brainstorming-output-tmpl.yaml' @@ -1249,10 +1254,11 @@ sections: content: | --- - *Session facilitated using the BMAD-METHOD brainstorming framework* + *Session facilitated using the BMAD-METHOD™ brainstorming framework* ==================== END: .bmad-core/templates/brainstorming-output-tmpl.yaml ==================== ==================== START: .bmad-core/templates/competitor-analysis-tmpl.yaml ==================== +# template: id: competitor-analysis-template-v2 name: Competitive Analysis Report @@ -1562,6 +1568,7 @@ sections: ==================== END: .bmad-core/templates/competitor-analysis-tmpl.yaml ==================== ==================== START: .bmad-core/templates/market-research-tmpl.yaml ==================== +# template: id: market-research-template-v2 name: Market Research Report @@ -1817,6 +1824,7 @@ sections: ==================== END: .bmad-core/templates/market-research-tmpl.yaml ==================== ==================== START: .bmad-core/templates/project-brief-tmpl.yaml ==================== +# template: id: project-brief-template-v2 name: Project Brief @@ -2041,11 +2049,12 @@ sections: ==================== END: .bmad-core/templates/project-brief-tmpl.yaml ==================== ==================== START: .bmad-core/data/bmad-kb.md ==================== -# BMad Knowledge Base + +# BMAD™ Knowledge Base ## Overview -BMad-Method (Breakthrough Method of Agile AI-driven Development) is a framework that combines AI agents with Agile development methodologies. The v4 system introduces a modular architecture with improved dependency management, bundle optimization, and support for both web and IDE environments. +BMAD-METHOD™ (Breakthrough Method of Agile AI-driven Development) is a framework that combines AI agents with Agile development methodologies. The v4 system introduces a modular architecture with improved dependency management, bundle optimization, and support for both web and IDE environments. ### Key Features @@ -2144,7 +2153,7 @@ npx bmad-method install - **Roo Code**: Web-based IDE with agent support - **GitHub Copilot**: VS Code extension with AI peer programming assistant -**Note for VS Code Users**: BMad-Method assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMad agents. The installer includes built-in support for Cline and Roo. +**Note for VS Code Users**: BMAD-METHOD™ assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMad agents. The installer includes built-in support for Cline and Roo. **Verify Installation**: @@ -2152,7 +2161,7 @@ npx bmad-method install - IDE-specific integration files created - All agent commands/rules/modes available -**Remember**: At its core, BMad-Method is about mastering and harnessing prompt engineering. Any IDE with AI agent support can use BMad - the framework provides the structured prompts and workflows that make AI development effective +**Remember**: At its core, BMAD-METHOD™ is about mastering and harnessing prompt engineering. Any IDE with AI agent support can use BMad - the framework provides the structured prompts and workflows that make AI development effective ### Environment Selection Guide @@ -2396,7 +2405,7 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing ### System Overview -The BMad-Method is built around a modular architecture centered on the `bmad-core` directory, which serves as the brain of the entire system. This design enables the framework to operate effectively in both IDE environments (like Cursor, VS Code) and web-based AI interfaces (like ChatGPT, Gemini). +The BMAD-METHOD™ is built around a modular architecture centered on the `bmad-core` directory, which serves as the brain of the entire system. This design enables the framework to operate effectively in both IDE environments (like Cursor, VS Code) and web-based AI interfaces (like ChatGPT, Gemini). ### Key Architectural Components @@ -2751,7 +2760,7 @@ Use the `shard-doc` task or `@kayvan/markdown-tree-parser` tool for automatic sh - **Keep conversations focused** - One agent, one task per conversation - **Review everything** - Always review and approve before marking complete -## Contributing to BMad-Method +## Contributing to BMAD-METHOD™ ### Quick Contribution Guidelines @@ -2783,7 +2792,7 @@ For full details, see `CONTRIBUTING.md`. Key points: ### What Are Expansion Packs? -Expansion packs extend BMad-Method beyond traditional software development into ANY domain. They provide specialized agent teams, templates, and workflows while keeping the core framework lean and focused on development. +Expansion packs extend BMAD-METHOD™ beyond traditional software development into ANY domain. They provide specialized agent teams, templates, and workflows while keeping the core framework lean and focused on development. ### Why Use Expansion Packs? @@ -2850,6 +2859,7 @@ Use the **expansion-creator** pack to build your own: ==================== END: .bmad-core/data/bmad-kb.md ==================== ==================== START: .bmad-core/data/brainstorming-techniques.md ==================== + # Brainstorming Techniques Data ## Creative Expansion diff --git a/dist/agents/architect.txt b/dist/agents/architect.txt index fd98da4e..992cbfbe 100644 --- a/dist/agents/architect.txt +++ b/dist/agents/architect.txt @@ -105,6 +105,7 @@ dependencies: ==================== END: .bmad-core/agents/architect.md ==================== ==================== START: .bmad-core/tasks/create-deep-research-prompt.md ==================== + # Create Deep Research Prompt Task This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation. @@ -386,6 +387,7 @@ CRITICAL: collaborate with the user to develop specific, actionable research que ==================== END: .bmad-core/tasks/create-deep-research-prompt.md ==================== ==================== START: .bmad-core/tasks/create-doc.md ==================== + # Create Document from Template (YAML Driven) ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️ @@ -490,6 +492,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once). ==================== END: .bmad-core/tasks/create-doc.md ==================== ==================== START: .bmad-core/tasks/document-project.md ==================== + # Document an Existing Project ## Purpose @@ -836,6 +839,7 @@ Apply the advanced elicitation task after major sections to refine based on user ==================== END: .bmad-core/tasks/document-project.md ==================== ==================== START: .bmad-core/tasks/execute-checklist.md ==================== + # 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. @@ -925,6 +929,7 @@ The LLM will: ==================== END: .bmad-core/tasks/execute-checklist.md ==================== ==================== START: .bmad-core/templates/architecture-tmpl.yaml ==================== +# template: id: architecture-template-v2 name: Architecture Document @@ -1578,6 +1583,7 @@ sections: ==================== END: .bmad-core/templates/architecture-tmpl.yaml ==================== ==================== START: .bmad-core/templates/brownfield-architecture-tmpl.yaml ==================== +# template: id: brownfield-architecture-template-v2 name: Brownfield Enhancement Architecture @@ -2057,6 +2063,7 @@ sections: ==================== END: .bmad-core/templates/brownfield-architecture-tmpl.yaml ==================== ==================== START: .bmad-core/templates/front-end-architecture-tmpl.yaml ==================== +# template: id: frontend-architecture-template-v2 name: Frontend Architecture Document @@ -2278,6 +2285,7 @@ sections: ==================== END: .bmad-core/templates/front-end-architecture-tmpl.yaml ==================== ==================== START: .bmad-core/templates/fullstack-architecture-tmpl.yaml ==================== +# template: id: fullstack-architecture-template-v2 name: Fullstack Architecture Document @@ -3104,6 +3112,7 @@ sections: ==================== END: .bmad-core/templates/fullstack-architecture-tmpl.yaml ==================== ==================== START: .bmad-core/checklists/architect-checklist.md ==================== + # Architect Solution Validation Checklist This checklist serves as a comprehensive framework for the Architect to validate the technical design and architecture before development execution. The Architect should systematically work through each item, ensuring the architecture is robust, scalable, secure, and aligned with the product requirements. @@ -3545,6 +3554,7 @@ After presenting the report, ask the user if they would like detailed analysis o ==================== END: .bmad-core/checklists/architect-checklist.md ==================== ==================== START: .bmad-core/data/technical-preferences.md ==================== + # User-Defined Preferred Patterns and Preferences None Listed diff --git a/dist/agents/bmad-master.txt b/dist/agents/bmad-master.txt index 0f7f4c4b..101f1386 100644 --- a/dist/agents/bmad-master.txt +++ b/dist/agents/bmad-master.txt @@ -127,6 +127,7 @@ dependencies: ==================== END: .bmad-core/agents/bmad-master.md ==================== ==================== START: .bmad-core/tasks/advanced-elicitation.md ==================== + # Advanced Elicitation Task ## Purpose @@ -247,6 +248,7 @@ Choose a number (0-8) or 9 to proceed: ==================== END: .bmad-core/tasks/advanced-elicitation.md ==================== ==================== START: .bmad-core/tasks/brownfield-create-epic.md ==================== + # Create Brownfield Epic Task ## Purpose @@ -410,6 +412,7 @@ The epic creation is successful when: ==================== END: .bmad-core/tasks/brownfield-create-epic.md ==================== ==================== START: .bmad-core/tasks/brownfield-create-story.md ==================== + # Create Brownfield Story Task ## Purpose @@ -560,6 +563,7 @@ The story creation is successful when: ==================== END: .bmad-core/tasks/brownfield-create-story.md ==================== ==================== START: .bmad-core/tasks/correct-course.md ==================== + # Correct Course Task ## Purpose @@ -633,6 +637,7 @@ The story creation is successful when: ==================== END: .bmad-core/tasks/correct-course.md ==================== ==================== START: .bmad-core/tasks/create-deep-research-prompt.md ==================== + # Create Deep Research Prompt Task This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation. @@ -914,6 +919,7 @@ CRITICAL: collaborate with the user to develop specific, actionable research que ==================== END: .bmad-core/tasks/create-deep-research-prompt.md ==================== ==================== START: .bmad-core/tasks/create-doc.md ==================== + # Create Document from Template (YAML Driven) ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️ @@ -1018,6 +1024,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once). ==================== END: .bmad-core/tasks/create-doc.md ==================== ==================== START: .bmad-core/tasks/create-next-story.md ==================== + # Create Next Story Task ## Purpose @@ -1133,6 +1140,7 @@ ALWAYS cite source documents: `[Source: architecture/{filename}.md#{section}]` ==================== END: .bmad-core/tasks/create-next-story.md ==================== ==================== START: .bmad-core/tasks/document-project.md ==================== + # Document an Existing Project ## Purpose @@ -1479,6 +1487,7 @@ Apply the advanced elicitation task after major sections to refine based on user ==================== END: .bmad-core/tasks/document-project.md ==================== ==================== START: .bmad-core/tasks/execute-checklist.md ==================== + # 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. @@ -1568,6 +1577,7 @@ The LLM will: ==================== END: .bmad-core/tasks/execute-checklist.md ==================== ==================== START: .bmad-core/tasks/facilitate-brainstorming-session.md ==================== + --- docOutputLocation: docs/brainstorming-session-results.md template: '.bmad-core/templates/brainstorming-output-tmpl.yaml' @@ -1707,6 +1717,7 @@ Generate structured document with these sections: ==================== END: .bmad-core/tasks/facilitate-brainstorming-session.md ==================== ==================== START: .bmad-core/tasks/generate-ai-frontend-prompt.md ==================== + # Create AI Frontend Prompt Task ## Purpose @@ -1761,6 +1772,7 @@ You will now synthesize the inputs and the above principles into a final, compre ==================== END: .bmad-core/tasks/generate-ai-frontend-prompt.md ==================== ==================== START: .bmad-core/tasks/index-docs.md ==================== + # Index Documentation Task ## Purpose @@ -1937,6 +1949,7 @@ Would you like to proceed with documentation indexing? Please provide the requir ==================== END: .bmad-core/tasks/index-docs.md ==================== ==================== START: .bmad-core/tasks/shard-doc.md ==================== + # Document Sharding Task ## Purpose @@ -2125,6 +2138,7 @@ Document sharded successfully: ==================== END: .bmad-core/tasks/shard-doc.md ==================== ==================== START: .bmad-core/templates/architecture-tmpl.yaml ==================== +# template: id: architecture-template-v2 name: Architecture Document @@ -2778,6 +2792,7 @@ sections: ==================== END: .bmad-core/templates/architecture-tmpl.yaml ==================== ==================== START: .bmad-core/templates/brownfield-architecture-tmpl.yaml ==================== +# template: id: brownfield-architecture-template-v2 name: Brownfield Enhancement Architecture @@ -3257,6 +3272,7 @@ sections: ==================== END: .bmad-core/templates/brownfield-architecture-tmpl.yaml ==================== ==================== START: .bmad-core/templates/brownfield-prd-tmpl.yaml ==================== +# template: id: brownfield-prd-template-v2 name: Brownfield Enhancement PRD @@ -3540,6 +3556,7 @@ sections: ==================== END: .bmad-core/templates/brownfield-prd-tmpl.yaml ==================== ==================== START: .bmad-core/templates/competitor-analysis-tmpl.yaml ==================== +# template: id: competitor-analysis-template-v2 name: Competitive Analysis Report @@ -3849,6 +3866,7 @@ sections: ==================== END: .bmad-core/templates/competitor-analysis-tmpl.yaml ==================== ==================== START: .bmad-core/templates/front-end-architecture-tmpl.yaml ==================== +# template: id: frontend-architecture-template-v2 name: Frontend Architecture Document @@ -4070,6 +4088,7 @@ sections: ==================== END: .bmad-core/templates/front-end-architecture-tmpl.yaml ==================== ==================== START: .bmad-core/templates/front-end-spec-tmpl.yaml ==================== +# template: id: frontend-spec-template-v2 name: UI/UX Specification @@ -4422,6 +4441,7 @@ sections: ==================== END: .bmad-core/templates/front-end-spec-tmpl.yaml ==================== ==================== START: .bmad-core/templates/fullstack-architecture-tmpl.yaml ==================== +# template: id: fullstack-architecture-template-v2 name: Fullstack Architecture Document @@ -5248,6 +5268,7 @@ sections: ==================== END: .bmad-core/templates/fullstack-architecture-tmpl.yaml ==================== ==================== START: .bmad-core/templates/market-research-tmpl.yaml ==================== +# template: id: market-research-template-v2 name: Market Research Report @@ -5503,6 +5524,7 @@ sections: ==================== END: .bmad-core/templates/market-research-tmpl.yaml ==================== ==================== START: .bmad-core/templates/prd-tmpl.yaml ==================== +# template: id: prd-template-v2 name: Product Requirements Document @@ -5708,6 +5730,7 @@ sections: ==================== END: .bmad-core/templates/prd-tmpl.yaml ==================== ==================== START: .bmad-core/templates/project-brief-tmpl.yaml ==================== +# template: id: project-brief-template-v2 name: Project Brief @@ -5932,6 +5955,7 @@ sections: ==================== END: .bmad-core/templates/project-brief-tmpl.yaml ==================== ==================== START: .bmad-core/templates/story-tmpl.yaml ==================== +# template: id: story-template-v2 name: Story Document @@ -6072,6 +6096,7 @@ sections: ==================== END: .bmad-core/templates/story-tmpl.yaml ==================== ==================== START: .bmad-core/checklists/architect-checklist.md ==================== + # Architect Solution Validation Checklist This checklist serves as a comprehensive framework for the Architect to validate the technical design and architecture before development execution. The Architect should systematically work through each item, ensuring the architecture is robust, scalable, secure, and aligned with the product requirements. @@ -6513,6 +6538,7 @@ After presenting the report, ask the user if they would like detailed analysis o ==================== END: .bmad-core/checklists/architect-checklist.md ==================== ==================== START: .bmad-core/checklists/change-checklist.md ==================== + # Change Navigation Checklist **Purpose:** To systematically guide the selected Agent and user through the analysis and planning required when a significant change (pivot, tech issue, missing requirement, failed story) is identified during the BMad workflow. @@ -6698,6 +6724,7 @@ Keep it action-oriented and forward-looking.]] ==================== END: .bmad-core/checklists/change-checklist.md ==================== ==================== START: .bmad-core/checklists/pm-checklist.md ==================== + # Product Manager (PM) Requirements Checklist This checklist serves as a comprehensive framework to ensure the Product Requirements Document (PRD) and Epic definitions are complete, well-structured, and appropriately scoped for MVP development. The PM should systematically work through each item during the product definition process. @@ -7071,6 +7098,7 @@ After presenting the report, ask if the user wants: ==================== END: .bmad-core/checklists/pm-checklist.md ==================== ==================== START: .bmad-core/checklists/po-master-checklist.md ==================== + # Product Owner (PO) Master Validation Checklist This checklist serves as a comprehensive framework for the Product Owner to validate project plans before development execution. It adapts intelligently based on project type (greenfield vs brownfield) and includes UI/UX considerations when applicable. @@ -7506,6 +7534,7 @@ After presenting the report, ask if the user wants: ==================== END: .bmad-core/checklists/po-master-checklist.md ==================== ==================== START: .bmad-core/checklists/story-dod-checklist.md ==================== + # Story Definition of Done (DoD) Checklist ## Instructions for Developer Agent @@ -7603,6 +7632,7 @@ Be honest - it's better to flag issues now than have them discovered later.]] ==================== END: .bmad-core/checklists/story-dod-checklist.md ==================== ==================== START: .bmad-core/checklists/story-draft-checklist.md ==================== + # Story Draft Checklist The Scrum Master should use this checklist to validate that each story contains sufficient context for a developer agent to implement it successfully, while assuming the dev agent has reasonable capabilities to figure things out. @@ -7759,11 +7789,12 @@ Be pragmatic - perfect documentation doesn't exist, but it must be enough to pro ==================== END: .bmad-core/checklists/story-draft-checklist.md ==================== ==================== START: .bmad-core/data/bmad-kb.md ==================== -# BMad Knowledge Base + +# BMAD™ Knowledge Base ## Overview -BMad-Method (Breakthrough Method of Agile AI-driven Development) is a framework that combines AI agents with Agile development methodologies. The v4 system introduces a modular architecture with improved dependency management, bundle optimization, and support for both web and IDE environments. +BMAD-METHOD™ (Breakthrough Method of Agile AI-driven Development) is a framework that combines AI agents with Agile development methodologies. The v4 system introduces a modular architecture with improved dependency management, bundle optimization, and support for both web and IDE environments. ### Key Features @@ -7862,7 +7893,7 @@ npx bmad-method install - **Roo Code**: Web-based IDE with agent support - **GitHub Copilot**: VS Code extension with AI peer programming assistant -**Note for VS Code Users**: BMad-Method assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMad agents. The installer includes built-in support for Cline and Roo. +**Note for VS Code Users**: BMAD-METHOD™ assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMad agents. The installer includes built-in support for Cline and Roo. **Verify Installation**: @@ -7870,7 +7901,7 @@ npx bmad-method install - IDE-specific integration files created - All agent commands/rules/modes available -**Remember**: At its core, BMad-Method is about mastering and harnessing prompt engineering. Any IDE with AI agent support can use BMad - the framework provides the structured prompts and workflows that make AI development effective +**Remember**: At its core, BMAD-METHOD™ is about mastering and harnessing prompt engineering. Any IDE with AI agent support can use BMad - the framework provides the structured prompts and workflows that make AI development effective ### Environment Selection Guide @@ -8114,7 +8145,7 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing ### System Overview -The BMad-Method is built around a modular architecture centered on the `bmad-core` directory, which serves as the brain of the entire system. This design enables the framework to operate effectively in both IDE environments (like Cursor, VS Code) and web-based AI interfaces (like ChatGPT, Gemini). +The BMAD-METHOD™ is built around a modular architecture centered on the `bmad-core` directory, which serves as the brain of the entire system. This design enables the framework to operate effectively in both IDE environments (like Cursor, VS Code) and web-based AI interfaces (like ChatGPT, Gemini). ### Key Architectural Components @@ -8469,7 +8500,7 @@ Use the `shard-doc` task or `@kayvan/markdown-tree-parser` tool for automatic sh - **Keep conversations focused** - One agent, one task per conversation - **Review everything** - Always review and approve before marking complete -## Contributing to BMad-Method +## Contributing to BMAD-METHOD™ ### Quick Contribution Guidelines @@ -8501,7 +8532,7 @@ For full details, see `CONTRIBUTING.md`. Key points: ### What Are Expansion Packs? -Expansion packs extend BMad-Method beyond traditional software development into ANY domain. They provide specialized agent teams, templates, and workflows while keeping the core framework lean and focused on development. +Expansion packs extend BMAD-METHOD™ beyond traditional software development into ANY domain. They provide specialized agent teams, templates, and workflows while keeping the core framework lean and focused on development. ### Why Use Expansion Packs? @@ -8568,6 +8599,7 @@ Use the **expansion-creator** pack to build your own: ==================== END: .bmad-core/data/bmad-kb.md ==================== ==================== START: .bmad-core/data/brainstorming-techniques.md ==================== + # Brainstorming Techniques Data ## Creative Expansion @@ -8607,6 +8639,7 @@ Use the **expansion-creator** pack to build your own: ==================== END: .bmad-core/data/brainstorming-techniques.md ==================== ==================== START: .bmad-core/data/elicitation-methods.md ==================== + # Elicitation Methods Data ## Core Reflective Methods @@ -8764,6 +8797,7 @@ Use the **expansion-creator** pack to build your own: ==================== END: .bmad-core/data/elicitation-methods.md ==================== ==================== START: .bmad-core/data/technical-preferences.md ==================== + # User-Defined Preferred Patterns and Preferences None Listed diff --git a/dist/agents/bmad-orchestrator.txt b/dist/agents/bmad-orchestrator.txt index 8b66a936..321ad11b 100644 --- a/dist/agents/bmad-orchestrator.txt +++ b/dist/agents/bmad-orchestrator.txt @@ -82,13 +82,8 @@ commands: doc-out: Output full document kb-mode: Load full BMad knowledge base party-mode: Group chat with all agents - plan: Create detailed workflow plan before starting - plan-status: Show current workflow plan progress - plan-update: Update workflow plan status status: Show current context, active agent, and progress task: Run a specific task (list if name not specified) - workflow: Start a specific workflow (list if name not specified) - workflow-guidance: Get personalized help selecting the right workflow yolo: Toggle skip confirmations mode exit: Return to BMad or exit session help-display-template: | @@ -172,6 +167,7 @@ dependencies: ==================== END: .bmad-core/agents/bmad-orchestrator.md ==================== ==================== START: .bmad-core/tasks/advanced-elicitation.md ==================== + # Advanced Elicitation Task ## Purpose @@ -292,6 +288,7 @@ Choose a number (0-8) or 9 to proceed: ==================== END: .bmad-core/tasks/advanced-elicitation.md ==================== ==================== START: .bmad-core/tasks/create-doc.md ==================== + # Create Document from Template (YAML Driven) ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️ @@ -396,6 +393,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once). ==================== END: .bmad-core/tasks/create-doc.md ==================== ==================== START: .bmad-core/tasks/kb-mode-interaction.md ==================== + # KB Mode Interaction Task ## Purpose @@ -474,11 +472,12 @@ Or ask me about anything else related to BMad-Method! ==================== END: .bmad-core/tasks/kb-mode-interaction.md ==================== ==================== START: .bmad-core/data/bmad-kb.md ==================== -# BMad Knowledge Base + +# BMAD™ Knowledge Base ## Overview -BMad-Method (Breakthrough Method of Agile AI-driven Development) is a framework that combines AI agents with Agile development methodologies. The v4 system introduces a modular architecture with improved dependency management, bundle optimization, and support for both web and IDE environments. +BMAD-METHOD™ (Breakthrough Method of Agile AI-driven Development) is a framework that combines AI agents with Agile development methodologies. The v4 system introduces a modular architecture with improved dependency management, bundle optimization, and support for both web and IDE environments. ### Key Features @@ -577,7 +576,7 @@ npx bmad-method install - **Roo Code**: Web-based IDE with agent support - **GitHub Copilot**: VS Code extension with AI peer programming assistant -**Note for VS Code Users**: BMad-Method assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMad agents. The installer includes built-in support for Cline and Roo. +**Note for VS Code Users**: BMAD-METHOD™ assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMad agents. The installer includes built-in support for Cline and Roo. **Verify Installation**: @@ -585,7 +584,7 @@ npx bmad-method install - IDE-specific integration files created - All agent commands/rules/modes available -**Remember**: At its core, BMad-Method is about mastering and harnessing prompt engineering. Any IDE with AI agent support can use BMad - the framework provides the structured prompts and workflows that make AI development effective +**Remember**: At its core, BMAD-METHOD™ is about mastering and harnessing prompt engineering. Any IDE with AI agent support can use BMad - the framework provides the structured prompts and workflows that make AI development effective ### Environment Selection Guide @@ -829,7 +828,7 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing ### System Overview -The BMad-Method is built around a modular architecture centered on the `bmad-core` directory, which serves as the brain of the entire system. This design enables the framework to operate effectively in both IDE environments (like Cursor, VS Code) and web-based AI interfaces (like ChatGPT, Gemini). +The BMAD-METHOD™ is built around a modular architecture centered on the `bmad-core` directory, which serves as the brain of the entire system. This design enables the framework to operate effectively in both IDE environments (like Cursor, VS Code) and web-based AI interfaces (like ChatGPT, Gemini). ### Key Architectural Components @@ -1184,7 +1183,7 @@ Use the `shard-doc` task or `@kayvan/markdown-tree-parser` tool for automatic sh - **Keep conversations focused** - One agent, one task per conversation - **Review everything** - Always review and approve before marking complete -## Contributing to BMad-Method +## Contributing to BMAD-METHOD™ ### Quick Contribution Guidelines @@ -1216,7 +1215,7 @@ For full details, see `CONTRIBUTING.md`. Key points: ### What Are Expansion Packs? -Expansion packs extend BMad-Method beyond traditional software development into ANY domain. They provide specialized agent teams, templates, and workflows while keeping the core framework lean and focused on development. +Expansion packs extend BMAD-METHOD™ beyond traditional software development into ANY domain. They provide specialized agent teams, templates, and workflows while keeping the core framework lean and focused on development. ### Why Use Expansion Packs? @@ -1283,6 +1282,7 @@ Use the **expansion-creator** pack to build your own: ==================== END: .bmad-core/data/bmad-kb.md ==================== ==================== START: .bmad-core/data/elicitation-methods.md ==================== + # Elicitation Methods Data ## Core Reflective Methods @@ -1440,6 +1440,7 @@ Use the **expansion-creator** pack to build your own: ==================== END: .bmad-core/data/elicitation-methods.md ==================== ==================== START: .bmad-core/utils/workflow-management.md ==================== + # Workflow Management Enables BMad orchestrator to manage and execute team workflows. diff --git a/dist/agents/dev.txt b/dist/agents/dev.txt index 1e8245de..f9fa4a2b 100644 --- a/dist/agents/dev.txt +++ b/dist/agents/dev.txt @@ -93,6 +93,7 @@ dependencies: ==================== END: .bmad-core/agents/dev.md ==================== ==================== START: .bmad-core/tasks/apply-qa-fixes.md ==================== + # apply-qa-fixes Implement fixes based on QA results (gate and assessments) for a specific story. This task is for the Dev agent to systematically consume QA outputs and apply code/test changes while only updating allowed sections in the story file. @@ -244,6 +245,7 @@ Fix plan: ==================== END: .bmad-core/tasks/apply-qa-fixes.md ==================== ==================== START: .bmad-core/tasks/execute-checklist.md ==================== + # 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. @@ -333,6 +335,7 @@ The LLM will: ==================== END: .bmad-core/tasks/execute-checklist.md ==================== ==================== START: .bmad-core/tasks/validate-next-story.md ==================== + # Validate Next Story Task ## Purpose @@ -470,6 +473,7 @@ Provide a structured validation report including: ==================== END: .bmad-core/tasks/validate-next-story.md ==================== ==================== START: .bmad-core/checklists/story-dod-checklist.md ==================== + # Story Definition of Done (DoD) Checklist ## Instructions for Developer Agent diff --git a/dist/agents/pm.txt b/dist/agents/pm.txt index b5902cff..05062a67 100644 --- a/dist/agents/pm.txt +++ b/dist/agents/pm.txt @@ -104,6 +104,7 @@ dependencies: ==================== END: .bmad-core/agents/pm.md ==================== ==================== START: .bmad-core/tasks/brownfield-create-epic.md ==================== + # Create Brownfield Epic Task ## Purpose @@ -267,6 +268,7 @@ The epic creation is successful when: ==================== END: .bmad-core/tasks/brownfield-create-epic.md ==================== ==================== START: .bmad-core/tasks/brownfield-create-story.md ==================== + # Create Brownfield Story Task ## Purpose @@ -417,6 +419,7 @@ The story creation is successful when: ==================== END: .bmad-core/tasks/brownfield-create-story.md ==================== ==================== START: .bmad-core/tasks/correct-course.md ==================== + # Correct Course Task ## Purpose @@ -490,6 +493,7 @@ The story creation is successful when: ==================== END: .bmad-core/tasks/correct-course.md ==================== ==================== START: .bmad-core/tasks/create-deep-research-prompt.md ==================== + # Create Deep Research Prompt Task This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation. @@ -771,6 +775,7 @@ CRITICAL: collaborate with the user to develop specific, actionable research que ==================== END: .bmad-core/tasks/create-deep-research-prompt.md ==================== ==================== START: .bmad-core/tasks/create-doc.md ==================== + # Create Document from Template (YAML Driven) ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️ @@ -875,6 +880,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once). ==================== END: .bmad-core/tasks/create-doc.md ==================== ==================== START: .bmad-core/tasks/execute-checklist.md ==================== + # 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. @@ -964,6 +970,7 @@ The LLM will: ==================== END: .bmad-core/tasks/execute-checklist.md ==================== ==================== START: .bmad-core/tasks/shard-doc.md ==================== + # Document Sharding Task ## Purpose @@ -1152,6 +1159,7 @@ Document sharded successfully: ==================== END: .bmad-core/tasks/shard-doc.md ==================== ==================== START: .bmad-core/templates/brownfield-prd-tmpl.yaml ==================== +# template: id: brownfield-prd-template-v2 name: Brownfield Enhancement PRD @@ -1435,6 +1443,7 @@ sections: ==================== END: .bmad-core/templates/brownfield-prd-tmpl.yaml ==================== ==================== START: .bmad-core/templates/prd-tmpl.yaml ==================== +# template: id: prd-template-v2 name: Product Requirements Document @@ -1640,6 +1649,7 @@ sections: ==================== END: .bmad-core/templates/prd-tmpl.yaml ==================== ==================== START: .bmad-core/checklists/change-checklist.md ==================== + # Change Navigation Checklist **Purpose:** To systematically guide the selected Agent and user through the analysis and planning required when a significant change (pivot, tech issue, missing requirement, failed story) is identified during the BMad workflow. @@ -1825,6 +1835,7 @@ Keep it action-oriented and forward-looking.]] ==================== END: .bmad-core/checklists/change-checklist.md ==================== ==================== START: .bmad-core/checklists/pm-checklist.md ==================== + # Product Manager (PM) Requirements Checklist This checklist serves as a comprehensive framework to ensure the Product Requirements Document (PRD) and Epic definitions are complete, well-structured, and appropriately scoped for MVP development. The PM should systematically work through each item during the product definition process. @@ -2198,6 +2209,7 @@ After presenting the report, ask if the user wants: ==================== END: .bmad-core/checklists/pm-checklist.md ==================== ==================== START: .bmad-core/data/technical-preferences.md ==================== + # User-Defined Preferred Patterns and Preferences None Listed diff --git a/dist/agents/po.txt b/dist/agents/po.txt index 822f8ad3..2ab445d5 100644 --- a/dist/agents/po.txt +++ b/dist/agents/po.txt @@ -99,6 +99,7 @@ dependencies: ==================== END: .bmad-core/agents/po.md ==================== ==================== START: .bmad-core/tasks/correct-course.md ==================== + # Correct Course Task ## Purpose @@ -172,6 +173,7 @@ dependencies: ==================== END: .bmad-core/tasks/correct-course.md ==================== ==================== START: .bmad-core/tasks/execute-checklist.md ==================== + # 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. @@ -261,6 +263,7 @@ The LLM will: ==================== END: .bmad-core/tasks/execute-checklist.md ==================== ==================== START: .bmad-core/tasks/shard-doc.md ==================== + # Document Sharding Task ## Purpose @@ -449,6 +452,7 @@ Document sharded successfully: ==================== END: .bmad-core/tasks/shard-doc.md ==================== ==================== START: .bmad-core/tasks/validate-next-story.md ==================== + # Validate Next Story Task ## Purpose @@ -586,6 +590,7 @@ Provide a structured validation report including: ==================== END: .bmad-core/tasks/validate-next-story.md ==================== ==================== START: .bmad-core/templates/story-tmpl.yaml ==================== +# template: id: story-template-v2 name: Story Document @@ -726,6 +731,7 @@ sections: ==================== END: .bmad-core/templates/story-tmpl.yaml ==================== ==================== START: .bmad-core/checklists/change-checklist.md ==================== + # Change Navigation Checklist **Purpose:** To systematically guide the selected Agent and user through the analysis and planning required when a significant change (pivot, tech issue, missing requirement, failed story) is identified during the BMad workflow. @@ -911,6 +917,7 @@ Keep it action-oriented and forward-looking.]] ==================== END: .bmad-core/checklists/change-checklist.md ==================== ==================== START: .bmad-core/checklists/po-master-checklist.md ==================== + # Product Owner (PO) Master Validation Checklist This checklist serves as a comprehensive framework for the Product Owner to validate project plans before development execution. It adapts intelligently based on project type (greenfield vs brownfield) and includes UI/UX considerations when applicable. diff --git a/dist/agents/qa.txt b/dist/agents/qa.txt index 2f939fc3..0979397c 100644 --- a/dist/agents/qa.txt +++ b/dist/agents/qa.txt @@ -111,6 +111,7 @@ dependencies: ==================== END: .bmad-core/agents/qa.md ==================== ==================== START: .bmad-core/tasks/nfr-assess.md ==================== + # nfr-assess Quick NFR validation focused on the core four: security, performance, reliability, maintainability. @@ -457,6 +458,7 @@ performance_deep_dive: ==================== END: .bmad-core/tasks/nfr-assess.md ==================== ==================== START: .bmad-core/tasks/qa-gate.md ==================== + # qa-gate Create or update a quality gate decision file for a story based on review findings. @@ -621,6 +623,7 @@ Gate: CONCERNS → qa.qaLocation/gates/{epic}.{story}-{slug}.yml ==================== END: .bmad-core/tasks/qa-gate.md ==================== ==================== START: .bmad-core/tasks/review-story.md ==================== + # review-story Perform a comprehensive test architecture review with quality gate decision. This adaptive, risk-aware review creates both a story update and a detailed gate file. @@ -938,6 +941,7 @@ After review: ==================== END: .bmad-core/tasks/review-story.md ==================== ==================== START: .bmad-core/tasks/risk-profile.md ==================== + # risk-profile Generate a comprehensive risk assessment matrix for a story implementation using probability × impact analysis. @@ -1294,6 +1298,7 @@ Risk profile: qa.qaLocation/assessments/{epic}.{story}-risk-{YYYYMMDD}.md ==================== END: .bmad-core/tasks/risk-profile.md ==================== ==================== START: .bmad-core/tasks/test-design.md ==================== + # test-design Create comprehensive test scenarios with appropriate test level recommendations for story implementation. @@ -1471,6 +1476,7 @@ Before finalizing, verify: ==================== END: .bmad-core/tasks/test-design.md ==================== ==================== START: .bmad-core/tasks/trace-requirements.md ==================== + # trace-requirements Map story requirements to test cases using Given-When-Then patterns for comprehensive traceability. @@ -1738,6 +1744,7 @@ Trace matrix: qa.qaLocation/assessments/{epic}.{story}-trace-{YYYYMMDD}.md ==================== END: .bmad-core/tasks/trace-requirements.md ==================== ==================== START: .bmad-core/templates/qa-gate-tmpl.yaml ==================== +# template: id: qa-gate-template-v1 name: Quality Gate Decision @@ -1843,6 +1850,7 @@ optional_fields_examples: ==================== END: .bmad-core/templates/qa-gate-tmpl.yaml ==================== ==================== START: .bmad-core/templates/story-tmpl.yaml ==================== +# template: id: story-template-v2 name: Story Document @@ -1983,6 +1991,7 @@ sections: ==================== END: .bmad-core/templates/story-tmpl.yaml ==================== ==================== START: .bmad-core/data/technical-preferences.md ==================== + # User-Defined Preferred Patterns and Preferences None Listed diff --git a/dist/agents/sm.txt b/dist/agents/sm.txt index cad03b71..78ca362e 100644 --- a/dist/agents/sm.txt +++ b/dist/agents/sm.txt @@ -85,6 +85,7 @@ dependencies: ==================== END: .bmad-core/agents/sm.md ==================== ==================== START: .bmad-core/tasks/correct-course.md ==================== + # Correct Course Task ## Purpose @@ -158,6 +159,7 @@ dependencies: ==================== END: .bmad-core/tasks/correct-course.md ==================== ==================== START: .bmad-core/tasks/create-next-story.md ==================== + # Create Next Story Task ## Purpose @@ -273,6 +275,7 @@ ALWAYS cite source documents: `[Source: architecture/{filename}.md#{section}]` ==================== END: .bmad-core/tasks/create-next-story.md ==================== ==================== START: .bmad-core/tasks/execute-checklist.md ==================== + # 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. @@ -362,6 +365,7 @@ The LLM will: ==================== END: .bmad-core/tasks/execute-checklist.md ==================== ==================== START: .bmad-core/templates/story-tmpl.yaml ==================== +# template: id: story-template-v2 name: Story Document @@ -502,6 +506,7 @@ sections: ==================== END: .bmad-core/templates/story-tmpl.yaml ==================== ==================== START: .bmad-core/checklists/story-draft-checklist.md ==================== + # Story Draft Checklist The Scrum Master should use this checklist to validate that each story contains sufficient context for a developer agent to implement it successfully, while assuming the dev agent has reasonable capabilities to figure things out. diff --git a/dist/agents/ux-expert.txt b/dist/agents/ux-expert.txt index 70572bd9..a0643d26 100644 --- a/dist/agents/ux-expert.txt +++ b/dist/agents/ux-expert.txt @@ -89,6 +89,7 @@ dependencies: ==================== END: .bmad-core/agents/ux-expert.md ==================== ==================== START: .bmad-core/tasks/create-doc.md ==================== + # Create Document from Template (YAML Driven) ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️ @@ -193,6 +194,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once). ==================== END: .bmad-core/tasks/create-doc.md ==================== ==================== START: .bmad-core/tasks/execute-checklist.md ==================== + # 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. @@ -282,6 +284,7 @@ The LLM will: ==================== END: .bmad-core/tasks/execute-checklist.md ==================== ==================== START: .bmad-core/tasks/generate-ai-frontend-prompt.md ==================== + # Create AI Frontend Prompt Task ## Purpose @@ -336,6 +339,7 @@ You will now synthesize the inputs and the above principles into a final, compre ==================== END: .bmad-core/tasks/generate-ai-frontend-prompt.md ==================== ==================== START: .bmad-core/templates/front-end-spec-tmpl.yaml ==================== +# template: id: frontend-spec-template-v2 name: UI/UX Specification @@ -688,6 +692,7 @@ sections: ==================== END: .bmad-core/templates/front-end-spec-tmpl.yaml ==================== ==================== START: .bmad-core/data/technical-preferences.md ==================== + # User-Defined Preferred Patterns and Preferences None Listed diff --git a/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt b/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt index b5fa9723..09e8df42 100644 --- a/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +++ b/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt @@ -95,6 +95,7 @@ dependencies: ==================== END: .bmad-2d-phaser-game-dev/agents/game-designer.md ==================== ==================== START: .bmad-2d-phaser-game-dev/tasks/create-doc.md ==================== + # Create Document from Template (YAML Driven) ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️ @@ -199,6 +200,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once). ==================== END: .bmad-2d-phaser-game-dev/tasks/create-doc.md ==================== ==================== START: .bmad-2d-phaser-game-dev/tasks/execute-checklist.md ==================== + # 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. @@ -288,6 +290,7 @@ The LLM will: ==================== END: .bmad-2d-phaser-game-dev/tasks/execute-checklist.md ==================== ==================== START: .bmad-2d-phaser-game-dev/tasks/game-design-brainstorming.md ==================== + # Game Design Brainstorming Techniques Task This task provides a comprehensive toolkit of creative brainstorming techniques specifically designed for game design ideation and innovative thinking. The game designer can use these techniques to facilitate productive brainstorming sessions focused on game mechanics, player experience, and creative concepts. @@ -581,6 +584,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques ==================== END: .bmad-2d-phaser-game-dev/tasks/game-design-brainstorming.md ==================== ==================== START: .bmad-2d-phaser-game-dev/tasks/create-deep-research-prompt.md ==================== + # Create Deep Research Prompt Task This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation. @@ -862,6 +866,7 @@ CRITICAL: collaborate with the user to develop specific, actionable research que ==================== END: .bmad-2d-phaser-game-dev/tasks/create-deep-research-prompt.md ==================== ==================== START: .bmad-2d-phaser-game-dev/tasks/advanced-elicitation.md ==================== + # Advanced Game Design Elicitation Task ## Purpose @@ -975,6 +980,7 @@ The questions and perspectives offered should always consider: ==================== END: .bmad-2d-phaser-game-dev/tasks/advanced-elicitation.md ==================== ==================== START: .bmad-2d-phaser-game-dev/templates/game-design-doc-tmpl.yaml ==================== +# template: id: game-design-doc-template-v2 name: Game Design Document (GDD) @@ -1321,6 +1327,7 @@ sections: ==================== END: .bmad-2d-phaser-game-dev/templates/game-design-doc-tmpl.yaml ==================== ==================== START: .bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.yaml ==================== +# template: id: level-design-doc-template-v2 name: Level Design Document @@ -1808,6 +1815,7 @@ sections: ==================== END: .bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.yaml ==================== ==================== START: .bmad-2d-phaser-game-dev/templates/game-brief-tmpl.yaml ==================== +# template: id: game-brief-template-v2 name: Game Brief @@ -2167,6 +2175,7 @@ sections: ==================== END: .bmad-2d-phaser-game-dev/templates/game-brief-tmpl.yaml ==================== ==================== START: .bmad-2d-phaser-game-dev/checklists/game-design-checklist.md ==================== + # Game Design Document Quality Checklist ## Document Completeness diff --git a/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt b/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt index e8b10de4..0f524c18 100644 --- a/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +++ b/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt @@ -102,6 +102,7 @@ dependencies: ==================== END: .bmad-2d-phaser-game-dev/agents/game-developer.md ==================== ==================== START: .bmad-2d-phaser-game-dev/tasks/execute-checklist.md ==================== + # 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. @@ -191,6 +192,7 @@ The LLM will: ==================== END: .bmad-2d-phaser-game-dev/tasks/execute-checklist.md ==================== ==================== START: .bmad-2d-phaser-game-dev/templates/game-architecture-tmpl.yaml ==================== +# template: id: game-architecture-template-v2 name: Game Architecture Document @@ -807,6 +809,7 @@ sections: ==================== END: .bmad-2d-phaser-game-dev/templates/game-architecture-tmpl.yaml ==================== ==================== START: .bmad-2d-phaser-game-dev/checklists/game-story-dod-checklist.md ==================== + # Game Development Story Definition of Done Checklist ## Story Completeness @@ -970,6 +973,7 @@ _Any specific concerns, recommendations, or clarifications needed before develop ==================== END: .bmad-2d-phaser-game-dev/checklists/game-story-dod-checklist.md ==================== ==================== START: .bmad-2d-phaser-game-dev/data/development-guidelines.md ==================== + # Game Development Guidelines ## Overview diff --git a/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt b/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt index c38591de..7095db2d 100644 --- a/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +++ b/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt @@ -88,6 +88,7 @@ dependencies: ==================== END: .bmad-2d-phaser-game-dev/agents/game-sm.md ==================== ==================== START: .bmad-2d-phaser-game-dev/tasks/create-game-story.md ==================== + # Create Game Development Story Task ## Purpose @@ -307,6 +308,7 @@ This task ensures game development stories are immediately actionable and enable ==================== END: .bmad-2d-phaser-game-dev/tasks/create-game-story.md ==================== ==================== START: .bmad-2d-phaser-game-dev/tasks/execute-checklist.md ==================== + # 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. @@ -396,6 +398,7 @@ The LLM will: ==================== END: .bmad-2d-phaser-game-dev/tasks/execute-checklist.md ==================== ==================== START: .bmad-2d-phaser-game-dev/templates/game-story-tmpl.yaml ==================== +# template: id: game-story-template-v2 name: Game Development Story @@ -652,6 +655,7 @@ sections: ==================== END: .bmad-2d-phaser-game-dev/templates/game-story-tmpl.yaml ==================== ==================== START: .bmad-2d-phaser-game-dev/checklists/game-story-dod-checklist.md ==================== + # Game Development Story Definition of Done Checklist ## Story Completeness diff --git a/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt b/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt index 4303b160..99c6d038 100644 --- a/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +++ b/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt @@ -40,6 +40,7 @@ These references map directly to bundle sections: ==================== START: .bmad-2d-phaser-game-dev/agent-teams/phaser-2d-nodejs-game-team.yaml ==================== +# bundle: name: Phaser 2D NodeJS Game Team icon: 🎮 @@ -162,13 +163,8 @@ commands: doc-out: Output full document kb-mode: Load full BMad knowledge base party-mode: Group chat with all agents - plan: Create detailed workflow plan before starting - plan-status: Show current workflow plan progress - plan-update: Update workflow plan status status: Show current context, active agent, and progress task: Run a specific task (list if name not specified) - workflow: Start a specific workflow (list if name not specified) - workflow-guidance: Get personalized help selecting the right workflow yolo: Toggle skip confirmations mode exit: Return to BMad or exit session help-display-template: | @@ -417,6 +413,7 @@ dependencies: ==================== END: .bmad-2d-phaser-game-dev/agents/game-sm.md ==================== ==================== START: .bmad-2d-phaser-game-dev/data/bmad-kb.md ==================== + # Game Development BMad Knowledge Base ## Overview @@ -670,6 +667,7 @@ This knowledge base provides the foundation for effective game development using ==================== END: .bmad-2d-phaser-game-dev/data/bmad-kb.md ==================== ==================== START: .bmad-2d-phaser-game-dev/data/brainstorming-techniques.md ==================== + # Brainstorming Techniques Data ## Creative Expansion @@ -709,6 +707,7 @@ This knowledge base provides the foundation for effective game development using ==================== END: .bmad-2d-phaser-game-dev/data/brainstorming-techniques.md ==================== ==================== START: .bmad-2d-phaser-game-dev/tasks/advanced-elicitation.md ==================== + # Advanced Game Design Elicitation Task ## Purpose @@ -822,6 +821,7 @@ The questions and perspectives offered should always consider: ==================== END: .bmad-2d-phaser-game-dev/tasks/advanced-elicitation.md ==================== ==================== START: .bmad-2d-phaser-game-dev/tasks/create-deep-research-prompt.md ==================== + # Create Deep Research Prompt Task This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation. @@ -1103,6 +1103,7 @@ CRITICAL: collaborate with the user to develop specific, actionable research que ==================== END: .bmad-2d-phaser-game-dev/tasks/create-deep-research-prompt.md ==================== ==================== START: .bmad-2d-phaser-game-dev/tasks/create-doc.md ==================== + # Create Document from Template (YAML Driven) ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️ @@ -1207,6 +1208,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once). ==================== END: .bmad-2d-phaser-game-dev/tasks/create-doc.md ==================== ==================== START: .bmad-2d-phaser-game-dev/tasks/document-project.md ==================== + # Document an Existing Project ## Purpose @@ -1553,6 +1555,7 @@ Apply the advanced elicitation task after major sections to refine based on user ==================== END: .bmad-2d-phaser-game-dev/tasks/document-project.md ==================== ==================== START: .bmad-2d-phaser-game-dev/tasks/facilitate-brainstorming-session.md ==================== + --- docOutputLocation: docs/brainstorming-session-results.md template: '.bmad-2d-phaser-game-dev/templates/brainstorming-output-tmpl.yaml' @@ -1847,10 +1850,11 @@ sections: content: | --- - *Session facilitated using the BMAD-METHOD brainstorming framework* + *Session facilitated using the BMAD-METHOD™ brainstorming framework* ==================== END: .bmad-2d-phaser-game-dev/templates/brainstorming-output-tmpl.yaml ==================== ==================== START: .bmad-2d-phaser-game-dev/templates/competitor-analysis-tmpl.yaml ==================== +# template: id: competitor-analysis-template-v2 name: Competitive Analysis Report @@ -2160,6 +2164,7 @@ sections: ==================== END: .bmad-2d-phaser-game-dev/templates/competitor-analysis-tmpl.yaml ==================== ==================== START: .bmad-2d-phaser-game-dev/templates/market-research-tmpl.yaml ==================== +# template: id: market-research-template-v2 name: Market Research Report @@ -2415,6 +2420,7 @@ sections: ==================== END: .bmad-2d-phaser-game-dev/templates/market-research-tmpl.yaml ==================== ==================== START: .bmad-2d-phaser-game-dev/templates/project-brief-tmpl.yaml ==================== +# template: id: project-brief-template-v2 name: Project Brief @@ -2639,6 +2645,7 @@ sections: ==================== END: .bmad-2d-phaser-game-dev/templates/project-brief-tmpl.yaml ==================== ==================== START: .bmad-2d-phaser-game-dev/data/elicitation-methods.md ==================== + # Elicitation Methods Data ## Core Reflective Methods @@ -2796,6 +2803,7 @@ sections: ==================== END: .bmad-2d-phaser-game-dev/data/elicitation-methods.md ==================== ==================== START: .bmad-2d-phaser-game-dev/tasks/kb-mode-interaction.md ==================== + # KB Mode Interaction Task ## Purpose @@ -2874,6 +2882,7 @@ Or ask me about anything else related to BMad-Method! ==================== END: .bmad-2d-phaser-game-dev/tasks/kb-mode-interaction.md ==================== ==================== START: .bmad-2d-phaser-game-dev/utils/workflow-management.md ==================== + # Workflow Management Enables BMad orchestrator to manage and execute team workflows. @@ -2946,6 +2955,7 @@ Agents should be workflow-aware: know active workflow, their role, access artifa ==================== END: .bmad-2d-phaser-game-dev/utils/workflow-management.md ==================== ==================== START: .bmad-2d-phaser-game-dev/tasks/execute-checklist.md ==================== + # 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. @@ -3035,6 +3045,7 @@ The LLM will: ==================== END: .bmad-2d-phaser-game-dev/tasks/execute-checklist.md ==================== ==================== START: .bmad-2d-phaser-game-dev/tasks/game-design-brainstorming.md ==================== + # Game Design Brainstorming Techniques Task This task provides a comprehensive toolkit of creative brainstorming techniques specifically designed for game design ideation and innovative thinking. The game designer can use these techniques to facilitate productive brainstorming sessions focused on game mechanics, player experience, and creative concepts. @@ -3328,6 +3339,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques ==================== END: .bmad-2d-phaser-game-dev/tasks/game-design-brainstorming.md ==================== ==================== START: .bmad-2d-phaser-game-dev/templates/game-design-doc-tmpl.yaml ==================== +# template: id: game-design-doc-template-v2 name: Game Design Document (GDD) @@ -3674,6 +3686,7 @@ sections: ==================== END: .bmad-2d-phaser-game-dev/templates/game-design-doc-tmpl.yaml ==================== ==================== START: .bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.yaml ==================== +# template: id: level-design-doc-template-v2 name: Level Design Document @@ -4161,6 +4174,7 @@ sections: ==================== END: .bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.yaml ==================== ==================== START: .bmad-2d-phaser-game-dev/templates/game-brief-tmpl.yaml ==================== +# template: id: game-brief-template-v2 name: Game Brief @@ -4520,6 +4534,7 @@ sections: ==================== END: .bmad-2d-phaser-game-dev/templates/game-brief-tmpl.yaml ==================== ==================== START: .bmad-2d-phaser-game-dev/checklists/game-design-checklist.md ==================== + # Game Design Document Quality Checklist ## Document Completeness @@ -4724,6 +4739,7 @@ _Outline immediate next actions for the team based on this assessment._ ==================== END: .bmad-2d-phaser-game-dev/checklists/game-design-checklist.md ==================== ==================== START: .bmad-2d-phaser-game-dev/templates/game-architecture-tmpl.yaml ==================== +# template: id: game-architecture-template-v2 name: Game Architecture Document @@ -5340,6 +5356,7 @@ sections: ==================== END: .bmad-2d-phaser-game-dev/templates/game-architecture-tmpl.yaml ==================== ==================== START: .bmad-2d-phaser-game-dev/checklists/game-story-dod-checklist.md ==================== + # Game Development Story Definition of Done Checklist ## Story Completeness @@ -5503,6 +5520,7 @@ _Any specific concerns, recommendations, or clarifications needed before develop ==================== END: .bmad-2d-phaser-game-dev/checklists/game-story-dod-checklist.md ==================== ==================== START: .bmad-2d-phaser-game-dev/data/development-guidelines.md ==================== + # Game Development Guidelines ## Overview @@ -6153,6 +6171,7 @@ These guidelines ensure consistent, high-quality game development that meets per ==================== END: .bmad-2d-phaser-game-dev/data/development-guidelines.md ==================== ==================== START: .bmad-2d-phaser-game-dev/tasks/create-game-story.md ==================== + # Create Game Development Story Task ## Purpose @@ -6372,6 +6391,7 @@ This task ensures game development stories are immediately actionable and enable ==================== END: .bmad-2d-phaser-game-dev/tasks/create-game-story.md ==================== ==================== START: .bmad-2d-phaser-game-dev/templates/game-story-tmpl.yaml ==================== +# template: id: game-story-template-v2 name: Game Development Story @@ -6628,6 +6648,7 @@ sections: ==================== END: .bmad-2d-phaser-game-dev/templates/game-story-tmpl.yaml ==================== ==================== START: .bmad-2d-phaser-game-dev/templates/game-architecture-tmpl.yaml ==================== +# template: id: game-architecture-template-v2 name: Game Architecture Document @@ -7244,6 +7265,7 @@ sections: ==================== END: .bmad-2d-phaser-game-dev/templates/game-architecture-tmpl.yaml ==================== ==================== START: .bmad-2d-phaser-game-dev/templates/game-brief-tmpl.yaml ==================== +# template: id: game-brief-template-v2 name: Game Brief @@ -7603,6 +7625,7 @@ sections: ==================== END: .bmad-2d-phaser-game-dev/templates/game-brief-tmpl.yaml ==================== ==================== START: .bmad-2d-phaser-game-dev/templates/game-design-doc-tmpl.yaml ==================== +# template: id: game-design-doc-template-v2 name: Game Design Document (GDD) @@ -7949,6 +7972,7 @@ sections: ==================== END: .bmad-2d-phaser-game-dev/templates/game-design-doc-tmpl.yaml ==================== ==================== START: .bmad-2d-phaser-game-dev/templates/game-story-tmpl.yaml ==================== +# template: id: game-story-template-v2 name: Game Development Story @@ -8205,6 +8229,7 @@ sections: ==================== END: .bmad-2d-phaser-game-dev/templates/game-story-tmpl.yaml ==================== ==================== START: .bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.yaml ==================== +# template: id: level-design-doc-template-v2 name: Level Design Document @@ -8692,6 +8717,7 @@ sections: ==================== END: .bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.yaml ==================== ==================== START: .bmad-2d-phaser-game-dev/tasks/advanced-elicitation.md ==================== + # Advanced Game Design Elicitation Task ## Purpose @@ -8805,6 +8831,7 @@ The questions and perspectives offered should always consider: ==================== END: .bmad-2d-phaser-game-dev/tasks/advanced-elicitation.md ==================== ==================== START: .bmad-2d-phaser-game-dev/tasks/create-game-story.md ==================== + # Create Game Development Story Task ## Purpose @@ -9024,6 +9051,7 @@ This task ensures game development stories are immediately actionable and enable ==================== END: .bmad-2d-phaser-game-dev/tasks/create-game-story.md ==================== ==================== START: .bmad-2d-phaser-game-dev/tasks/game-design-brainstorming.md ==================== + # Game Design Brainstorming Techniques Task This task provides a comprehensive toolkit of creative brainstorming techniques specifically designed for game design ideation and innovative thinking. The game designer can use these techniques to facilitate productive brainstorming sessions focused on game mechanics, player experience, and creative concepts. @@ -9317,6 +9345,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques ==================== END: .bmad-2d-phaser-game-dev/tasks/game-design-brainstorming.md ==================== ==================== START: .bmad-2d-phaser-game-dev/checklists/game-design-checklist.md ==================== + # Game Design Document Quality Checklist ## Document Completeness @@ -9521,6 +9550,7 @@ _Outline immediate next actions for the team based on this assessment._ ==================== END: .bmad-2d-phaser-game-dev/checklists/game-design-checklist.md ==================== ==================== START: .bmad-2d-phaser-game-dev/checklists/game-story-dod-checklist.md ==================== + # Game Development Story Definition of Done Checklist ## Story Completeness @@ -9684,6 +9714,7 @@ _Any specific concerns, recommendations, or clarifications needed before develop ==================== END: .bmad-2d-phaser-game-dev/checklists/game-story-dod-checklist.md ==================== ==================== START: .bmad-2d-phaser-game-dev/workflows/game-dev-greenfield.yaml ==================== +# workflow: id: game-dev-greenfield name: Game Development - Greenfield Project @@ -9870,6 +9901,7 @@ workflow: ==================== END: .bmad-2d-phaser-game-dev/workflows/game-dev-greenfield.yaml ==================== ==================== START: .bmad-2d-phaser-game-dev/workflows/game-prototype.yaml ==================== +# workflow: id: game-prototype name: Game Prototype Development @@ -10048,6 +10080,7 @@ workflow: ==================== END: .bmad-2d-phaser-game-dev/workflows/game-prototype.yaml ==================== ==================== START: .bmad-2d-phaser-game-dev/data/bmad-kb.md ==================== + # Game Development BMad Knowledge Base ## Overview @@ -10301,6 +10334,7 @@ This knowledge base provides the foundation for effective game development using ==================== END: .bmad-2d-phaser-game-dev/data/bmad-kb.md ==================== ==================== START: .bmad-2d-phaser-game-dev/data/development-guidelines.md ==================== + # Game Development Guidelines ## Overview diff --git a/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.txt b/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.txt index 7cabad1e..cbb79e4b 100644 --- a/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.txt +++ b/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.txt @@ -103,6 +103,7 @@ dependencies: ==================== END: .bmad-2d-unity-game-dev/agents/game-architect.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/create-doc.md ==================== + # Create Document from Template (YAML Driven) ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️ @@ -207,6 +208,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once). ==================== END: .bmad-2d-unity-game-dev/tasks/create-doc.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/create-deep-research-prompt.md ==================== + # Create Deep Research Prompt Task This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation. @@ -488,6 +490,7 @@ CRITICAL: collaborate with the user to develop specific, actionable research que ==================== END: .bmad-2d-unity-game-dev/tasks/create-deep-research-prompt.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/shard-doc.md ==================== + # Document Sharding Task ## Purpose @@ -676,6 +679,7 @@ Document sharded successfully: ==================== END: .bmad-2d-unity-game-dev/tasks/shard-doc.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/document-project.md ==================== + # Document an Existing Project ## Purpose @@ -1022,6 +1026,7 @@ Apply the advanced elicitation task after major sections to refine based on user ==================== END: .bmad-2d-unity-game-dev/tasks/document-project.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/execute-checklist.md ==================== + # 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. @@ -1111,6 +1116,7 @@ The LLM will: ==================== END: .bmad-2d-unity-game-dev/tasks/execute-checklist.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/advanced-elicitation.md ==================== + # Advanced Game Design Elicitation Task ## Purpose @@ -1224,6 +1230,7 @@ The questions and perspectives offered should always consider: ==================== END: .bmad-2d-unity-game-dev/tasks/advanced-elicitation.md ==================== ==================== START: .bmad-2d-unity-game-dev/templates/game-architecture-tmpl.yaml ==================== +# template: id: game-architecture-template-v3 name: Game Architecture Document @@ -2257,6 +2264,7 @@ sections: ==================== END: .bmad-2d-unity-game-dev/templates/game-architecture-tmpl.yaml ==================== ==================== START: .bmad-2d-unity-game-dev/checklists/game-architect-checklist.md ==================== + # Game Architect Solution Validation Checklist This checklist serves as a comprehensive framework for the Game Architect to validate the technical design and architecture before game development execution. The Game Architect should systematically work through each item, ensuring the game architecture is robust, scalable, performant, and aligned with the Game Design Document requirements. @@ -2651,6 +2659,7 @@ After presenting the report, ask the user if they would like detailed analysis o ==================== END: .bmad-2d-unity-game-dev/checklists/game-architect-checklist.md ==================== ==================== START: .bmad-2d-unity-game-dev/data/development-guidelines.md ==================== + # Game Development Guidelines (Unity & C#) ## Overview @@ -3240,6 +3249,7 @@ These guidelines ensure consistent, high-quality game development that meets per ==================== END: .bmad-2d-unity-game-dev/data/development-guidelines.md ==================== ==================== START: .bmad-2d-unity-game-dev/data/bmad-kb.md ==================== + # BMad Knowledge Base - 2D Unity Game Development ## Overview diff --git a/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt b/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt index 275f881e..5002ee37 100644 --- a/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt +++ b/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt @@ -100,6 +100,7 @@ dependencies: ==================== END: .bmad-2d-unity-game-dev/agents/game-designer.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/create-doc.md ==================== + # Create Document from Template (YAML Driven) ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️ @@ -204,6 +205,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once). ==================== END: .bmad-2d-unity-game-dev/tasks/create-doc.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/execute-checklist.md ==================== + # 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. @@ -293,6 +295,7 @@ The LLM will: ==================== END: .bmad-2d-unity-game-dev/tasks/execute-checklist.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/shard-doc.md ==================== + # Document Sharding Task ## Purpose @@ -481,6 +484,7 @@ Document sharded successfully: ==================== END: .bmad-2d-unity-game-dev/tasks/shard-doc.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/game-design-brainstorming.md ==================== + # Game Design Brainstorming Techniques Task This task provides a comprehensive toolkit of creative brainstorming techniques specifically designed for game design ideation and innovative thinking. The game designer can use these techniques to facilitate productive brainstorming sessions focused on game mechanics, player experience, and creative concepts. @@ -774,6 +778,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques ==================== END: .bmad-2d-unity-game-dev/tasks/game-design-brainstorming.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/create-deep-research-prompt.md ==================== + # Create Deep Research Prompt Task This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation. @@ -1055,6 +1060,7 @@ CRITICAL: collaborate with the user to develop specific, actionable research que ==================== END: .bmad-2d-unity-game-dev/tasks/create-deep-research-prompt.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/advanced-elicitation.md ==================== + # Advanced Game Design Elicitation Task ## Purpose @@ -1168,6 +1174,7 @@ The questions and perspectives offered should always consider: ==================== END: .bmad-2d-unity-game-dev/tasks/advanced-elicitation.md ==================== ==================== START: .bmad-2d-unity-game-dev/templates/game-design-doc-tmpl.yaml ==================== +# template: id: game-design-doc-template-v3 name: Game Design Document (GDD) @@ -1876,6 +1883,7 @@ sections: ==================== END: .bmad-2d-unity-game-dev/templates/game-design-doc-tmpl.yaml ==================== ==================== START: .bmad-2d-unity-game-dev/templates/level-design-doc-tmpl.yaml ==================== +# template: id: level-design-doc-template-v2 name: Level Design Document @@ -2363,6 +2371,7 @@ sections: ==================== END: .bmad-2d-unity-game-dev/templates/level-design-doc-tmpl.yaml ==================== ==================== START: .bmad-2d-unity-game-dev/templates/game-brief-tmpl.yaml ==================== +# template: id: game-brief-template-v3 name: Game Brief @@ -2722,6 +2731,7 @@ sections: ==================== END: .bmad-2d-unity-game-dev/templates/game-brief-tmpl.yaml ==================== ==================== START: .bmad-2d-unity-game-dev/checklists/game-design-checklist.md ==================== + # Game Design Document Quality Checklist ## Document Completeness @@ -2926,6 +2936,7 @@ _Outline immediate next actions for the team based on this assessment._ ==================== END: .bmad-2d-unity-game-dev/checklists/game-design-checklist.md ==================== ==================== START: .bmad-2d-unity-game-dev/data/bmad-kb.md ==================== + # BMad Knowledge Base - 2D Unity Game Development ## Overview diff --git a/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.txt b/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.txt index 5c8407e1..9198b046 100644 --- a/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.txt +++ b/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.txt @@ -97,6 +97,7 @@ dependencies: ==================== END: .bmad-2d-unity-game-dev/agents/game-developer.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/execute-checklist.md ==================== + # 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. @@ -186,6 +187,7 @@ The LLM will: ==================== END: .bmad-2d-unity-game-dev/tasks/execute-checklist.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/validate-next-story.md ==================== + # Validate Next Story Task ## Purpose @@ -323,6 +325,7 @@ Provide a structured validation report including: ==================== END: .bmad-2d-unity-game-dev/tasks/validate-next-story.md ==================== ==================== START: .bmad-2d-unity-game-dev/checklists/game-story-dod-checklist.md ==================== + # Game Development Story Definition of Done (DoD) Checklist ## Instructions for Developer Agent diff --git a/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.txt b/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.txt index 6637e712..3fd0711a 100644 --- a/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.txt +++ b/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.txt @@ -88,6 +88,7 @@ dependencies: ==================== END: .bmad-2d-unity-game-dev/agents/game-sm.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/create-game-story.md ==================== + # Create Game Story Task ## Purpose @@ -275,6 +276,7 @@ This task ensures game development stories are immediately actionable and enable ==================== END: .bmad-2d-unity-game-dev/tasks/create-game-story.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/execute-checklist.md ==================== + # 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. @@ -364,6 +366,7 @@ The LLM will: ==================== END: .bmad-2d-unity-game-dev/tasks/execute-checklist.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/correct-course-game.md ==================== + # Correct Course Task - Game Development ## Purpose @@ -508,6 +511,7 @@ Based on the analysis and agreed path forward: ==================== END: .bmad-2d-unity-game-dev/tasks/correct-course-game.md ==================== ==================== START: .bmad-2d-unity-game-dev/templates/game-story-tmpl.yaml ==================== +# template: id: game-story-template-v3 name: Game Development Story @@ -767,6 +771,7 @@ sections: ==================== END: .bmad-2d-unity-game-dev/templates/game-story-tmpl.yaml ==================== ==================== START: .bmad-2d-unity-game-dev/checklists/game-change-checklist.md ==================== + # Game Development Change Navigation Checklist **Purpose:** To systematically guide the Game SM agent and user through analysis and planning when a significant change (performance issue, platform constraint, technical blocker, gameplay feedback) is identified during Unity game development. diff --git a/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt b/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt index 410bbdf3..904b7200 100644 --- a/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt +++ b/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt @@ -40,6 +40,7 @@ These references map directly to bundle sections: ==================== START: .bmad-2d-unity-game-dev/agent-teams/unity-2d-game-team.yaml ==================== +# bundle: name: Unity 2D Game Team icon: 🎮 @@ -163,13 +164,8 @@ commands: doc-out: Output full document kb-mode: Load full BMad knowledge base party-mode: Group chat with all agents - plan: Create detailed workflow plan before starting - plan-status: Show current workflow plan progress - plan-update: Update workflow plan status status: Show current context, active agent, and progress task: Run a specific task (list if name not specified) - workflow: Start a specific workflow (list if name not specified) - workflow-guidance: Get personalized help selecting the right workflow yolo: Toggle skip confirmations mode exit: Return to BMad or exit session help-display-template: | @@ -481,6 +477,7 @@ dependencies: ==================== END: .bmad-2d-unity-game-dev/agents/game-sm.md ==================== ==================== START: .bmad-2d-unity-game-dev/data/bmad-kb.md ==================== + # BMad Knowledge Base - 2D Unity Game Development ## Overview @@ -1253,6 +1250,7 @@ This knowledge base provides the foundation for effective game development using ==================== END: .bmad-2d-unity-game-dev/data/bmad-kb.md ==================== ==================== START: .bmad-2d-unity-game-dev/data/brainstorming-techniques.md ==================== + # Brainstorming Techniques Data ## Creative Expansion @@ -1292,6 +1290,7 @@ This knowledge base provides the foundation for effective game development using ==================== END: .bmad-2d-unity-game-dev/data/brainstorming-techniques.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/advanced-elicitation.md ==================== + # Advanced Game Design Elicitation Task ## Purpose @@ -1405,6 +1404,7 @@ The questions and perspectives offered should always consider: ==================== END: .bmad-2d-unity-game-dev/tasks/advanced-elicitation.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/create-deep-research-prompt.md ==================== + # Create Deep Research Prompt Task This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation. @@ -1686,6 +1686,7 @@ CRITICAL: collaborate with the user to develop specific, actionable research que ==================== END: .bmad-2d-unity-game-dev/tasks/create-deep-research-prompt.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/create-doc.md ==================== + # Create Document from Template (YAML Driven) ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️ @@ -1790,6 +1791,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once). ==================== END: .bmad-2d-unity-game-dev/tasks/create-doc.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/document-project.md ==================== + # Document an Existing Project ## Purpose @@ -2136,6 +2138,7 @@ Apply the advanced elicitation task after major sections to refine based on user ==================== END: .bmad-2d-unity-game-dev/tasks/document-project.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/facilitate-brainstorming-session.md ==================== + --- docOutputLocation: docs/brainstorming-session-results.md template: '.bmad-2d-unity-game-dev/templates/brainstorming-output-tmpl.yaml' @@ -2430,10 +2433,11 @@ sections: content: | --- - *Session facilitated using the BMAD-METHOD brainstorming framework* + *Session facilitated using the BMAD-METHOD™ brainstorming framework* ==================== END: .bmad-2d-unity-game-dev/templates/brainstorming-output-tmpl.yaml ==================== ==================== START: .bmad-2d-unity-game-dev/templates/competitor-analysis-tmpl.yaml ==================== +# template: id: competitor-analysis-template-v2 name: Competitive Analysis Report @@ -2743,6 +2747,7 @@ sections: ==================== END: .bmad-2d-unity-game-dev/templates/competitor-analysis-tmpl.yaml ==================== ==================== START: .bmad-2d-unity-game-dev/templates/market-research-tmpl.yaml ==================== +# template: id: market-research-template-v2 name: Market Research Report @@ -2998,6 +3003,7 @@ sections: ==================== END: .bmad-2d-unity-game-dev/templates/market-research-tmpl.yaml ==================== ==================== START: .bmad-2d-unity-game-dev/templates/project-brief-tmpl.yaml ==================== +# template: id: project-brief-template-v2 name: Project Brief @@ -3222,6 +3228,7 @@ sections: ==================== END: .bmad-2d-unity-game-dev/templates/project-brief-tmpl.yaml ==================== ==================== START: .bmad-2d-unity-game-dev/data/elicitation-methods.md ==================== + # Elicitation Methods Data ## Core Reflective Methods @@ -3379,6 +3386,7 @@ sections: ==================== END: .bmad-2d-unity-game-dev/data/elicitation-methods.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/kb-mode-interaction.md ==================== + # KB Mode Interaction Task ## Purpose @@ -3457,6 +3465,7 @@ Or ask me about anything else related to BMad-Method! ==================== END: .bmad-2d-unity-game-dev/tasks/kb-mode-interaction.md ==================== ==================== START: .bmad-2d-unity-game-dev/utils/workflow-management.md ==================== + # Workflow Management Enables BMad orchestrator to manage and execute team workflows. @@ -3529,6 +3538,7 @@ Agents should be workflow-aware: know active workflow, their role, access artifa ==================== END: .bmad-2d-unity-game-dev/utils/workflow-management.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/execute-checklist.md ==================== + # 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. @@ -3618,6 +3628,7 @@ The LLM will: ==================== END: .bmad-2d-unity-game-dev/tasks/execute-checklist.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/shard-doc.md ==================== + # Document Sharding Task ## Purpose @@ -3806,6 +3817,7 @@ Document sharded successfully: ==================== END: .bmad-2d-unity-game-dev/tasks/shard-doc.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/game-design-brainstorming.md ==================== + # Game Design Brainstorming Techniques Task This task provides a comprehensive toolkit of creative brainstorming techniques specifically designed for game design ideation and innovative thinking. The game designer can use these techniques to facilitate productive brainstorming sessions focused on game mechanics, player experience, and creative concepts. @@ -4099,6 +4111,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques ==================== END: .bmad-2d-unity-game-dev/tasks/game-design-brainstorming.md ==================== ==================== START: .bmad-2d-unity-game-dev/templates/game-design-doc-tmpl.yaml ==================== +# template: id: game-design-doc-template-v3 name: Game Design Document (GDD) @@ -4807,6 +4820,7 @@ sections: ==================== END: .bmad-2d-unity-game-dev/templates/game-design-doc-tmpl.yaml ==================== ==================== START: .bmad-2d-unity-game-dev/templates/level-design-doc-tmpl.yaml ==================== +# template: id: level-design-doc-template-v2 name: Level Design Document @@ -5294,6 +5308,7 @@ sections: ==================== END: .bmad-2d-unity-game-dev/templates/level-design-doc-tmpl.yaml ==================== ==================== START: .bmad-2d-unity-game-dev/templates/game-brief-tmpl.yaml ==================== +# template: id: game-brief-template-v3 name: Game Brief @@ -5653,6 +5668,7 @@ sections: ==================== END: .bmad-2d-unity-game-dev/templates/game-brief-tmpl.yaml ==================== ==================== START: .bmad-2d-unity-game-dev/checklists/game-design-checklist.md ==================== + # Game Design Document Quality Checklist ## Document Completeness @@ -5857,6 +5873,7 @@ _Outline immediate next actions for the team based on this assessment._ ==================== END: .bmad-2d-unity-game-dev/checklists/game-design-checklist.md ==================== ==================== START: .bmad-2d-unity-game-dev/templates/game-architecture-tmpl.yaml ==================== +# template: id: game-architecture-template-v3 name: Game Architecture Document @@ -6890,6 +6907,7 @@ sections: ==================== END: .bmad-2d-unity-game-dev/templates/game-architecture-tmpl.yaml ==================== ==================== START: .bmad-2d-unity-game-dev/checklists/game-architect-checklist.md ==================== + # Game Architect Solution Validation Checklist This checklist serves as a comprehensive framework for the Game Architect to validate the technical design and architecture before game development execution. The Game Architect should systematically work through each item, ensuring the game architecture is robust, scalable, performant, and aligned with the Game Design Document requirements. @@ -7284,6 +7302,7 @@ After presenting the report, ask the user if they would like detailed analysis o ==================== END: .bmad-2d-unity-game-dev/checklists/game-architect-checklist.md ==================== ==================== START: .bmad-2d-unity-game-dev/data/development-guidelines.md ==================== + # Game Development Guidelines (Unity & C#) ## Overview @@ -7873,6 +7892,7 @@ These guidelines ensure consistent, high-quality game development that meets per ==================== END: .bmad-2d-unity-game-dev/data/development-guidelines.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/validate-next-story.md ==================== + # Validate Next Story Task ## Purpose @@ -8010,6 +8030,7 @@ Provide a structured validation report including: ==================== END: .bmad-2d-unity-game-dev/tasks/validate-next-story.md ==================== ==================== START: .bmad-2d-unity-game-dev/checklists/game-story-dod-checklist.md ==================== + # Game Development Story Definition of Done (DoD) Checklist ## Instructions for Developer Agent @@ -8137,6 +8158,7 @@ Be honest - it's better to flag issues now than have them discovered during play ==================== END: .bmad-2d-unity-game-dev/checklists/game-story-dod-checklist.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/create-game-story.md ==================== + # Create Game Story Task ## Purpose @@ -8324,6 +8346,7 @@ This task ensures game development stories are immediately actionable and enable ==================== END: .bmad-2d-unity-game-dev/tasks/create-game-story.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/correct-course-game.md ==================== + # Correct Course Task - Game Development ## Purpose @@ -8468,6 +8491,7 @@ Based on the analysis and agreed path forward: ==================== END: .bmad-2d-unity-game-dev/tasks/correct-course-game.md ==================== ==================== START: .bmad-2d-unity-game-dev/templates/game-story-tmpl.yaml ==================== +# template: id: game-story-template-v3 name: Game Development Story @@ -8727,6 +8751,7 @@ sections: ==================== END: .bmad-2d-unity-game-dev/templates/game-story-tmpl.yaml ==================== ==================== START: .bmad-2d-unity-game-dev/checklists/game-change-checklist.md ==================== + # Game Development Change Navigation Checklist **Purpose:** To systematically guide the Game SM agent and user through analysis and planning when a significant change (performance issue, platform constraint, technical blocker, gameplay feedback) is identified during Unity game development. @@ -8933,6 +8958,7 @@ Keep it technically precise and actionable.]] ==================== END: .bmad-2d-unity-game-dev/checklists/game-change-checklist.md ==================== ==================== START: .bmad-2d-unity-game-dev/templates/game-architecture-tmpl.yaml ==================== +# template: id: game-architecture-template-v3 name: Game Architecture Document @@ -9966,6 +9992,7 @@ sections: ==================== END: .bmad-2d-unity-game-dev/templates/game-architecture-tmpl.yaml ==================== ==================== START: .bmad-2d-unity-game-dev/templates/game-brief-tmpl.yaml ==================== +# template: id: game-brief-template-v3 name: Game Brief @@ -10325,6 +10352,7 @@ sections: ==================== END: .bmad-2d-unity-game-dev/templates/game-brief-tmpl.yaml ==================== ==================== START: .bmad-2d-unity-game-dev/templates/game-design-doc-tmpl.yaml ==================== +# template: id: game-design-doc-template-v3 name: Game Design Document (GDD) @@ -11033,6 +11061,7 @@ sections: ==================== END: .bmad-2d-unity-game-dev/templates/game-design-doc-tmpl.yaml ==================== ==================== START: .bmad-2d-unity-game-dev/templates/game-story-tmpl.yaml ==================== +# template: id: game-story-template-v3 name: Game Development Story @@ -11292,6 +11321,7 @@ sections: ==================== END: .bmad-2d-unity-game-dev/templates/game-story-tmpl.yaml ==================== ==================== START: .bmad-2d-unity-game-dev/templates/level-design-doc-tmpl.yaml ==================== +# template: id: level-design-doc-template-v2 name: Level Design Document @@ -11779,6 +11809,7 @@ sections: ==================== END: .bmad-2d-unity-game-dev/templates/level-design-doc-tmpl.yaml ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/advanced-elicitation.md ==================== + # Advanced Game Design Elicitation Task ## Purpose @@ -11892,6 +11923,7 @@ The questions and perspectives offered should always consider: ==================== END: .bmad-2d-unity-game-dev/tasks/advanced-elicitation.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/correct-course-game.md ==================== + # Correct Course Task - Game Development ## Purpose @@ -12036,6 +12068,7 @@ Based on the analysis and agreed path forward: ==================== END: .bmad-2d-unity-game-dev/tasks/correct-course-game.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/create-game-story.md ==================== + # Create Game Story Task ## Purpose @@ -12223,6 +12256,7 @@ This task ensures game development stories are immediately actionable and enable ==================== END: .bmad-2d-unity-game-dev/tasks/create-game-story.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/game-design-brainstorming.md ==================== + # Game Design Brainstorming Techniques Task This task provides a comprehensive toolkit of creative brainstorming techniques specifically designed for game design ideation and innovative thinking. The game designer can use these techniques to facilitate productive brainstorming sessions focused on game mechanics, player experience, and creative concepts. @@ -12516,6 +12550,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques ==================== END: .bmad-2d-unity-game-dev/tasks/game-design-brainstorming.md ==================== ==================== START: .bmad-2d-unity-game-dev/tasks/validate-game-story.md ==================== + # Validate Game Story Task ## Purpose @@ -12719,6 +12754,7 @@ Based on validation results, provide specific recommendations for: ==================== END: .bmad-2d-unity-game-dev/tasks/validate-game-story.md ==================== ==================== START: .bmad-2d-unity-game-dev/checklists/game-architect-checklist.md ==================== + # Game Architect Solution Validation Checklist This checklist serves as a comprehensive framework for the Game Architect to validate the technical design and architecture before game development execution. The Game Architect should systematically work through each item, ensuring the game architecture is robust, scalable, performant, and aligned with the Game Design Document requirements. @@ -13113,6 +13149,7 @@ After presenting the report, ask the user if they would like detailed analysis o ==================== END: .bmad-2d-unity-game-dev/checklists/game-architect-checklist.md ==================== ==================== START: .bmad-2d-unity-game-dev/checklists/game-change-checklist.md ==================== + # Game Development Change Navigation Checklist **Purpose:** To systematically guide the Game SM agent and user through analysis and planning when a significant change (performance issue, platform constraint, technical blocker, gameplay feedback) is identified during Unity game development. @@ -13319,6 +13356,7 @@ Keep it technically precise and actionable.]] ==================== END: .bmad-2d-unity-game-dev/checklists/game-change-checklist.md ==================== ==================== START: .bmad-2d-unity-game-dev/checklists/game-design-checklist.md ==================== + # Game Design Document Quality Checklist ## Document Completeness @@ -13523,6 +13561,7 @@ _Outline immediate next actions for the team based on this assessment._ ==================== END: .bmad-2d-unity-game-dev/checklists/game-design-checklist.md ==================== ==================== START: .bmad-2d-unity-game-dev/checklists/game-story-dod-checklist.md ==================== + # Game Development Story Definition of Done (DoD) Checklist ## Instructions for Developer Agent @@ -13650,6 +13689,7 @@ Be honest - it's better to flag issues now than have them discovered during play ==================== END: .bmad-2d-unity-game-dev/checklists/game-story-dod-checklist.md ==================== ==================== START: .bmad-2d-unity-game-dev/workflows/game-dev-greenfield.yaml ==================== +# workflow: id: unity-game-dev-greenfield name: Game Development - Greenfield Project (Unity) @@ -13836,6 +13876,7 @@ workflow: ==================== END: .bmad-2d-unity-game-dev/workflows/game-dev-greenfield.yaml ==================== ==================== START: .bmad-2d-unity-game-dev/workflows/game-prototype.yaml ==================== +# workflow: id: unity-game-prototype name: Game Prototype Development (Unity) @@ -14014,6 +14055,7 @@ workflow: ==================== END: .bmad-2d-unity-game-dev/workflows/game-prototype.yaml ==================== ==================== START: .bmad-2d-unity-game-dev/data/bmad-kb.md ==================== + # BMad Knowledge Base - 2D Unity Game Development ## Overview @@ -14786,6 +14828,7 @@ This knowledge base provides the foundation for effective game development using ==================== END: .bmad-2d-unity-game-dev/data/bmad-kb.md ==================== ==================== START: .bmad-2d-unity-game-dev/data/development-guidelines.md ==================== + # Game Development Guidelines (Unity & C#) ## Overview diff --git a/dist/expansion-packs/bmad-creative-writing/agents/beta-reader.txt b/dist/expansion-packs/bmad-creative-writing/agents/beta-reader.txt index 1a0bf99a..ac89f03e 100644 --- a/dist/expansion-packs/bmad-creative-writing/agents/beta-reader.txt +++ b/dist/expansion-packs/bmad-creative-writing/agents/beta-reader.txt @@ -102,6 +102,7 @@ dependencies: You are the Beta Reader, the story's first audience. You experience the narrative as readers will, catching issues that authors are too close to see. Monitor: + - **Confusion triggers**: unclear motivations, missing context - **Engagement valleys**: where attention wanders - **Logic breaks**: plot holes and inconsistencies @@ -115,6 +116,7 @@ Remember to present all options as numbered lists for easy selection. ==================== END: .bmad-creative-writing/agents/beta-reader.md ==================== ==================== START: .bmad-creative-writing/tasks/create-doc.md ==================== + # Create Document from Template (YAML Driven) ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️ @@ -219,63 +221,82 @@ 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/provide-feedback.md ==================== + # ------------------------------------------------------------ + # 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 +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 -... + +- 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 + ... ==================== END: .bmad-creative-writing/tasks/provide-feedback.md ==================== ==================== START: .bmad-creative-writing/tasks/quick-feedback.md ==================== + # ------------------------------------------------------------ + # 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 +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 -... + +- chapter-dialog.md + steps: +- Use condensed beta-feedback-form. + output: chapter-notes.md + ... ==================== END: .bmad-creative-writing/tasks/quick-feedback.md ==================== ==================== START: .bmad-creative-writing/tasks/analyze-reader-feedback.md ==================== + # ------------------------------------------------------------ + # 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 + ... ==================== END: .bmad-creative-writing/tasks/analyze-reader-feedback.md ==================== ==================== START: .bmad-creative-writing/tasks/execute-checklist.md ==================== + # 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. @@ -287,7 +308,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 @@ -300,14 +320,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 @@ -316,7 +334,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 @@ -324,7 +341,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 @@ -338,7 +354,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 @@ -348,7 +363,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 @@ -372,6 +386,7 @@ The LLM will: ==================== END: .bmad-creative-writing/tasks/execute-checklist.md ==================== ==================== START: .bmad-creative-writing/tasks/advanced-elicitation.md ==================== + # Advanced Elicitation Task ## Purpose @@ -492,6 +507,7 @@ Choose a number (0-8) or 9 to proceed: ==================== END: .bmad-creative-writing/tasks/advanced-elicitation.md ==================== ==================== START: .bmad-creative-writing/templates/beta-feedback-form.yaml ==================== +# --- template: id: beta-feedback-form-tmpl @@ -591,25 +607,32 @@ sections: ==================== END: .bmad-creative-writing/templates/beta-feedback-form.yaml ==================== ==================== START: .bmad-creative-writing/checklists/beta-feedback-closure-checklist.md ==================== + # ------------------------------------------------------------ + # 6. Beta‑Feedback Closure Checklist + # ------------------------------------------------------------ + --- + checklist: - id: beta-feedback-closure-checklist - name: Beta‑Feedback Closure Checklist - description: Ensure all beta reader notes are addressed or consciously deferred. +id: beta-feedback-closure-checklist +name: Beta‑Feedback Closure Checklist +description: Ensure all beta reader notes are addressed or consciously deferred. items: - - "[ ] Each beta note categorized (Fix/Ignore/Consider)" - - "[ ] Fixes implemented in manuscript" - - "[ ] ‘Ignore’ notes documented with rationale" - - "[ ] ‘Consider’ notes scheduled for future pass" - - "[ ] Beta readers acknowledged in back matter" - - "[ ] Summary of changes logged in retro.md" -... + +- "[ ] Each beta note categorized (Fix/Ignore/Consider)" +- "[ ] Fixes implemented in manuscript" +- "[ ] ‘Ignore’ notes documented with rationale" +- "[ ] ‘Consider’ notes scheduled for future pass" +- "[ ] Beta readers acknowledged in back matter" +- "[ ] Summary of changes logged in retro.md" + ... ==================== END: .bmad-creative-writing/checklists/beta-feedback-closure-checklist.md ==================== ==================== START: .bmad-creative-writing/data/bmad-kb.md ==================== + # BMad Creative Writing Knowledge Base ## Overview @@ -715,24 +738,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 @@ -741,6 +768,7 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating ## Genre Support ### Built-in Genre Checklists + - Fantasy & Sci-Fi - Romance & Thriller - Mystery & Horror @@ -748,6 +776,7 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating - Young Adult Each genre includes: + - Trope management - Reader expectations - Market positioning @@ -756,24 +785,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 @@ -810,14 +843,17 @@ 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 ==================== + # 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%) @@ -833,7 +869,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 @@ -848,6 +886,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 @@ -857,6 +896,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c 7. Resolution ## Freytag's Pyramid + 1. Exposition 2. Rising Action 3. Climax @@ -864,6 +904,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c 5. Denouement ## Kishōtenketsu (Japanese) + - **Ki**: Introduction - **Shō**: Development - **Ten**: Twist diff --git a/dist/expansion-packs/bmad-creative-writing/agents/book-critic.txt b/dist/expansion-packs/bmad-creative-writing/agents/book-critic.txt index 7446dbe2..1c67dbda 100644 --- a/dist/expansion-packs/bmad-creative-writing/agents/book-critic.txt +++ b/dist/expansion-packs/bmad-creative-writing/agents/book-critic.txt @@ -40,8 +40,10 @@ These references map directly to bundle sections: ==================== START: .bmad-creative-writing/agents/book-critic.md ==================== -# Book Critic Agent Definition -# ------------------------------------------------------- +# book-critic + +CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode: + ```yaml agent: name: Evelyn Clarke @@ -72,7 +74,8 @@ commands: - exit: Say goodbye as the Book Critic and abandon persona dependencies: tasks: - - critical-review # ensure this task exists; otherwise agent handles logic inline + - critical-review checklists: - - genre-tropes-checklist # optional, enhances genre comparison + - genre-tropes-checklist +``` ==================== END: .bmad-creative-writing/agents/book-critic.md ==================== diff --git a/dist/expansion-packs/bmad-creative-writing/agents/character-psychologist.txt b/dist/expansion-packs/bmad-creative-writing/agents/character-psychologist.txt index ee519f57..eda103aa 100644 --- a/dist/expansion-packs/bmad-creative-writing/agents/character-psychologist.txt +++ b/dist/expansion-packs/bmad-creative-writing/agents/character-psychologist.txt @@ -101,6 +101,7 @@ dependencies: You are the Character Psychologist, an expert in human nature and its fictional representation. You understand that compelling characters emerge from the intersection of desire, fear, and circumstance. Focus on: + - **Core wounds** that shape worldview - **Defense mechanisms** that create behavior patterns - **Ghost/lie/want/need** framework @@ -114,6 +115,7 @@ Remember to present all options as numbered lists for easy selection. ==================== END: .bmad-creative-writing/agents/character-psychologist.md ==================== ==================== START: .bmad-creative-writing/tasks/create-doc.md ==================== + # Create Document from Template (YAML Driven) ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️ @@ -218,35 +220,45 @@ 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/develop-character.md ==================== + # ------------------------------------------------------------ + # 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 + ... ==================== END: .bmad-creative-writing/tasks/develop-character.md ==================== ==================== START: .bmad-creative-writing/tasks/workshop-dialog.md ==================== + # 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 @@ -255,7 +267,9 @@ For each character, assess: - Emotional expression style ### 2. Subtext Analysis + For each exchange: + - What's being said directly - What's really being communicated - Power dynamics at play @@ -264,14 +278,18 @@ For each exchange: - 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 @@ -280,6 +298,7 @@ Where dialog lacks tension: - Add environmental pressure ### 5. Polish Pass + - Read aloud for rhythm - Check period authenticity - Verify character consistency @@ -288,28 +307,36 @@ Where dialog lacks tension: - Add distinctive character markers ## Output + Refined dialog with stronger voices and dramatic impact ==================== END: .bmad-creative-writing/tasks/workshop-dialog.md ==================== ==================== START: .bmad-creative-writing/tasks/character-depth-pass.md ==================== + # ------------------------------------------------------------ + # 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 + ... ==================== END: .bmad-creative-writing/tasks/character-depth-pass.md ==================== ==================== START: .bmad-creative-writing/tasks/execute-checklist.md ==================== + # 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. @@ -321,7 +348,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 @@ -334,14 +360,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 @@ -350,7 +374,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 @@ -358,7 +381,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 @@ -372,7 +394,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 @@ -382,7 +403,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 @@ -406,6 +426,7 @@ The LLM will: ==================== END: .bmad-creative-writing/tasks/execute-checklist.md ==================== ==================== START: .bmad-creative-writing/tasks/advanced-elicitation.md ==================== + # Advanced Elicitation Task ## Purpose @@ -526,6 +547,7 @@ Choose a number (0-8) or 9 to proceed: ==================== END: .bmad-creative-writing/tasks/advanced-elicitation.md ==================== ==================== START: .bmad-creative-writing/templates/character-profile-tmpl.yaml ==================== +# --- template: id: character-profile @@ -620,25 +642,32 @@ sections: ==================== END: .bmad-creative-writing/templates/character-profile-tmpl.yaml ==================== ==================== START: .bmad-creative-writing/checklists/character-consistency-checklist.md ==================== + # ------------------------------------------------------------ + # 1. Character Consistency Checklist + # ------------------------------------------------------------ + --- + checklist: - id: character-consistency-checklist - name: Character Consistency Checklist - description: Verify character details and voice remain consistent throughout the manuscript. +id: character-consistency-checklist +name: Character Consistency Checklist +description: Verify character details and voice remain consistent throughout the manuscript. items: - - "[ ] Names spelled consistently (incl. diacritics)" - - "[ ] Physical descriptors match across chapters" - - "[ ] Goals and motivations do not contradict earlier scenes" - - "[ ] Character voice (speech patterns, vocabulary) is uniform" - - "[ ] Relationships and histories align with timeline" - - "[ ] Internal conflict/arc progression is logical" -... + +- "[ ] Names spelled consistently (incl. diacritics)" +- "[ ] Physical descriptors match across chapters" +- "[ ] Goals and motivations do not contradict earlier scenes" +- "[ ] Character voice (speech patterns, vocabulary) is uniform" +- "[ ] Relationships and histories align with timeline" +- "[ ] Internal conflict/arc progression is logical" + ... ==================== END: .bmad-creative-writing/checklists/character-consistency-checklist.md ==================== ==================== START: .bmad-creative-writing/data/bmad-kb.md ==================== + # BMad Creative Writing Knowledge Base ## Overview @@ -744,24 +773,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 @@ -770,6 +803,7 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating ## Genre Support ### Built-in Genre Checklists + - Fantasy & Sci-Fi - Romance & Thriller - Mystery & Horror @@ -777,6 +811,7 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating - Young Adult Each genre includes: + - Trope management - Reader expectations - Market positioning @@ -785,24 +820,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 diff --git a/dist/expansion-packs/bmad-creative-writing/agents/dialog-specialist.txt b/dist/expansion-packs/bmad-creative-writing/agents/dialog-specialist.txt index e3fdbcad..fea7f2b1 100644 --- a/dist/expansion-packs/bmad-creative-writing/agents/dialog-specialist.txt +++ b/dist/expansion-packs/bmad-creative-writing/agents/dialog-specialist.txt @@ -100,6 +100,7 @@ dependencies: You are the Dialog Specialist, translator of human interaction into compelling fiction. You understand that great dialog does multiple jobs simultaneously. Master: + - **Naturalistic flow** without real speech's redundancy - **Character-specific** vocabulary and rhythm - **Subtext and implication** over direct statement @@ -113,6 +114,7 @@ Remember to present all options as numbered lists for easy selection. ==================== END: .bmad-creative-writing/agents/dialog-specialist.md ==================== ==================== START: .bmad-creative-writing/tasks/create-doc.md ==================== + # Create Document from Template (YAML Driven) ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️ @@ -217,15 +219,19 @@ 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/workshop-dialog.md ==================== + # 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 @@ -234,7 +240,9 @@ For each character, assess: - Emotional expression style ### 2. Subtext Analysis + For each exchange: + - What's being said directly - What's really being communicated - Power dynamics at play @@ -243,14 +251,18 @@ For each exchange: - 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 @@ -259,6 +271,7 @@ Where dialog lacks tension: - Add environmental pressure ### 5. Polish Pass + - Read aloud for rhythm - Check period authenticity - Verify character consistency @@ -267,10 +280,12 @@ Where dialog lacks tension: - Add distinctive character markers ## Output + Refined dialog with stronger voices and dramatic impact ==================== END: .bmad-creative-writing/tasks/workshop-dialog.md ==================== ==================== START: .bmad-creative-writing/tasks/execute-checklist.md ==================== + # 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. @@ -282,7 +297,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 @@ -295,14 +309,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 @@ -311,7 +323,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 @@ -319,7 +330,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 @@ -333,7 +343,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 @@ -343,7 +352,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 @@ -367,6 +375,7 @@ The LLM will: ==================== END: .bmad-creative-writing/tasks/execute-checklist.md ==================== ==================== START: .bmad-creative-writing/tasks/advanced-elicitation.md ==================== + # Advanced Elicitation Task ## Purpose @@ -487,6 +496,7 @@ Choose a number (0-8) or 9 to proceed: ==================== END: .bmad-creative-writing/tasks/advanced-elicitation.md ==================== ==================== START: .bmad-creative-writing/templates/character-profile-tmpl.yaml ==================== +# --- template: id: character-profile @@ -581,25 +591,32 @@ sections: ==================== END: .bmad-creative-writing/templates/character-profile-tmpl.yaml ==================== ==================== START: .bmad-creative-writing/checklists/comedic-timing-checklist.md ==================== + # ------------------------------------------------------------ + # 23. Comedic Timing & Humor Checklist + # ------------------------------------------------------------ + --- + checklist: - id: comedic-timing-checklist - name: Comedic Timing & Humor Checklist - description: Ensure jokes land and humorous beats serve character/plot. +id: comedic-timing-checklist +name: Comedic Timing & Humor Checklist +description: Ensure jokes land and humorous beats serve character/plot. items: - - "[ ] Setup, beat, punchline structure clear" - - "[ ] Humor aligns with character voice" - - "[ ] Cultural references understandable by target audience" - - "[ ] No conflicting tone in serious scenes" - - "[ ] Callback jokes spaced for maximum payoff" - - "[ ] Physical comedy described with vivid imagery" -... + +- "[ ] Setup, beat, punchline structure clear" +- "[ ] Humor aligns with character voice" +- "[ ] Cultural references understandable by target audience" +- "[ ] No conflicting tone in serious scenes" +- "[ ] Callback jokes spaced for maximum payoff" +- "[ ] Physical comedy described with vivid imagery" + ... ==================== END: .bmad-creative-writing/checklists/comedic-timing-checklist.md ==================== ==================== START: .bmad-creative-writing/data/bmad-kb.md ==================== + # BMad Creative Writing Knowledge Base ## Overview @@ -705,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 @@ -731,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 @@ -738,6 +760,7 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating - Young Adult Each genre includes: + - Trope management - Reader expectations - Market positioning @@ -746,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 @@ -800,14 +827,17 @@ 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 ==================== + # 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%) @@ -823,7 +853,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 @@ -838,6 +870,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 @@ -847,6 +880,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c 7. Resolution ## Freytag's Pyramid + 1. Exposition 2. Rising Action 3. Climax @@ -854,6 +888,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c 5. Denouement ## Kishōtenketsu (Japanese) + - **Ki**: Introduction - **Shō**: Development - **Ten**: Twist diff --git a/dist/expansion-packs/bmad-creative-writing/agents/editor.txt b/dist/expansion-packs/bmad-creative-writing/agents/editor.txt index 3c9cea91..9e19ce41 100644 --- a/dist/expansion-packs/bmad-creative-writing/agents/editor.txt +++ b/dist/expansion-packs/bmad-creative-writing/agents/editor.txt @@ -101,6 +101,7 @@ dependencies: You are the Editor, defender of clear, powerful prose. You balance respect for authorial voice with the demands of readability and market expectations. Focus on: + - **Micro-level**: word choice, sentence structure, grammar - **Meso-level**: paragraph flow, scene transitions, pacing - **Macro-level**: chapter structure, act breaks, overall arc @@ -114,6 +115,7 @@ Remember to present all options as numbered lists for easy selection. ==================== END: .bmad-creative-writing/agents/editor.md ==================== ==================== START: .bmad-creative-writing/tasks/create-doc.md ==================== + # Create Document from Template (YAML Driven) ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️ @@ -218,46 +220,59 @@ 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/final-polish.md ==================== + # ------------------------------------------------------------ + # 14. Final Polish + # ------------------------------------------------------------ + --- + task: - id: final-polish - name: Final Polish - description: Line‑edit for style, clarity, grammar. - persona_default: editor +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 -... + +- chapter-dialog.md | polished-manuscript.md + steps: +- Correct grammar and tighten prose. +- Ensure consistent voice. + output: chapter-final.md | final-manuscript.md + ... ==================== END: .bmad-creative-writing/tasks/final-polish.md ==================== ==================== START: .bmad-creative-writing/tasks/incorporate-feedback.md ==================== + # ------------------------------------------------------------ + # 6. Incorporate Feedback + # ------------------------------------------------------------ + --- + task: - id: incorporate-feedback - name: Incorporate Feedback - description: Merge beta feedback into manuscript; accept, reject, or revise. - persona_default: editor +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 -... + +- draft-manuscript.md +- beta-notes.md + steps: +- Summarize actionable changes. +- Apply revisions inline. +- Mark resolved comments. + output: polished-manuscript.md + ... ==================== END: .bmad-creative-writing/tasks/incorporate-feedback.md ==================== ==================== START: .bmad-creative-writing/tasks/execute-checklist.md ==================== + # 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. @@ -269,7 +284,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 @@ -282,14 +296,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 @@ -298,7 +310,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 @@ -306,7 +317,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 @@ -320,7 +330,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 @@ -330,7 +339,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 @@ -354,6 +362,7 @@ The LLM will: ==================== END: .bmad-creative-writing/tasks/execute-checklist.md ==================== ==================== START: .bmad-creative-writing/tasks/advanced-elicitation.md ==================== + # Advanced Elicitation Task ## Purpose @@ -474,6 +483,7 @@ Choose a number (0-8) or 9 to proceed: ==================== END: .bmad-creative-writing/tasks/advanced-elicitation.md ==================== ==================== START: .bmad-creative-writing/templates/chapter-draft-tmpl.yaml ==================== +# --- template: id: chapter-draft-tmpl @@ -558,44 +568,57 @@ sections: ==================== END: .bmad-creative-writing/templates/chapter-draft-tmpl.yaml ==================== ==================== START: .bmad-creative-writing/checklists/line-edit-quality-checklist.md ==================== + # ------------------------------------------------------------ + # 4. Line‑Edit Quality Checklist + # ------------------------------------------------------------ + --- + checklist: - id: line-edit-quality-checklist - name: Line‑Edit Quality Checklist - description: Copy‑editing pass for clarity, grammar, and style. +id: line-edit-quality-checklist +name: Line‑Edit Quality Checklist +description: Copy‑editing pass for clarity, grammar, and style. items: - - "[ ] Grammar/spelling free of errors" - - "[ ] Passive voice minimized (target <15%)" - - "[ ] Repetitious words/phrases trimmed" - - "[ ] Dialogue punctuation correct" - - "[ ] Sentences varied in length/rhythm" - - "[ ] Consistent tense and POV" -... + +- "[ ] Grammar/spelling free of errors" +- "[ ] Passive voice minimized (target <15%)" +- "[ ] Repetitious words/phrases trimmed" +- "[ ] Dialogue punctuation correct" +- "[ ] Sentences varied in length/rhythm" +- "[ ] Consistent tense and POV" + ... ==================== END: .bmad-creative-writing/checklists/line-edit-quality-checklist.md ==================== ==================== START: .bmad-creative-writing/checklists/publication-readiness-checklist.md ==================== + # ------------------------------------------------------------ + # 5. Publication Readiness Checklist + # ------------------------------------------------------------ + --- + checklist: - id: publication-readiness-checklist - name: Publication Readiness Checklist - description: Final checks before releasing or submitting the manuscript. +id: publication-readiness-checklist +name: Publication Readiness Checklist +description: Final checks before releasing or submitting the manuscript. items: - - "[ ] Front matter complete (title, author, dedication)" - - "[ ] Back matter complete (acknowledgments, about author)" - - "[ ] Table of contents updated (digital)" - - "[ ] Chapter headings numbered correctly" - - "[ ] Formatting styles consistent" - - "[ ] Metadata (ISBN, keywords) embedded" -... + +- "[ ] Front matter complete (title, author, dedication)" +- "[ ] Back matter complete (acknowledgments, about author)" +- "[ ] Table of contents updated (digital)" +- "[ ] Chapter headings numbered correctly" +- "[ ] Formatting styles consistent" +- "[ ] Metadata (ISBN, keywords) embedded" + ... ==================== END: .bmad-creative-writing/checklists/publication-readiness-checklist.md ==================== ==================== START: .bmad-creative-writing/data/bmad-kb.md ==================== + # BMad Creative Writing Knowledge Base ## Overview @@ -701,24 +724,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 @@ -727,6 +754,7 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating ## Genre Support ### Built-in Genre Checklists + - Fantasy & Sci-Fi - Romance & Thriller - Mystery & Horror @@ -734,6 +762,7 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating - Young Adult Each genre includes: + - Trope management - Reader expectations - Market positioning @@ -742,24 +771,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 diff --git a/dist/expansion-packs/bmad-creative-writing/agents/genre-specialist.txt b/dist/expansion-packs/bmad-creative-writing/agents/genre-specialist.txt index d2c93ee4..bf3715b2 100644 --- a/dist/expansion-packs/bmad-creative-writing/agents/genre-specialist.txt +++ b/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,7 @@ 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 ==================== + # Create Document from Template (YAML Driven) ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️ @@ -220,16 +222,19 @@ 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 ==================== + # 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 +243,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 +251,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 +261,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 +269,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 +286,12 @@ 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 ==================== + # 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 +303,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 +315,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 +329,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 +336,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 +349,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 +358,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 +381,7 @@ The LLM will: ==================== END: .bmad-creative-writing/tasks/execute-checklist.md ==================== ==================== START: .bmad-creative-writing/tasks/advanced-elicitation.md ==================== + # Advanced Elicitation Task ## Purpose @@ -494,6 +502,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 ==================== +# --- template: id: story-outline @@ -592,80 +601,105 @@ sections: ==================== END: .bmad-creative-writing/templates/story-outline-tmpl.yaml ==================== ==================== START: .bmad-creative-writing/checklists/genre-tropes-checklist.md ==================== + # ------------------------------------------------------------ + # 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 ==================== + # ------------------------------------------------------------ + # 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 ==================== + # ------------------------------------------------------------ + # 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 ==================== + # ------------------------------------------------------------ + # 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 ==================== + # BMad Creative Writing Knowledge Base ## Overview @@ -771,24 +805,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 +835,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 +843,7 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating - Young Adult Each genre includes: + - Trope management - Reader expectations - Market positioning @@ -812,24 +852,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 +910,17 @@ 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 ==================== + # 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 +936,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 +953,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 +963,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 +971,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c 5. Denouement ## Kishōtenketsu (Japanese) + - **Ki**: Introduction - **Shō**: Development - **Ten**: Twist diff --git a/dist/expansion-packs/bmad-creative-writing/agents/narrative-designer.txt b/dist/expansion-packs/bmad-creative-writing/agents/narrative-designer.txt index 73943531..9d4ff9a2 100644 --- a/dist/expansion-packs/bmad-creative-writing/agents/narrative-designer.txt +++ b/dist/expansion-packs/bmad-creative-writing/agents/narrative-designer.txt @@ -101,6 +101,7 @@ dependencies: You are the Narrative Designer, architect of stories that respond to reader/player choices. You balance authorial vision with participant agency. Design for: + - **Meaningful choices** not false dilemmas - **Consequence chains** that feel logical - **Emotional investment** in decisions @@ -114,6 +115,7 @@ Remember to present all options as numbered lists for easy selection. ==================== END: .bmad-creative-writing/agents/narrative-designer.md ==================== ==================== START: .bmad-creative-writing/tasks/create-doc.md ==================== + # Create Document from Template (YAML Driven) ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️ @@ -218,44 +220,57 @@ 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/outline-scenes.md ==================== + # ------------------------------------------------------------ + # 11. Outline Scenes + # ------------------------------------------------------------ + --- + task: - id: outline-scenes - name: Outline Scenes - description: Group scene list into chapters with act structure. - persona_default: plot-architect +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 -... + +- scene-list.md + steps: +- Assign scenes to chapters. +- Produce snowflake-outline.md with headings per chapter. + output: snowflake-outline.md + ... ==================== END: .bmad-creative-writing/tasks/outline-scenes.md ==================== ==================== START: .bmad-creative-writing/tasks/generate-scene-list.md ==================== + # ------------------------------------------------------------ + # 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 +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 -... + +- synopsis.md | story-outline.md + steps: +- Identify key beats. +- Fill scene-list-tmpl table. + output: scene-list.md + ... ==================== END: .bmad-creative-writing/tasks/generate-scene-list.md ==================== ==================== START: .bmad-creative-writing/tasks/execute-checklist.md ==================== + # 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. @@ -267,7 +282,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 @@ -280,14 +294,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 @@ -296,7 +308,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 @@ -304,7 +315,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 @@ -318,7 +328,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 @@ -328,7 +337,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 @@ -352,6 +360,7 @@ The LLM will: ==================== END: .bmad-creative-writing/tasks/execute-checklist.md ==================== ==================== START: .bmad-creative-writing/tasks/advanced-elicitation.md ==================== + # Advanced Elicitation Task ## Purpose @@ -472,6 +481,7 @@ Choose a number (0-8) or 9 to proceed: ==================== END: .bmad-creative-writing/tasks/advanced-elicitation.md ==================== ==================== START: .bmad-creative-writing/templates/scene-list-tmpl.yaml ==================== +# --- template: id: scene-list-tmpl @@ -529,9 +539,11 @@ sections: ==================== END: .bmad-creative-writing/templates/scene-list-tmpl.yaml ==================== ==================== START: .bmad-creative-writing/checklists/plot-structure-checklist.md ==================== + # Plot Structure Checklist ## Opening + - [ ] Hook engages within first page - [ ] Genre/tone established early - [ ] World rules clear @@ -539,6 +551,7 @@ sections: - [ ] Status quo established before disruption ## Structure Fundamentals + - [ ] Inciting incident by 10-15% mark - [ ] Clear story question posed - [ ] Stakes established and clear @@ -546,19 +559,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 @@ -566,6 +583,7 @@ sections: - [ ] Dark night of soul (character lowest) ## Climax + - [ ] Protagonist must act (no rescue) - [ ] Uses lessons learned - [ ] Internal/external conflicts merge @@ -573,6 +591,7 @@ sections: - [ ] Clear win/loss/transformation ## Resolution + - [ ] New equilibrium established - [ ] Loose threads tied - [ ] Character growth demonstrated @@ -581,6 +600,7 @@ sections: ==================== END: .bmad-creative-writing/checklists/plot-structure-checklist.md ==================== ==================== START: .bmad-creative-writing/data/bmad-kb.md ==================== + # BMad Creative Writing Knowledge Base ## Overview @@ -686,24 +706,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 @@ -712,6 +736,7 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating ## Genre Support ### Built-in Genre Checklists + - Fantasy & Sci-Fi - Romance & Thriller - Mystery & Horror @@ -719,6 +744,7 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating - Young Adult Each genre includes: + - Trope management - Reader expectations - Market positioning @@ -727,24 +753,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 @@ -781,14 +811,17 @@ 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 ==================== + # 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%) @@ -804,7 +837,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 @@ -819,6 +854,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 @@ -828,6 +864,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c 7. Resolution ## Freytag's Pyramid + 1. Exposition 2. Rising Action 3. Climax @@ -835,6 +872,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c 5. Denouement ## Kishōtenketsu (Japanese) + - **Ki**: Introduction - **Shō**: Development - **Ten**: Twist diff --git a/dist/expansion-packs/bmad-creative-writing/agents/plot-architect.txt b/dist/expansion-packs/bmad-creative-writing/agents/plot-architect.txt index dcbdb674..c70e99b3 100644 --- a/dist/expansion-packs/bmad-creative-writing/agents/plot-architect.txt +++ b/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 @@ -116,6 +117,7 @@ Remember to present all options as numbered lists for easy selection. ==================== END: .bmad-creative-writing/agents/plot-architect.md ==================== ==================== START: .bmad-creative-writing/tasks/create-doc.md ==================== + # Create Document from Template (YAML Driven) ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️ @@ -220,16 +222,19 @@ 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 ==================== + # 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 +243,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 +251,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 +261,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 +269,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 +286,12 @@ 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 ==================== + # 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 +303,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 +315,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 +329,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 +336,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 +349,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 +358,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 +381,7 @@ The LLM will: ==================== END: .bmad-creative-writing/tasks/execute-checklist.md ==================== ==================== START: .bmad-creative-writing/tasks/advanced-elicitation.md ==================== + # Advanced Elicitation Task ## Purpose @@ -494,6 +502,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 ==================== +# --- template: id: story-outline @@ -592,6 +601,7 @@ sections: ==================== END: .bmad-creative-writing/templates/story-outline-tmpl.yaml ==================== ==================== START: .bmad-creative-writing/templates/premise-brief-tmpl.yaml ==================== +# --- template: id: premise-brief-tmpl @@ -672,6 +682,7 @@ sections: ==================== END: .bmad-creative-writing/templates/premise-brief-tmpl.yaml ==================== ==================== START: .bmad-creative-writing/templates/scene-list-tmpl.yaml ==================== +# --- template: id: scene-list-tmpl @@ -729,6 +740,7 @@ sections: ==================== END: .bmad-creative-writing/templates/scene-list-tmpl.yaml ==================== ==================== START: .bmad-creative-writing/templates/chapter-draft-tmpl.yaml ==================== +# --- template: id: chapter-draft-tmpl @@ -813,9 +825,11 @@ sections: ==================== END: .bmad-creative-writing/templates/chapter-draft-tmpl.yaml ==================== ==================== START: .bmad-creative-writing/checklists/plot-structure-checklist.md ==================== + # Plot Structure Checklist ## Opening + - [ ] Hook engages within first page - [ ] Genre/tone established early - [ ] World rules clear @@ -823,6 +837,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 +845,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 +869,7 @@ sections: - [ ] Dark night of soul (character lowest) ## Climax + - [ ] Protagonist must act (no rescue) - [ ] Uses lessons learned - [ ] Internal/external conflicts merge @@ -857,6 +877,7 @@ sections: - [ ] Clear win/loss/transformation ## Resolution + - [ ] New equilibrium established - [ ] Loose threads tied - [ ] Character growth demonstrated @@ -865,14 +886,17 @@ sections: ==================== END: .bmad-creative-writing/checklists/plot-structure-checklist.md ==================== ==================== START: .bmad-creative-writing/data/story-structures.md ==================== + # 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 +912,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 +929,7 @@ sections: 12. Return with Elixir ## Seven-Point Structure + 1. Hook 2. Plot Turn 1 3. Pinch Point 1 @@ -912,6 +939,7 @@ sections: 7. Resolution ## Freytag's Pyramid + 1. Exposition 2. Rising Action 3. Climax @@ -919,6 +947,7 @@ sections: 5. Denouement ## Kishōtenketsu (Japanese) + - **Ki**: Introduction - **Shō**: Development - **Ten**: Twist @@ -926,6 +955,7 @@ sections: ==================== END: .bmad-creative-writing/data/story-structures.md ==================== ==================== START: .bmad-creative-writing/data/bmad-kb.md ==================== + # BMad Creative Writing Knowledge Base ## Overview @@ -1031,24 +1061,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 +1091,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 +1099,7 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating - Young Adult Each genre includes: + - Trope management - Reader expectations - Market positioning @@ -1072,24 +1108,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 diff --git a/dist/expansion-packs/bmad-creative-writing/agents/world-builder.txt b/dist/expansion-packs/bmad-creative-writing/agents/world-builder.txt index 6566496b..d0ecd85c 100644 --- a/dist/expansion-packs/bmad-creative-writing/agents/world-builder.txt +++ b/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 @@ -115,6 +116,7 @@ Remember to present all options as numbered lists for easy selection. ==================== END: .bmad-creative-writing/agents/world-builder.md ==================== ==================== START: .bmad-creative-writing/tasks/create-doc.md ==================== + # Create Document from Template (YAML Driven) ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️ @@ -219,26 +221,33 @@ 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/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 ==================== + # 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. @@ -250,7 +259,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 +271,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 +285,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 +292,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 +305,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 +314,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 @@ -335,6 +337,7 @@ The LLM will: ==================== END: .bmad-creative-writing/tasks/execute-checklist.md ==================== ==================== START: .bmad-creative-writing/tasks/advanced-elicitation.md ==================== + # Advanced Elicitation Task ## Purpose @@ -455,6 +458,7 @@ Choose a number (0-8) or 9 to proceed: ==================== END: .bmad-creative-writing/tasks/advanced-elicitation.md ==================== ==================== START: .bmad-creative-writing/templates/world-guide-tmpl.yaml ==================== +# --- template: id: world-guide-tmpl @@ -546,63 +550,82 @@ sections: ==================== END: .bmad-creative-writing/templates/world-guide-tmpl.yaml ==================== ==================== 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 ==================== + # BMad Creative Writing Knowledge Base ## Overview @@ -708,24 +731,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 +761,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 +769,7 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating - Young Adult Each genre includes: + - Trope management - Reader expectations - Market positioning @@ -749,24 +778,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 @@ -803,14 +836,17 @@ 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 ==================== + # 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 +862,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 +879,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 +889,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 +897,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c 5. Denouement ## Kishōtenketsu (Japanese) + - **Ki**: Introduction - **Shō**: Development - **Ten**: Twist diff --git a/dist/expansion-packs/bmad-creative-writing/teams/agent-team.txt b/dist/expansion-packs/bmad-creative-writing/teams/agent-team.txt index 88e0bc1c..8a9fba64 100644 --- a/dist/expansion-packs/bmad-creative-writing/teams/agent-team.txt +++ b/dist/expansion-packs/bmad-creative-writing/teams/agent-team.txt @@ -40,6 +40,7 @@ These references map directly to bundle sections: ==================== START: .bmad-creative-writing/agent-teams/agent-team.yaml ==================== +# bundle: name: Creative Writing Team icon: ✍️ @@ -53,7 +54,7 @@ agents: - dialog-specialist - narrative-designer - genre-specialist - - book-critic # newly added professional critic agent + - book-critic # newly added professional critic agent workflows: - novel-writing - screenplay-development @@ -104,13 +105,8 @@ commands: doc-out: Output full document kb-mode: Load full BMad knowledge base party-mode: Group chat with all agents - plan: Create detailed workflow plan before starting - plan-status: Show current workflow plan progress - plan-update: Update workflow plan status status: Show current context, active agent, and progress task: Run a specific task (list if name not specified) - workflow: Start a specific workflow (list if name not specified) - workflow-guidance: Get personalized help selecting the right workflow yolo: Toggle skip confirmations mode exit: Return to BMad or exit session help-display-template: | @@ -257,6 +253,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 @@ -331,6 +328,7 @@ dependencies: You are the Character Psychologist, an expert in human nature and its fictional representation. You understand that compelling characters emerge from the intersection of desire, fear, and circumstance. Focus on: + - **Core wounds** that shape worldview - **Defense mechanisms** that create behavior patterns - **Ghost/lie/want/need** framework @@ -406,6 +404,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 @@ -480,6 +479,7 @@ dependencies: You are the Editor, defender of clear, powerful prose. You balance respect for authorial voice with the demands of readability and market expectations. Focus on: + - **Micro-level**: word choice, sentence structure, grammar - **Meso-level**: paragraph flow, scene transitions, pacing - **Macro-level**: chapter structure, act breaks, overall arc @@ -555,6 +555,7 @@ dependencies: You are the Beta Reader, the story's first audience. You experience the narrative as readers will, catching issues that authors are too close to see. Monitor: + - **Confusion triggers**: unclear motivations, missing context - **Engagement valleys**: where attention wanders - **Logic breaks**: plot holes and inconsistencies @@ -628,6 +629,7 @@ dependencies: You are the Dialog Specialist, translator of human interaction into compelling fiction. You understand that great dialog does multiple jobs simultaneously. Master: + - **Naturalistic flow** without real speech's redundancy - **Character-specific** vocabulary and rhythm - **Subtext and implication** over direct statement @@ -702,6 +704,7 @@ dependencies: You are the Narrative Designer, architect of stories that respond to reader/player choices. You balance authorial vision with participant agency. Design for: + - **Meaningful choices** not false dilemmas - **Consequence chains** that feel logical - **Emotional investment** in decisions @@ -778,8 +781,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 @@ -791,8 +795,10 @@ Remember to present all options as numbered lists for easy selection. ==================== END: .bmad-creative-writing/agents/genre-specialist.md ==================== ==================== START: .bmad-creative-writing/agents/book-critic.md ==================== -# Book Critic Agent Definition -# ------------------------------------------------------- +# book-critic + +CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode: + ```yaml agent: name: Evelyn Clarke @@ -823,12 +829,14 @@ commands: - exit: Say goodbye as the Book Critic and abandon persona dependencies: tasks: - - critical-review # ensure this task exists; otherwise agent handles logic inline + - critical-review checklists: - - genre-tropes-checklist # optional, enhances genre comparison + - genre-tropes-checklist +``` ==================== END: .bmad-creative-writing/agents/book-critic.md ==================== ==================== START: .bmad-creative-writing/data/bmad-kb.md ==================== + # BMad Creative Writing Knowledge Base ## Overview @@ -934,24 +942,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 @@ -960,6 +972,7 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating ## Genre Support ### Built-in Genre Checklists + - Fantasy & Sci-Fi - Romance & Thriller - Mystery & Horror @@ -967,6 +980,7 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating - Young Adult Each genre includes: + - Trope management - Reader expectations - Market positioning @@ -975,24 +989,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 @@ -1029,6 +1047,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c ==================== END: .bmad-creative-writing/data/bmad-kb.md ==================== ==================== START: .bmad-creative-writing/data/elicitation-methods.md ==================== + # Elicitation Methods Data ## Core Reflective Methods @@ -1186,6 +1205,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c ==================== END: .bmad-creative-writing/data/elicitation-methods.md ==================== ==================== START: .bmad-creative-writing/tasks/advanced-elicitation.md ==================== + # Advanced Elicitation Task ## Purpose @@ -1306,6 +1326,7 @@ Choose a number (0-8) or 9 to proceed: ==================== END: .bmad-creative-writing/tasks/advanced-elicitation.md ==================== ==================== START: .bmad-creative-writing/tasks/create-doc.md ==================== + # Create Document from Template (YAML Driven) ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️ @@ -1410,6 +1431,7 @@ 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/kb-mode-interaction.md ==================== + # KB Mode Interaction Task ## Purpose @@ -1488,6 +1510,7 @@ Or ask me about anything else related to BMad-Method! ==================== END: .bmad-creative-writing/tasks/kb-mode-interaction.md ==================== ==================== START: .bmad-creative-writing/utils/workflow-management.md ==================== + # Workflow Management Enables BMad orchestrator to manage and execute team workflows. @@ -1560,16 +1583,19 @@ Agents should be workflow-aware: know active workflow, their role, access artifa ==================== END: .bmad-creative-writing/utils/workflow-management.md ==================== ==================== START: .bmad-creative-writing/tasks/analyze-story-structure.md ==================== + # 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 @@ -1578,6 +1604,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? @@ -1585,7 +1612,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 @@ -1593,6 +1622,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 @@ -1600,13 +1630,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 @@ -1614,10 +1647,12 @@ 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 ==================== + # 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. @@ -1629,7 +1664,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 @@ -1642,14 +1676,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 @@ -1658,7 +1690,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 @@ -1666,7 +1697,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 @@ -1680,7 +1710,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 @@ -1690,7 +1719,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 @@ -1714,6 +1742,7 @@ The LLM will: ==================== END: .bmad-creative-writing/tasks/execute-checklist.md ==================== ==================== START: .bmad-creative-writing/templates/story-outline-tmpl.yaml ==================== +# --- template: id: story-outline @@ -1812,6 +1841,7 @@ sections: ==================== END: .bmad-creative-writing/templates/story-outline-tmpl.yaml ==================== ==================== START: .bmad-creative-writing/templates/premise-brief-tmpl.yaml ==================== +# --- template: id: premise-brief-tmpl @@ -1892,6 +1922,7 @@ sections: ==================== END: .bmad-creative-writing/templates/premise-brief-tmpl.yaml ==================== ==================== START: .bmad-creative-writing/templates/scene-list-tmpl.yaml ==================== +# --- template: id: scene-list-tmpl @@ -1949,6 +1980,7 @@ sections: ==================== END: .bmad-creative-writing/templates/scene-list-tmpl.yaml ==================== ==================== START: .bmad-creative-writing/templates/chapter-draft-tmpl.yaml ==================== +# --- template: id: chapter-draft-tmpl @@ -2033,9 +2065,11 @@ sections: ==================== END: .bmad-creative-writing/templates/chapter-draft-tmpl.yaml ==================== ==================== START: .bmad-creative-writing/checklists/plot-structure-checklist.md ==================== + # Plot Structure Checklist ## Opening + - [ ] Hook engages within first page - [ ] Genre/tone established early - [ ] World rules clear @@ -2043,6 +2077,7 @@ sections: - [ ] Status quo established before disruption ## Structure Fundamentals + - [ ] Inciting incident by 10-15% mark - [ ] Clear story question posed - [ ] Stakes established and clear @@ -2050,19 +2085,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 @@ -2070,6 +2109,7 @@ sections: - [ ] Dark night of soul (character lowest) ## Climax + - [ ] Protagonist must act (no rescue) - [ ] Uses lessons learned - [ ] Internal/external conflicts merge @@ -2077,6 +2117,7 @@ sections: - [ ] Clear win/loss/transformation ## Resolution + - [ ] New equilibrium established - [ ] Loose threads tied - [ ] Character growth demonstrated @@ -2085,14 +2126,17 @@ sections: ==================== END: .bmad-creative-writing/checklists/plot-structure-checklist.md ==================== ==================== START: .bmad-creative-writing/data/story-structures.md ==================== + # 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%) @@ -2108,7 +2152,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 @@ -2123,6 +2169,7 @@ sections: 12. Return with Elixir ## Seven-Point Structure + 1. Hook 2. Plot Turn 1 3. Pinch Point 1 @@ -2132,6 +2179,7 @@ sections: 7. Resolution ## Freytag's Pyramid + 1. Exposition 2. Rising Action 3. Climax @@ -2139,6 +2187,7 @@ sections: 5. Denouement ## Kishōtenketsu (Japanese) + - **Ki**: Introduction - **Shō**: Development - **Ten**: Twist @@ -2146,35 +2195,45 @@ sections: ==================== END: .bmad-creative-writing/data/story-structures.md ==================== ==================== START: .bmad-creative-writing/tasks/develop-character.md ==================== + # ------------------------------------------------------------ + # 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 + ... ==================== END: .bmad-creative-writing/tasks/develop-character.md ==================== ==================== START: .bmad-creative-writing/tasks/workshop-dialog.md ==================== + # 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 @@ -2183,7 +2242,9 @@ For each character, assess: - Emotional expression style ### 2. Subtext Analysis + For each exchange: + - What's being said directly - What's really being communicated - Power dynamics at play @@ -2192,14 +2253,18 @@ For each exchange: - 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 @@ -2208,6 +2273,7 @@ Where dialog lacks tension: - Add environmental pressure ### 5. Polish Pass + - Read aloud for rhythm - Check period authenticity - Verify character consistency @@ -2216,28 +2282,36 @@ Where dialog lacks tension: - Add distinctive character markers ## Output + Refined dialog with stronger voices and dramatic impact ==================== END: .bmad-creative-writing/tasks/workshop-dialog.md ==================== ==================== START: .bmad-creative-writing/tasks/character-depth-pass.md ==================== + # ------------------------------------------------------------ + # 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 + ... ==================== END: .bmad-creative-writing/tasks/character-depth-pass.md ==================== ==================== START: .bmad-creative-writing/templates/character-profile-tmpl.yaml ==================== +# --- template: id: character-profile @@ -2332,45 +2406,58 @@ sections: ==================== END: .bmad-creative-writing/templates/character-profile-tmpl.yaml ==================== ==================== START: .bmad-creative-writing/checklists/character-consistency-checklist.md ==================== + # ------------------------------------------------------------ + # 1. Character Consistency Checklist + # ------------------------------------------------------------ + --- + checklist: - id: character-consistency-checklist - name: Character Consistency Checklist - description: Verify character details and voice remain consistent throughout the manuscript. +id: character-consistency-checklist +name: Character Consistency Checklist +description: Verify character details and voice remain consistent throughout the manuscript. items: - - "[ ] Names spelled consistently (incl. diacritics)" - - "[ ] Physical descriptors match across chapters" - - "[ ] Goals and motivations do not contradict earlier scenes" - - "[ ] Character voice (speech patterns, vocabulary) is uniform" - - "[ ] Relationships and histories align with timeline" - - "[ ] Internal conflict/arc progression is logical" -... + +- "[ ] Names spelled consistently (incl. diacritics)" +- "[ ] Physical descriptors match across chapters" +- "[ ] Goals and motivations do not contradict earlier scenes" +- "[ ] Character voice (speech patterns, vocabulary) is uniform" +- "[ ] Relationships and histories align with timeline" +- "[ ] Internal conflict/arc progression is logical" + ... ==================== END: .bmad-creative-writing/checklists/character-consistency-checklist.md ==================== ==================== 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/templates/world-guide-tmpl.yaml ==================== +# --- template: id: world-guide-tmpl @@ -2462,198 +2549,259 @@ sections: ==================== END: .bmad-creative-writing/templates/world-guide-tmpl.yaml ==================== ==================== 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/tasks/final-polish.md ==================== + # ------------------------------------------------------------ + # 14. Final Polish + # ------------------------------------------------------------ + --- + task: - id: final-polish - name: Final Polish - description: Line‑edit for style, clarity, grammar. - persona_default: editor +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 -... + +- chapter-dialog.md | polished-manuscript.md + steps: +- Correct grammar and tighten prose. +- Ensure consistent voice. + output: chapter-final.md | final-manuscript.md + ... ==================== END: .bmad-creative-writing/tasks/final-polish.md ==================== ==================== START: .bmad-creative-writing/tasks/incorporate-feedback.md ==================== + # ------------------------------------------------------------ + # 6. Incorporate Feedback + # ------------------------------------------------------------ + --- + task: - id: incorporate-feedback - name: Incorporate Feedback - description: Merge beta feedback into manuscript; accept, reject, or revise. - persona_default: editor +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 -... + +- draft-manuscript.md +- beta-notes.md + steps: +- Summarize actionable changes. +- Apply revisions inline. +- Mark resolved comments. + output: polished-manuscript.md + ... ==================== END: .bmad-creative-writing/tasks/incorporate-feedback.md ==================== ==================== START: .bmad-creative-writing/checklists/line-edit-quality-checklist.md ==================== + # ------------------------------------------------------------ + # 4. Line‑Edit Quality Checklist + # ------------------------------------------------------------ + --- + checklist: - id: line-edit-quality-checklist - name: Line‑Edit Quality Checklist - description: Copy‑editing pass for clarity, grammar, and style. +id: line-edit-quality-checklist +name: Line‑Edit Quality Checklist +description: Copy‑editing pass for clarity, grammar, and style. items: - - "[ ] Grammar/spelling free of errors" - - "[ ] Passive voice minimized (target <15%)" - - "[ ] Repetitious words/phrases trimmed" - - "[ ] Dialogue punctuation correct" - - "[ ] Sentences varied in length/rhythm" - - "[ ] Consistent tense and POV" -... + +- "[ ] Grammar/spelling free of errors" +- "[ ] Passive voice minimized (target <15%)" +- "[ ] Repetitious words/phrases trimmed" +- "[ ] Dialogue punctuation correct" +- "[ ] Sentences varied in length/rhythm" +- "[ ] Consistent tense and POV" + ... ==================== END: .bmad-creative-writing/checklists/line-edit-quality-checklist.md ==================== ==================== START: .bmad-creative-writing/checklists/publication-readiness-checklist.md ==================== + # ------------------------------------------------------------ + # 5. Publication Readiness Checklist + # ------------------------------------------------------------ + --- + checklist: - id: publication-readiness-checklist - name: Publication Readiness Checklist - description: Final checks before releasing or submitting the manuscript. +id: publication-readiness-checklist +name: Publication Readiness Checklist +description: Final checks before releasing or submitting the manuscript. items: - - "[ ] Front matter complete (title, author, dedication)" - - "[ ] Back matter complete (acknowledgments, about author)" - - "[ ] Table of contents updated (digital)" - - "[ ] Chapter headings numbered correctly" - - "[ ] Formatting styles consistent" - - "[ ] Metadata (ISBN, keywords) embedded" -... + +- "[ ] Front matter complete (title, author, dedication)" +- "[ ] Back matter complete (acknowledgments, about author)" +- "[ ] Table of contents updated (digital)" +- "[ ] Chapter headings numbered correctly" +- "[ ] Formatting styles consistent" +- "[ ] Metadata (ISBN, keywords) embedded" + ... ==================== END: .bmad-creative-writing/checklists/publication-readiness-checklist.md ==================== ==================== START: .bmad-creative-writing/tasks/provide-feedback.md ==================== + # ------------------------------------------------------------ + # 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 +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 -... + +- 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 + ... ==================== END: .bmad-creative-writing/tasks/provide-feedback.md ==================== ==================== START: .bmad-creative-writing/tasks/quick-feedback.md ==================== + # ------------------------------------------------------------ + # 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 +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 -... + +- chapter-dialog.md + steps: +- Use condensed beta-feedback-form. + output: chapter-notes.md + ... ==================== END: .bmad-creative-writing/tasks/quick-feedback.md ==================== ==================== START: .bmad-creative-writing/tasks/analyze-reader-feedback.md ==================== + # ------------------------------------------------------------ + # 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 + ... ==================== END: .bmad-creative-writing/tasks/analyze-reader-feedback.md ==================== ==================== START: .bmad-creative-writing/templates/beta-feedback-form.yaml ==================== +# --- template: id: beta-feedback-form-tmpl @@ -2753,137 +2901,180 @@ sections: ==================== END: .bmad-creative-writing/templates/beta-feedback-form.yaml ==================== ==================== START: .bmad-creative-writing/checklists/beta-feedback-closure-checklist.md ==================== + # ------------------------------------------------------------ + # 6. Beta‑Feedback Closure Checklist + # ------------------------------------------------------------ + --- + checklist: - id: beta-feedback-closure-checklist - name: Beta‑Feedback Closure Checklist - description: Ensure all beta reader notes are addressed or consciously deferred. +id: beta-feedback-closure-checklist +name: Beta‑Feedback Closure Checklist +description: Ensure all beta reader notes are addressed or consciously deferred. items: - - "[ ] Each beta note categorized (Fix/Ignore/Consider)" - - "[ ] Fixes implemented in manuscript" - - "[ ] ‘Ignore’ notes documented with rationale" - - "[ ] ‘Consider’ notes scheduled for future pass" - - "[ ] Beta readers acknowledged in back matter" - - "[ ] Summary of changes logged in retro.md" -... + +- "[ ] Each beta note categorized (Fix/Ignore/Consider)" +- "[ ] Fixes implemented in manuscript" +- "[ ] ‘Ignore’ notes documented with rationale" +- "[ ] ‘Consider’ notes scheduled for future pass" +- "[ ] Beta readers acknowledged in back matter" +- "[ ] Summary of changes logged in retro.md" + ... ==================== END: .bmad-creative-writing/checklists/beta-feedback-closure-checklist.md ==================== ==================== START: .bmad-creative-writing/checklists/comedic-timing-checklist.md ==================== + # ------------------------------------------------------------ + # 23. Comedic Timing & Humor Checklist + # ------------------------------------------------------------ + --- + checklist: - id: comedic-timing-checklist - name: Comedic Timing & Humor Checklist - description: Ensure jokes land and humorous beats serve character/plot. +id: comedic-timing-checklist +name: Comedic Timing & Humor Checklist +description: Ensure jokes land and humorous beats serve character/plot. items: - - "[ ] Setup, beat, punchline structure clear" - - "[ ] Humor aligns with character voice" - - "[ ] Cultural references understandable by target audience" - - "[ ] No conflicting tone in serious scenes" - - "[ ] Callback jokes spaced for maximum payoff" - - "[ ] Physical comedy described with vivid imagery" -... + +- "[ ] Setup, beat, punchline structure clear" +- "[ ] Humor aligns with character voice" +- "[ ] Cultural references understandable by target audience" +- "[ ] No conflicting tone in serious scenes" +- "[ ] Callback jokes spaced for maximum payoff" +- "[ ] Physical comedy described with vivid imagery" + ... ==================== END: .bmad-creative-writing/checklists/comedic-timing-checklist.md ==================== ==================== START: .bmad-creative-writing/tasks/outline-scenes.md ==================== + # ------------------------------------------------------------ + # 11. Outline Scenes + # ------------------------------------------------------------ + --- + task: - id: outline-scenes - name: Outline Scenes - description: Group scene list into chapters with act structure. - persona_default: plot-architect +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 -... + +- scene-list.md + steps: +- Assign scenes to chapters. +- Produce snowflake-outline.md with headings per chapter. + output: snowflake-outline.md + ... ==================== END: .bmad-creative-writing/tasks/outline-scenes.md ==================== ==================== START: .bmad-creative-writing/tasks/generate-scene-list.md ==================== + # ------------------------------------------------------------ + # 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 +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 -... + +- synopsis.md | story-outline.md + steps: +- Identify key beats. +- Fill scene-list-tmpl table. + output: scene-list.md + ... ==================== END: .bmad-creative-writing/tasks/generate-scene-list.md ==================== ==================== START: .bmad-creative-writing/checklists/genre-tropes-checklist.md ==================== + # ------------------------------------------------------------ + # 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/scifi-technology-plausibility-checklist.md ==================== + # ------------------------------------------------------------ + # 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 ==================== + # ------------------------------------------------------------ + # 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/templates/beta-feedback-form.yaml ==================== +# --- template: id: beta-feedback-form-tmpl @@ -2983,6 +3174,7 @@ sections: ==================== END: .bmad-creative-writing/templates/beta-feedback-form.yaml ==================== ==================== START: .bmad-creative-writing/templates/chapter-draft-tmpl.yaml ==================== +# --- template: id: chapter-draft-tmpl @@ -3067,6 +3259,7 @@ sections: ==================== END: .bmad-creative-writing/templates/chapter-draft-tmpl.yaml ==================== ==================== START: .bmad-creative-writing/templates/character-profile-tmpl.yaml ==================== +# --- template: id: character-profile @@ -3161,6 +3354,7 @@ sections: ==================== END: .bmad-creative-writing/templates/character-profile-tmpl.yaml ==================== ==================== START: .bmad-creative-writing/templates/cover-design-brief-tmpl.yaml ==================== +# --- template: id: cover-design-brief-tmpl @@ -3261,6 +3455,7 @@ sections: ==================== END: .bmad-creative-writing/templates/cover-design-brief-tmpl.yaml ==================== ==================== START: .bmad-creative-writing/templates/premise-brief-tmpl.yaml ==================== +# --- template: id: premise-brief-tmpl @@ -3341,6 +3536,7 @@ sections: ==================== END: .bmad-creative-writing/templates/premise-brief-tmpl.yaml ==================== ==================== START: .bmad-creative-writing/templates/scene-list-tmpl.yaml ==================== +# --- template: id: scene-list-tmpl @@ -3398,6 +3594,7 @@ sections: ==================== END: .bmad-creative-writing/templates/scene-list-tmpl.yaml ==================== ==================== START: .bmad-creative-writing/templates/story-outline-tmpl.yaml ==================== +# --- template: id: story-outline @@ -3496,6 +3693,7 @@ sections: ==================== END: .bmad-creative-writing/templates/story-outline-tmpl.yaml ==================== ==================== START: .bmad-creative-writing/templates/world-guide-tmpl.yaml ==================== +# --- template: id: world-guide-tmpl @@ -3587,6 +3785,7 @@ sections: ==================== END: .bmad-creative-writing/templates/world-guide-tmpl.yaml ==================== ==================== START: .bmad-creative-writing/tasks/advanced-elicitation.md ==================== + # Advanced Elicitation Task ## Purpose @@ -3707,35 +3906,44 @@ Choose a number (0-8) or 9 to proceed: ==================== END: .bmad-creative-writing/tasks/advanced-elicitation.md ==================== ==================== START: .bmad-creative-writing/tasks/analyze-reader-feedback.md ==================== + # ------------------------------------------------------------ + # 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 + ... ==================== END: .bmad-creative-writing/tasks/analyze-reader-feedback.md ==================== ==================== START: .bmad-creative-writing/tasks/analyze-story-structure.md ==================== + # 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 @@ -3744,6 +3952,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? @@ -3751,7 +3960,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 @@ -3759,6 +3970,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 @@ -3766,13 +3978,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 @@ -3780,92 +3995,118 @@ 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/assemble-kdp-package.md ==================== + # ------------------------------------------------------------ + # 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 + ... ==================== END: .bmad-creative-writing/tasks/assemble-kdp-package.md ==================== ==================== START: .bmad-creative-writing/tasks/brainstorm-premise.md ==================== + # ------------------------------------------------------------ + # 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 + ... ==================== END: .bmad-creative-writing/tasks/brainstorm-premise.md ==================== ==================== 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/character-depth-pass.md ==================== + # ------------------------------------------------------------ + # 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 + ... ==================== END: .bmad-creative-writing/tasks/character-depth-pass.md ==================== ==================== START: .bmad-creative-writing/tasks/create-doc.md ==================== + # Create Document from Template (YAML Driven) ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️ @@ -3970,70 +4211,61 @@ 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/create-draft-section.md ==================== + # ------------------------------------------------------------ + # 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 + ... ==================== END: .bmad-creative-writing/tasks/create-draft-section.md ==================== -==================== START: .bmad-creative-writing/tasks/critical-review.md ==================== -# ------------------------------------------------------------ -# 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 -... -==================== END: .bmad-creative-writing/tasks/critical-review.md ==================== - ==================== START: .bmad-creative-writing/tasks/develop-character.md ==================== + # ------------------------------------------------------------ + # 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 + ... ==================== END: .bmad-creative-writing/tasks/develop-character.md ==================== ==================== START: .bmad-creative-writing/tasks/execute-checklist.md ==================== + # 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. @@ -4045,7 +4277,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 @@ -4058,14 +4289,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 @@ -4074,7 +4303,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 @@ -4082,7 +4310,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 @@ -4096,7 +4323,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 @@ -4106,7 +4332,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 @@ -4130,250 +4355,326 @@ The LLM will: ==================== END: .bmad-creative-writing/tasks/execute-checklist.md ==================== ==================== START: .bmad-creative-writing/tasks/expand-premise.md ==================== + # ------------------------------------------------------------ + # 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 +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 -... + +- premise.txt + steps: +- Ask for genre confirmation. +- Draft one paragraph (~5 sentences) covering protagonist, conflict, stakes. + output: premise-paragraph.md + ... ==================== END: .bmad-creative-writing/tasks/expand-premise.md ==================== ==================== START: .bmad-creative-writing/tasks/expand-synopsis.md ==================== + # ------------------------------------------------------------ + # 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 +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 -... + +- premise-paragraph.md + steps: +- Outline three‑act structure in prose. +- Keep under 700 words. + output: synopsis.md + ... ==================== END: .bmad-creative-writing/tasks/expand-synopsis.md ==================== ==================== START: .bmad-creative-writing/tasks/final-polish.md ==================== + # ------------------------------------------------------------ + # 14. Final Polish + # ------------------------------------------------------------ + --- + task: - id: final-polish - name: Final Polish - description: Line‑edit for style, clarity, grammar. - persona_default: editor +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 -... + +- chapter-dialog.md | polished-manuscript.md + steps: +- Correct grammar and tighten prose. +- Ensure consistent voice. + output: chapter-final.md | final-manuscript.md + ... ==================== END: .bmad-creative-writing/tasks/final-polish.md ==================== ==================== START: .bmad-creative-writing/tasks/generate-cover-brief.md ==================== + # ------------------------------------------------------------ + # 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 +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 -... + +- 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 + ... ==================== END: .bmad-creative-writing/tasks/generate-cover-brief.md ==================== ==================== START: .bmad-creative-writing/tasks/generate-cover-prompts.md ==================== + # ------------------------------------------------------------ + # 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 +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 -... + +- 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 + ... ==================== END: .bmad-creative-writing/tasks/generate-cover-prompts.md ==================== ==================== START: .bmad-creative-writing/tasks/generate-scene-list.md ==================== + # ------------------------------------------------------------ + # 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 +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 -... + +- synopsis.md | story-outline.md + steps: +- Identify key beats. +- Fill scene-list-tmpl table. + output: scene-list.md + ... ==================== END: .bmad-creative-writing/tasks/generate-scene-list.md ==================== ==================== START: .bmad-creative-writing/tasks/incorporate-feedback.md ==================== + # ------------------------------------------------------------ + # 6. Incorporate Feedback + # ------------------------------------------------------------ + --- + task: - id: incorporate-feedback - name: Incorporate Feedback - description: Merge beta feedback into manuscript; accept, reject, or revise. - persona_default: editor +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 -... + +- draft-manuscript.md +- beta-notes.md + steps: +- Summarize actionable changes. +- Apply revisions inline. +- Mark resolved comments. + output: polished-manuscript.md + ... ==================== END: .bmad-creative-writing/tasks/incorporate-feedback.md ==================== ==================== START: .bmad-creative-writing/tasks/outline-scenes.md ==================== + # ------------------------------------------------------------ + # 11. Outline Scenes + # ------------------------------------------------------------ + --- + task: - id: outline-scenes - name: Outline Scenes - description: Group scene list into chapters with act structure. - persona_default: plot-architect +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 -... + +- scene-list.md + steps: +- Assign scenes to chapters. +- Produce snowflake-outline.md with headings per chapter. + output: snowflake-outline.md + ... ==================== END: .bmad-creative-writing/tasks/outline-scenes.md ==================== ==================== START: .bmad-creative-writing/tasks/provide-feedback.md ==================== + # ------------------------------------------------------------ + # 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 +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 -... + +- 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 + ... ==================== END: .bmad-creative-writing/tasks/provide-feedback.md ==================== ==================== START: .bmad-creative-writing/tasks/publish-chapter.md ==================== + # ------------------------------------------------------------ + # 15. Publish Chapter + # ------------------------------------------------------------ + --- + task: - id: publish-chapter - name: Publish Chapter - description: Format and log a chapter release. - persona_default: editor +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 -... + +- chapter-final.md + steps: +- Generate front/back matter as needed. +- Append entry to publication-log.md (date, URL). + output: publication-log.md + ... ==================== END: .bmad-creative-writing/tasks/publish-chapter.md ==================== ==================== START: .bmad-creative-writing/tasks/quick-feedback.md ==================== + # ------------------------------------------------------------ + # 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 +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 -... + +- chapter-dialog.md + steps: +- Use condensed beta-feedback-form. + output: chapter-notes.md + ... ==================== END: .bmad-creative-writing/tasks/quick-feedback.md ==================== ==================== START: .bmad-creative-writing/tasks/select-next-arc.md ==================== + # ------------------------------------------------------------ + # 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 +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 -... + +- retrospective data (retro.md) | snowflake-outline.md + steps: +- Analyze reader feedback. +- Update release-plan.md with upcoming beats. + output: release-plan.md + ... ==================== END: .bmad-creative-writing/tasks/select-next-arc.md ==================== ==================== START: .bmad-creative-writing/tasks/workshop-dialog.md ==================== + # 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 @@ -4382,7 +4683,9 @@ For each character, assess: - Emotional expression style ### 2. Subtext Analysis + For each exchange: + - What's being said directly - What's really being communicated - Power dynamics at play @@ -4391,14 +4694,18 @@ For each exchange: - 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 @@ -4407,6 +4714,7 @@ Where dialog lacks tension: - Add environmental pressure ### 5. Polish Pass + - Read aloud for rhythm - Check period authenticity - Verify character consistency @@ -4415,316 +4723,390 @@ Where dialog lacks tension: - Add distinctive character markers ## Output + Refined dialog with stronger voices and dramatic impact ==================== END: .bmad-creative-writing/tasks/workshop-dialog.md ==================== ==================== START: .bmad-creative-writing/checklists/beta-feedback-closure-checklist.md ==================== + # ------------------------------------------------------------ + # 6. Beta‑Feedback Closure Checklist + # ------------------------------------------------------------ + --- + checklist: - id: beta-feedback-closure-checklist - name: Beta‑Feedback Closure Checklist - description: Ensure all beta reader notes are addressed or consciously deferred. +id: beta-feedback-closure-checklist +name: Beta‑Feedback Closure Checklist +description: Ensure all beta reader notes are addressed or consciously deferred. items: - - "[ ] Each beta note categorized (Fix/Ignore/Consider)" - - "[ ] Fixes implemented in manuscript" - - "[ ] ‘Ignore’ notes documented with rationale" - - "[ ] ‘Consider’ notes scheduled for future pass" - - "[ ] Beta readers acknowledged in back matter" - - "[ ] Summary of changes logged in retro.md" -... + +- "[ ] Each beta note categorized (Fix/Ignore/Consider)" +- "[ ] Fixes implemented in manuscript" +- "[ ] ‘Ignore’ notes documented with rationale" +- "[ ] ‘Consider’ notes scheduled for future pass" +- "[ ] Beta readers acknowledged in back matter" +- "[ ] Summary of changes logged in retro.md" + ... ==================== END: .bmad-creative-writing/checklists/beta-feedback-closure-checklist.md ==================== ==================== START: .bmad-creative-writing/checklists/character-consistency-checklist.md ==================== + # ------------------------------------------------------------ + # 1. Character Consistency Checklist + # ------------------------------------------------------------ + --- + checklist: - id: character-consistency-checklist - name: Character Consistency Checklist - description: Verify character details and voice remain consistent throughout the manuscript. +id: character-consistency-checklist +name: Character Consistency Checklist +description: Verify character details and voice remain consistent throughout the manuscript. items: - - "[ ] Names spelled consistently (incl. diacritics)" - - "[ ] Physical descriptors match across chapters" - - "[ ] Goals and motivations do not contradict earlier scenes" - - "[ ] Character voice (speech patterns, vocabulary) is uniform" - - "[ ] Relationships and histories align with timeline" - - "[ ] Internal conflict/arc progression is logical" -... + +- "[ ] Names spelled consistently (incl. diacritics)" +- "[ ] Physical descriptors match across chapters" +- "[ ] Goals and motivations do not contradict earlier scenes" +- "[ ] Character voice (speech patterns, vocabulary) is uniform" +- "[ ] Relationships and histories align with timeline" +- "[ ] Internal conflict/arc progression is logical" + ... ==================== END: .bmad-creative-writing/checklists/character-consistency-checklist.md ==================== ==================== START: .bmad-creative-writing/checklists/comedic-timing-checklist.md ==================== + # ------------------------------------------------------------ + # 23. Comedic Timing & Humor Checklist + # ------------------------------------------------------------ + --- + checklist: - id: comedic-timing-checklist - name: Comedic Timing & Humor Checklist - description: Ensure jokes land and humorous beats serve character/plot. +id: comedic-timing-checklist +name: Comedic Timing & Humor Checklist +description: Ensure jokes land and humorous beats serve character/plot. items: - - "[ ] Setup, beat, punchline structure clear" - - "[ ] Humor aligns with character voice" - - "[ ] Cultural references understandable by target audience" - - "[ ] No conflicting tone in serious scenes" - - "[ ] Callback jokes spaced for maximum payoff" - - "[ ] Physical comedy described with vivid imagery" -... + +- "[ ] Setup, beat, punchline structure clear" +- "[ ] Humor aligns with character voice" +- "[ ] Cultural references understandable by target audience" +- "[ ] No conflicting tone in serious scenes" +- "[ ] Callback jokes spaced for maximum payoff" +- "[ ] Physical comedy described with vivid imagery" + ... ==================== END: .bmad-creative-writing/checklists/comedic-timing-checklist.md ==================== ==================== START: .bmad-creative-writing/checklists/cyberpunk-aesthetic-checklist.md ==================== + # ------------------------------------------------------------ + # 24. Cyberpunk Aesthetic Consistency Checklist + # ------------------------------------------------------------ + --- + checklist: - id: cyberpunk-aesthetic-checklist - name: Cyberpunk Aesthetic Consistency Checklist - description: Keep neon‑noir atmosphere, tech slang, and socio‑economic themes consistent. +id: cyberpunk-aesthetic-checklist +name: Cyberpunk Aesthetic Consistency Checklist +description: Keep neon‑noir atmosphere, tech slang, and socio‑economic themes consistent. items: - - "[ ] High‑tech / low‑life dichotomy evident" - - "[ ] Corporate oppression motif recurring" - - "[ ] Street slang and jargon consistent" - - "[ ] Urban setting features neon, rain, verticality" - - "[ ] Augmentation tech follows established rules" - - "[ ] Hacking sequences plausible within world rules" -... + +- "[ ] High‑tech / low‑life dichotomy evident" +- "[ ] Corporate oppression motif recurring" +- "[ ] Street slang and jargon consistent" +- "[ ] Urban setting features neon, rain, verticality" +- "[ ] Augmentation tech follows established rules" +- "[ ] Hacking sequences plausible within world rules" + ... ==================== END: .bmad-creative-writing/checklists/cyberpunk-aesthetic-checklist.md ==================== ==================== START: .bmad-creative-writing/checklists/ebook-formatting-checklist.md ==================== + # ------------------------------------------------------------ + # 14. eBook Formatting Checklist + --- + checklist: - id: ebook-formatting-checklist - name: eBook Formatting Checklist - description: Validate manuscript is Kindle/EPUB ready. +id: ebook-formatting-checklist +name: eBook Formatting Checklist +description: Validate manuscript is Kindle/EPUB ready. items: - - "[ ] Front matter meets Amazon/Apple guidelines" - - "[ ] No orphan/widow lines after conversion" - - "[ ] Embedded fonts licensed or removed" - - "[ ] Images compressed & have alt text" - - "[ ] Table of contents linked correctly" - - "[ ] EPUB passes EPUBCheck / Kindle Previewer" -... + +- "[ ] Front matter meets Amazon/Apple guidelines" +- "[ ] No orphan/widow lines after conversion" +- "[ ] Embedded fonts licensed or removed" +- "[ ] Images compressed & have alt text" +- "[ ] Table of contents linked correctly" +- "[ ] EPUB passes EPUBCheck / Kindle Previewer" + ... ==================== END: .bmad-creative-writing/checklists/ebook-formatting-checklist.md ==================== ==================== START: .bmad-creative-writing/checklists/epic-poetry-meter-checklist.md ==================== + # ------------------------------------------------------------ + # 22. Epic Poetry Meter & Form Checklist + # ------------------------------------------------------------ + --- + checklist: - id: epic-poetry-meter-checklist - name: Epic Poetry Meter & Form Checklist - description: Maintain consistent meter, line length, and poetic devices in epic verse. +id: epic-poetry-meter-checklist +name: Epic Poetry Meter & Form Checklist +description: Maintain consistent meter, line length, and poetic devices in epic verse. items: - - "[ ] Chosen meter specified (dactylic hexameter, iambic pentameter, etc.)" - - "[ ] Scansion performed on random sample lines" - - "[ ] Caesuras / enjambments used intentionally" - - "[ ] Repetition / epithets maintain oral tradition flavor" - - "[ ] Invocation of the muse or equivalent opening present" - - "[ ] Book/canto divisions follow narrative arc" -... + +- "[ ] Chosen meter specified (dactylic hexameter, iambic pentameter, etc.)" +- "[ ] Scansion performed on random sample lines" +- "[ ] Caesuras / enjambments used intentionally" +- "[ ] Repetition / epithets maintain oral tradition flavor" +- "[ ] Invocation of the muse or equivalent opening present" +- "[ ] Book/canto divisions follow narrative arc" + ... ==================== END: .bmad-creative-writing/checklists/epic-poetry-meter-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/foreshadowing-payoff-checklist.md ==================== + # ------------------------------------------------------------ + # 9. Foreshadowing & Payoff Checklist + # ------------------------------------------------------------ + --- + checklist: - id: foreshadowing-payoff-checklist - name: Foreshadowing & Payoff Checklist - description: Ensure planted clues/payoffs resolve satisfactorily and no dangling setups remain. +id: foreshadowing-payoff-checklist +name: Foreshadowing & Payoff Checklist +description: Ensure planted clues/payoffs resolve satisfactorily and no dangling setups remain. items: - - "[ ] Each major twist has early foreshadowing" - - "[ ] Subplots introduced are resolved or intentionally left open w/ sequel hook" - - "[ ] Symbolic motifs recur at least 3 times (rule of three)" - - "[ ] Chekhov’s gun fired before finale" - - "[ ] No dropped characters or MacGuffins" -... + +- "[ ] Each major twist has early foreshadowing" +- "[ ] Subplots introduced are resolved or intentionally left open w/ sequel hook" +- "[ ] Symbolic motifs recur at least 3 times (rule of three)" +- "[ ] Chekhov’s gun fired before finale" +- "[ ] No dropped characters or MacGuffins" + ... ==================== END: .bmad-creative-writing/checklists/foreshadowing-payoff-checklist.md ==================== -==================== START: .bmad-creative-writing/checklists/genre-tropes-checklist.md ==================== -# ------------------------------------------------------------ -# 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. -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" -... -==================== END: .bmad-creative-writing/checklists/genre-tropes-checklist.md ==================== - ==================== START: .bmad-creative-writing/checklists/historical-accuracy-checklist.md ==================== + # ------------------------------------------------------------ + # 18. Historical Accuracy Checklist + # ------------------------------------------------------------ + --- + checklist: - id: historical-accuracy-checklist - name: Historical Accuracy Checklist - description: Validate era‑appropriate details and avoid anachronisms. +id: historical-accuracy-checklist +name: Historical Accuracy Checklist +description: Validate era‑appropriate details and avoid anachronisms. items: - - "[ ] Clothing and fashion match era" - - "[ ] Speech patterns and slang accurate" - - "[ ] Technology and tools available in timeframe" - - "[ ] Political and cultural norms correct" - - "[ ] Major historical events timeline respected" - - "[ ] Sensitivity to real cultures and peoples" -... + +- "[ ] Clothing and fashion match era" +- "[ ] Speech patterns and slang accurate" +- "[ ] Technology and tools available in timeframe" +- "[ ] Political and cultural norms correct" +- "[ ] Major historical events timeline respected" +- "[ ] Sensitivity to real cultures and peoples" + ... ==================== END: .bmad-creative-writing/checklists/historical-accuracy-checklist.md ==================== ==================== START: .bmad-creative-writing/checklists/horror-suspense-checklist.md ==================== + # ------------------------------------------------------------ + # 16. Horror Suspense & Scare Checklist + # ------------------------------------------------------------ + --- + checklist: - id: horror-suspense-checklist - name: Horror Suspense & Scare Checklist - description: Maintain escalating tension and effective scares. +id: horror-suspense-checklist +name: Horror Suspense & Scare Checklist +description: Maintain escalating tension and effective scares. items: - - "[ ] Early dread established within first 10%" - - "[ ] Rising stakes every 2–3 chapters" - - "[ ] Sensory details evoke fear (sound, smell, touch)" - - "[ ] At least one false scare before true threat" - - "[ ] Monster/antagonist rules consistent" - - "[ ] Climax delivers cathartic payoff and lingering unease" -... + +- "[ ] Early dread established within first 10%" +- "[ ] Rising stakes every 2–3 chapters" +- "[ ] Sensory details evoke fear (sound, smell, touch)" +- "[ ] At least one false scare before true threat" +- "[ ] Monster/antagonist rules consistent" +- "[ ] Climax delivers cathartic payoff and lingering unease" + ... ==================== END: .bmad-creative-writing/checklists/horror-suspense-checklist.md ==================== ==================== START: .bmad-creative-writing/checklists/kdp-cover-ready-checklist.md ==================== + # ------------------------------------------------------------ + # checklists/kdp-cover-ready-checklist.md + # ------------------------------------------------------------ + --- + checklist: - id: kdp-cover-ready-checklist - name: KDP Cover Ready Checklist - description: Ensure final cover meets Amazon KDP print specs. +id: kdp-cover-ready-checklist +name: KDP Cover Ready Checklist +description: Ensure final cover meets Amazon KDP print specs. items: - - "[ ] Correct trim size & bleed margins applied" - - "[ ] 300 DPI images" - - "[ ] CMYK color profile for print PDF" - - "[ ] Spine text ≥ 0.0625" away from edges" - - "[ ] Barcode zone clear of critical art" - - "[ ] No transparent layers" - - "[ ] File size < 40MB PDF" - - "[ ] Front & back text legible at thumbnail size" -... + +- "[ ] Correct trim size & bleed margins applied" +- "[ ] 300 DPI images" +- "[ ] CMYK color profile for print PDF" +- "[ ] Spine text ≥ 0.0625" away from edges" +- "[ ] Barcode zone clear of critical art" +- "[ ] No transparent layers" +- "[ ] File size < 40MB PDF" +- "[ ] Front & back text legible at thumbnail size" + ... ==================== END: .bmad-creative-writing/checklists/kdp-cover-ready-checklist.md ==================== ==================== START: .bmad-creative-writing/checklists/line-edit-quality-checklist.md ==================== + # ------------------------------------------------------------ + # 4. Line‑Edit Quality Checklist + # ------------------------------------------------------------ + --- + checklist: - id: line-edit-quality-checklist - name: Line‑Edit Quality Checklist - description: Copy‑editing pass for clarity, grammar, and style. +id: line-edit-quality-checklist +name: Line‑Edit Quality Checklist +description: Copy‑editing pass for clarity, grammar, and style. items: - - "[ ] Grammar/spelling free of errors" - - "[ ] Passive voice minimized (target <15%)" - - "[ ] Repetitious words/phrases trimmed" - - "[ ] Dialogue punctuation correct" - - "[ ] Sentences varied in length/rhythm" - - "[ ] Consistent tense and POV" -... + +- "[ ] Grammar/spelling free of errors" +- "[ ] Passive voice minimized (target <15%)" +- "[ ] Repetitious words/phrases trimmed" +- "[ ] Dialogue punctuation correct" +- "[ ] Sentences varied in length/rhythm" +- "[ ] Consistent tense and POV" + ... ==================== END: .bmad-creative-writing/checklists/line-edit-quality-checklist.md ==================== ==================== START: .bmad-creative-writing/checklists/marketing-copy-checklist.md ==================== + # ------------------------------------------------------------ + # 13. Marketing Copy Checklist + # ------------------------------------------------------------ + --- + checklist: - id: marketing-copy-checklist - name: Marketing Copy Checklist - description: Ensure query/blurb/sales page copy is compelling and professional. +id: marketing-copy-checklist +name: Marketing Copy Checklist +description: Ensure query/blurb/sales page copy is compelling and professional. items: - - "[ ] Hook sentence under 35 words" - - "[ ] Stakes and protagonist named" - - "[ ] Unique selling point emphasized" - - "[ ] Clarity on genre and tone" - - "[ ] Query letter follows standard format" - - "[ ] Bio & comparable titles included" -... + +- "[ ] Hook sentence under 35 words" +- "[ ] Stakes and protagonist named" +- "[ ] Unique selling point emphasized" +- "[ ] Clarity on genre and tone" +- "[ ] Query letter follows standard format" +- "[ ] Bio & comparable titles included" + ... ==================== END: .bmad-creative-writing/checklists/marketing-copy-checklist.md ==================== ==================== START: .bmad-creative-writing/checklists/mystery-clue-trail-checklist.md ==================== + # ------------------------------------------------------------ + # 11. Mystery Clue Trail Checklist + # ------------------------------------------------------------ + --- + checklist: - id: mystery-clue-trail-checklist - name: Mystery Clue Trail Checklist - description: Specialized checklist for mystery novels—ensures fair‑play clues and red herrings. +id: mystery-clue-trail-checklist +name: Mystery Clue Trail Checklist +description: Specialized checklist for mystery novels—ensures fair‑play clues and red herrings. items: - - "[ ] Introduce primary mystery within first two chapters" - - "[ ] Every clue visible to the reader" - - "[ ] At least 2 credible red herrings" - - "[ ] Detective/protagonist has plausible method to discover clues" - - "[ ] Culprit motive/hiding method explained satisfactorily" - - "[ ] Climax reveals tie up all threads" -... + +- "[ ] Introduce primary mystery within first two chapters" +- "[ ] Every clue visible to the reader" +- "[ ] At least 2 credible red herrings" +- "[ ] Detective/protagonist has plausible method to discover clues" +- "[ ] Culprit motive/hiding method explained satisfactorily" +- "[ ] Climax reveals tie up all threads" + ... ==================== END: .bmad-creative-writing/checklists/mystery-clue-trail-checklist.md ==================== ==================== START: .bmad-creative-writing/checklists/orbital-mechanics-checklist.md ==================== + # ------------------------------------------------------------ + # 21. Hard‑Science Orbital Mechanics Checklist + # ------------------------------------------------------------ + --- + checklist: - id: orbital-mechanics-checklist - name: Hard‑Science Orbital Mechanics Checklist - description: Verify spacecraft trajectories, delta‑v budgets, and orbital timings are scientifically plausible. +id: orbital-mechanics-checklist +name: Hard‑Science Orbital Mechanics Checklist +description: Verify spacecraft trajectories, delta‑v budgets, and orbital timings are scientifically plausible. items: - - "[ ] Gravity assists modeled with correct bodies and dates" - - "[ ] Delta‑v calculations align with propulsion tech limits" - - "[ ] Transfer windows and travel times match real ephemeris" - - "[ ] Orbits obey Kepler’s laws (elliptical periods, periapsis)" - - "[ ] Communication latency accounted for at given distances" - - "[ ] Plot accounts for orbital plane changes / inclination costs" -... + +- "[ ] Gravity assists modeled with correct bodies and dates" +- "[ ] Delta‑v calculations align with propulsion tech limits" +- "[ ] Transfer windows and travel times match real ephemeris" +- "[ ] Orbits obey Kepler’s laws (elliptical periods, periapsis)" +- "[ ] Communication latency accounted for at given distances" +- "[ ] Plot accounts for orbital plane changes / inclination costs" + ... ==================== END: .bmad-creative-writing/checklists/orbital-mechanics-checklist.md ==================== ==================== START: .bmad-creative-writing/checklists/plot-structure-checklist.md ==================== + # Plot Structure Checklist ## Opening + - [ ] Hook engages within first page - [ ] Genre/tone established early - [ ] World rules clear @@ -4732,6 +5114,7 @@ items: - [ ] Status quo established before disruption ## Structure Fundamentals + - [ ] Inciting incident by 10-15% mark - [ ] Clear story question posed - [ ] Stakes established and clear @@ -4739,19 +5122,23 @@ items: - [ ] 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 @@ -4759,6 +5146,7 @@ items: - [ ] Dark night of soul (character lowest) ## Climax + - [ ] Protagonist must act (no rescue) - [ ] Uses lessons learned - [ ] Internal/external conflicts merge @@ -4766,6 +5154,7 @@ items: - [ ] Clear win/loss/transformation ## Resolution + - [ ] New equilibrium established - [ ] Loose threads tied - [ ] Character growth demonstrated @@ -4774,207 +5163,278 @@ items: ==================== END: .bmad-creative-writing/checklists/plot-structure-checklist.md ==================== ==================== START: .bmad-creative-writing/checklists/publication-readiness-checklist.md ==================== + # ------------------------------------------------------------ + # 5. Publication Readiness Checklist + # ------------------------------------------------------------ + --- + checklist: - id: publication-readiness-checklist - name: Publication Readiness Checklist - description: Final checks before releasing or submitting the manuscript. +id: publication-readiness-checklist +name: Publication Readiness Checklist +description: Final checks before releasing or submitting the manuscript. items: - - "[ ] Front matter complete (title, author, dedication)" - - "[ ] Back matter complete (acknowledgments, about author)" - - "[ ] Table of contents updated (digital)" - - "[ ] Chapter headings numbered correctly" - - "[ ] Formatting styles consistent" - - "[ ] Metadata (ISBN, keywords) embedded" -... + +- "[ ] Front matter complete (title, author, dedication)" +- "[ ] Back matter complete (acknowledgments, about author)" +- "[ ] Table of contents updated (digital)" +- "[ ] Chapter headings numbered correctly" +- "[ ] Formatting styles consistent" +- "[ ] Metadata (ISBN, keywords) embedded" + ... ==================== END: .bmad-creative-writing/checklists/publication-readiness-checklist.md ==================== ==================== START: .bmad-creative-writing/checklists/romance-emotional-beats-checklist.md ==================== + # ------------------------------------------------------------ + # 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/checklists/scene-quality-checklist.md ==================== + # ------------------------------------------------------------ + # 3. Scene Quality Checklist + # ------------------------------------------------------------ + --- + checklist: - id: scene-quality-checklist - name: Scene Quality Checklist - description: Quick QA pass for each scene/chapter to ensure narrative purpose. +id: scene-quality-checklist +name: Scene Quality Checklist +description: Quick QA pass for each scene/chapter to ensure narrative purpose. items: - - "[ ] Clear POV established immediately" - - "[ ] Scene goal & conflict articulated" - - "[ ] Stakes apparent to the reader" - - "[ ] Hook at opening and/or end" - - "[ ] Logical cause–effect with previous scene" - - "[ ] Character emotion/reaction present" -... + +- "[ ] Clear POV established immediately" +- "[ ] Scene goal & conflict articulated" +- "[ ] Stakes apparent to the reader" +- "[ ] Hook at opening and/or end" +- "[ ] Logical cause–effect with previous scene" +- "[ ] Character emotion/reaction present" + ... ==================== END: .bmad-creative-writing/checklists/scene-quality-checklist.md ==================== ==================== START: .bmad-creative-writing/checklists/scifi-technology-plausibility-checklist.md ==================== + # ------------------------------------------------------------ + # 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/sensitivity-representation-checklist.md ==================== + # ------------------------------------------------------------ + # 7. Sensitivity & Representation Checklist + # ------------------------------------------------------------ + --- + checklist: - id: sensitivity-representation-checklist - name: Sensitivity & Representation Checklist - description: Ensure respectful, accurate portrayal of marginalized groups and sensitive topics. +id: sensitivity-representation-checklist +name: Sensitivity & Representation Checklist +description: Ensure respectful, accurate portrayal of marginalized groups and sensitive topics. items: - - "[ ] Consulted authentic sources or sensitivity readers for represented groups" - - "[ ] Avoided harmful stereotypes or caricatures" - - "[ ] Language and descriptors are respectful and current" - - "[ ] Traumatic content handled with appropriate weight and trigger warnings" - - "[ ] Cultural references are accurate and contextualized" - - "[ ] Own‑voices acknowledgement (if applicable)" -... + +- "[ ] Consulted authentic sources or sensitivity readers for represented groups" +- "[ ] Avoided harmful stereotypes or caricatures" +- "[ ] Language and descriptors are respectful and current" +- "[ ] Traumatic content handled with appropriate weight and trigger warnings" +- "[ ] Cultural references are accurate and contextualized" +- "[ ] Own‑voices acknowledgement (if applicable)" + ... ==================== END: .bmad-creative-writing/checklists/sensitivity-representation-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/checklists/thriller-pacing-stakes-checklist.md ==================== + # ------------------------------------------------------------ + # 19. Thriller Pacing & Stakes Checklist + # ------------------------------------------------------------ + --- + checklist: - id: thriller-pacing-stakes-checklist - name: Thriller Pacing & Stakes Checklist - description: Keep readers on edge with tight pacing and escalating stakes. +id: thriller-pacing-stakes-checklist +name: Thriller Pacing & Stakes Checklist +description: Keep readers on edge with tight pacing and escalating stakes. items: - - "[ ] Inciting incident by 10% mark" - - "[ ] Ticking clock or deadline present" - - "[ ] Complications escalate danger every 3–4 chapters" - - "[ ] Protagonist setbacks increase tension" - - "[ ] Twist/reversal at midpoint" - - "[ ] Final confrontation resolves central threat" -... + +- "[ ] Inciting incident by 10% mark" +- "[ ] Ticking clock or deadline present" +- "[ ] Complications escalate danger every 3–4 chapters" +- "[ ] Protagonist setbacks increase tension" +- "[ ] Twist/reversal at midpoint" +- "[ ] Final confrontation resolves central threat" + ... ==================== END: .bmad-creative-writing/checklists/thriller-pacing-stakes-checklist.md ==================== ==================== START: .bmad-creative-writing/checklists/timeline-continuity-checklist.md ==================== + # ------------------------------------------------------------ + # 8. Timeline & Continuity Checklist + # ------------------------------------------------------------ + --- + checklist: - id: timeline-continuity-checklist - name: Timeline & Continuity Checklist - description: Verify dates, ages, seasons, and causal events remain consistent. +id: timeline-continuity-checklist +name: Timeline & Continuity Checklist +description: Verify dates, ages, seasons, and causal events remain consistent. items: - - "[ ] Character ages progress logically" - - "[ ] Seasons/holidays align with passage of time" - - "[ ] Travel durations match map scale" - - "[ ] Cause → effect order preserved across chapters" - - "[ ] Flashbacks clearly timestamped and consistent" - - "[ ] Timeline visual (chronology.md) updated" -... + +- "[ ] Character ages progress logically" +- "[ ] Seasons/holidays align with passage of time" +- "[ ] Travel durations match map scale" +- "[ ] Cause → effect order preserved across chapters" +- "[ ] Flashbacks clearly timestamped and consistent" +- "[ ] Timeline visual (chronology.md) updated" + ... ==================== END: .bmad-creative-writing/checklists/timeline-continuity-checklist.md ==================== ==================== 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/ya-appropriateness-checklist.md ==================== + # ------------------------------------------------------------ + # 20. YA Appropriateness Checklist + # ------------------------------------------------------------ + --- + checklist: - id: ya-appropriateness-checklist - name: Young Adult Content Appropriateness Checklist - description: Ensure themes, language, and content suit YA audience. +id: ya-appropriateness-checklist +name: Young Adult Content Appropriateness Checklist +description: Ensure themes, language, and content suit YA audience. items: - - "[ ] Protagonist age 13–18 and driving action" - - "[ ] Themes of identity, friendship, coming‑of‑age present" - - "[ ] Romance handles consent and boundaries responsibly" - - "[ ] Violence and language within YA market norms" - - "[ ] No explicit sexual content beyond fade‑to‑black" - - "[ ] Hopeful or growth‑oriented ending" -... + +- "[ ] Protagonist age 13–18 and driving action" +- "[ ] Themes of identity, friendship, coming‑of‑age present" +- "[ ] Romance handles consent and boundaries responsibly" +- "[ ] Violence and language within YA market norms" +- "[ ] No explicit sexual content beyond fade‑to‑black" +- "[ ] Hopeful or growth‑oriented ending" + ... ==================== END: .bmad-creative-writing/checklists/ya-appropriateness-checklist.md ==================== ==================== START: .bmad-creative-writing/workflows/book-cover-design-workflow.md ==================== + # Book Cover Design Assets + # ============================================================ + # This canvas file contains: + # 1. Agent definition (cover-designer) + # 2. Three tasks + # 3. One template + # 4. One checklist + # ------------------------------------------------------------ # ------------------------------------------------------------ + # agents/cover-designer.md + # ------------------------------------------------------------ + ```yaml agent: name: Iris Vega @@ -5015,81 +5475,103 @@ dependencies: ``` # ------------------------------------------------------------ + # 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 -... # ------------------------------------------------------------ + +--- + +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 + ... + +# ------------------------------------------------------------ + # 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 -... # ------------------------------------------------------------ + +--- + +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 + ... + +# ------------------------------------------------------------ + # 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 -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 -... # ------------------------------------------------------------ -# templates/cover-design-brief-tmpl.yaml + +--- + +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 +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 + ... + # ------------------------------------------------------------ + +# templates/cover-design-brief-tmpl.yaml + +# ------------------------------------------------------------ + --- + template: - id: cover-design-brief-tmpl - name: Cover Design Brief - description: Structured form capturing creative + technical details for cover design. - whenToUse: During generate-cover-brief task. - exampleOutput: cover-brief.md +id: cover-design-brief-tmpl +name: Cover Design Brief +description: Structured form capturing creative + technical details for cover design. +whenToUse: During generate-cover-brief task. +exampleOutput: cover-brief.md + --- + # Cover Design Brief – {{title}} ## Book Metadata + - **Title:** {{title}} - **Subtitle:** {{subtitle}} - **Author:** {{author}} @@ -5098,21 +5580,24 @@ template: - **Target Audience:** {{audience}} ## Technical Specs -| Item | Value | -|------|-------| -| Trim Size | {{trim_size}} | -| Page Count | {{page_count}} | -| Paper Color | {{paper_color}} | -| Print Type | {{print_type}} | -| Matte/Glossy | {{finish}} | + +| Item | Value | +| ------------ | --------------- | +| Trim Size | {{trim_size}} | +| Page Count | {{page_count}} | +| Paper Color | {{paper_color}} | +| Print Type | {{print_type}} | +| Matte/Glossy | {{finish}} | ## Creative Direction + - **Mood / Tone Keywords:** {{mood_keywords}} - **Primary Imagery:** {{imagery}} - **Color Palette:** {{colors}} - **Font Style Preferences:** {{fonts}} ## Back Cover Content + - **Blurb:** {{blurb}} - **Review Snippets:** {{reviews}} - **Author Bio:** {{author_bio}} @@ -5122,27 +5607,32 @@ template: ... # ------------------------------------------------------------ + # checklists/kdp-cover-ready-checklist.md + # ------------------------------------------------------------ + --- + checklist: - id: kdp-cover-ready-checklist - name: KDP Cover Ready Checklist - description: Ensure final cover meets Amazon KDP print specs. +id: kdp-cover-ready-checklist +name: KDP Cover Ready Checklist +description: Ensure final cover meets Amazon KDP print specs. items: - - "[ ] Correct trim size & bleed margins applied" - - "[ ] 300 DPI images" - - "[ ] CMYK color profile for print PDF" - - "[ ] Spine text ≥ 0.0625" away from edges" - - "[ ] Barcode zone clear of critical art" - - "[ ] No transparent layers" - - "[ ] File size < 40MB PDF" - - "[ ] Front & back text legible at thumbnail size" -... + +- "[ ] Correct trim size & bleed margins applied" +- "[ ] 300 DPI images" +- "[ ] CMYK color profile for print PDF" +- "[ ] Spine text ≥ 0.0625" away from edges" +- "[ ] Barcode zone clear of critical art" +- "[ ] No transparent layers" +- "[ ] File size < 40MB PDF" +- "[ ] Front & back text legible at thumbnail size" + ... ==================== END: .bmad-creative-writing/workflows/book-cover-design-workflow.md ==================== ==================== START: .bmad-creative-writing/workflows/novel-greenfield-workflow.yaml ==================== ---- +# workflow: id: novel-greenfield-workflow name: Greenfield Novel Workflow @@ -5198,10 +5688,10 @@ workflow: output: critic-review.md completion_criteria: - critic-review.md exists -... ==================== END: .bmad-creative-writing/workflows/novel-greenfield-workflow.yaml ==================== ==================== START: .bmad-creative-writing/workflows/novel-serial-workflow.yaml ==================== +# --- workflow: id: novel-serial-workflow @@ -5251,10 +5741,10 @@ workflow: completion_criteria: - publication-log.md exists - critic-review.md exists -... ==================== END: .bmad-creative-writing/workflows/novel-serial-workflow.yaml ==================== ==================== START: .bmad-creative-writing/workflows/novel-snowflake-workflow.yaml ==================== +# --- workflow: id: novel-snowflake-workflow @@ -5322,17 +5812,17 @@ workflow: output: critic-review.md completion_criteria: - critic-review.md exists -... +# end ==================== END: .bmad-creative-writing/workflows/novel-snowflake-workflow.yaml ==================== ==================== START: .bmad-creative-writing/workflows/novel-writing.yaml ==================== ---- +# # workflows/novel-writing.yaml name: novel-writing title: Novel Writing Workflow description: | End‑to‑end pipeline for drafting, revising, and polishing a full‑length novel - using the BMAD Creative Writing team. + using the BMAD™ Creative Writing team. triggers: - command: /novel @@ -5420,7 +5910,7 @@ outputs: ==================== END: .bmad-creative-writing/workflows/novel-writing.yaml ==================== ==================== START: .bmad-creative-writing/workflows/screenplay-development.yaml ==================== ---- +# # workflows/screenplay-development.yaml name: screenplay-development title: Screenplay Development Workflow @@ -5508,7 +5998,7 @@ outputs: ==================== END: .bmad-creative-writing/workflows/screenplay-development.yaml ==================== ==================== START: .bmad-creative-writing/workflows/series-planning.yaml ==================== ---- +# # workflows/series-planning.yaml name: series-planning title: Series Planning Workflow @@ -5589,7 +6079,7 @@ outputs: ==================== END: .bmad-creative-writing/workflows/series-planning.yaml ==================== ==================== START: .bmad-creative-writing/workflows/short-story-creation.yaml ==================== ---- +# # workflows/short-story-creation.yaml name: short-story-creation title: Short Story Creation Workflow @@ -5656,6 +6146,7 @@ outputs: ==================== END: .bmad-creative-writing/workflows/short-story-creation.yaml ==================== ==================== START: .bmad-creative-writing/data/bmad-kb.md ==================== + # BMad Creative Writing Knowledge Base ## Overview @@ -5761,24 +6252,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 @@ -5787,6 +6282,7 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating ## Genre Support ### Built-in Genre Checklists + - Fantasy & Sci-Fi - Romance & Thriller - Mystery & Horror @@ -5794,6 +6290,7 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating - Young Adult Each genre includes: + - Trope management - Reader expectations - Market positioning @@ -5802,24 +6299,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 @@ -5856,14 +6357,17 @@ 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 ==================== + # 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%) @@ -5879,7 +6383,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 @@ -5894,6 +6400,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 @@ -5903,6 +6410,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c 7. Resolution ## Freytag's Pyramid + 1. Exposition 2. Rising Action 3. Climax @@ -5910,6 +6418,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c 5. Denouement ## Kishōtenketsu (Japanese) + - **Ki**: Introduction - **Shō**: Development - **Ten**: Twist diff --git a/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt b/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt index 6dcc915e..7100441e 100644 --- a/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +++ b/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt @@ -101,6 +101,7 @@ dependencies: ==================== END: .bmad-infrastructure-devops/agents/infra-devops-platform.md ==================== ==================== START: .bmad-infrastructure-devops/tasks/create-doc.md ==================== + # Create Document from Template (YAML Driven) ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️ @@ -205,6 +206,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once). ==================== END: .bmad-infrastructure-devops/tasks/create-doc.md ==================== ==================== START: .bmad-infrastructure-devops/tasks/review-infrastructure.md ==================== + # Infrastructure Review Task ## Purpose @@ -367,6 +369,7 @@ REPEAT by Asking the user if they would like to perform another Reflective, Elic ==================== END: .bmad-infrastructure-devops/tasks/review-infrastructure.md ==================== ==================== START: .bmad-infrastructure-devops/tasks/validate-infrastructure.md ==================== + # Infrastructure Validation Task ## Purpose @@ -523,6 +526,7 @@ REPEAT by Asking the user if they would like to perform another Reflective, Elic ==================== END: .bmad-infrastructure-devops/tasks/validate-infrastructure.md ==================== ==================== START: .bmad-infrastructure-devops/templates/infrastructure-architecture-tmpl.yaml ==================== +# template: id: infrastructure-architecture-template-v2 name: Infrastructure Architecture @@ -950,6 +954,7 @@ sections: ==================== END: .bmad-infrastructure-devops/templates/infrastructure-architecture-tmpl.yaml ==================== ==================== START: .bmad-infrastructure-devops/templates/infrastructure-platform-from-arch-tmpl.yaml ==================== +# template: id: infrastructure-platform-template-v2 name: Platform Infrastructure Implementation @@ -1582,6 +1587,7 @@ sections: ==================== END: .bmad-infrastructure-devops/templates/infrastructure-platform-from-arch-tmpl.yaml ==================== ==================== START: .bmad-infrastructure-devops/checklists/infrastructure-checklist.md ==================== + # Infrastructure Change Validation Checklist This checklist serves as a comprehensive framework for validating infrastructure changes before deployment to production. The DevOps/Platform Engineer should systematically work through each item, ensuring the infrastructure is secure, compliant, resilient, and properly implemented according to organizational standards. @@ -2069,6 +2075,7 @@ This checklist serves as a comprehensive framework for validating infrastructure ==================== END: .bmad-infrastructure-devops/checklists/infrastructure-checklist.md ==================== ==================== START: .bmad-infrastructure-devops/data/technical-preferences.md ==================== + # User-Defined Preferred Patterns and Preferences None Listed diff --git a/dist/teams/team-all.txt b/dist/teams/team-all.txt index 390f05bd..db88f523 100644 --- a/dist/teams/team-all.txt +++ b/dist/teams/team-all.txt @@ -40,6 +40,7 @@ These references map directly to bundle sections: ==================== START: .bmad-core/agent-teams/team-all.yaml ==================== +# bundle: name: Team All icon: 👥 @@ -99,13 +100,8 @@ commands: doc-out: Output full document kb-mode: Load full BMad knowledge base party-mode: Group chat with all agents - plan: Create detailed workflow plan before starting - plan-status: Show current workflow plan progress - plan-update: Update workflow plan status status: Show current context, active agent, and progress task: Run a specific task (list if name not specified) - workflow: Start a specific workflow (list if name not specified) - workflow-guidance: Get personalized help selecting the right workflow yolo: Toggle skip confirmations mode exit: Return to BMad or exit session help-display-template: | @@ -659,6 +655,7 @@ dependencies: ==================== END: .bmad-core/agents/ux-expert.md ==================== ==================== START: .bmad-core/tasks/advanced-elicitation.md ==================== + # Advanced Elicitation Task ## Purpose @@ -779,6 +776,7 @@ Choose a number (0-8) or 9 to proceed: ==================== END: .bmad-core/tasks/advanced-elicitation.md ==================== ==================== START: .bmad-core/tasks/create-doc.md ==================== + # Create Document from Template (YAML Driven) ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️ @@ -883,6 +881,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once). ==================== END: .bmad-core/tasks/create-doc.md ==================== ==================== START: .bmad-core/tasks/kb-mode-interaction.md ==================== + # KB Mode Interaction Task ## Purpose @@ -961,11 +960,12 @@ Or ask me about anything else related to BMad-Method! ==================== END: .bmad-core/tasks/kb-mode-interaction.md ==================== ==================== START: .bmad-core/data/bmad-kb.md ==================== -# BMad Knowledge Base + +# BMAD™ Knowledge Base ## Overview -BMad-Method (Breakthrough Method of Agile AI-driven Development) is a framework that combines AI agents with Agile development methodologies. The v4 system introduces a modular architecture with improved dependency management, bundle optimization, and support for both web and IDE environments. +BMAD-METHOD™ (Breakthrough Method of Agile AI-driven Development) is a framework that combines AI agents with Agile development methodologies. The v4 system introduces a modular architecture with improved dependency management, bundle optimization, and support for both web and IDE environments. ### Key Features @@ -1064,7 +1064,7 @@ npx bmad-method install - **Roo Code**: Web-based IDE with agent support - **GitHub Copilot**: VS Code extension with AI peer programming assistant -**Note for VS Code Users**: BMad-Method assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMad agents. The installer includes built-in support for Cline and Roo. +**Note for VS Code Users**: BMAD-METHOD™ assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMad agents. The installer includes built-in support for Cline and Roo. **Verify Installation**: @@ -1072,7 +1072,7 @@ npx bmad-method install - IDE-specific integration files created - All agent commands/rules/modes available -**Remember**: At its core, BMad-Method is about mastering and harnessing prompt engineering. Any IDE with AI agent support can use BMad - the framework provides the structured prompts and workflows that make AI development effective +**Remember**: At its core, BMAD-METHOD™ is about mastering and harnessing prompt engineering. Any IDE with AI agent support can use BMad - the framework provides the structured prompts and workflows that make AI development effective ### Environment Selection Guide @@ -1316,7 +1316,7 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing ### System Overview -The BMad-Method is built around a modular architecture centered on the `bmad-core` directory, which serves as the brain of the entire system. This design enables the framework to operate effectively in both IDE environments (like Cursor, VS Code) and web-based AI interfaces (like ChatGPT, Gemini). +The BMAD-METHOD™ is built around a modular architecture centered on the `bmad-core` directory, which serves as the brain of the entire system. This design enables the framework to operate effectively in both IDE environments (like Cursor, VS Code) and web-based AI interfaces (like ChatGPT, Gemini). ### Key Architectural Components @@ -1671,7 +1671,7 @@ Use the `shard-doc` task or `@kayvan/markdown-tree-parser` tool for automatic sh - **Keep conversations focused** - One agent, one task per conversation - **Review everything** - Always review and approve before marking complete -## Contributing to BMad-Method +## Contributing to BMAD-METHOD™ ### Quick Contribution Guidelines @@ -1703,7 +1703,7 @@ For full details, see `CONTRIBUTING.md`. Key points: ### What Are Expansion Packs? -Expansion packs extend BMad-Method beyond traditional software development into ANY domain. They provide specialized agent teams, templates, and workflows while keeping the core framework lean and focused on development. +Expansion packs extend BMAD-METHOD™ beyond traditional software development into ANY domain. They provide specialized agent teams, templates, and workflows while keeping the core framework lean and focused on development. ### Why Use Expansion Packs? @@ -1770,6 +1770,7 @@ Use the **expansion-creator** pack to build your own: ==================== END: .bmad-core/data/bmad-kb.md ==================== ==================== START: .bmad-core/data/elicitation-methods.md ==================== + # Elicitation Methods Data ## Core Reflective Methods @@ -1927,6 +1928,7 @@ Use the **expansion-creator** pack to build your own: ==================== END: .bmad-core/data/elicitation-methods.md ==================== ==================== START: .bmad-core/utils/workflow-management.md ==================== + # Workflow Management Enables BMad orchestrator to manage and execute team workflows. @@ -1999,6 +2001,7 @@ Agents should be workflow-aware: know active workflow, their role, access artifa ==================== END: .bmad-core/utils/workflow-management.md ==================== ==================== START: .bmad-core/tasks/create-deep-research-prompt.md ==================== + # Create Deep Research Prompt Task This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation. @@ -2280,6 +2283,7 @@ CRITICAL: collaborate with the user to develop specific, actionable research que ==================== END: .bmad-core/tasks/create-deep-research-prompt.md ==================== ==================== START: .bmad-core/tasks/document-project.md ==================== + # Document an Existing Project ## Purpose @@ -2626,6 +2630,7 @@ Apply the advanced elicitation task after major sections to refine based on user ==================== END: .bmad-core/tasks/document-project.md ==================== ==================== START: .bmad-core/tasks/facilitate-brainstorming-session.md ==================== + --- docOutputLocation: docs/brainstorming-session-results.md template: '.bmad-core/templates/brainstorming-output-tmpl.yaml' @@ -2920,10 +2925,11 @@ sections: content: | --- - *Session facilitated using the BMAD-METHOD brainstorming framework* + *Session facilitated using the BMAD-METHOD™ brainstorming framework* ==================== END: .bmad-core/templates/brainstorming-output-tmpl.yaml ==================== ==================== START: .bmad-core/templates/competitor-analysis-tmpl.yaml ==================== +# template: id: competitor-analysis-template-v2 name: Competitive Analysis Report @@ -3233,6 +3239,7 @@ sections: ==================== END: .bmad-core/templates/competitor-analysis-tmpl.yaml ==================== ==================== START: .bmad-core/templates/market-research-tmpl.yaml ==================== +# template: id: market-research-template-v2 name: Market Research Report @@ -3488,6 +3495,7 @@ sections: ==================== END: .bmad-core/templates/market-research-tmpl.yaml ==================== ==================== START: .bmad-core/templates/project-brief-tmpl.yaml ==================== +# template: id: project-brief-template-v2 name: Project Brief @@ -3712,6 +3720,7 @@ sections: ==================== END: .bmad-core/templates/project-brief-tmpl.yaml ==================== ==================== START: .bmad-core/data/brainstorming-techniques.md ==================== + # Brainstorming Techniques Data ## Creative Expansion @@ -3751,6 +3760,7 @@ sections: ==================== END: .bmad-core/data/brainstorming-techniques.md ==================== ==================== START: .bmad-core/tasks/execute-checklist.md ==================== + # 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. @@ -3840,6 +3850,7 @@ The LLM will: ==================== END: .bmad-core/tasks/execute-checklist.md ==================== ==================== START: .bmad-core/templates/architecture-tmpl.yaml ==================== +# template: id: architecture-template-v2 name: Architecture Document @@ -4493,6 +4504,7 @@ sections: ==================== END: .bmad-core/templates/architecture-tmpl.yaml ==================== ==================== START: .bmad-core/templates/brownfield-architecture-tmpl.yaml ==================== +# template: id: brownfield-architecture-template-v2 name: Brownfield Enhancement Architecture @@ -4972,6 +4984,7 @@ sections: ==================== END: .bmad-core/templates/brownfield-architecture-tmpl.yaml ==================== ==================== START: .bmad-core/templates/front-end-architecture-tmpl.yaml ==================== +# template: id: frontend-architecture-template-v2 name: Frontend Architecture Document @@ -5193,6 +5206,7 @@ sections: ==================== END: .bmad-core/templates/front-end-architecture-tmpl.yaml ==================== ==================== START: .bmad-core/templates/fullstack-architecture-tmpl.yaml ==================== +# template: id: fullstack-architecture-template-v2 name: Fullstack Architecture Document @@ -6019,6 +6033,7 @@ sections: ==================== END: .bmad-core/templates/fullstack-architecture-tmpl.yaml ==================== ==================== START: .bmad-core/checklists/architect-checklist.md ==================== + # Architect Solution Validation Checklist This checklist serves as a comprehensive framework for the Architect to validate the technical design and architecture before development execution. The Architect should systematically work through each item, ensuring the architecture is robust, scalable, secure, and aligned with the product requirements. @@ -6460,12 +6475,14 @@ After presenting the report, ask the user if they would like detailed analysis o ==================== END: .bmad-core/checklists/architect-checklist.md ==================== ==================== START: .bmad-core/data/technical-preferences.md ==================== + # User-Defined Preferred Patterns and Preferences None Listed ==================== END: .bmad-core/data/technical-preferences.md ==================== ==================== START: .bmad-core/tasks/apply-qa-fixes.md ==================== + # apply-qa-fixes Implement fixes based on QA results (gate and assessments) for a specific story. This task is for the Dev agent to systematically consume QA outputs and apply code/test changes while only updating allowed sections in the story file. @@ -6617,6 +6634,7 @@ Fix plan: ==================== END: .bmad-core/tasks/apply-qa-fixes.md ==================== ==================== START: .bmad-core/tasks/validate-next-story.md ==================== + # Validate Next Story Task ## Purpose @@ -6754,6 +6772,7 @@ Provide a structured validation report including: ==================== END: .bmad-core/tasks/validate-next-story.md ==================== ==================== START: .bmad-core/checklists/story-dod-checklist.md ==================== + # Story Definition of Done (DoD) Checklist ## Instructions for Developer Agent @@ -6851,6 +6870,7 @@ Be honest - it's better to flag issues now than have them discovered later.]] ==================== END: .bmad-core/checklists/story-dod-checklist.md ==================== ==================== START: .bmad-core/tasks/brownfield-create-epic.md ==================== + # Create Brownfield Epic Task ## Purpose @@ -7014,6 +7034,7 @@ The epic creation is successful when: ==================== END: .bmad-core/tasks/brownfield-create-epic.md ==================== ==================== START: .bmad-core/tasks/brownfield-create-story.md ==================== + # Create Brownfield Story Task ## Purpose @@ -7164,6 +7185,7 @@ The story creation is successful when: ==================== END: .bmad-core/tasks/brownfield-create-story.md ==================== ==================== START: .bmad-core/tasks/correct-course.md ==================== + # Correct Course Task ## Purpose @@ -7237,6 +7259,7 @@ The story creation is successful when: ==================== END: .bmad-core/tasks/correct-course.md ==================== ==================== START: .bmad-core/tasks/shard-doc.md ==================== + # Document Sharding Task ## Purpose @@ -7425,6 +7448,7 @@ Document sharded successfully: ==================== END: .bmad-core/tasks/shard-doc.md ==================== ==================== START: .bmad-core/templates/brownfield-prd-tmpl.yaml ==================== +# template: id: brownfield-prd-template-v2 name: Brownfield Enhancement PRD @@ -7708,6 +7732,7 @@ sections: ==================== END: .bmad-core/templates/brownfield-prd-tmpl.yaml ==================== ==================== START: .bmad-core/templates/prd-tmpl.yaml ==================== +# template: id: prd-template-v2 name: Product Requirements Document @@ -7913,6 +7938,7 @@ sections: ==================== END: .bmad-core/templates/prd-tmpl.yaml ==================== ==================== START: .bmad-core/checklists/change-checklist.md ==================== + # Change Navigation Checklist **Purpose:** To systematically guide the selected Agent and user through the analysis and planning required when a significant change (pivot, tech issue, missing requirement, failed story) is identified during the BMad workflow. @@ -8098,6 +8124,7 @@ Keep it action-oriented and forward-looking.]] ==================== END: .bmad-core/checklists/change-checklist.md ==================== ==================== START: .bmad-core/checklists/pm-checklist.md ==================== + # Product Manager (PM) Requirements Checklist This checklist serves as a comprehensive framework to ensure the Product Requirements Document (PRD) and Epic definitions are complete, well-structured, and appropriately scoped for MVP development. The PM should systematically work through each item during the product definition process. @@ -8471,6 +8498,7 @@ After presenting the report, ask if the user wants: ==================== END: .bmad-core/checklists/pm-checklist.md ==================== ==================== START: .bmad-core/templates/story-tmpl.yaml ==================== +# template: id: story-template-v2 name: Story Document @@ -8611,6 +8639,7 @@ sections: ==================== END: .bmad-core/templates/story-tmpl.yaml ==================== ==================== START: .bmad-core/checklists/po-master-checklist.md ==================== + # Product Owner (PO) Master Validation Checklist This checklist serves as a comprehensive framework for the Product Owner to validate project plans before development execution. It adapts intelligently based on project type (greenfield vs brownfield) and includes UI/UX considerations when applicable. @@ -9046,6 +9075,7 @@ After presenting the report, ask if the user wants: ==================== END: .bmad-core/checklists/po-master-checklist.md ==================== ==================== START: .bmad-core/tasks/nfr-assess.md ==================== + # nfr-assess Quick NFR validation focused on the core four: security, performance, reliability, maintainability. @@ -9392,6 +9422,7 @@ performance_deep_dive: ==================== END: .bmad-core/tasks/nfr-assess.md ==================== ==================== START: .bmad-core/tasks/qa-gate.md ==================== + # qa-gate Create or update a quality gate decision file for a story based on review findings. @@ -9556,6 +9587,7 @@ Gate: CONCERNS → qa.qaLocation/gates/{epic}.{story}-{slug}.yml ==================== END: .bmad-core/tasks/qa-gate.md ==================== ==================== START: .bmad-core/tasks/review-story.md ==================== + # review-story Perform a comprehensive test architecture review with quality gate decision. This adaptive, risk-aware review creates both a story update and a detailed gate file. @@ -9873,6 +9905,7 @@ After review: ==================== END: .bmad-core/tasks/review-story.md ==================== ==================== START: .bmad-core/tasks/risk-profile.md ==================== + # risk-profile Generate a comprehensive risk assessment matrix for a story implementation using probability × impact analysis. @@ -10229,6 +10262,7 @@ Risk profile: qa.qaLocation/assessments/{epic}.{story}-risk-{YYYYMMDD}.md ==================== END: .bmad-core/tasks/risk-profile.md ==================== ==================== START: .bmad-core/tasks/test-design.md ==================== + # test-design Create comprehensive test scenarios with appropriate test level recommendations for story implementation. @@ -10406,6 +10440,7 @@ Before finalizing, verify: ==================== END: .bmad-core/tasks/test-design.md ==================== ==================== START: .bmad-core/tasks/trace-requirements.md ==================== + # trace-requirements Map story requirements to test cases using Given-When-Then patterns for comprehensive traceability. @@ -10673,6 +10708,7 @@ Trace matrix: qa.qaLocation/assessments/{epic}.{story}-trace-{YYYYMMDD}.md ==================== END: .bmad-core/tasks/trace-requirements.md ==================== ==================== START: .bmad-core/templates/qa-gate-tmpl.yaml ==================== +# template: id: qa-gate-template-v1 name: Quality Gate Decision @@ -10778,6 +10814,7 @@ optional_fields_examples: ==================== END: .bmad-core/templates/qa-gate-tmpl.yaml ==================== ==================== START: .bmad-core/tasks/create-next-story.md ==================== + # Create Next Story Task ## Purpose @@ -10893,6 +10930,7 @@ ALWAYS cite source documents: `[Source: architecture/{filename}.md#{section}]` ==================== END: .bmad-core/tasks/create-next-story.md ==================== ==================== START: .bmad-core/checklists/story-draft-checklist.md ==================== + # Story Draft Checklist The Scrum Master should use this checklist to validate that each story contains sufficient context for a developer agent to implement it successfully, while assuming the dev agent has reasonable capabilities to figure things out. @@ -11049,6 +11087,7 @@ Be pragmatic - perfect documentation doesn't exist, but it must be enough to pro ==================== END: .bmad-core/checklists/story-draft-checklist.md ==================== ==================== START: .bmad-core/tasks/generate-ai-frontend-prompt.md ==================== + # Create AI Frontend Prompt Task ## Purpose @@ -11103,6 +11142,7 @@ You will now synthesize the inputs and the above principles into a final, compre ==================== END: .bmad-core/tasks/generate-ai-frontend-prompt.md ==================== ==================== START: .bmad-core/templates/front-end-spec-tmpl.yaml ==================== +# template: id: frontend-spec-template-v2 name: UI/UX Specification @@ -11455,6 +11495,7 @@ sections: ==================== END: .bmad-core/templates/front-end-spec-tmpl.yaml ==================== ==================== START: .bmad-core/workflows/brownfield-fullstack.yaml ==================== +# workflow: id: brownfield-fullstack name: Brownfield Full-Stack Enhancement @@ -11755,6 +11796,7 @@ workflow: ==================== END: .bmad-core/workflows/brownfield-fullstack.yaml ==================== ==================== START: .bmad-core/workflows/brownfield-service.yaml ==================== +# workflow: id: brownfield-service name: Brownfield Service/API Enhancement @@ -11945,6 +11987,7 @@ workflow: ==================== END: .bmad-core/workflows/brownfield-service.yaml ==================== ==================== START: .bmad-core/workflows/brownfield-ui.yaml ==================== +# workflow: id: brownfield-ui name: Brownfield UI/Frontend Enhancement @@ -12145,6 +12188,7 @@ workflow: ==================== END: .bmad-core/workflows/brownfield-ui.yaml ==================== ==================== START: .bmad-core/workflows/greenfield-fullstack.yaml ==================== +# workflow: id: greenfield-fullstack name: Greenfield Full-Stack Application Development @@ -12388,6 +12432,7 @@ workflow: ==================== END: .bmad-core/workflows/greenfield-fullstack.yaml ==================== ==================== START: .bmad-core/workflows/greenfield-service.yaml ==================== +# workflow: id: greenfield-service name: Greenfield Service/API Development @@ -12597,6 +12642,7 @@ workflow: ==================== END: .bmad-core/workflows/greenfield-service.yaml ==================== ==================== START: .bmad-core/workflows/greenfield-ui.yaml ==================== +# workflow: id: greenfield-ui name: Greenfield UI/Frontend Development diff --git a/dist/teams/team-fullstack.txt b/dist/teams/team-fullstack.txt index aabba406..4f389def 100644 --- a/dist/teams/team-fullstack.txt +++ b/dist/teams/team-fullstack.txt @@ -40,6 +40,7 @@ These references map directly to bundle sections: ==================== START: .bmad-core/agent-teams/team-fullstack.yaml ==================== +# bundle: name: Team Fullstack icon: 🚀 @@ -103,13 +104,8 @@ commands: doc-out: Output full document kb-mode: Load full BMad knowledge base party-mode: Group chat with all agents - plan: Create detailed workflow plan before starting - plan-status: Show current workflow plan progress - plan-update: Update workflow plan status status: Show current context, active agent, and progress task: Run a specific task (list if name not specified) - workflow: Start a specific workflow (list if name not specified) - workflow-guidance: Get personalized help selecting the right workflow yolo: Toggle skip confirmations mode exit: Return to BMad or exit session help-display-template: | @@ -494,6 +490,7 @@ dependencies: ==================== END: .bmad-core/agents/po.md ==================== ==================== START: .bmad-core/tasks/advanced-elicitation.md ==================== + # Advanced Elicitation Task ## Purpose @@ -614,6 +611,7 @@ Choose a number (0-8) or 9 to proceed: ==================== END: .bmad-core/tasks/advanced-elicitation.md ==================== ==================== START: .bmad-core/tasks/create-doc.md ==================== + # Create Document from Template (YAML Driven) ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️ @@ -718,6 +716,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once). ==================== END: .bmad-core/tasks/create-doc.md ==================== ==================== START: .bmad-core/tasks/kb-mode-interaction.md ==================== + # KB Mode Interaction Task ## Purpose @@ -796,11 +795,12 @@ Or ask me about anything else related to BMad-Method! ==================== END: .bmad-core/tasks/kb-mode-interaction.md ==================== ==================== START: .bmad-core/data/bmad-kb.md ==================== -# BMad Knowledge Base + +# BMAD™ Knowledge Base ## Overview -BMad-Method (Breakthrough Method of Agile AI-driven Development) is a framework that combines AI agents with Agile development methodologies. The v4 system introduces a modular architecture with improved dependency management, bundle optimization, and support for both web and IDE environments. +BMAD-METHOD™ (Breakthrough Method of Agile AI-driven Development) is a framework that combines AI agents with Agile development methodologies. The v4 system introduces a modular architecture with improved dependency management, bundle optimization, and support for both web and IDE environments. ### Key Features @@ -899,7 +899,7 @@ npx bmad-method install - **Roo Code**: Web-based IDE with agent support - **GitHub Copilot**: VS Code extension with AI peer programming assistant -**Note for VS Code Users**: BMad-Method assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMad agents. The installer includes built-in support for Cline and Roo. +**Note for VS Code Users**: BMAD-METHOD™ assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMad agents. The installer includes built-in support for Cline and Roo. **Verify Installation**: @@ -907,7 +907,7 @@ npx bmad-method install - IDE-specific integration files created - All agent commands/rules/modes available -**Remember**: At its core, BMad-Method is about mastering and harnessing prompt engineering. Any IDE with AI agent support can use BMad - the framework provides the structured prompts and workflows that make AI development effective +**Remember**: At its core, BMAD-METHOD™ is about mastering and harnessing prompt engineering. Any IDE with AI agent support can use BMad - the framework provides the structured prompts and workflows that make AI development effective ### Environment Selection Guide @@ -1151,7 +1151,7 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing ### System Overview -The BMad-Method is built around a modular architecture centered on the `bmad-core` directory, which serves as the brain of the entire system. This design enables the framework to operate effectively in both IDE environments (like Cursor, VS Code) and web-based AI interfaces (like ChatGPT, Gemini). +The BMAD-METHOD™ is built around a modular architecture centered on the `bmad-core` directory, which serves as the brain of the entire system. This design enables the framework to operate effectively in both IDE environments (like Cursor, VS Code) and web-based AI interfaces (like ChatGPT, Gemini). ### Key Architectural Components @@ -1506,7 +1506,7 @@ Use the `shard-doc` task or `@kayvan/markdown-tree-parser` tool for automatic sh - **Keep conversations focused** - One agent, one task per conversation - **Review everything** - Always review and approve before marking complete -## Contributing to BMad-Method +## Contributing to BMAD-METHOD™ ### Quick Contribution Guidelines @@ -1538,7 +1538,7 @@ For full details, see `CONTRIBUTING.md`. Key points: ### What Are Expansion Packs? -Expansion packs extend BMad-Method beyond traditional software development into ANY domain. They provide specialized agent teams, templates, and workflows while keeping the core framework lean and focused on development. +Expansion packs extend BMAD-METHOD™ beyond traditional software development into ANY domain. They provide specialized agent teams, templates, and workflows while keeping the core framework lean and focused on development. ### Why Use Expansion Packs? @@ -1605,6 +1605,7 @@ Use the **expansion-creator** pack to build your own: ==================== END: .bmad-core/data/bmad-kb.md ==================== ==================== START: .bmad-core/data/elicitation-methods.md ==================== + # Elicitation Methods Data ## Core Reflective Methods @@ -1762,6 +1763,7 @@ Use the **expansion-creator** pack to build your own: ==================== END: .bmad-core/data/elicitation-methods.md ==================== ==================== START: .bmad-core/utils/workflow-management.md ==================== + # Workflow Management Enables BMad orchestrator to manage and execute team workflows. @@ -1834,6 +1836,7 @@ Agents should be workflow-aware: know active workflow, their role, access artifa ==================== END: .bmad-core/utils/workflow-management.md ==================== ==================== START: .bmad-core/tasks/create-deep-research-prompt.md ==================== + # Create Deep Research Prompt Task This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation. @@ -2115,6 +2118,7 @@ CRITICAL: collaborate with the user to develop specific, actionable research que ==================== END: .bmad-core/tasks/create-deep-research-prompt.md ==================== ==================== START: .bmad-core/tasks/document-project.md ==================== + # Document an Existing Project ## Purpose @@ -2461,6 +2465,7 @@ Apply the advanced elicitation task after major sections to refine based on user ==================== END: .bmad-core/tasks/document-project.md ==================== ==================== START: .bmad-core/tasks/facilitate-brainstorming-session.md ==================== + --- docOutputLocation: docs/brainstorming-session-results.md template: '.bmad-core/templates/brainstorming-output-tmpl.yaml' @@ -2755,10 +2760,11 @@ sections: content: | --- - *Session facilitated using the BMAD-METHOD brainstorming framework* + *Session facilitated using the BMAD-METHOD™ brainstorming framework* ==================== END: .bmad-core/templates/brainstorming-output-tmpl.yaml ==================== ==================== START: .bmad-core/templates/competitor-analysis-tmpl.yaml ==================== +# template: id: competitor-analysis-template-v2 name: Competitive Analysis Report @@ -3068,6 +3074,7 @@ sections: ==================== END: .bmad-core/templates/competitor-analysis-tmpl.yaml ==================== ==================== START: .bmad-core/templates/market-research-tmpl.yaml ==================== +# template: id: market-research-template-v2 name: Market Research Report @@ -3323,6 +3330,7 @@ sections: ==================== END: .bmad-core/templates/market-research-tmpl.yaml ==================== ==================== START: .bmad-core/templates/project-brief-tmpl.yaml ==================== +# template: id: project-brief-template-v2 name: Project Brief @@ -3547,6 +3555,7 @@ sections: ==================== END: .bmad-core/templates/project-brief-tmpl.yaml ==================== ==================== START: .bmad-core/data/brainstorming-techniques.md ==================== + # Brainstorming Techniques Data ## Creative Expansion @@ -3586,6 +3595,7 @@ sections: ==================== END: .bmad-core/data/brainstorming-techniques.md ==================== ==================== START: .bmad-core/tasks/brownfield-create-epic.md ==================== + # Create Brownfield Epic Task ## Purpose @@ -3749,6 +3759,7 @@ The epic creation is successful when: ==================== END: .bmad-core/tasks/brownfield-create-epic.md ==================== ==================== START: .bmad-core/tasks/brownfield-create-story.md ==================== + # Create Brownfield Story Task ## Purpose @@ -3899,6 +3910,7 @@ The story creation is successful when: ==================== END: .bmad-core/tasks/brownfield-create-story.md ==================== ==================== START: .bmad-core/tasks/correct-course.md ==================== + # Correct Course Task ## Purpose @@ -3972,6 +3984,7 @@ The story creation is successful when: ==================== END: .bmad-core/tasks/correct-course.md ==================== ==================== START: .bmad-core/tasks/execute-checklist.md ==================== + # 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. @@ -4061,6 +4074,7 @@ The LLM will: ==================== END: .bmad-core/tasks/execute-checklist.md ==================== ==================== START: .bmad-core/tasks/shard-doc.md ==================== + # Document Sharding Task ## Purpose @@ -4249,6 +4263,7 @@ Document sharded successfully: ==================== END: .bmad-core/tasks/shard-doc.md ==================== ==================== START: .bmad-core/templates/brownfield-prd-tmpl.yaml ==================== +# template: id: brownfield-prd-template-v2 name: Brownfield Enhancement PRD @@ -4532,6 +4547,7 @@ sections: ==================== END: .bmad-core/templates/brownfield-prd-tmpl.yaml ==================== ==================== START: .bmad-core/templates/prd-tmpl.yaml ==================== +# template: id: prd-template-v2 name: Product Requirements Document @@ -4737,6 +4753,7 @@ sections: ==================== END: .bmad-core/templates/prd-tmpl.yaml ==================== ==================== START: .bmad-core/checklists/change-checklist.md ==================== + # Change Navigation Checklist **Purpose:** To systematically guide the selected Agent and user through the analysis and planning required when a significant change (pivot, tech issue, missing requirement, failed story) is identified during the BMad workflow. @@ -4922,6 +4939,7 @@ Keep it action-oriented and forward-looking.]] ==================== END: .bmad-core/checklists/change-checklist.md ==================== ==================== START: .bmad-core/checklists/pm-checklist.md ==================== + # Product Manager (PM) Requirements Checklist This checklist serves as a comprehensive framework to ensure the Product Requirements Document (PRD) and Epic definitions are complete, well-structured, and appropriately scoped for MVP development. The PM should systematically work through each item during the product definition process. @@ -5295,12 +5313,14 @@ After presenting the report, ask if the user wants: ==================== END: .bmad-core/checklists/pm-checklist.md ==================== ==================== START: .bmad-core/data/technical-preferences.md ==================== + # User-Defined Preferred Patterns and Preferences None Listed ==================== END: .bmad-core/data/technical-preferences.md ==================== ==================== START: .bmad-core/tasks/generate-ai-frontend-prompt.md ==================== + # Create AI Frontend Prompt Task ## Purpose @@ -5355,6 +5375,7 @@ You will now synthesize the inputs and the above principles into a final, compre ==================== END: .bmad-core/tasks/generate-ai-frontend-prompt.md ==================== ==================== START: .bmad-core/templates/front-end-spec-tmpl.yaml ==================== +# template: id: frontend-spec-template-v2 name: UI/UX Specification @@ -5707,6 +5728,7 @@ sections: ==================== END: .bmad-core/templates/front-end-spec-tmpl.yaml ==================== ==================== START: .bmad-core/templates/architecture-tmpl.yaml ==================== +# template: id: architecture-template-v2 name: Architecture Document @@ -6360,6 +6382,7 @@ sections: ==================== END: .bmad-core/templates/architecture-tmpl.yaml ==================== ==================== START: .bmad-core/templates/brownfield-architecture-tmpl.yaml ==================== +# template: id: brownfield-architecture-template-v2 name: Brownfield Enhancement Architecture @@ -6839,6 +6862,7 @@ sections: ==================== END: .bmad-core/templates/brownfield-architecture-tmpl.yaml ==================== ==================== START: .bmad-core/templates/front-end-architecture-tmpl.yaml ==================== +# template: id: frontend-architecture-template-v2 name: Frontend Architecture Document @@ -7060,6 +7084,7 @@ sections: ==================== END: .bmad-core/templates/front-end-architecture-tmpl.yaml ==================== ==================== START: .bmad-core/templates/fullstack-architecture-tmpl.yaml ==================== +# template: id: fullstack-architecture-template-v2 name: Fullstack Architecture Document @@ -7886,6 +7911,7 @@ sections: ==================== END: .bmad-core/templates/fullstack-architecture-tmpl.yaml ==================== ==================== START: .bmad-core/checklists/architect-checklist.md ==================== + # Architect Solution Validation Checklist This checklist serves as a comprehensive framework for the Architect to validate the technical design and architecture before development execution. The Architect should systematically work through each item, ensuring the architecture is robust, scalable, secure, and aligned with the product requirements. @@ -8327,6 +8353,7 @@ After presenting the report, ask the user if they would like detailed analysis o ==================== END: .bmad-core/checklists/architect-checklist.md ==================== ==================== START: .bmad-core/tasks/validate-next-story.md ==================== + # Validate Next Story Task ## Purpose @@ -8464,6 +8491,7 @@ Provide a structured validation report including: ==================== END: .bmad-core/tasks/validate-next-story.md ==================== ==================== START: .bmad-core/templates/story-tmpl.yaml ==================== +# template: id: story-template-v2 name: Story Document @@ -8604,6 +8632,7 @@ sections: ==================== END: .bmad-core/templates/story-tmpl.yaml ==================== ==================== START: .bmad-core/checklists/po-master-checklist.md ==================== + # Product Owner (PO) Master Validation Checklist This checklist serves as a comprehensive framework for the Product Owner to validate project plans before development execution. It adapts intelligently based on project type (greenfield vs brownfield) and includes UI/UX considerations when applicable. @@ -9039,6 +9068,7 @@ After presenting the report, ask if the user wants: ==================== END: .bmad-core/checklists/po-master-checklist.md ==================== ==================== START: .bmad-core/workflows/brownfield-fullstack.yaml ==================== +# workflow: id: brownfield-fullstack name: Brownfield Full-Stack Enhancement @@ -9339,6 +9369,7 @@ workflow: ==================== END: .bmad-core/workflows/brownfield-fullstack.yaml ==================== ==================== START: .bmad-core/workflows/brownfield-service.yaml ==================== +# workflow: id: brownfield-service name: Brownfield Service/API Enhancement @@ -9529,6 +9560,7 @@ workflow: ==================== END: .bmad-core/workflows/brownfield-service.yaml ==================== ==================== START: .bmad-core/workflows/brownfield-ui.yaml ==================== +# workflow: id: brownfield-ui name: Brownfield UI/Frontend Enhancement @@ -9729,6 +9761,7 @@ workflow: ==================== END: .bmad-core/workflows/brownfield-ui.yaml ==================== ==================== START: .bmad-core/workflows/greenfield-fullstack.yaml ==================== +# workflow: id: greenfield-fullstack name: Greenfield Full-Stack Application Development @@ -9972,6 +10005,7 @@ workflow: ==================== END: .bmad-core/workflows/greenfield-fullstack.yaml ==================== ==================== START: .bmad-core/workflows/greenfield-service.yaml ==================== +# workflow: id: greenfield-service name: Greenfield Service/API Development @@ -10181,6 +10215,7 @@ workflow: ==================== END: .bmad-core/workflows/greenfield-service.yaml ==================== ==================== START: .bmad-core/workflows/greenfield-ui.yaml ==================== +# workflow: id: greenfield-ui name: Greenfield UI/Frontend Development diff --git a/dist/teams/team-ide-minimal.txt b/dist/teams/team-ide-minimal.txt index e5a2d9d1..e3683d68 100644 --- a/dist/teams/team-ide-minimal.txt +++ b/dist/teams/team-ide-minimal.txt @@ -40,6 +40,7 @@ These references map directly to bundle sections: ==================== START: .bmad-core/agent-teams/team-ide-minimal.yaml ==================== +# bundle: name: Team IDE Minimal icon: ⚡ @@ -95,13 +96,8 @@ commands: doc-out: Output full document kb-mode: Load full BMad knowledge base party-mode: Group chat with all agents - plan: Create detailed workflow plan before starting - plan-status: Show current workflow plan progress - plan-update: Update workflow plan status status: Show current context, active agent, and progress task: Run a specific task (list if name not specified) - workflow: Start a specific workflow (list if name not specified) - workflow-guidance: Get personalized help selecting the right workflow yolo: Toggle skip confirmations mode exit: Return to BMad or exit session help-display-template: | @@ -413,6 +409,7 @@ dependencies: ==================== END: .bmad-core/agents/qa.md ==================== ==================== START: .bmad-core/tasks/advanced-elicitation.md ==================== + # Advanced Elicitation Task ## Purpose @@ -533,6 +530,7 @@ Choose a number (0-8) or 9 to proceed: ==================== END: .bmad-core/tasks/advanced-elicitation.md ==================== ==================== START: .bmad-core/tasks/create-doc.md ==================== + # Create Document from Template (YAML Driven) ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️ @@ -637,6 +635,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once). ==================== END: .bmad-core/tasks/create-doc.md ==================== ==================== START: .bmad-core/tasks/kb-mode-interaction.md ==================== + # KB Mode Interaction Task ## Purpose @@ -715,11 +714,12 @@ Or ask me about anything else related to BMad-Method! ==================== END: .bmad-core/tasks/kb-mode-interaction.md ==================== ==================== START: .bmad-core/data/bmad-kb.md ==================== -# BMad Knowledge Base + +# BMAD™ Knowledge Base ## Overview -BMad-Method (Breakthrough Method of Agile AI-driven Development) is a framework that combines AI agents with Agile development methodologies. The v4 system introduces a modular architecture with improved dependency management, bundle optimization, and support for both web and IDE environments. +BMAD-METHOD™ (Breakthrough Method of Agile AI-driven Development) is a framework that combines AI agents with Agile development methodologies. The v4 system introduces a modular architecture with improved dependency management, bundle optimization, and support for both web and IDE environments. ### Key Features @@ -818,7 +818,7 @@ npx bmad-method install - **Roo Code**: Web-based IDE with agent support - **GitHub Copilot**: VS Code extension with AI peer programming assistant -**Note for VS Code Users**: BMad-Method assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMad agents. The installer includes built-in support for Cline and Roo. +**Note for VS Code Users**: BMAD-METHOD™ assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMad agents. The installer includes built-in support for Cline and Roo. **Verify Installation**: @@ -826,7 +826,7 @@ npx bmad-method install - IDE-specific integration files created - All agent commands/rules/modes available -**Remember**: At its core, BMad-Method is about mastering and harnessing prompt engineering. Any IDE with AI agent support can use BMad - the framework provides the structured prompts and workflows that make AI development effective +**Remember**: At its core, BMAD-METHOD™ is about mastering and harnessing prompt engineering. Any IDE with AI agent support can use BMad - the framework provides the structured prompts and workflows that make AI development effective ### Environment Selection Guide @@ -1070,7 +1070,7 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing ### System Overview -The BMad-Method is built around a modular architecture centered on the `bmad-core` directory, which serves as the brain of the entire system. This design enables the framework to operate effectively in both IDE environments (like Cursor, VS Code) and web-based AI interfaces (like ChatGPT, Gemini). +The BMAD-METHOD™ is built around a modular architecture centered on the `bmad-core` directory, which serves as the brain of the entire system. This design enables the framework to operate effectively in both IDE environments (like Cursor, VS Code) and web-based AI interfaces (like ChatGPT, Gemini). ### Key Architectural Components @@ -1425,7 +1425,7 @@ Use the `shard-doc` task or `@kayvan/markdown-tree-parser` tool for automatic sh - **Keep conversations focused** - One agent, one task per conversation - **Review everything** - Always review and approve before marking complete -## Contributing to BMad-Method +## Contributing to BMAD-METHOD™ ### Quick Contribution Guidelines @@ -1457,7 +1457,7 @@ For full details, see `CONTRIBUTING.md`. Key points: ### What Are Expansion Packs? -Expansion packs extend BMad-Method beyond traditional software development into ANY domain. They provide specialized agent teams, templates, and workflows while keeping the core framework lean and focused on development. +Expansion packs extend BMAD-METHOD™ beyond traditional software development into ANY domain. They provide specialized agent teams, templates, and workflows while keeping the core framework lean and focused on development. ### Why Use Expansion Packs? @@ -1524,6 +1524,7 @@ Use the **expansion-creator** pack to build your own: ==================== END: .bmad-core/data/bmad-kb.md ==================== ==================== START: .bmad-core/data/elicitation-methods.md ==================== + # Elicitation Methods Data ## Core Reflective Methods @@ -1681,6 +1682,7 @@ Use the **expansion-creator** pack to build your own: ==================== END: .bmad-core/data/elicitation-methods.md ==================== ==================== START: .bmad-core/utils/workflow-management.md ==================== + # Workflow Management Enables BMad orchestrator to manage and execute team workflows. @@ -1753,6 +1755,7 @@ Agents should be workflow-aware: know active workflow, their role, access artifa ==================== END: .bmad-core/utils/workflow-management.md ==================== ==================== START: .bmad-core/tasks/correct-course.md ==================== + # Correct Course Task ## Purpose @@ -1826,6 +1829,7 @@ Agents should be workflow-aware: know active workflow, their role, access artifa ==================== END: .bmad-core/tasks/correct-course.md ==================== ==================== START: .bmad-core/tasks/execute-checklist.md ==================== + # 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. @@ -1915,6 +1919,7 @@ The LLM will: ==================== END: .bmad-core/tasks/execute-checklist.md ==================== ==================== START: .bmad-core/tasks/shard-doc.md ==================== + # Document Sharding Task ## Purpose @@ -2103,6 +2108,7 @@ Document sharded successfully: ==================== END: .bmad-core/tasks/shard-doc.md ==================== ==================== START: .bmad-core/tasks/validate-next-story.md ==================== + # Validate Next Story Task ## Purpose @@ -2240,6 +2246,7 @@ Provide a structured validation report including: ==================== END: .bmad-core/tasks/validate-next-story.md ==================== ==================== START: .bmad-core/templates/story-tmpl.yaml ==================== +# template: id: story-template-v2 name: Story Document @@ -2380,6 +2387,7 @@ sections: ==================== END: .bmad-core/templates/story-tmpl.yaml ==================== ==================== START: .bmad-core/checklists/change-checklist.md ==================== + # Change Navigation Checklist **Purpose:** To systematically guide the selected Agent and user through the analysis and planning required when a significant change (pivot, tech issue, missing requirement, failed story) is identified during the BMad workflow. @@ -2565,6 +2573,7 @@ Keep it action-oriented and forward-looking.]] ==================== END: .bmad-core/checklists/change-checklist.md ==================== ==================== START: .bmad-core/checklists/po-master-checklist.md ==================== + # Product Owner (PO) Master Validation Checklist This checklist serves as a comprehensive framework for the Product Owner to validate project plans before development execution. It adapts intelligently based on project type (greenfield vs brownfield) and includes UI/UX considerations when applicable. @@ -3000,6 +3009,7 @@ After presenting the report, ask if the user wants: ==================== END: .bmad-core/checklists/po-master-checklist.md ==================== ==================== START: .bmad-core/tasks/create-next-story.md ==================== + # Create Next Story Task ## Purpose @@ -3115,6 +3125,7 @@ ALWAYS cite source documents: `[Source: architecture/{filename}.md#{section}]` ==================== END: .bmad-core/tasks/create-next-story.md ==================== ==================== START: .bmad-core/checklists/story-draft-checklist.md ==================== + # Story Draft Checklist The Scrum Master should use this checklist to validate that each story contains sufficient context for a developer agent to implement it successfully, while assuming the dev agent has reasonable capabilities to figure things out. @@ -3271,6 +3282,7 @@ Be pragmatic - perfect documentation doesn't exist, but it must be enough to pro ==================== END: .bmad-core/checklists/story-draft-checklist.md ==================== ==================== START: .bmad-core/tasks/apply-qa-fixes.md ==================== + # apply-qa-fixes Implement fixes based on QA results (gate and assessments) for a specific story. This task is for the Dev agent to systematically consume QA outputs and apply code/test changes while only updating allowed sections in the story file. @@ -3422,6 +3434,7 @@ Fix plan: ==================== END: .bmad-core/tasks/apply-qa-fixes.md ==================== ==================== START: .bmad-core/checklists/story-dod-checklist.md ==================== + # Story Definition of Done (DoD) Checklist ## Instructions for Developer Agent @@ -3519,6 +3532,7 @@ Be honest - it's better to flag issues now than have them discovered later.]] ==================== END: .bmad-core/checklists/story-dod-checklist.md ==================== ==================== START: .bmad-core/tasks/nfr-assess.md ==================== + # nfr-assess Quick NFR validation focused on the core four: security, performance, reliability, maintainability. @@ -3865,6 +3879,7 @@ performance_deep_dive: ==================== END: .bmad-core/tasks/nfr-assess.md ==================== ==================== START: .bmad-core/tasks/qa-gate.md ==================== + # qa-gate Create or update a quality gate decision file for a story based on review findings. @@ -4029,6 +4044,7 @@ Gate: CONCERNS → qa.qaLocation/gates/{epic}.{story}-{slug}.yml ==================== END: .bmad-core/tasks/qa-gate.md ==================== ==================== START: .bmad-core/tasks/review-story.md ==================== + # review-story Perform a comprehensive test architecture review with quality gate decision. This adaptive, risk-aware review creates both a story update and a detailed gate file. @@ -4346,6 +4362,7 @@ After review: ==================== END: .bmad-core/tasks/review-story.md ==================== ==================== START: .bmad-core/tasks/risk-profile.md ==================== + # risk-profile Generate a comprehensive risk assessment matrix for a story implementation using probability × impact analysis. @@ -4702,6 +4719,7 @@ Risk profile: qa.qaLocation/assessments/{epic}.{story}-risk-{YYYYMMDD}.md ==================== END: .bmad-core/tasks/risk-profile.md ==================== ==================== START: .bmad-core/tasks/test-design.md ==================== + # test-design Create comprehensive test scenarios with appropriate test level recommendations for story implementation. @@ -4879,6 +4897,7 @@ Before finalizing, verify: ==================== END: .bmad-core/tasks/test-design.md ==================== ==================== START: .bmad-core/tasks/trace-requirements.md ==================== + # trace-requirements Map story requirements to test cases using Given-When-Then patterns for comprehensive traceability. @@ -5146,6 +5165,7 @@ Trace matrix: qa.qaLocation/assessments/{epic}.{story}-trace-{YYYYMMDD}.md ==================== END: .bmad-core/tasks/trace-requirements.md ==================== ==================== START: .bmad-core/templates/qa-gate-tmpl.yaml ==================== +# template: id: qa-gate-template-v1 name: Quality Gate Decision @@ -5251,6 +5271,7 @@ optional_fields_examples: ==================== END: .bmad-core/templates/qa-gate-tmpl.yaml ==================== ==================== START: .bmad-core/data/technical-preferences.md ==================== + # User-Defined Preferred Patterns and Preferences None Listed diff --git a/dist/teams/team-no-ui.txt b/dist/teams/team-no-ui.txt index 312802a3..0bf562e8 100644 --- a/dist/teams/team-no-ui.txt +++ b/dist/teams/team-no-ui.txt @@ -40,6 +40,7 @@ These references map directly to bundle sections: ==================== START: .bmad-core/agent-teams/team-no-ui.yaml ==================== +# bundle: name: Team No UI icon: 🔧 @@ -98,13 +99,8 @@ commands: doc-out: Output full document kb-mode: Load full BMad knowledge base party-mode: Group chat with all agents - plan: Create detailed workflow plan before starting - plan-status: Show current workflow plan progress - plan-update: Update workflow plan status status: Show current context, active agent, and progress task: Run a specific task (list if name not specified) - workflow: Start a specific workflow (list if name not specified) - workflow-guidance: Get personalized help selecting the right workflow yolo: Toggle skip confirmations mode exit: Return to BMad or exit session help-display-template: | @@ -440,6 +436,7 @@ dependencies: ==================== END: .bmad-core/agents/po.md ==================== ==================== START: .bmad-core/tasks/advanced-elicitation.md ==================== + # Advanced Elicitation Task ## Purpose @@ -560,6 +557,7 @@ Choose a number (0-8) or 9 to proceed: ==================== END: .bmad-core/tasks/advanced-elicitation.md ==================== ==================== START: .bmad-core/tasks/create-doc.md ==================== + # Create Document from Template (YAML Driven) ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️ @@ -664,6 +662,7 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once). ==================== END: .bmad-core/tasks/create-doc.md ==================== ==================== START: .bmad-core/tasks/kb-mode-interaction.md ==================== + # KB Mode Interaction Task ## Purpose @@ -742,11 +741,12 @@ Or ask me about anything else related to BMad-Method! ==================== END: .bmad-core/tasks/kb-mode-interaction.md ==================== ==================== START: .bmad-core/data/bmad-kb.md ==================== -# BMad Knowledge Base + +# BMAD™ Knowledge Base ## Overview -BMad-Method (Breakthrough Method of Agile AI-driven Development) is a framework that combines AI agents with Agile development methodologies. The v4 system introduces a modular architecture with improved dependency management, bundle optimization, and support for both web and IDE environments. +BMAD-METHOD™ (Breakthrough Method of Agile AI-driven Development) is a framework that combines AI agents with Agile development methodologies. The v4 system introduces a modular architecture with improved dependency management, bundle optimization, and support for both web and IDE environments. ### Key Features @@ -845,7 +845,7 @@ npx bmad-method install - **Roo Code**: Web-based IDE with agent support - **GitHub Copilot**: VS Code extension with AI peer programming assistant -**Note for VS Code Users**: BMad-Method assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMad agents. The installer includes built-in support for Cline and Roo. +**Note for VS Code Users**: BMAD-METHOD™ assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMad agents. The installer includes built-in support for Cline and Roo. **Verify Installation**: @@ -853,7 +853,7 @@ npx bmad-method install - IDE-specific integration files created - All agent commands/rules/modes available -**Remember**: At its core, BMad-Method is about mastering and harnessing prompt engineering. Any IDE with AI agent support can use BMad - the framework provides the structured prompts and workflows that make AI development effective +**Remember**: At its core, BMAD-METHOD™ is about mastering and harnessing prompt engineering. Any IDE with AI agent support can use BMad - the framework provides the structured prompts and workflows that make AI development effective ### Environment Selection Guide @@ -1097,7 +1097,7 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing ### System Overview -The BMad-Method is built around a modular architecture centered on the `bmad-core` directory, which serves as the brain of the entire system. This design enables the framework to operate effectively in both IDE environments (like Cursor, VS Code) and web-based AI interfaces (like ChatGPT, Gemini). +The BMAD-METHOD™ is built around a modular architecture centered on the `bmad-core` directory, which serves as the brain of the entire system. This design enables the framework to operate effectively in both IDE environments (like Cursor, VS Code) and web-based AI interfaces (like ChatGPT, Gemini). ### Key Architectural Components @@ -1452,7 +1452,7 @@ Use the `shard-doc` task or `@kayvan/markdown-tree-parser` tool for automatic sh - **Keep conversations focused** - One agent, one task per conversation - **Review everything** - Always review and approve before marking complete -## Contributing to BMad-Method +## Contributing to BMAD-METHOD™ ### Quick Contribution Guidelines @@ -1484,7 +1484,7 @@ For full details, see `CONTRIBUTING.md`. Key points: ### What Are Expansion Packs? -Expansion packs extend BMad-Method beyond traditional software development into ANY domain. They provide specialized agent teams, templates, and workflows while keeping the core framework lean and focused on development. +Expansion packs extend BMAD-METHOD™ beyond traditional software development into ANY domain. They provide specialized agent teams, templates, and workflows while keeping the core framework lean and focused on development. ### Why Use Expansion Packs? @@ -1551,6 +1551,7 @@ Use the **expansion-creator** pack to build your own: ==================== END: .bmad-core/data/bmad-kb.md ==================== ==================== START: .bmad-core/data/elicitation-methods.md ==================== + # Elicitation Methods Data ## Core Reflective Methods @@ -1708,6 +1709,7 @@ Use the **expansion-creator** pack to build your own: ==================== END: .bmad-core/data/elicitation-methods.md ==================== ==================== START: .bmad-core/utils/workflow-management.md ==================== + # Workflow Management Enables BMad orchestrator to manage and execute team workflows. @@ -1780,6 +1782,7 @@ Agents should be workflow-aware: know active workflow, their role, access artifa ==================== END: .bmad-core/utils/workflow-management.md ==================== ==================== START: .bmad-core/tasks/create-deep-research-prompt.md ==================== + # Create Deep Research Prompt Task This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation. @@ -2061,6 +2064,7 @@ CRITICAL: collaborate with the user to develop specific, actionable research que ==================== END: .bmad-core/tasks/create-deep-research-prompt.md ==================== ==================== START: .bmad-core/tasks/document-project.md ==================== + # Document an Existing Project ## Purpose @@ -2407,6 +2411,7 @@ Apply the advanced elicitation task after major sections to refine based on user ==================== END: .bmad-core/tasks/document-project.md ==================== ==================== START: .bmad-core/tasks/facilitate-brainstorming-session.md ==================== + --- docOutputLocation: docs/brainstorming-session-results.md template: '.bmad-core/templates/brainstorming-output-tmpl.yaml' @@ -2701,10 +2706,11 @@ sections: content: | --- - *Session facilitated using the BMAD-METHOD brainstorming framework* + *Session facilitated using the BMAD-METHOD™ brainstorming framework* ==================== END: .bmad-core/templates/brainstorming-output-tmpl.yaml ==================== ==================== START: .bmad-core/templates/competitor-analysis-tmpl.yaml ==================== +# template: id: competitor-analysis-template-v2 name: Competitive Analysis Report @@ -3014,6 +3020,7 @@ sections: ==================== END: .bmad-core/templates/competitor-analysis-tmpl.yaml ==================== ==================== START: .bmad-core/templates/market-research-tmpl.yaml ==================== +# template: id: market-research-template-v2 name: Market Research Report @@ -3269,6 +3276,7 @@ sections: ==================== END: .bmad-core/templates/market-research-tmpl.yaml ==================== ==================== START: .bmad-core/templates/project-brief-tmpl.yaml ==================== +# template: id: project-brief-template-v2 name: Project Brief @@ -3493,6 +3501,7 @@ sections: ==================== END: .bmad-core/templates/project-brief-tmpl.yaml ==================== ==================== START: .bmad-core/data/brainstorming-techniques.md ==================== + # Brainstorming Techniques Data ## Creative Expansion @@ -3532,6 +3541,7 @@ sections: ==================== END: .bmad-core/data/brainstorming-techniques.md ==================== ==================== START: .bmad-core/tasks/brownfield-create-epic.md ==================== + # Create Brownfield Epic Task ## Purpose @@ -3695,6 +3705,7 @@ The epic creation is successful when: ==================== END: .bmad-core/tasks/brownfield-create-epic.md ==================== ==================== START: .bmad-core/tasks/brownfield-create-story.md ==================== + # Create Brownfield Story Task ## Purpose @@ -3845,6 +3856,7 @@ The story creation is successful when: ==================== END: .bmad-core/tasks/brownfield-create-story.md ==================== ==================== START: .bmad-core/tasks/correct-course.md ==================== + # Correct Course Task ## Purpose @@ -3918,6 +3930,7 @@ The story creation is successful when: ==================== END: .bmad-core/tasks/correct-course.md ==================== ==================== START: .bmad-core/tasks/execute-checklist.md ==================== + # 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. @@ -4007,6 +4020,7 @@ The LLM will: ==================== END: .bmad-core/tasks/execute-checklist.md ==================== ==================== START: .bmad-core/tasks/shard-doc.md ==================== + # Document Sharding Task ## Purpose @@ -4195,6 +4209,7 @@ Document sharded successfully: ==================== END: .bmad-core/tasks/shard-doc.md ==================== ==================== START: .bmad-core/templates/brownfield-prd-tmpl.yaml ==================== +# template: id: brownfield-prd-template-v2 name: Brownfield Enhancement PRD @@ -4478,6 +4493,7 @@ sections: ==================== END: .bmad-core/templates/brownfield-prd-tmpl.yaml ==================== ==================== START: .bmad-core/templates/prd-tmpl.yaml ==================== +# template: id: prd-template-v2 name: Product Requirements Document @@ -4683,6 +4699,7 @@ sections: ==================== END: .bmad-core/templates/prd-tmpl.yaml ==================== ==================== START: .bmad-core/checklists/change-checklist.md ==================== + # Change Navigation Checklist **Purpose:** To systematically guide the selected Agent and user through the analysis and planning required when a significant change (pivot, tech issue, missing requirement, failed story) is identified during the BMad workflow. @@ -4868,6 +4885,7 @@ Keep it action-oriented and forward-looking.]] ==================== END: .bmad-core/checklists/change-checklist.md ==================== ==================== START: .bmad-core/checklists/pm-checklist.md ==================== + # Product Manager (PM) Requirements Checklist This checklist serves as a comprehensive framework to ensure the Product Requirements Document (PRD) and Epic definitions are complete, well-structured, and appropriately scoped for MVP development. The PM should systematically work through each item during the product definition process. @@ -5241,12 +5259,14 @@ After presenting the report, ask if the user wants: ==================== END: .bmad-core/checklists/pm-checklist.md ==================== ==================== START: .bmad-core/data/technical-preferences.md ==================== + # User-Defined Preferred Patterns and Preferences None Listed ==================== END: .bmad-core/data/technical-preferences.md ==================== ==================== START: .bmad-core/templates/architecture-tmpl.yaml ==================== +# template: id: architecture-template-v2 name: Architecture Document @@ -5900,6 +5920,7 @@ sections: ==================== END: .bmad-core/templates/architecture-tmpl.yaml ==================== ==================== START: .bmad-core/templates/brownfield-architecture-tmpl.yaml ==================== +# template: id: brownfield-architecture-template-v2 name: Brownfield Enhancement Architecture @@ -6379,6 +6400,7 @@ sections: ==================== END: .bmad-core/templates/brownfield-architecture-tmpl.yaml ==================== ==================== START: .bmad-core/templates/front-end-architecture-tmpl.yaml ==================== +# template: id: frontend-architecture-template-v2 name: Frontend Architecture Document @@ -6600,6 +6622,7 @@ sections: ==================== END: .bmad-core/templates/front-end-architecture-tmpl.yaml ==================== ==================== START: .bmad-core/templates/fullstack-architecture-tmpl.yaml ==================== +# template: id: fullstack-architecture-template-v2 name: Fullstack Architecture Document @@ -7426,6 +7449,7 @@ sections: ==================== END: .bmad-core/templates/fullstack-architecture-tmpl.yaml ==================== ==================== START: .bmad-core/checklists/architect-checklist.md ==================== + # Architect Solution Validation Checklist This checklist serves as a comprehensive framework for the Architect to validate the technical design and architecture before development execution. The Architect should systematically work through each item, ensuring the architecture is robust, scalable, secure, and aligned with the product requirements. @@ -7867,6 +7891,7 @@ After presenting the report, ask the user if they would like detailed analysis o ==================== END: .bmad-core/checklists/architect-checklist.md ==================== ==================== START: .bmad-core/tasks/validate-next-story.md ==================== + # Validate Next Story Task ## Purpose @@ -8004,6 +8029,7 @@ Provide a structured validation report including: ==================== END: .bmad-core/tasks/validate-next-story.md ==================== ==================== START: .bmad-core/templates/story-tmpl.yaml ==================== +# template: id: story-template-v2 name: Story Document @@ -8144,6 +8170,7 @@ sections: ==================== END: .bmad-core/templates/story-tmpl.yaml ==================== ==================== START: .bmad-core/checklists/po-master-checklist.md ==================== + # Product Owner (PO) Master Validation Checklist This checklist serves as a comprehensive framework for the Product Owner to validate project plans before development execution. It adapts intelligently based on project type (greenfield vs brownfield) and includes UI/UX considerations when applicable. @@ -8579,6 +8606,7 @@ After presenting the report, ask if the user wants: ==================== END: .bmad-core/checklists/po-master-checklist.md ==================== ==================== START: .bmad-core/workflows/greenfield-service.yaml ==================== +# workflow: id: greenfield-service name: Greenfield Service/API Development @@ -8788,6 +8816,7 @@ workflow: ==================== END: .bmad-core/workflows/greenfield-service.yaml ==================== ==================== START: .bmad-core/workflows/brownfield-service.yaml ==================== +# workflow: id: brownfield-service name: Brownfield Service/API Enhancement diff --git a/docs/versioning-and-releases.md b/docs/versioning-and-releases.md index 6be45746..c8e19afc 100644 --- a/docs/versioning-and-releases.md +++ b/docs/versioning-and-releases.md @@ -144,7 +144,7 @@ npm view bmad-method versions --json If your local files don't match the published version after a release: ```bash -./sync-version.sh # Automatically syncs local files with npm latest +./tools/sync-version.sh # Automatically syncs local files with npm latest ``` ### If Release Fails diff --git a/expansion-packs/bmad-2d-phaser-game-dev/agent-teams/phaser-2d-nodejs-game-team.yaml b/expansion-packs/bmad-2d-phaser-game-dev/agent-teams/phaser-2d-nodejs-game-team.yaml index 6cbae16d..50801e05 100644 --- a/expansion-packs/bmad-2d-phaser-game-dev/agent-teams/phaser-2d-nodejs-game-team.yaml +++ b/expansion-packs/bmad-2d-phaser-game-dev/agent-teams/phaser-2d-nodejs-game-team.yaml @@ -1,3 +1,4 @@ +# bundle: name: Phaser 2D NodeJS Game Team icon: 🎮 diff --git a/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.md b/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.md index c9e4cfe4..ba806a75 100644 --- a/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.md +++ b/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.md @@ -1,3 +1,5 @@ + + # game-designer ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below. diff --git a/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.md b/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.md index 9e23646a..a22825cb 100644 --- a/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.md +++ b/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.md @@ -1,3 +1,5 @@ + + # game-developer ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below. diff --git a/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.md b/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.md index a522d44f..7446b4b1 100644 --- a/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.md +++ b/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.md @@ -1,3 +1,5 @@ + + # game-sm ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below. diff --git a/expansion-packs/bmad-2d-phaser-game-dev/checklists/game-design-checklist.md b/expansion-packs/bmad-2d-phaser-game-dev/checklists/game-design-checklist.md index ba6ed063..2e46c719 100644 --- a/expansion-packs/bmad-2d-phaser-game-dev/checklists/game-design-checklist.md +++ b/expansion-packs/bmad-2d-phaser-game-dev/checklists/game-design-checklist.md @@ -1,3 +1,5 @@ + + # Game Design Document Quality Checklist ## Document Completeness diff --git a/expansion-packs/bmad-2d-phaser-game-dev/checklists/game-story-dod-checklist.md b/expansion-packs/bmad-2d-phaser-game-dev/checklists/game-story-dod-checklist.md index b7fb9405..a9c18863 100644 --- a/expansion-packs/bmad-2d-phaser-game-dev/checklists/game-story-dod-checklist.md +++ b/expansion-packs/bmad-2d-phaser-game-dev/checklists/game-story-dod-checklist.md @@ -1,3 +1,5 @@ + + # Game Development Story Definition of Done Checklist ## Story Completeness diff --git a/expansion-packs/bmad-2d-phaser-game-dev/config.yaml b/expansion-packs/bmad-2d-phaser-game-dev/config.yaml index 269ca1f6..7065499f 100644 --- a/expansion-packs/bmad-2d-phaser-game-dev/config.yaml +++ b/expansion-packs/bmad-2d-phaser-game-dev/config.yaml @@ -1,3 +1,4 @@ +# name: bmad-2d-phaser-game-dev version: 1.13.0 short-title: Phaser 3 2D Game Dev Pack diff --git a/expansion-packs/bmad-2d-phaser-game-dev/data/bmad-kb.md b/expansion-packs/bmad-2d-phaser-game-dev/data/bmad-kb.md index 07ee55d7..c1710e7f 100644 --- a/expansion-packs/bmad-2d-phaser-game-dev/data/bmad-kb.md +++ b/expansion-packs/bmad-2d-phaser-game-dev/data/bmad-kb.md @@ -1,3 +1,5 @@ + + # Game Development BMad Knowledge Base ## Overview diff --git a/expansion-packs/bmad-2d-phaser-game-dev/data/development-guidelines.md b/expansion-packs/bmad-2d-phaser-game-dev/data/development-guidelines.md index 1d66719a..71478fa4 100644 --- a/expansion-packs/bmad-2d-phaser-game-dev/data/development-guidelines.md +++ b/expansion-packs/bmad-2d-phaser-game-dev/data/development-guidelines.md @@ -1,3 +1,5 @@ + + # Game Development Guidelines ## Overview diff --git a/expansion-packs/bmad-2d-phaser-game-dev/tasks/advanced-elicitation.md b/expansion-packs/bmad-2d-phaser-game-dev/tasks/advanced-elicitation.md index 34a7e74b..60e76217 100644 --- a/expansion-packs/bmad-2d-phaser-game-dev/tasks/advanced-elicitation.md +++ b/expansion-packs/bmad-2d-phaser-game-dev/tasks/advanced-elicitation.md @@ -1,3 +1,5 @@ + + # Advanced Game Design Elicitation Task ## Purpose diff --git a/expansion-packs/bmad-2d-phaser-game-dev/tasks/create-game-story.md b/expansion-packs/bmad-2d-phaser-game-dev/tasks/create-game-story.md index 43ab09b7..b842fe45 100644 --- a/expansion-packs/bmad-2d-phaser-game-dev/tasks/create-game-story.md +++ b/expansion-packs/bmad-2d-phaser-game-dev/tasks/create-game-story.md @@ -1,3 +1,5 @@ + + # Create Game Development Story Task ## Purpose diff --git a/expansion-packs/bmad-2d-phaser-game-dev/tasks/game-design-brainstorming.md b/expansion-packs/bmad-2d-phaser-game-dev/tasks/game-design-brainstorming.md index 2bb5e06f..d4bd692e 100644 --- a/expansion-packs/bmad-2d-phaser-game-dev/tasks/game-design-brainstorming.md +++ b/expansion-packs/bmad-2d-phaser-game-dev/tasks/game-design-brainstorming.md @@ -1,3 +1,5 @@ + + # Game Design Brainstorming Techniques Task This task provides a comprehensive toolkit of creative brainstorming techniques specifically designed for game design ideation and innovative thinking. The game designer can use these techniques to facilitate productive brainstorming sessions focused on game mechanics, player experience, and creative concepts. diff --git a/expansion-packs/bmad-2d-phaser-game-dev/templates/game-architecture-tmpl.yaml b/expansion-packs/bmad-2d-phaser-game-dev/templates/game-architecture-tmpl.yaml index 4accd3c3..e4526723 100644 --- a/expansion-packs/bmad-2d-phaser-game-dev/templates/game-architecture-tmpl.yaml +++ b/expansion-packs/bmad-2d-phaser-game-dev/templates/game-architecture-tmpl.yaml @@ -1,3 +1,4 @@ +# template: id: game-architecture-template-v2 name: Game Architecture Document diff --git a/expansion-packs/bmad-2d-phaser-game-dev/templates/game-brief-tmpl.yaml b/expansion-packs/bmad-2d-phaser-game-dev/templates/game-brief-tmpl.yaml index 118fbb0e..ada5283e 100644 --- a/expansion-packs/bmad-2d-phaser-game-dev/templates/game-brief-tmpl.yaml +++ b/expansion-packs/bmad-2d-phaser-game-dev/templates/game-brief-tmpl.yaml @@ -1,3 +1,4 @@ +# template: id: game-brief-template-v2 name: Game Brief diff --git a/expansion-packs/bmad-2d-phaser-game-dev/templates/game-design-doc-tmpl.yaml b/expansion-packs/bmad-2d-phaser-game-dev/templates/game-design-doc-tmpl.yaml index a1262ef8..25fed069 100644 --- a/expansion-packs/bmad-2d-phaser-game-dev/templates/game-design-doc-tmpl.yaml +++ b/expansion-packs/bmad-2d-phaser-game-dev/templates/game-design-doc-tmpl.yaml @@ -1,3 +1,4 @@ +# template: id: game-design-doc-template-v2 name: Game Design Document (GDD) diff --git a/expansion-packs/bmad-2d-phaser-game-dev/templates/game-story-tmpl.yaml b/expansion-packs/bmad-2d-phaser-game-dev/templates/game-story-tmpl.yaml index 63209a51..a8a2b170 100644 --- a/expansion-packs/bmad-2d-phaser-game-dev/templates/game-story-tmpl.yaml +++ b/expansion-packs/bmad-2d-phaser-game-dev/templates/game-story-tmpl.yaml @@ -1,3 +1,4 @@ +# template: id: game-story-template-v2 name: Game Development Story diff --git a/expansion-packs/bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.yaml b/expansion-packs/bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.yaml index 7e5f43fc..af2c2879 100644 --- a/expansion-packs/bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.yaml +++ b/expansion-packs/bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.yaml @@ -1,3 +1,4 @@ +# template: id: level-design-doc-template-v2 name: Level Design Document diff --git a/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-dev-greenfield.yaml b/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-dev-greenfield.yaml index 9c9e4415..6f0b175d 100644 --- a/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-dev-greenfield.yaml +++ b/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-dev-greenfield.yaml @@ -1,3 +1,4 @@ +# workflow: id: game-dev-greenfield name: Game Development - Greenfield Project diff --git a/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-prototype.yaml b/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-prototype.yaml index 4b5b48f1..abe64741 100644 --- a/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-prototype.yaml +++ b/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-prototype.yaml @@ -1,3 +1,4 @@ +# workflow: id: game-prototype name: Game Prototype Development diff --git a/expansion-packs/bmad-2d-unity-game-dev/agent-teams/unity-2d-game-team.yaml b/expansion-packs/bmad-2d-unity-game-dev/agent-teams/unity-2d-game-team.yaml index 22c2fa06..1eb07b38 100644 --- a/expansion-packs/bmad-2d-unity-game-dev/agent-teams/unity-2d-game-team.yaml +++ b/expansion-packs/bmad-2d-unity-game-dev/agent-teams/unity-2d-game-team.yaml @@ -1,3 +1,4 @@ +# bundle: name: Unity 2D Game Team icon: 🎮 diff --git a/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.md b/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.md index 53506365..254e0315 100644 --- a/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.md +++ b/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.md @@ -1,3 +1,5 @@ + + # game-architect ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below. diff --git a/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.md b/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.md index 78bf92a9..0169c984 100644 --- a/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.md +++ b/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.md @@ -1,3 +1,5 @@ + + # game-designer ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below. diff --git a/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.md b/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.md index fb28eab3..a43d41cd 100644 --- a/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.md +++ b/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.md @@ -1,3 +1,5 @@ + + # game-developer ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below. diff --git a/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.md b/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.md index f63f626b..498bdc28 100644 --- a/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.md +++ b/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.md @@ -1,3 +1,5 @@ + + # game-sm ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below. diff --git a/expansion-packs/bmad-2d-unity-game-dev/checklists/game-architect-checklist.md b/expansion-packs/bmad-2d-unity-game-dev/checklists/game-architect-checklist.md index 05fd3cac..f2bde583 100644 --- a/expansion-packs/bmad-2d-unity-game-dev/checklists/game-architect-checklist.md +++ b/expansion-packs/bmad-2d-unity-game-dev/checklists/game-architect-checklist.md @@ -1,3 +1,5 @@ + + # Game Architect Solution Validation Checklist This checklist serves as a comprehensive framework for the Game Architect to validate the technical design and architecture before game development execution. The Game Architect should systematically work through each item, ensuring the game architecture is robust, scalable, performant, and aligned with the Game Design Document requirements. diff --git a/expansion-packs/bmad-2d-unity-game-dev/checklists/game-change-checklist.md b/expansion-packs/bmad-2d-unity-game-dev/checklists/game-change-checklist.md index 708f6fc0..6b00765b 100644 --- a/expansion-packs/bmad-2d-unity-game-dev/checklists/game-change-checklist.md +++ b/expansion-packs/bmad-2d-unity-game-dev/checklists/game-change-checklist.md @@ -1,3 +1,5 @@ + + # Game Development Change Navigation Checklist **Purpose:** To systematically guide the Game SM agent and user through analysis and planning when a significant change (performance issue, platform constraint, technical blocker, gameplay feedback) is identified during Unity game development. diff --git a/expansion-packs/bmad-2d-unity-game-dev/checklists/game-design-checklist.md b/expansion-packs/bmad-2d-unity-game-dev/checklists/game-design-checklist.md index c56a9e35..17eff60d 100644 --- a/expansion-packs/bmad-2d-unity-game-dev/checklists/game-design-checklist.md +++ b/expansion-packs/bmad-2d-unity-game-dev/checklists/game-design-checklist.md @@ -1,3 +1,5 @@ + + # Game Design Document Quality Checklist ## Document Completeness diff --git a/expansion-packs/bmad-2d-unity-game-dev/checklists/game-story-dod-checklist.md b/expansion-packs/bmad-2d-unity-game-dev/checklists/game-story-dod-checklist.md index 328b2453..89f5c3ab 100644 --- a/expansion-packs/bmad-2d-unity-game-dev/checklists/game-story-dod-checklist.md +++ b/expansion-packs/bmad-2d-unity-game-dev/checklists/game-story-dod-checklist.md @@ -1,3 +1,5 @@ + + # Game Development Story Definition of Done (DoD) Checklist ## Instructions for Developer Agent diff --git a/expansion-packs/bmad-2d-unity-game-dev/config.yaml b/expansion-packs/bmad-2d-unity-game-dev/config.yaml index de44e7e3..2b7d4bc9 100644 --- a/expansion-packs/bmad-2d-unity-game-dev/config.yaml +++ b/expansion-packs/bmad-2d-unity-game-dev/config.yaml @@ -1,3 +1,4 @@ +# name: bmad-2d-unity-game-dev version: 1.6.0 short-title: Unity C# 2D Game Dev Pack diff --git a/expansion-packs/bmad-2d-unity-game-dev/data/bmad-kb.md b/expansion-packs/bmad-2d-unity-game-dev/data/bmad-kb.md index 97579dad..ddacae99 100644 --- a/expansion-packs/bmad-2d-unity-game-dev/data/bmad-kb.md +++ b/expansion-packs/bmad-2d-unity-game-dev/data/bmad-kb.md @@ -1,3 +1,5 @@ + + # BMad Knowledge Base - 2D Unity Game Development ## Overview diff --git a/expansion-packs/bmad-2d-unity-game-dev/data/development-guidelines.md b/expansion-packs/bmad-2d-unity-game-dev/data/development-guidelines.md index e43fef8d..a9d0edef 100644 --- a/expansion-packs/bmad-2d-unity-game-dev/data/development-guidelines.md +++ b/expansion-packs/bmad-2d-unity-game-dev/data/development-guidelines.md @@ -1,3 +1,5 @@ + + # Game Development Guidelines (Unity & C#) ## Overview diff --git a/expansion-packs/bmad-2d-unity-game-dev/tasks/advanced-elicitation.md b/expansion-packs/bmad-2d-unity-game-dev/tasks/advanced-elicitation.md index 88a32735..f4247e15 100644 --- a/expansion-packs/bmad-2d-unity-game-dev/tasks/advanced-elicitation.md +++ b/expansion-packs/bmad-2d-unity-game-dev/tasks/advanced-elicitation.md @@ -1,3 +1,5 @@ + + # Advanced Game Design Elicitation Task ## Purpose diff --git a/expansion-packs/bmad-2d-unity-game-dev/tasks/correct-course-game.md b/expansion-packs/bmad-2d-unity-game-dev/tasks/correct-course-game.md index 4b6ce36f..dfa25015 100644 --- a/expansion-packs/bmad-2d-unity-game-dev/tasks/correct-course-game.md +++ b/expansion-packs/bmad-2d-unity-game-dev/tasks/correct-course-game.md @@ -1,3 +1,5 @@ + + # Correct Course Task - Game Development ## Purpose diff --git a/expansion-packs/bmad-2d-unity-game-dev/tasks/create-game-story.md b/expansion-packs/bmad-2d-unity-game-dev/tasks/create-game-story.md index dfc03acd..02a8075b 100644 --- a/expansion-packs/bmad-2d-unity-game-dev/tasks/create-game-story.md +++ b/expansion-packs/bmad-2d-unity-game-dev/tasks/create-game-story.md @@ -1,3 +1,5 @@ + + # Create Game Story Task ## Purpose diff --git a/expansion-packs/bmad-2d-unity-game-dev/tasks/game-design-brainstorming.md b/expansion-packs/bmad-2d-unity-game-dev/tasks/game-design-brainstorming.md index 2bb5e06f..d4bd692e 100644 --- a/expansion-packs/bmad-2d-unity-game-dev/tasks/game-design-brainstorming.md +++ b/expansion-packs/bmad-2d-unity-game-dev/tasks/game-design-brainstorming.md @@ -1,3 +1,5 @@ + + # Game Design Brainstorming Techniques Task This task provides a comprehensive toolkit of creative brainstorming techniques specifically designed for game design ideation and innovative thinking. The game designer can use these techniques to facilitate productive brainstorming sessions focused on game mechanics, player experience, and creative concepts. diff --git a/expansion-packs/bmad-2d-unity-game-dev/tasks/validate-game-story.md b/expansion-packs/bmad-2d-unity-game-dev/tasks/validate-game-story.md index 4cefeaca..aeef2ccd 100644 --- a/expansion-packs/bmad-2d-unity-game-dev/tasks/validate-game-story.md +++ b/expansion-packs/bmad-2d-unity-game-dev/tasks/validate-game-story.md @@ -1,3 +1,5 @@ + + # Validate Game Story Task ## Purpose diff --git a/expansion-packs/bmad-2d-unity-game-dev/templates/game-architecture-tmpl.yaml b/expansion-packs/bmad-2d-unity-game-dev/templates/game-architecture-tmpl.yaml index 36e78012..1bc054ad 100644 --- a/expansion-packs/bmad-2d-unity-game-dev/templates/game-architecture-tmpl.yaml +++ b/expansion-packs/bmad-2d-unity-game-dev/templates/game-architecture-tmpl.yaml @@ -1,3 +1,4 @@ +# template: id: game-architecture-template-v3 name: Game Architecture Document diff --git a/expansion-packs/bmad-2d-unity-game-dev/templates/game-brief-tmpl.yaml b/expansion-packs/bmad-2d-unity-game-dev/templates/game-brief-tmpl.yaml index 1769ef29..e97b08c8 100644 --- a/expansion-packs/bmad-2d-unity-game-dev/templates/game-brief-tmpl.yaml +++ b/expansion-packs/bmad-2d-unity-game-dev/templates/game-brief-tmpl.yaml @@ -1,3 +1,4 @@ +# template: id: game-brief-template-v3 name: Game Brief diff --git a/expansion-packs/bmad-2d-unity-game-dev/templates/game-design-doc-tmpl.yaml b/expansion-packs/bmad-2d-unity-game-dev/templates/game-design-doc-tmpl.yaml index 60e7819b..7dcdf86a 100644 --- a/expansion-packs/bmad-2d-unity-game-dev/templates/game-design-doc-tmpl.yaml +++ b/expansion-packs/bmad-2d-unity-game-dev/templates/game-design-doc-tmpl.yaml @@ -1,3 +1,4 @@ +# template: id: game-design-doc-template-v3 name: Game Design Document (GDD) diff --git a/expansion-packs/bmad-2d-unity-game-dev/templates/game-story-tmpl.yaml b/expansion-packs/bmad-2d-unity-game-dev/templates/game-story-tmpl.yaml index c2020b06..81f5c3cf 100644 --- a/expansion-packs/bmad-2d-unity-game-dev/templates/game-story-tmpl.yaml +++ b/expansion-packs/bmad-2d-unity-game-dev/templates/game-story-tmpl.yaml @@ -1,3 +1,4 @@ +# template: id: game-story-template-v3 name: Game Development Story diff --git a/expansion-packs/bmad-2d-unity-game-dev/templates/level-design-doc-tmpl.yaml b/expansion-packs/bmad-2d-unity-game-dev/templates/level-design-doc-tmpl.yaml index 2cba1051..5ec5f2e8 100644 --- a/expansion-packs/bmad-2d-unity-game-dev/templates/level-design-doc-tmpl.yaml +++ b/expansion-packs/bmad-2d-unity-game-dev/templates/level-design-doc-tmpl.yaml @@ -1,3 +1,4 @@ +# template: id: level-design-doc-template-v2 name: Level Design Document diff --git a/expansion-packs/bmad-2d-unity-game-dev/workflows/game-dev-greenfield.yaml b/expansion-packs/bmad-2d-unity-game-dev/workflows/game-dev-greenfield.yaml index 946d516a..9f73d461 100644 --- a/expansion-packs/bmad-2d-unity-game-dev/workflows/game-dev-greenfield.yaml +++ b/expansion-packs/bmad-2d-unity-game-dev/workflows/game-dev-greenfield.yaml @@ -1,3 +1,4 @@ +# workflow: id: unity-game-dev-greenfield name: Game Development - Greenfield Project (Unity) diff --git a/expansion-packs/bmad-2d-unity-game-dev/workflows/game-prototype.yaml b/expansion-packs/bmad-2d-unity-game-dev/workflows/game-prototype.yaml index e91b160f..a5a44046 100644 --- a/expansion-packs/bmad-2d-unity-game-dev/workflows/game-prototype.yaml +++ b/expansion-packs/bmad-2d-unity-game-dev/workflows/game-prototype.yaml @@ -1,3 +1,4 @@ +# workflow: id: unity-game-prototype name: Game Prototype Development (Unity) diff --git a/expansion-packs/bmad-creative-writing/README.md b/expansion-packs/bmad-creative-writing/README.md index fb138b26..7e421791 100644 --- a/expansion-packs/bmad-creative-writing/README.md +++ b/expansion-packs/bmad-creative-writing/README.md @@ -7,6 +7,7 @@ Transform your AI into a complete creative writing studio with specialized agent The Creative Writing Expansion Pack extends BMad-Method with a comprehensive suite of writing-focused agents, workflows, and tools. Whether you're crafting novels, screenplays, short stories, or interactive narratives, this pack provides structured AI assistance throughout your creative process. ### Key Features + - 🤖 **10 Specialized Writing Agents** - From plot architecture to dialogue refinement - 📖 **8 Complete Workflows** - Novel writing, screenplay development, series planning, and more - ✅ **27 Quality Checklists** - Genre-specific and technical quality assurance @@ -16,6 +17,7 @@ The Creative Writing Expansion Pack extends BMad-Method with a comprehensive sui ## ✍️ Included Agents ### Core Writing Team + 1. **Plot Architect** - Story structure, pacing, and narrative arc design 2. **Character Psychologist** - Deep character development and psychology 3. **World Builder** - Setting, universe, and environment creation @@ -23,6 +25,7 @@ The Creative Writing Expansion Pack extends BMad-Method with a comprehensive sui 5. **Beta Reader** - First reader perspective and feedback simulation ### Specialist Agents + 6. **Dialog Specialist** - Natural dialogue, voice, and conversation crafting 7. **Narrative Designer** - Interactive storytelling and branching narratives 8. **Genre Specialist** - Genre conventions, tropes, and market awareness @@ -32,12 +35,14 @@ The Creative Writing Expansion Pack extends BMad-Method with a comprehensive sui ## 🚀 Installation ### Via BMad Installer (After PR Acceptance) + ```bash npx bmad-method install # Select "Creative Writing Studio" from the expansion packs list ``` ### Manual Installation + 1. Clone or download this expansion pack 2. Copy to your BMad Method installation: ```bash @@ -48,6 +53,7 @@ npx bmad-method install ## 💡 Usage ### Quick Start + ```bash # Load the complete creative writing team bmad load team creative-writing @@ -58,6 +64,7 @@ bmad activate character-psychologist ``` ### Available Workflows + - **novel-writing** - Complete novel development from premise to manuscript - **screenplay-development** - Three-act screenplay with industry formatting - **short-story-creation** - Focused narrative for magazines/anthologies @@ -66,6 +73,7 @@ bmad activate character-psychologist ## 📋 Key Components ### Templates + - `character-profile-tmpl.yaml` - Comprehensive character development - `story-outline-tmpl.yaml` - Three-act structure planning - `world-guide-tmpl.yaml` - World-building documentation @@ -76,6 +84,7 @@ bmad activate character-psychologist - `cover-design-brief-tmpl.yaml` - Cover concept specifications ### Featured Checklists + - Genre-specific: Fantasy, Sci-Fi, Romance, Mystery, Thriller, Horror - Technical: Plot structure, character consistency, timeline continuity - Publishing: KDP-ready, eBook formatting, marketing copy @@ -84,24 +93,28 @@ bmad activate character-psychologist ## 🎯 Use Cases ### Novel Writing + - Premise development and market positioning - Three-act structure with subplot integration - Character arc tracking across chapters - Beta feedback simulation before human readers ### Screenplay Development + - Industry-standard formatting - Visual storytelling emphasis - Dialogue-driven narrative - Scene/location optimization ### Series Planning + - Multi-book continuity management - Character evolution across volumes - World expansion strategies - Reader retention hooks ### Publishing Preparation + - KDP package assembly - Cover design briefs - Marketing copy generation @@ -110,6 +123,7 @@ bmad activate character-psychologist ## 🤝 Contributing We welcome contributions! Please: + 1. Fork the repository 2. Create a feature branch 3. Follow BMad Method conventions @@ -129,4 +143,4 @@ Special thanks to Brian (BMad) for creating the BMad Method framework. **Version:** 1.0.0 **Compatible with:** BMad Method v1.0+ -**Last Updated:** 2024 \ No newline at end of file +**Last Updated:** 2024 diff --git a/expansion-packs/bmad-creative-writing/agent-teams/agent-team.yaml b/expansion-packs/bmad-creative-writing/agent-teams/agent-team.yaml index caec6dc1..393d1bd6 100644 --- a/expansion-packs/bmad-creative-writing/agent-teams/agent-team.yaml +++ b/expansion-packs/bmad-creative-writing/agent-teams/agent-team.yaml @@ -1,3 +1,4 @@ +# bundle: name: Creative Writing Team icon: ✍️ @@ -11,7 +12,7 @@ agents: - dialog-specialist - narrative-designer - genre-specialist - - book-critic # newly added professional critic agent + - book-critic # newly added professional critic agent workflows: - novel-writing - screenplay-development diff --git a/expansion-packs/bmad-creative-writing/agents/beta-reader.md b/expansion-packs/bmad-creative-writing/agents/beta-reader.md index 220223ae..7369a159 100644 --- a/expansion-packs/bmad-creative-writing/agents/beta-reader.md +++ b/expansion-packs/bmad-creative-writing/agents/beta-reader.md @@ -1,3 +1,5 @@ + + # beta-reader ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below. @@ -47,16 +49,16 @@ core_principles: - Promises made must be kept - Numbered Options Protocol - Always use numbered lists for user selections commands: - - "*help - Show numbered list of available commands for selection" - - "*first-read - Simulate first-time reader experience" - - "*plot-holes - Identify logical inconsistencies" - - "*confusion-points - Flag unclear sections" - - "*engagement-curve - Map reader engagement" - - "*promise-audit - Check setup/payoff balance" - - "*genre-expectations - Verify genre satisfaction" - - "*emotional-impact - Assess emotional resonance" - - "*yolo - Toggle Yolo Mode" - - "*exit - Say goodbye as the Beta Reader, and then abandon inhabiting this persona" + - '*help - Show numbered list of available commands for selection' + - '*first-read - Simulate first-time reader experience' + - '*plot-holes - Identify logical inconsistencies' + - '*confusion-points - Flag unclear sections' + - '*engagement-curve - Map reader engagement' + - '*promise-audit - Check setup/payoff balance' + - '*genre-expectations - Verify genre satisfaction' + - '*emotional-impact - Assess emotional resonance' + - '*yolo - Toggle Yolo Mode' + - '*exit - Say goodbye as the Beta Reader, and then abandon inhabiting this persona' dependencies: tasks: - create-doc.md @@ -79,6 +81,7 @@ dependencies: You are the Beta Reader, the story's first audience. You experience the narrative as readers will, catching issues that authors are too close to see. Monitor: + - **Confusion triggers**: unclear motivations, missing context - **Engagement valleys**: where attention wanders - **Logic breaks**: plot holes and inconsistencies @@ -88,4 +91,4 @@ Monitor: Read with fresh eyes and an open heart. -Remember to present all options as numbered lists for easy selection. \ No newline at end of file +Remember to present all options as numbered lists for easy selection. diff --git a/expansion-packs/bmad-creative-writing/agents/book-critic.md b/expansion-packs/bmad-creative-writing/agents/book-critic.md index 0f1e2d91..4a1bfcfa 100644 --- a/expansion-packs/bmad-creative-writing/agents/book-critic.md +++ b/expansion-packs/bmad-creative-writing/agents/book-critic.md @@ -1,5 +1,9 @@ + + # Book Critic Agent Definition + # ------------------------------------------------------- + ```yaml agent: name: Evelyn Clarke @@ -30,6 +34,7 @@ commands: - exit: Say goodbye as the Book Critic and abandon persona dependencies: tasks: - - critical-review # ensure this task exists; otherwise agent handles logic inline + - critical-review # ensure this task exists; otherwise agent handles logic inline checklists: - - genre-tropes-checklist # optional, enhances genre comparison + - genre-tropes-checklist # optional, enhances genre comparison +``` diff --git a/expansion-packs/bmad-creative-writing/agents/character-psychologist.md b/expansion-packs/bmad-creative-writing/agents/character-psychologist.md index 260fe7bf..cfe0753d 100644 --- a/expansion-packs/bmad-creative-writing/agents/character-psychologist.md +++ b/expansion-packs/bmad-creative-writing/agents/character-psychologist.md @@ -1,3 +1,5 @@ + + # character-psychologist ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below. @@ -47,16 +49,16 @@ core_principles: - Growth requires meaningful change - Numbered Options Protocol - Always use numbered lists for user selections commands: - - "*help - Show numbered list of available commands for selection" - - "*create-profile - Run task create-doc.md with template character-profile-tmpl.yaml" - - "*analyze-motivation - Deep dive into character motivations" - - "*dialog-workshop - Run task workshop-dialog.md" - - "*relationship-map - Map character relationships" - - "*backstory-builder - Develop character history" - - "*arc-design - Design character transformation arc" - - "*voice-audit - Ensure dialog consistency" - - "*yolo - Toggle Yolo Mode" - - "*exit - Say goodbye as the Character Psychologist, and then abandon inhabiting this persona" + - '*help - Show numbered list of available commands for selection' + - '*create-profile - Run task create-doc.md with template character-profile-tmpl.yaml' + - '*analyze-motivation - Deep dive into character motivations' + - '*dialog-workshop - Run task workshop-dialog.md' + - '*relationship-map - Map character relationships' + - '*backstory-builder - Develop character history' + - '*arc-design - Design character transformation arc' + - '*voice-audit - Ensure dialog consistency' + - '*yolo - Toggle Yolo Mode' + - '*exit - Say goodbye as the Character Psychologist, and then abandon inhabiting this persona' dependencies: tasks: - create-doc.md @@ -78,6 +80,7 @@ dependencies: You are the Character Psychologist, an expert in human nature and its fictional representation. You understand that compelling characters emerge from the intersection of desire, fear, and circumstance. Focus on: + - **Core wounds** that shape worldview - **Defense mechanisms** that create behavior patterns - **Ghost/lie/want/need** framework @@ -87,4 +90,4 @@ Focus on: Every character should feel like the protagonist of their own story. -Remember to present all options as numbered lists for easy selection. \ No newline at end of file +Remember to present all options as numbered lists for easy selection. diff --git a/expansion-packs/bmad-creative-writing/agents/cover-designer.md b/expansion-packs/bmad-creative-writing/agents/cover-designer.md index eb65326e..878ca620 100644 --- a/expansion-packs/bmad-creative-writing/agents/cover-designer.md +++ b/expansion-packs/bmad-creative-writing/agents/cover-designer.md @@ -1,6 +1,11 @@ + + # ------------------------------------------------------------ + # agents/cover-designer.md + # ------------------------------------------------------------ + ```yaml agent: name: Iris Vega diff --git a/expansion-packs/bmad-creative-writing/agents/dialog-specialist.md b/expansion-packs/bmad-creative-writing/agents/dialog-specialist.md index 3390b04b..1df49a5f 100644 --- a/expansion-packs/bmad-creative-writing/agents/dialog-specialist.md +++ b/expansion-packs/bmad-creative-writing/agents/dialog-specialist.md @@ -1,3 +1,5 @@ + + # dialog-specialist ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below. @@ -47,16 +49,16 @@ core_principles: - Silence speaks volumes - Numbered Options Protocol - Always use numbered lists for user selections commands: - - "*help - Show numbered list of available commands for selection" - - "*refine-dialog - Polish conversation flow" - - "*voice-distinction - Differentiate character voices" - - "*subtext-layer - Add underlying meanings" - - "*tension-workshop - Build conversational conflict" - - "*dialect-guide - Create speech patterns" - - "*banter-builder - Develop character chemistry" - - "*monolog-craft - Shape powerful monologs" - - "*yolo - Toggle Yolo Mode" - - "*exit - Say goodbye as the Dialog Specialist, and then abandon inhabiting this persona" + - '*help - Show numbered list of available commands for selection' + - '*refine-dialog - Polish conversation flow' + - '*voice-distinction - Differentiate character voices' + - '*subtext-layer - Add underlying meanings' + - '*tension-workshop - Build conversational conflict' + - '*dialect-guide - Create speech patterns' + - '*banter-builder - Develop character chemistry' + - '*monolog-craft - Shape powerful monologs' + - '*yolo - Toggle Yolo Mode' + - '*exit - Say goodbye as the Dialog Specialist, and then abandon inhabiting this persona' dependencies: tasks: - create-doc.md @@ -77,6 +79,7 @@ dependencies: You are the Dialog Specialist, translator of human interaction into compelling fiction. You understand that great dialog does multiple jobs simultaneously. Master: + - **Naturalistic flow** without real speech's redundancy - **Character-specific** vocabulary and rhythm - **Subtext and implication** over direct statement @@ -86,4 +89,4 @@ Master: Every line should reveal character, advance plot, or both. -Remember to present all options as numbered lists for easy selection. \ No newline at end of file +Remember to present all options as numbered lists for easy selection. diff --git a/expansion-packs/bmad-creative-writing/agents/editor.md b/expansion-packs/bmad-creative-writing/agents/editor.md index bbb00d91..78068c95 100644 --- a/expansion-packs/bmad-creative-writing/agents/editor.md +++ b/expansion-packs/bmad-creative-writing/agents/editor.md @@ -1,3 +1,5 @@ + + # editor ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below. @@ -47,16 +49,16 @@ core_principles: - Every word must earn its place - Numbered Options Protocol - Always use numbered lists for user selections commands: - - "*help - Show numbered list of available commands for selection" - - "*line-edit - Perform detailed line editing" - - "*style-check - Ensure style consistency" - - "*flow-analysis - Analyze narrative flow" - - "*prose-rhythm - Evaluate sentence variety" - - "*grammar-sweep - Comprehensive grammar check" - - "*tighten-prose - Remove redundancy" - - "*fact-check - Verify internal consistency" - - "*yolo - Toggle Yolo Mode" - - "*exit - Say goodbye as the Editor, and then abandon inhabiting this persona" + - '*help - Show numbered list of available commands for selection' + - '*line-edit - Perform detailed line editing' + - '*style-check - Ensure style consistency' + - '*flow-analysis - Analyze narrative flow' + - '*prose-rhythm - Evaluate sentence variety' + - '*grammar-sweep - Comprehensive grammar check' + - '*tighten-prose - Remove redundancy' + - '*fact-check - Verify internal consistency' + - '*yolo - Toggle Yolo Mode' + - '*exit - Say goodbye as the Editor, and then abandon inhabiting this persona' dependencies: tasks: - create-doc.md @@ -78,6 +80,7 @@ dependencies: You are the Editor, defender of clear, powerful prose. You balance respect for authorial voice with the demands of readability and market expectations. Focus on: + - **Micro-level**: word choice, sentence structure, grammar - **Meso-level**: paragraph flow, scene transitions, pacing - **Macro-level**: chapter structure, act breaks, overall arc @@ -87,4 +90,4 @@ Focus on: Your goal: invisible excellence that lets the story shine. -Remember to present all options as numbered lists for easy selection. \ No newline at end of file +Remember to present all options as numbered lists for easy selection. diff --git a/expansion-packs/bmad-creative-writing/agents/genre-specialist.md b/expansion-packs/bmad-creative-writing/agents/genre-specialist.md index 71514077..05f58b56 100644 --- a/expansion-packs/bmad-creative-writing/agents/genre-specialist.md +++ b/expansion-packs/bmad-creative-writing/agents/genre-specialist.md @@ -1,3 +1,5 @@ + + # genre-specialist ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below. @@ -47,16 +49,16 @@ core_principles: - Cross-pollination enriches genres - Numbered Options Protocol - Always use numbered lists for user selections commands: - - "*help - Show numbered list of available commands for selection" - - "*genre-audit - Check genre compliance" - - "*trope-analysis - Identify and evaluate tropes" - - "*expectation-map - Map reader expectations" - - "*innovation-spots - Find fresh angle opportunities" - - "*crossover-potential - Identify genre-blending options" - - "*comp-titles - Suggest comparable titles" - - "*market-position - Analyze market placement" - - "*yolo - Toggle Yolo Mode" - - "*exit - Say goodbye as the Genre Specialist, and then abandon inhabiting this persona" + - '*help - Show numbered list of available commands for selection' + - '*genre-audit - Check genre compliance' + - '*trope-analysis - Identify and evaluate tropes' + - '*expectation-map - Map reader expectations' + - '*innovation-spots - Find fresh angle opportunities' + - '*crossover-potential - Identify genre-blending options' + - '*comp-titles - Suggest comparable titles' + - '*market-position - Analyze market placement' + - '*yolo - Toggle Yolo Mode' + - '*exit - Say goodbye as the Genre Specialist, and then abandon inhabiting this persona' dependencies: tasks: - create-doc.md @@ -80,8 +82,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 @@ -89,4 +92,4 @@ Navigate: Honor the genre while bringing something new. -Remember to present all options as numbered lists for easy selection. \ No newline at end of file +Remember to present all options as numbered lists for easy selection. diff --git a/expansion-packs/bmad-creative-writing/agents/narrative-designer.md b/expansion-packs/bmad-creative-writing/agents/narrative-designer.md index 7109c7b2..4e9badbc 100644 --- a/expansion-packs/bmad-creative-writing/agents/narrative-designer.md +++ b/expansion-packs/bmad-creative-writing/agents/narrative-designer.md @@ -1,3 +1,5 @@ + + # narrative-designer ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below. @@ -47,16 +49,16 @@ core_principles: - Narrative coherence across paths - Numbered Options Protocol - Always use numbered lists for user selections commands: - - "*help - Show numbered list of available commands for selection" - - "*design-branches - Create branching structure" - - "*choice-matrix - Map decision points" - - "*consequence-web - Design choice outcomes" - - "*agency-audit - Evaluate player agency" - - "*path-balance - Ensure branch quality" - - "*state-tracking - Design narrative variables" - - "*ending-design - Create satisfying conclusions" - - "*yolo - Toggle Yolo Mode" - - "*exit - Say goodbye as the Narrative Designer, and then abandon inhabiting this persona" + - '*help - Show numbered list of available commands for selection' + - '*design-branches - Create branching structure' + - '*choice-matrix - Map decision points' + - '*consequence-web - Design choice outcomes' + - '*agency-audit - Evaluate player agency' + - '*path-balance - Ensure branch quality' + - '*state-tracking - Design narrative variables' + - '*ending-design - Create satisfying conclusions' + - '*yolo - Toggle Yolo Mode' + - '*exit - Say goodbye as the Narrative Designer, and then abandon inhabiting this persona' dependencies: tasks: - create-doc.md @@ -78,6 +80,7 @@ dependencies: You are the Narrative Designer, architect of stories that respond to reader/player choices. You balance authorial vision with participant agency. Design for: + - **Meaningful choices** not false dilemmas - **Consequence chains** that feel logical - **Emotional investment** in decisions @@ -87,4 +90,4 @@ Design for: Every branch should feel like the "right" path. -Remember to present all options as numbered lists for easy selection. \ No newline at end of file +Remember to present all options as numbered lists for easy selection. diff --git a/expansion-packs/bmad-creative-writing/agents/plot-architect.md b/expansion-packs/bmad-creative-writing/agents/plot-architect.md index 4a94be27..57c6c307 100644 --- a/expansion-packs/bmad-creative-writing/agents/plot-architect.md +++ b/expansion-packs/bmad-creative-writing/agents/plot-architect.md @@ -1,3 +1,5 @@ + + # plot-architect ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below. @@ -47,16 +49,16 @@ core_principles: - Pacing controls reader engagement - Numbered Options Protocol - Always use numbered lists for user selections commands: - - "*help - Show numbered list of available commands for selection" - - "*create-outline - Run task create-doc.md with template story-outline-tmpl.yaml" - - "*analyze-structure - Run task analyze-story-structure.md" - - "*create-beat-sheet - Generate Save the Cat beat sheet" - - "*plot-diagnosis - Identify plot holes and pacing issues" - - "*create-synopsis - Generate story synopsis" - - "*arc-mapping - Map character and plot arcs" - - "*scene-audit - Evaluate scene effectiveness" - - "*yolo - Toggle Yolo Mode" - - "*exit - Say goodbye as the Plot Architect, and then abandon inhabiting this persona" + - '*help - Show numbered list of available commands for selection' + - '*create-outline - Run task create-doc.md with template story-outline-tmpl.yaml' + - '*analyze-structure - Run task analyze-story-structure.md' + - '*create-beat-sheet - Generate Save the Cat beat sheet' + - '*plot-diagnosis - Identify plot holes and pacing issues' + - '*create-synopsis - Generate story synopsis' + - '*arc-mapping - Map character and plot arcs' + - '*scene-audit - Evaluate scene effectiveness' + - '*yolo - Toggle Yolo Mode' + - '*exit - Say goodbye as the Plot Architect, and then abandon inhabiting this persona' dependencies: tasks: - create-doc.md @@ -80,6 +82,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 @@ -89,4 +92,4 @@ Think in terms of: Always consider pacing, tension curves, and reader engagement patterns. -Remember to present all options as numbered lists for easy selection. \ No newline at end of file +Remember to present all options as numbered lists for easy selection. diff --git a/expansion-packs/bmad-creative-writing/agents/world-builder.md b/expansion-packs/bmad-creative-writing/agents/world-builder.md index ac3dce8e..07bdf6c0 100644 --- a/expansion-packs/bmad-creative-writing/agents/world-builder.md +++ b/expansion-packs/bmad-creative-writing/agents/world-builder.md @@ -1,3 +1,5 @@ + + # world-builder ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below. @@ -47,16 +49,16 @@ core_principles: - Setting influences character and plot - Numbered Options Protocol - Always use numbered lists for user selections commands: - - "*help - Show numbered list of available commands for selection" - - "*create-world - Run task create-doc.md with template world-bible-tmpl.yaml" - - "*design-culture - Create cultural systems" - - "*map-geography - Design world geography" - - "*create-timeline - Build world history" - - "*magic-system - Design magic/technology rules" - - "*economy-builder - Create economic systems" - - "*language-notes - Develop naming conventions" - - "*yolo - Toggle Yolo Mode" - - "*exit - Say goodbye as the World Builder, and then abandon inhabiting this persona" + - '*help - Show numbered list of available commands for selection' + - '*create-world - Run task create-doc.md with template world-bible-tmpl.yaml' + - '*design-culture - Create cultural systems' + - '*map-geography - Design world geography' + - '*create-timeline - Build world history' + - '*magic-system - Design magic/technology rules' + - '*economy-builder - Create economic systems' + - '*language-notes - Develop naming conventions' + - '*yolo - Toggle Yolo Mode' + - '*exit - Say goodbye as the World Builder, and then abandon inhabiting this persona' dependencies: tasks: - create-doc.md @@ -79,6 +81,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 @@ -88,4 +91,4 @@ Consider: Every detail should serve the story while maintaining consistency. -Remember to present all options as numbered lists for easy selection. \ No newline at end of file +Remember to present all options as numbered lists for easy selection. diff --git a/expansion-packs/bmad-creative-writing/checklists/beta-feedback-closure-checklist.md b/expansion-packs/bmad-creative-writing/checklists/beta-feedback-closure-checklist.md index 9781ad8f..d3614d91 100644 --- a/expansion-packs/bmad-creative-writing/checklists/beta-feedback-closure-checklist.md +++ b/expansion-packs/bmad-creative-writing/checklists/beta-feedback-closure-checklist.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 6. Beta‑Feedback Closure Checklist + # ------------------------------------------------------------ + --- + checklist: - id: beta-feedback-closure-checklist - name: Beta‑Feedback Closure Checklist - description: Ensure all beta reader notes are addressed or consciously deferred. +id: beta-feedback-closure-checklist +name: Beta‑Feedback Closure Checklist +description: Ensure all beta reader notes are addressed or consciously deferred. items: - - "[ ] Each beta note categorized (Fix/Ignore/Consider)" - - "[ ] Fixes implemented in manuscript" - - "[ ] ‘Ignore’ notes documented with rationale" - - "[ ] ‘Consider’ notes scheduled for future pass" - - "[ ] Beta readers acknowledged in back matter" - - "[ ] Summary of changes logged in retro.md" -... + +- "[ ] Each beta note categorized (Fix/Ignore/Consider)" +- "[ ] Fixes implemented in manuscript" +- "[ ] ‘Ignore’ notes documented with rationale" +- "[ ] ‘Consider’ notes scheduled for future pass" +- "[ ] Beta readers acknowledged in back matter" +- "[ ] Summary of changes logged in retro.md" + ... diff --git a/expansion-packs/bmad-creative-writing/checklists/character-consistency-checklist.md b/expansion-packs/bmad-creative-writing/checklists/character-consistency-checklist.md index 3e00146e..c51f2310 100644 --- a/expansion-packs/bmad-creative-writing/checklists/character-consistency-checklist.md +++ b/expansion-packs/bmad-creative-writing/checklists/character-consistency-checklist.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 1. Character Consistency Checklist + # ------------------------------------------------------------ + --- + checklist: - id: character-consistency-checklist - name: Character Consistency Checklist - description: Verify character details and voice remain consistent throughout the manuscript. +id: character-consistency-checklist +name: Character Consistency Checklist +description: Verify character details and voice remain consistent throughout the manuscript. items: - - "[ ] Names spelled consistently (incl. diacritics)" - - "[ ] Physical descriptors match across chapters" - - "[ ] Goals and motivations do not contradict earlier scenes" - - "[ ] Character voice (speech patterns, vocabulary) is uniform" - - "[ ] Relationships and histories align with timeline" - - "[ ] Internal conflict/arc progression is logical" -... + +- "[ ] Names spelled consistently (incl. diacritics)" +- "[ ] Physical descriptors match across chapters" +- "[ ] Goals and motivations do not contradict earlier scenes" +- "[ ] Character voice (speech patterns, vocabulary) is uniform" +- "[ ] Relationships and histories align with timeline" +- "[ ] Internal conflict/arc progression is logical" + ... diff --git a/expansion-packs/bmad-creative-writing/checklists/comedic-timing-checklist.md b/expansion-packs/bmad-creative-writing/checklists/comedic-timing-checklist.md index da76c696..b0d5e427 100644 --- a/expansion-packs/bmad-creative-writing/checklists/comedic-timing-checklist.md +++ b/expansion-packs/bmad-creative-writing/checklists/comedic-timing-checklist.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 23. Comedic Timing & Humor Checklist + # ------------------------------------------------------------ + --- + checklist: - id: comedic-timing-checklist - name: Comedic Timing & Humor Checklist - description: Ensure jokes land and humorous beats serve character/plot. +id: comedic-timing-checklist +name: Comedic Timing & Humor Checklist +description: Ensure jokes land and humorous beats serve character/plot. items: - - "[ ] Setup, beat, punchline structure clear" - - "[ ] Humor aligns with character voice" - - "[ ] Cultural references understandable by target audience" - - "[ ] No conflicting tone in serious scenes" - - "[ ] Callback jokes spaced for maximum payoff" - - "[ ] Physical comedy described with vivid imagery" -... + +- "[ ] Setup, beat, punchline structure clear" +- "[ ] Humor aligns with character voice" +- "[ ] Cultural references understandable by target audience" +- "[ ] No conflicting tone in serious scenes" +- "[ ] Callback jokes spaced for maximum payoff" +- "[ ] Physical comedy described with vivid imagery" + ... diff --git a/expansion-packs/bmad-creative-writing/checklists/cyberpunk-aesthetic-checklist.md b/expansion-packs/bmad-creative-writing/checklists/cyberpunk-aesthetic-checklist.md index 8626b327..cda60997 100644 --- a/expansion-packs/bmad-creative-writing/checklists/cyberpunk-aesthetic-checklist.md +++ b/expansion-packs/bmad-creative-writing/checklists/cyberpunk-aesthetic-checklist.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 24. Cyberpunk Aesthetic Consistency Checklist + # ------------------------------------------------------------ + --- + checklist: - id: cyberpunk-aesthetic-checklist - name: Cyberpunk Aesthetic Consistency Checklist - description: Keep neon‑noir atmosphere, tech slang, and socio‑economic themes consistent. +id: cyberpunk-aesthetic-checklist +name: Cyberpunk Aesthetic Consistency Checklist +description: Keep neon‑noir atmosphere, tech slang, and socio‑economic themes consistent. items: - - "[ ] High‑tech / low‑life dichotomy evident" - - "[ ] Corporate oppression motif recurring" - - "[ ] Street slang and jargon consistent" - - "[ ] Urban setting features neon, rain, verticality" - - "[ ] Augmentation tech follows established rules" - - "[ ] Hacking sequences plausible within world rules" -... + +- "[ ] High‑tech / low‑life dichotomy evident" +- "[ ] Corporate oppression motif recurring" +- "[ ] Street slang and jargon consistent" +- "[ ] Urban setting features neon, rain, verticality" +- "[ ] Augmentation tech follows established rules" +- "[ ] Hacking sequences plausible within world rules" + ... diff --git a/expansion-packs/bmad-creative-writing/checklists/ebook-formatting-checklist.md b/expansion-packs/bmad-creative-writing/checklists/ebook-formatting-checklist.md index 4d39f6d4..09f801a0 100644 --- a/expansion-packs/bmad-creative-writing/checklists/ebook-formatting-checklist.md +++ b/expansion-packs/bmad-creative-writing/checklists/ebook-formatting-checklist.md @@ -1,15 +1,21 @@ + + # ------------------------------------------------------------ + # 14. eBook Formatting Checklist + --- + checklist: - id: ebook-formatting-checklist - name: eBook Formatting Checklist - description: Validate manuscript is Kindle/EPUB ready. +id: ebook-formatting-checklist +name: eBook Formatting Checklist +description: Validate manuscript is Kindle/EPUB ready. items: - - "[ ] Front matter meets Amazon/Apple guidelines" - - "[ ] No orphan/widow lines after conversion" - - "[ ] Embedded fonts licensed or removed" - - "[ ] Images compressed & have alt text" - - "[ ] Table of contents linked correctly" - - "[ ] EPUB passes EPUBCheck / Kindle Previewer" -... + +- "[ ] Front matter meets Amazon/Apple guidelines" +- "[ ] No orphan/widow lines after conversion" +- "[ ] Embedded fonts licensed or removed" +- "[ ] Images compressed & have alt text" +- "[ ] Table of contents linked correctly" +- "[ ] EPUB passes EPUBCheck / Kindle Previewer" + ... diff --git a/expansion-packs/bmad-creative-writing/checklists/epic-poetry-meter-checklist.md b/expansion-packs/bmad-creative-writing/checklists/epic-poetry-meter-checklist.md index 1bac3fd3..0cce2b7b 100644 --- a/expansion-packs/bmad-creative-writing/checklists/epic-poetry-meter-checklist.md +++ b/expansion-packs/bmad-creative-writing/checklists/epic-poetry-meter-checklist.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 22. Epic Poetry Meter & Form Checklist + # ------------------------------------------------------------ + --- + checklist: - id: epic-poetry-meter-checklist - name: Epic Poetry Meter & Form Checklist - description: Maintain consistent meter, line length, and poetic devices in epic verse. +id: epic-poetry-meter-checklist +name: Epic Poetry Meter & Form Checklist +description: Maintain consistent meter, line length, and poetic devices in epic verse. items: - - "[ ] Chosen meter specified (dactylic hexameter, iambic pentameter, etc.)" - - "[ ] Scansion performed on random sample lines" - - "[ ] Caesuras / enjambments used intentionally" - - "[ ] Repetition / epithets maintain oral tradition flavor" - - "[ ] Invocation of the muse or equivalent opening present" - - "[ ] Book/canto divisions follow narrative arc" -... + +- "[ ] Chosen meter specified (dactylic hexameter, iambic pentameter, etc.)" +- "[ ] Scansion performed on random sample lines" +- "[ ] Caesuras / enjambments used intentionally" +- "[ ] Repetition / epithets maintain oral tradition flavor" +- "[ ] Invocation of the muse or equivalent opening present" +- "[ ] Book/canto divisions follow narrative arc" + ... diff --git a/expansion-packs/bmad-creative-writing/checklists/fantasy-magic-system-checklist.md b/expansion-packs/bmad-creative-writing/checklists/fantasy-magic-system-checklist.md index 33da9d8e..3aecfab1 100644 --- a/expansion-packs/bmad-creative-writing/checklists/fantasy-magic-system-checklist.md +++ b/expansion-packs/bmad-creative-writing/checklists/fantasy-magic-system-checklist.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 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" + ... diff --git a/expansion-packs/bmad-creative-writing/checklists/foreshadowing-payoff-checklist.md b/expansion-packs/bmad-creative-writing/checklists/foreshadowing-payoff-checklist.md index cdf772ec..8d371f17 100644 --- a/expansion-packs/bmad-creative-writing/checklists/foreshadowing-payoff-checklist.md +++ b/expansion-packs/bmad-creative-writing/checklists/foreshadowing-payoff-checklist.md @@ -1,15 +1,22 @@ + + # ------------------------------------------------------------ + # 9. Foreshadowing & Payoff Checklist + # ------------------------------------------------------------ + --- + checklist: - id: foreshadowing-payoff-checklist - name: Foreshadowing & Payoff Checklist - description: Ensure planted clues/payoffs resolve satisfactorily and no dangling setups remain. +id: foreshadowing-payoff-checklist +name: Foreshadowing & Payoff Checklist +description: Ensure planted clues/payoffs resolve satisfactorily and no dangling setups remain. items: - - "[ ] Each major twist has early foreshadowing" - - "[ ] Subplots introduced are resolved or intentionally left open w/ sequel hook" - - "[ ] Symbolic motifs recur at least 3 times (rule of three)" - - "[ ] Chekhov’s gun fired before finale" - - "[ ] No dropped characters or MacGuffins" -... + +- "[ ] Each major twist has early foreshadowing" +- "[ ] Subplots introduced are resolved or intentionally left open w/ sequel hook" +- "[ ] Symbolic motifs recur at least 3 times (rule of three)" +- "[ ] Chekhov’s gun fired before finale" +- "[ ] No dropped characters or MacGuffins" + ... diff --git a/expansion-packs/bmad-creative-writing/checklists/genre-tropes-checklist.md b/expansion-packs/bmad-creative-writing/checklists/genre-tropes-checklist.md index 6a6d3e9e..2b5a2136 100644 --- a/expansion-packs/bmad-creative-writing/checklists/genre-tropes-checklist.md +++ b/expansion-packs/bmad-creative-writing/checklists/genre-tropes-checklist.md @@ -1,15 +1,22 @@ + + # ------------------------------------------------------------ + # 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" + ... diff --git a/expansion-packs/bmad-creative-writing/checklists/historical-accuracy-checklist.md b/expansion-packs/bmad-creative-writing/checklists/historical-accuracy-checklist.md index 2ef39dd0..f22e3399 100644 --- a/expansion-packs/bmad-creative-writing/checklists/historical-accuracy-checklist.md +++ b/expansion-packs/bmad-creative-writing/checklists/historical-accuracy-checklist.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 18. Historical Accuracy Checklist + # ------------------------------------------------------------ + --- + checklist: - id: historical-accuracy-checklist - name: Historical Accuracy Checklist - description: Validate era‑appropriate details and avoid anachronisms. +id: historical-accuracy-checklist +name: Historical Accuracy Checklist +description: Validate era‑appropriate details and avoid anachronisms. items: - - "[ ] Clothing and fashion match era" - - "[ ] Speech patterns and slang accurate" - - "[ ] Technology and tools available in timeframe" - - "[ ] Political and cultural norms correct" - - "[ ] Major historical events timeline respected" - - "[ ] Sensitivity to real cultures and peoples" -... + +- "[ ] Clothing and fashion match era" +- "[ ] Speech patterns and slang accurate" +- "[ ] Technology and tools available in timeframe" +- "[ ] Political and cultural norms correct" +- "[ ] Major historical events timeline respected" +- "[ ] Sensitivity to real cultures and peoples" + ... diff --git a/expansion-packs/bmad-creative-writing/checklists/horror-suspense-checklist.md b/expansion-packs/bmad-creative-writing/checklists/horror-suspense-checklist.md index 5201c20d..7c754571 100644 --- a/expansion-packs/bmad-creative-writing/checklists/horror-suspense-checklist.md +++ b/expansion-packs/bmad-creative-writing/checklists/horror-suspense-checklist.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 16. Horror Suspense & Scare Checklist + # ------------------------------------------------------------ + --- + checklist: - id: horror-suspense-checklist - name: Horror Suspense & Scare Checklist - description: Maintain escalating tension and effective scares. +id: horror-suspense-checklist +name: Horror Suspense & Scare Checklist +description: Maintain escalating tension and effective scares. items: - - "[ ] Early dread established within first 10%" - - "[ ] Rising stakes every 2–3 chapters" - - "[ ] Sensory details evoke fear (sound, smell, touch)" - - "[ ] At least one false scare before true threat" - - "[ ] Monster/antagonist rules consistent" - - "[ ] Climax delivers cathartic payoff and lingering unease" -... + +- "[ ] Early dread established within first 10%" +- "[ ] Rising stakes every 2–3 chapters" +- "[ ] Sensory details evoke fear (sound, smell, touch)" +- "[ ] At least one false scare before true threat" +- "[ ] Monster/antagonist rules consistent" +- "[ ] Climax delivers cathartic payoff and lingering unease" + ... diff --git a/expansion-packs/bmad-creative-writing/checklists/kdp-cover-ready-checklist.md b/expansion-packs/bmad-creative-writing/checklists/kdp-cover-ready-checklist.md index d17e6977..afb9aa35 100644 --- a/expansion-packs/bmad-creative-writing/checklists/kdp-cover-ready-checklist.md +++ b/expansion-packs/bmad-creative-writing/checklists/kdp-cover-ready-checklist.md @@ -1,18 +1,25 @@ + + # ------------------------------------------------------------ + # checklists/kdp-cover-ready-checklist.md + # ------------------------------------------------------------ + --- + checklist: - id: kdp-cover-ready-checklist - name: KDP Cover Ready Checklist - description: Ensure final cover meets Amazon KDP print specs. +id: kdp-cover-ready-checklist +name: KDP Cover Ready Checklist +description: Ensure final cover meets Amazon KDP print specs. items: - - "[ ] Correct trim size & bleed margins applied" - - "[ ] 300 DPI images" - - "[ ] CMYK color profile for print PDF" - - "[ ] Spine text ≥ 0.0625" away from edges" - - "[ ] Barcode zone clear of critical art" - - "[ ] No transparent layers" - - "[ ] File size < 40MB PDF" - - "[ ] Front & back text legible at thumbnail size" -... + +- "[ ] Correct trim size & bleed margins applied" +- "[ ] 300 DPI images" +- "[ ] CMYK color profile for print PDF" +- "[ ] Spine text ≥ 0.0625" away from edges" +- "[ ] Barcode zone clear of critical art" +- "[ ] No transparent layers" +- "[ ] File size < 40MB PDF" +- "[ ] Front & back text legible at thumbnail size" + ... diff --git a/expansion-packs/bmad-creative-writing/checklists/line-edit-quality-checklist.md b/expansion-packs/bmad-creative-writing/checklists/line-edit-quality-checklist.md index b26f62ab..f829d758 100644 --- a/expansion-packs/bmad-creative-writing/checklists/line-edit-quality-checklist.md +++ b/expansion-packs/bmad-creative-writing/checklists/line-edit-quality-checklist.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 4. Line‑Edit Quality Checklist + # ------------------------------------------------------------ + --- + checklist: - id: line-edit-quality-checklist - name: Line‑Edit Quality Checklist - description: Copy‑editing pass for clarity, grammar, and style. +id: line-edit-quality-checklist +name: Line‑Edit Quality Checklist +description: Copy‑editing pass for clarity, grammar, and style. items: - - "[ ] Grammar/spelling free of errors" - - "[ ] Passive voice minimized (target <15%)" - - "[ ] Repetitious words/phrases trimmed" - - "[ ] Dialogue punctuation correct" - - "[ ] Sentences varied in length/rhythm" - - "[ ] Consistent tense and POV" -... + +- "[ ] Grammar/spelling free of errors" +- "[ ] Passive voice minimized (target <15%)" +- "[ ] Repetitious words/phrases trimmed" +- "[ ] Dialogue punctuation correct" +- "[ ] Sentences varied in length/rhythm" +- "[ ] Consistent tense and POV" + ... diff --git a/expansion-packs/bmad-creative-writing/checklists/marketing-copy-checklist.md b/expansion-packs/bmad-creative-writing/checklists/marketing-copy-checklist.md index a7cbc71f..fe52b77d 100644 --- a/expansion-packs/bmad-creative-writing/checklists/marketing-copy-checklist.md +++ b/expansion-packs/bmad-creative-writing/checklists/marketing-copy-checklist.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 13. Marketing Copy Checklist + # ------------------------------------------------------------ + --- + checklist: - id: marketing-copy-checklist - name: Marketing Copy Checklist - description: Ensure query/blurb/sales page copy is compelling and professional. +id: marketing-copy-checklist +name: Marketing Copy Checklist +description: Ensure query/blurb/sales page copy is compelling and professional. items: - - "[ ] Hook sentence under 35 words" - - "[ ] Stakes and protagonist named" - - "[ ] Unique selling point emphasized" - - "[ ] Clarity on genre and tone" - - "[ ] Query letter follows standard format" - - "[ ] Bio & comparable titles included" -... + +- "[ ] Hook sentence under 35 words" +- "[ ] Stakes and protagonist named" +- "[ ] Unique selling point emphasized" +- "[ ] Clarity on genre and tone" +- "[ ] Query letter follows standard format" +- "[ ] Bio & comparable titles included" + ... diff --git a/expansion-packs/bmad-creative-writing/checklists/mystery-clue-trail-checklist.md b/expansion-packs/bmad-creative-writing/checklists/mystery-clue-trail-checklist.md index 2c7e4613..c1640b3b 100644 --- a/expansion-packs/bmad-creative-writing/checklists/mystery-clue-trail-checklist.md +++ b/expansion-packs/bmad-creative-writing/checklists/mystery-clue-trail-checklist.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 11. Mystery Clue Trail Checklist + # ------------------------------------------------------------ + --- + checklist: - id: mystery-clue-trail-checklist - name: Mystery Clue Trail Checklist - description: Specialized checklist for mystery novels—ensures fair‑play clues and red herrings. +id: mystery-clue-trail-checklist +name: Mystery Clue Trail Checklist +description: Specialized checklist for mystery novels—ensures fair‑play clues and red herrings. items: - - "[ ] Introduce primary mystery within first two chapters" - - "[ ] Every clue visible to the reader" - - "[ ] At least 2 credible red herrings" - - "[ ] Detective/protagonist has plausible method to discover clues" - - "[ ] Culprit motive/hiding method explained satisfactorily" - - "[ ] Climax reveals tie up all threads" -... + +- "[ ] Introduce primary mystery within first two chapters" +- "[ ] Every clue visible to the reader" +- "[ ] At least 2 credible red herrings" +- "[ ] Detective/protagonist has plausible method to discover clues" +- "[ ] Culprit motive/hiding method explained satisfactorily" +- "[ ] Climax reveals tie up all threads" + ... diff --git a/expansion-packs/bmad-creative-writing/checklists/orbital-mechanics-checklist.md b/expansion-packs/bmad-creative-writing/checklists/orbital-mechanics-checklist.md index d70cfbf6..f00f7e69 100644 --- a/expansion-packs/bmad-creative-writing/checklists/orbital-mechanics-checklist.md +++ b/expansion-packs/bmad-creative-writing/checklists/orbital-mechanics-checklist.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 21. Hard‑Science Orbital Mechanics Checklist + # ------------------------------------------------------------ + --- + checklist: - id: orbital-mechanics-checklist - name: Hard‑Science Orbital Mechanics Checklist - description: Verify spacecraft trajectories, delta‑v budgets, and orbital timings are scientifically plausible. +id: orbital-mechanics-checklist +name: Hard‑Science Orbital Mechanics Checklist +description: Verify spacecraft trajectories, delta‑v budgets, and orbital timings are scientifically plausible. items: - - "[ ] Gravity assists modeled with correct bodies and dates" - - "[ ] Delta‑v calculations align with propulsion tech limits" - - "[ ] Transfer windows and travel times match real ephemeris" - - "[ ] Orbits obey Kepler’s laws (elliptical periods, periapsis)" - - "[ ] Communication latency accounted for at given distances" - - "[ ] Plot accounts for orbital plane changes / inclination costs" -... + +- "[ ] Gravity assists modeled with correct bodies and dates" +- "[ ] Delta‑v calculations align with propulsion tech limits" +- "[ ] Transfer windows and travel times match real ephemeris" +- "[ ] Orbits obey Kepler’s laws (elliptical periods, periapsis)" +- "[ ] Communication latency accounted for at given distances" +- "[ ] Plot accounts for orbital plane changes / inclination costs" + ... diff --git a/expansion-packs/bmad-creative-writing/checklists/plot-structure-checklist.md b/expansion-packs/bmad-creative-writing/checklists/plot-structure-checklist.md index 2ed6505f..e8726e01 100644 --- a/expansion-packs/bmad-creative-writing/checklists/plot-structure-checklist.md +++ b/expansion-packs/bmad-creative-writing/checklists/plot-structure-checklist.md @@ -1,6 +1,9 @@ + + # Plot Structure Checklist ## Opening + - [ ] Hook engages within first page - [ ] Genre/tone established early - [ ] World rules clear @@ -8,6 +11,7 @@ - [ ] Status quo established before disruption ## Structure Fundamentals + - [ ] Inciting incident by 10-15% mark - [ ] Clear story question posed - [ ] Stakes established and clear @@ -15,19 +19,23 @@ - [ ] 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 @@ -35,6 +43,7 @@ - [ ] Dark night of soul (character lowest) ## Climax + - [ ] Protagonist must act (no rescue) - [ ] Uses lessons learned - [ ] Internal/external conflicts merge @@ -42,8 +51,9 @@ - [ ] Clear win/loss/transformation ## Resolution + - [ ] New equilibrium established - [ ] Loose threads tied - [ ] Character growth demonstrated - [ ] Thematic statement clear -- [ ] Emotional satisfaction delivered \ No newline at end of file +- [ ] Emotional satisfaction delivered diff --git a/expansion-packs/bmad-creative-writing/checklists/publication-readiness-checklist.md b/expansion-packs/bmad-creative-writing/checklists/publication-readiness-checklist.md index 25c6d61a..1048447e 100644 --- a/expansion-packs/bmad-creative-writing/checklists/publication-readiness-checklist.md +++ b/expansion-packs/bmad-creative-writing/checklists/publication-readiness-checklist.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 5. Publication Readiness Checklist + # ------------------------------------------------------------ + --- + checklist: - id: publication-readiness-checklist - name: Publication Readiness Checklist - description: Final checks before releasing or submitting the manuscript. +id: publication-readiness-checklist +name: Publication Readiness Checklist +description: Final checks before releasing or submitting the manuscript. items: - - "[ ] Front matter complete (title, author, dedication)" - - "[ ] Back matter complete (acknowledgments, about author)" - - "[ ] Table of contents updated (digital)" - - "[ ] Chapter headings numbered correctly" - - "[ ] Formatting styles consistent" - - "[ ] Metadata (ISBN, keywords) embedded" -... + +- "[ ] Front matter complete (title, author, dedication)" +- "[ ] Back matter complete (acknowledgments, about author)" +- "[ ] Table of contents updated (digital)" +- "[ ] Chapter headings numbered correctly" +- "[ ] Formatting styles consistent" +- "[ ] Metadata (ISBN, keywords) embedded" + ... diff --git a/expansion-packs/bmad-creative-writing/checklists/romance-emotional-beats-checklist.md b/expansion-packs/bmad-creative-writing/checklists/romance-emotional-beats-checklist.md index 34de4613..890f39c4 100644 --- a/expansion-packs/bmad-creative-writing/checklists/romance-emotional-beats-checklist.md +++ b/expansion-packs/bmad-creative-writing/checklists/romance-emotional-beats-checklist.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 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" + ... diff --git a/expansion-packs/bmad-creative-writing/checklists/scene-quality-checklist.md b/expansion-packs/bmad-creative-writing/checklists/scene-quality-checklist.md index c8c212eb..0b76c2de 100644 --- a/expansion-packs/bmad-creative-writing/checklists/scene-quality-checklist.md +++ b/expansion-packs/bmad-creative-writing/checklists/scene-quality-checklist.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 3. Scene Quality Checklist + # ------------------------------------------------------------ + --- + checklist: - id: scene-quality-checklist - name: Scene Quality Checklist - description: Quick QA pass for each scene/chapter to ensure narrative purpose. +id: scene-quality-checklist +name: Scene Quality Checklist +description: Quick QA pass for each scene/chapter to ensure narrative purpose. items: - - "[ ] Clear POV established immediately" - - "[ ] Scene goal & conflict articulated" - - "[ ] Stakes apparent to the reader" - - "[ ] Hook at opening and/or end" - - "[ ] Logical cause–effect with previous scene" - - "[ ] Character emotion/reaction present" -... + +- "[ ] Clear POV established immediately" +- "[ ] Scene goal & conflict articulated" +- "[ ] Stakes apparent to the reader" +- "[ ] Hook at opening and/or end" +- "[ ] Logical cause–effect with previous scene" +- "[ ] Character emotion/reaction present" + ... diff --git a/expansion-packs/bmad-creative-writing/checklists/scifi-technology-plausibility-checklist.md b/expansion-packs/bmad-creative-writing/checklists/scifi-technology-plausibility-checklist.md index 3fd15fcc..8f3e4ef2 100644 --- a/expansion-packs/bmad-creative-writing/checklists/scifi-technology-plausibility-checklist.md +++ b/expansion-packs/bmad-creative-writing/checklists/scifi-technology-plausibility-checklist.md @@ -1,15 +1,22 @@ + + # ------------------------------------------------------------ + # 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" + ... diff --git a/expansion-packs/bmad-creative-writing/checklists/sensitivity-representation-checklist.md b/expansion-packs/bmad-creative-writing/checklists/sensitivity-representation-checklist.md index a6c3ec0d..8335bdf2 100644 --- a/expansion-packs/bmad-creative-writing/checklists/sensitivity-representation-checklist.md +++ b/expansion-packs/bmad-creative-writing/checklists/sensitivity-representation-checklist.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 7. Sensitivity & Representation Checklist + # ------------------------------------------------------------ + --- + checklist: - id: sensitivity-representation-checklist - name: Sensitivity & Representation Checklist - description: Ensure respectful, accurate portrayal of marginalized groups and sensitive topics. +id: sensitivity-representation-checklist +name: Sensitivity & Representation Checklist +description: Ensure respectful, accurate portrayal of marginalized groups and sensitive topics. items: - - "[ ] Consulted authentic sources or sensitivity readers for represented groups" - - "[ ] Avoided harmful stereotypes or caricatures" - - "[ ] Language and descriptors are respectful and current" - - "[ ] Traumatic content handled with appropriate weight and trigger warnings" - - "[ ] Cultural references are accurate and contextualized" - - "[ ] Own‑voices acknowledgement (if applicable)" -... + +- "[ ] Consulted authentic sources or sensitivity readers for represented groups" +- "[ ] Avoided harmful stereotypes or caricatures" +- "[ ] Language and descriptors are respectful and current" +- "[ ] Traumatic content handled with appropriate weight and trigger warnings" +- "[ ] Cultural references are accurate and contextualized" +- "[ ] Own‑voices acknowledgement (if applicable)" + ... diff --git a/expansion-packs/bmad-creative-writing/checklists/steampunk-gadget-checklist.md b/expansion-packs/bmad-creative-writing/checklists/steampunk-gadget-checklist.md index 303a3137..a8818633 100644 --- a/expansion-packs/bmad-creative-writing/checklists/steampunk-gadget-checklist.md +++ b/expansion-packs/bmad-creative-writing/checklists/steampunk-gadget-checklist.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 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" + ... diff --git a/expansion-packs/bmad-creative-writing/checklists/thriller-pacing-stakes-checklist.md b/expansion-packs/bmad-creative-writing/checklists/thriller-pacing-stakes-checklist.md index f49b739b..41ff9be6 100644 --- a/expansion-packs/bmad-creative-writing/checklists/thriller-pacing-stakes-checklist.md +++ b/expansion-packs/bmad-creative-writing/checklists/thriller-pacing-stakes-checklist.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 19. Thriller Pacing & Stakes Checklist + # ------------------------------------------------------------ + --- + checklist: - id: thriller-pacing-stakes-checklist - name: Thriller Pacing & Stakes Checklist - description: Keep readers on edge with tight pacing and escalating stakes. +id: thriller-pacing-stakes-checklist +name: Thriller Pacing & Stakes Checklist +description: Keep readers on edge with tight pacing and escalating stakes. items: - - "[ ] Inciting incident by 10% mark" - - "[ ] Ticking clock or deadline present" - - "[ ] Complications escalate danger every 3–4 chapters" - - "[ ] Protagonist setbacks increase tension" - - "[ ] Twist/reversal at midpoint" - - "[ ] Final confrontation resolves central threat" -... + +- "[ ] Inciting incident by 10% mark" +- "[ ] Ticking clock or deadline present" +- "[ ] Complications escalate danger every 3–4 chapters" +- "[ ] Protagonist setbacks increase tension" +- "[ ] Twist/reversal at midpoint" +- "[ ] Final confrontation resolves central threat" + ... diff --git a/expansion-packs/bmad-creative-writing/checklists/timeline-continuity-checklist.md b/expansion-packs/bmad-creative-writing/checklists/timeline-continuity-checklist.md index 70bd0d9d..9c8adea8 100644 --- a/expansion-packs/bmad-creative-writing/checklists/timeline-continuity-checklist.md +++ b/expansion-packs/bmad-creative-writing/checklists/timeline-continuity-checklist.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 8. Timeline & Continuity Checklist + # ------------------------------------------------------------ + --- + checklist: - id: timeline-continuity-checklist - name: Timeline & Continuity Checklist - description: Verify dates, ages, seasons, and causal events remain consistent. +id: timeline-continuity-checklist +name: Timeline & Continuity Checklist +description: Verify dates, ages, seasons, and causal events remain consistent. items: - - "[ ] Character ages progress logically" - - "[ ] Seasons/holidays align with passage of time" - - "[ ] Travel durations match map scale" - - "[ ] Cause → effect order preserved across chapters" - - "[ ] Flashbacks clearly timestamped and consistent" - - "[ ] Timeline visual (chronology.md) updated" -... + +- "[ ] Character ages progress logically" +- "[ ] Seasons/holidays align with passage of time" +- "[ ] Travel durations match map scale" +- "[ ] Cause → effect order preserved across chapters" +- "[ ] Flashbacks clearly timestamped and consistent" +- "[ ] Timeline visual (chronology.md) updated" + ... diff --git a/expansion-packs/bmad-creative-writing/checklists/world-building-continuity-checklist.md b/expansion-packs/bmad-creative-writing/checklists/world-building-continuity-checklist.md index 08e03691..c3c08bfc 100644 --- a/expansion-packs/bmad-creative-writing/checklists/world-building-continuity-checklist.md +++ b/expansion-packs/bmad-creative-writing/checklists/world-building-continuity-checklist.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 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" + ... diff --git a/expansion-packs/bmad-creative-writing/checklists/ya-appropriateness-checklist.md b/expansion-packs/bmad-creative-writing/checklists/ya-appropriateness-checklist.md index 7d5826af..099d29c6 100644 --- a/expansion-packs/bmad-creative-writing/checklists/ya-appropriateness-checklist.md +++ b/expansion-packs/bmad-creative-writing/checklists/ya-appropriateness-checklist.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 20. YA Appropriateness Checklist + # ------------------------------------------------------------ + --- + checklist: - id: ya-appropriateness-checklist - name: Young Adult Content Appropriateness Checklist - description: Ensure themes, language, and content suit YA audience. +id: ya-appropriateness-checklist +name: Young Adult Content Appropriateness Checklist +description: Ensure themes, language, and content suit YA audience. items: - - "[ ] Protagonist age 13–18 and driving action" - - "[ ] Themes of identity, friendship, coming‑of‑age present" - - "[ ] Romance handles consent and boundaries responsibly" - - "[ ] Violence and language within YA market norms" - - "[ ] No explicit sexual content beyond fade‑to‑black" - - "[ ] Hopeful or growth‑oriented ending" -... + +- "[ ] Protagonist age 13–18 and driving action" +- "[ ] Themes of identity, friendship, coming‑of‑age present" +- "[ ] Romance handles consent and boundaries responsibly" +- "[ ] Violence and language within YA market norms" +- "[ ] No explicit sexual content beyond fade‑to‑black" +- "[ ] Hopeful or growth‑oriented ending" + ... diff --git a/expansion-packs/bmad-creative-writing/config.yaml b/expansion-packs/bmad-creative-writing/config.yaml index a0fcb71e..8b9de573 100644 --- a/expansion-packs/bmad-creative-writing/config.yaml +++ b/expansion-packs/bmad-creative-writing/config.yaml @@ -1,5 +1,6 @@ +# name: bmad-creative-writing -version: 1.1.0 +version: 1.1.1 short-title: Creative Writing Studio description: >- Comprehensive AI-powered creative writing framework providing specialized @@ -8,4 +9,4 @@ description: >- ideation to publication, 27 quality checklists, and KDP publishing integration. author: Wes -slashPrefix: cw +slashPrefix: bmad-cw diff --git a/expansion-packs/bmad-creative-writing/data/bmad-kb.md b/expansion-packs/bmad-creative-writing/data/bmad-kb.md index b88b5e58..13e98704 100644 --- a/expansion-packs/bmad-creative-writing/data/bmad-kb.md +++ b/expansion-packs/bmad-creative-writing/data/bmad-kb.md @@ -1,3 +1,5 @@ + + # BMad Creative Writing Knowledge Base ## Overview @@ -103,24 +105,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 @@ -129,6 +135,7 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating ## Genre Support ### Built-in Genre Checklists + - Fantasy & Sci-Fi - Romance & Thriller - Mystery & Horror @@ -136,6 +143,7 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating - Young Adult Each genre includes: + - Trope management - Reader expectations - Market positioning @@ -144,24 +152,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 @@ -194,4 +206,4 @@ The Creative Writing extension maintains compatibility with core BMad features: 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. \ No newline at end of file +Remember: BMad Creative Writing provides structure to liberate creativity, not constrain it. diff --git a/expansion-packs/bmad-creative-writing/data/story-structures.md b/expansion-packs/bmad-creative-writing/data/story-structures.md index aba8c395..461fed84 100644 --- a/expansion-packs/bmad-creative-writing/data/story-structures.md +++ b/expansion-packs/bmad-creative-writing/data/story-structures.md @@ -1,11 +1,15 @@ + + # 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 \ No newline at end of file +- **Ketsu**: Conclusion diff --git a/expansion-packs/bmad-creative-writing/docs/brief.md b/expansion-packs/bmad-creative-writing/docs/brief.md index b5e08f07..81c4fcf1 100644 --- a/expansion-packs/bmad-creative-writing/docs/brief.md +++ b/expansion-packs/bmad-creative-writing/docs/brief.md @@ -1,3 +1,5 @@ + + # 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. \ No newline at end of file + +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. diff --git a/expansion-packs/bmad-creative-writing/tasks/advanced-elicitation.md b/expansion-packs/bmad-creative-writing/tasks/advanced-elicitation.md index 84981375..f9bb9688 100644 --- a/expansion-packs/bmad-creative-writing/tasks/advanced-elicitation.md +++ b/expansion-packs/bmad-creative-writing/tasks/advanced-elicitation.md @@ -1,3 +1,5 @@ + + # 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 \ No newline at end of file +- **Maintain Flow**: Keep the process moving efficiently diff --git a/expansion-packs/bmad-creative-writing/tasks/analyze-reader-feedback.md b/expansion-packs/bmad-creative-writing/tasks/analyze-reader-feedback.md index ae534d67..26b1d2cd 100644 --- a/expansion-packs/bmad-creative-writing/tasks/analyze-reader-feedback.md +++ b/expansion-packs/bmad-creative-writing/tasks/analyze-reader-feedback.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 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 + ... diff --git a/expansion-packs/bmad-creative-writing/tasks/analyze-story-structure.md b/expansion-packs/bmad-creative-writing/tasks/analyze-story-structure.md index 93a3f918..aa5f9dfe 100644 --- a/expansion-packs/bmad-creative-writing/tasks/analyze-story-structure.md +++ b/expansion-packs/bmad-creative-writing/tasks/analyze-story-structure.md @@ -1,13 +1,17 @@ + + # 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 \ No newline at end of file + +Comprehensive structural analysis with actionable recommendations diff --git a/expansion-packs/bmad-creative-writing/tasks/assemble-kdp-package.md b/expansion-packs/bmad-creative-writing/tasks/assemble-kdp-package.md index 5877a151..05ad3819 100644 --- a/expansion-packs/bmad-creative-writing/tasks/assemble-kdp-package.md +++ b/expansion-packs/bmad-creative-writing/tasks/assemble-kdp-package.md @@ -1,22 +1,29 @@ + + # ------------------------------------------------------------ + # 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 + ... diff --git a/expansion-packs/bmad-creative-writing/tasks/brainstorm-premise.md b/expansion-packs/bmad-creative-writing/tasks/brainstorm-premise.md index 5d60875d..ad52f3b8 100644 --- a/expansion-packs/bmad-creative-writing/tasks/brainstorm-premise.md +++ b/expansion-packs/bmad-creative-writing/tasks/brainstorm-premise.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 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 + ... diff --git a/expansion-packs/bmad-creative-writing/tasks/build-world.md b/expansion-packs/bmad-creative-writing/tasks/build-world.md index 1de3f5f5..ee2701c3 100644 --- a/expansion-packs/bmad-creative-writing/tasks/build-world.md +++ b/expansion-packs/bmad-creative-writing/tasks/build-world.md @@ -1,17 +1,24 @@ + + # ------------------------------------------------------------ + # 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 + ... diff --git a/expansion-packs/bmad-creative-writing/tasks/character-depth-pass.md b/expansion-packs/bmad-creative-writing/tasks/character-depth-pass.md index 535ffa12..788f3797 100644 --- a/expansion-packs/bmad-creative-writing/tasks/character-depth-pass.md +++ b/expansion-packs/bmad-creative-writing/tasks/character-depth-pass.md @@ -1,15 +1,22 @@ + + # ------------------------------------------------------------ + # 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 + ... diff --git a/expansion-packs/bmad-creative-writing/tasks/create-doc.md b/expansion-packs/bmad-creative-writing/tasks/create-doc.md index 6bc4a0d7..60da7fe3 100644 --- a/expansion-packs/bmad-creative-writing/tasks/create-doc.md +++ b/expansion-packs/bmad-creative-writing/tasks/create-doc.md @@ -1,3 +1,5 @@ + + # 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:" \ No newline at end of file +- End with "Select 1-9 or just type your question/feedback:" diff --git a/expansion-packs/bmad-creative-writing/tasks/create-draft-section.md b/expansion-packs/bmad-creative-writing/tasks/create-draft-section.md index 5aaca9ee..f8a62934 100644 --- a/expansion-packs/bmad-creative-writing/tasks/create-draft-section.md +++ b/expansion-packs/bmad-creative-writing/tasks/create-draft-section.md @@ -1,19 +1,26 @@ + + # ------------------------------------------------------------ + # 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 + ... diff --git a/expansion-packs/bmad-creative-writing/tasks/critical-review.md b/expansion-packs/bmad-creative-writing/tasks/critical-review.md index 70fc6093..c81b6b33 100644 --- a/expansion-packs/bmad-creative-writing/tasks/critical-review.md +++ b/expansion-packs/bmad-creative-writing/tasks/critical-review.md @@ -1,19 +1,26 @@ + + # ------------------------------------------------------------ + # 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 + ... diff --git a/expansion-packs/bmad-creative-writing/tasks/develop-character.md b/expansion-packs/bmad-creative-writing/tasks/develop-character.md index 7f79569d..871defb6 100644 --- a/expansion-packs/bmad-creative-writing/tasks/develop-character.md +++ b/expansion-packs/bmad-creative-writing/tasks/develop-character.md @@ -1,17 +1,24 @@ + + # ------------------------------------------------------------ + # 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 + ... diff --git a/expansion-packs/bmad-creative-writing/tasks/execute-checklist.md b/expansion-packs/bmad-creative-writing/tasks/execute-checklist.md index 636337f1..2a216d7d 100644 --- a/expansion-packs/bmad-creative-writing/tasks/execute-checklist.md +++ b/expansion-packs/bmad-creative-writing/tasks/execute-checklist.md @@ -1,3 +1,5 @@ + + # 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. @@ -9,7 +11,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 @@ -22,14 +23,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 @@ -38,7 +37,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 @@ -46,7 +44,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 @@ -60,7 +57,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 @@ -70,7 +66,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 @@ -90,4 +85,4 @@ 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 \ No newline at end of file +- Offer to provide detailed analysis of any section, especially those with warnings or failures diff --git a/expansion-packs/bmad-creative-writing/tasks/expand-premise.md b/expansion-packs/bmad-creative-writing/tasks/expand-premise.md index d8a56577..935dc890 100644 --- a/expansion-packs/bmad-creative-writing/tasks/expand-premise.md +++ b/expansion-packs/bmad-creative-writing/tasks/expand-premise.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 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 +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 -... + +- premise.txt + steps: +- Ask for genre confirmation. +- Draft one paragraph (~5 sentences) covering protagonist, conflict, stakes. + output: premise-paragraph.md + ... diff --git a/expansion-packs/bmad-creative-writing/tasks/expand-synopsis.md b/expansion-packs/bmad-creative-writing/tasks/expand-synopsis.md index 653d9ec3..685431a9 100644 --- a/expansion-packs/bmad-creative-writing/tasks/expand-synopsis.md +++ b/expansion-packs/bmad-creative-writing/tasks/expand-synopsis.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 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 +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 -... + +- premise-paragraph.md + steps: +- Outline three‑act structure in prose. +- Keep under 700 words. + output: synopsis.md + ... diff --git a/expansion-packs/bmad-creative-writing/tasks/final-polish.md b/expansion-packs/bmad-creative-writing/tasks/final-polish.md index df5cbfc2..93253d45 100644 --- a/expansion-packs/bmad-creative-writing/tasks/final-polish.md +++ b/expansion-packs/bmad-creative-writing/tasks/final-polish.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 14. Final Polish + # ------------------------------------------------------------ + --- + task: - id: final-polish - name: Final Polish - description: Line‑edit for style, clarity, grammar. - persona_default: editor +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 -... + +- chapter-dialog.md | polished-manuscript.md + steps: +- Correct grammar and tighten prose. +- Ensure consistent voice. + output: chapter-final.md | final-manuscript.md + ... diff --git a/expansion-packs/bmad-creative-writing/tasks/generate-cover-brief.md b/expansion-packs/bmad-creative-writing/tasks/generate-cover-brief.md index 04e6d5ac..cc396945 100644 --- a/expansion-packs/bmad-creative-writing/tasks/generate-cover-brief.md +++ b/expansion-packs/bmad-creative-writing/tasks/generate-cover-brief.md @@ -1,18 +1,25 @@ + + # ------------------------------------------------------------ + # 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 +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 -... + +- 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 + ... diff --git a/expansion-packs/bmad-creative-writing/tasks/generate-cover-prompts.md b/expansion-packs/bmad-creative-writing/tasks/generate-cover-prompts.md index d3a07537..5f80bebe 100644 --- a/expansion-packs/bmad-creative-writing/tasks/generate-cover-prompts.md +++ b/expansion-packs/bmad-creative-writing/tasks/generate-cover-prompts.md @@ -1,19 +1,26 @@ + + # ------------------------------------------------------------ + # 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 +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 -... + +- 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 + ... diff --git a/expansion-packs/bmad-creative-writing/tasks/generate-scene-list.md b/expansion-packs/bmad-creative-writing/tasks/generate-scene-list.md index 4f1ab570..4c536272 100644 --- a/expansion-packs/bmad-creative-writing/tasks/generate-scene-list.md +++ b/expansion-packs/bmad-creative-writing/tasks/generate-scene-list.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 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 +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 -... + +- synopsis.md | story-outline.md + steps: +- Identify key beats. +- Fill scene-list-tmpl table. + output: scene-list.md + ... diff --git a/expansion-packs/bmad-creative-writing/tasks/incorporate-feedback.md b/expansion-packs/bmad-creative-writing/tasks/incorporate-feedback.md index ce7b928d..c335e754 100644 --- a/expansion-packs/bmad-creative-writing/tasks/incorporate-feedback.md +++ b/expansion-packs/bmad-creative-writing/tasks/incorporate-feedback.md @@ -1,18 +1,25 @@ + + # ------------------------------------------------------------ + # 6. Incorporate Feedback + # ------------------------------------------------------------ + --- + task: - id: incorporate-feedback - name: Incorporate Feedback - description: Merge beta feedback into manuscript; accept, reject, or revise. - persona_default: editor +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 -... + +- draft-manuscript.md +- beta-notes.md + steps: +- Summarize actionable changes. +- Apply revisions inline. +- Mark resolved comments. + output: polished-manuscript.md + ... diff --git a/expansion-packs/bmad-creative-writing/tasks/outline-scenes.md b/expansion-packs/bmad-creative-writing/tasks/outline-scenes.md index 2762b695..62c9c142 100644 --- a/expansion-packs/bmad-creative-writing/tasks/outline-scenes.md +++ b/expansion-packs/bmad-creative-writing/tasks/outline-scenes.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 11. Outline Scenes + # ------------------------------------------------------------ + --- + task: - id: outline-scenes - name: Outline Scenes - description: Group scene list into chapters with act structure. - persona_default: plot-architect +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 -... + +- scene-list.md + steps: +- Assign scenes to chapters. +- Produce snowflake-outline.md with headings per chapter. + output: snowflake-outline.md + ... diff --git a/expansion-packs/bmad-creative-writing/tasks/provide-feedback.md b/expansion-packs/bmad-creative-writing/tasks/provide-feedback.md index f8aedee1..0ed80812 100644 --- a/expansion-packs/bmad-creative-writing/tasks/provide-feedback.md +++ b/expansion-packs/bmad-creative-writing/tasks/provide-feedback.md @@ -1,17 +1,24 @@ + + # ------------------------------------------------------------ + # 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 +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 -... + +- 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 + ... diff --git a/expansion-packs/bmad-creative-writing/tasks/publish-chapter.md b/expansion-packs/bmad-creative-writing/tasks/publish-chapter.md index 16d5f9bc..9a93ff9a 100644 --- a/expansion-packs/bmad-creative-writing/tasks/publish-chapter.md +++ b/expansion-packs/bmad-creative-writing/tasks/publish-chapter.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 15. Publish Chapter + # ------------------------------------------------------------ + --- + task: - id: publish-chapter - name: Publish Chapter - description: Format and log a chapter release. - persona_default: editor +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 -... + +- chapter-final.md + steps: +- Generate front/back matter as needed. +- Append entry to publication-log.md (date, URL). + output: publication-log.md + ... diff --git a/expansion-packs/bmad-creative-writing/tasks/quick-feedback.md b/expansion-packs/bmad-creative-writing/tasks/quick-feedback.md index fa31ae6c..9738337a 100644 --- a/expansion-packs/bmad-creative-writing/tasks/quick-feedback.md +++ b/expansion-packs/bmad-creative-writing/tasks/quick-feedback.md @@ -1,15 +1,22 @@ + + # ------------------------------------------------------------ + # 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 +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 -... + +- chapter-dialog.md + steps: +- Use condensed beta-feedback-form. + output: chapter-notes.md + ... diff --git a/expansion-packs/bmad-creative-writing/tasks/select-next-arc.md b/expansion-packs/bmad-creative-writing/tasks/select-next-arc.md index 2d1f5422..9204fda9 100644 --- a/expansion-packs/bmad-creative-writing/tasks/select-next-arc.md +++ b/expansion-packs/bmad-creative-writing/tasks/select-next-arc.md @@ -1,16 +1,23 @@ + + # ------------------------------------------------------------ + # 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 +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 -... + +- retrospective data (retro.md) | snowflake-outline.md + steps: +- Analyze reader feedback. +- Update release-plan.md with upcoming beats. + output: release-plan.md + ... diff --git a/expansion-packs/bmad-creative-writing/tasks/workshop-dialog.md b/expansion-packs/bmad-creative-writing/tasks/workshop-dialog.md index dd3ecea1..667e1152 100644 --- a/expansion-packs/bmad-creative-writing/tasks/workshop-dialog.md +++ b/expansion-packs/bmad-creative-writing/tasks/workshop-dialog.md @@ -1,12 +1,17 @@ + + # 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 @@ -15,7 +20,9 @@ For each character, assess: - Emotional expression style ### 2. Subtext Analysis + For each exchange: + - What's being said directly - What's really being communicated - Power dynamics at play @@ -24,14 +31,18 @@ For each exchange: - 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 @@ -40,6 +51,7 @@ Where dialog lacks tension: - Add environmental pressure ### 5. Polish Pass + - Read aloud for rhythm - Check period authenticity - Verify character consistency @@ -48,4 +60,5 @@ Where dialog lacks tension: - Add distinctive character markers ## Output -Refined dialog with stronger voices and dramatic impact \ No newline at end of file + +Refined dialog with stronger voices and dramatic impact diff --git a/expansion-packs/bmad-creative-writing/templates/beta-feedback-form.yaml b/expansion-packs/bmad-creative-writing/templates/beta-feedback-form.yaml index 85b8808c..a3df270b 100644 --- a/expansion-packs/bmad-creative-writing/templates/beta-feedback-form.yaml +++ b/expansion-packs/bmad-creative-writing/templates/beta-feedback-form.yaml @@ -1,3 +1,4 @@ +# --- template: id: beta-feedback-form-tmpl diff --git a/expansion-packs/bmad-creative-writing/templates/chapter-draft-tmpl.yaml b/expansion-packs/bmad-creative-writing/templates/chapter-draft-tmpl.yaml index 26fc3176..2f4f5086 100644 --- a/expansion-packs/bmad-creative-writing/templates/chapter-draft-tmpl.yaml +++ b/expansion-packs/bmad-creative-writing/templates/chapter-draft-tmpl.yaml @@ -1,3 +1,4 @@ +# --- template: id: chapter-draft-tmpl diff --git a/expansion-packs/bmad-creative-writing/templates/character-profile-tmpl.yaml b/expansion-packs/bmad-creative-writing/templates/character-profile-tmpl.yaml index 7422e726..93a314b3 100644 --- a/expansion-packs/bmad-creative-writing/templates/character-profile-tmpl.yaml +++ b/expansion-packs/bmad-creative-writing/templates/character-profile-tmpl.yaml @@ -1,3 +1,4 @@ +# --- template: id: character-profile @@ -89,4 +90,3 @@ sections: - Pet peeves - Hidden talents - Contradictions - diff --git a/expansion-packs/bmad-creative-writing/templates/cover-design-brief-tmpl.yaml b/expansion-packs/bmad-creative-writing/templates/cover-design-brief-tmpl.yaml index 05c8d767..7f94e593 100644 --- a/expansion-packs/bmad-creative-writing/templates/cover-design-brief-tmpl.yaml +++ b/expansion-packs/bmad-creative-writing/templates/cover-design-brief-tmpl.yaml @@ -1,3 +1,4 @@ +# --- template: id: cover-design-brief-tmpl diff --git a/expansion-packs/bmad-creative-writing/templates/premise-brief-tmpl.yaml b/expansion-packs/bmad-creative-writing/templates/premise-brief-tmpl.yaml index 22b6bb4e..e0c2d00c 100644 --- a/expansion-packs/bmad-creative-writing/templates/premise-brief-tmpl.yaml +++ b/expansion-packs/bmad-creative-writing/templates/premise-brief-tmpl.yaml @@ -1,3 +1,4 @@ +# --- template: id: premise-brief-tmpl diff --git a/expansion-packs/bmad-creative-writing/templates/scene-list-tmpl.yaml b/expansion-packs/bmad-creative-writing/templates/scene-list-tmpl.yaml index 60d9e9d8..94784a4c 100644 --- a/expansion-packs/bmad-creative-writing/templates/scene-list-tmpl.yaml +++ b/expansion-packs/bmad-creative-writing/templates/scene-list-tmpl.yaml @@ -1,3 +1,4 @@ +# --- template: id: scene-list-tmpl diff --git a/expansion-packs/bmad-creative-writing/templates/story-outline-tmpl.yaml b/expansion-packs/bmad-creative-writing/templates/story-outline-tmpl.yaml index 2dc37b0a..e163292c 100644 --- a/expansion-packs/bmad-creative-writing/templates/story-outline-tmpl.yaml +++ b/expansion-packs/bmad-creative-writing/templates/story-outline-tmpl.yaml @@ -1,3 +1,4 @@ +# --- template: id: story-outline @@ -93,4 +94,3 @@ sections: - Hook/cliffhanger repeatable: true elicit: true - diff --git a/expansion-packs/bmad-creative-writing/templates/world-guide-tmpl.yaml b/expansion-packs/bmad-creative-writing/templates/world-guide-tmpl.yaml index 8318cb4b..2b4332eb 100644 --- a/expansion-packs/bmad-creative-writing/templates/world-guide-tmpl.yaml +++ b/expansion-packs/bmad-creative-writing/templates/world-guide-tmpl.yaml @@ -1,3 +1,4 @@ +# --- template: id: world-guide-tmpl diff --git a/expansion-packs/bmad-creative-writing/workflows/book-cover-design-workflow.md b/expansion-packs/bmad-creative-writing/workflows/book-cover-design-workflow.md index 478bb08e..6d0c24e6 100644 --- a/expansion-packs/bmad-creative-writing/workflows/book-cover-design-workflow.md +++ b/expansion-packs/bmad-creative-writing/workflows/book-cover-design-workflow.md @@ -1,15 +1,27 @@ + + # Book Cover Design Assets + # ============================================================ + # This canvas file contains: + # 1. Agent definition (cover-designer) + # 2. Three tasks + # 3. One template + # 4. One checklist + # ------------------------------------------------------------ # ------------------------------------------------------------ + # agents/cover-designer.md + # ------------------------------------------------------------ + ```yaml agent: name: Iris Vega @@ -50,81 +62,103 @@ dependencies: ``` # ------------------------------------------------------------ + # 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 -... # ------------------------------------------------------------ + +--- + +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 + ... + +# ------------------------------------------------------------ + # 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 -... # ------------------------------------------------------------ + +--- + +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 + ... + +# ------------------------------------------------------------ + # 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 -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 -... # ------------------------------------------------------------ -# templates/cover-design-brief-tmpl.yaml + +--- + +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 +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 + ... + # ------------------------------------------------------------ + +# templates/cover-design-brief-tmpl.yaml + +# ------------------------------------------------------------ + --- + template: - id: cover-design-brief-tmpl - name: Cover Design Brief - description: Structured form capturing creative + technical details for cover design. - whenToUse: During generate-cover-brief task. - exampleOutput: cover-brief.md +id: cover-design-brief-tmpl +name: Cover Design Brief +description: Structured form capturing creative + technical details for cover design. +whenToUse: During generate-cover-brief task. +exampleOutput: cover-brief.md + --- + # Cover Design Brief – {{title}} ## Book Metadata + - **Title:** {{title}} - **Subtitle:** {{subtitle}} - **Author:** {{author}} @@ -133,21 +167,24 @@ template: - **Target Audience:** {{audience}} ## Technical Specs -| Item | Value | -|------|-------| -| Trim Size | {{trim_size}} | -| Page Count | {{page_count}} | -| Paper Color | {{paper_color}} | -| Print Type | {{print_type}} | -| Matte/Glossy | {{finish}} | + +| Item | Value | +| ------------ | --------------- | +| Trim Size | {{trim_size}} | +| Page Count | {{page_count}} | +| Paper Color | {{paper_color}} | +| Print Type | {{print_type}} | +| Matte/Glossy | {{finish}} | ## Creative Direction + - **Mood / Tone Keywords:** {{mood_keywords}} - **Primary Imagery:** {{imagery}} - **Color Palette:** {{colors}} - **Font Style Preferences:** {{fonts}} ## Back Cover Content + - **Blurb:** {{blurb}} - **Review Snippets:** {{reviews}} - **Author Bio:** {{author_bio}} @@ -157,20 +194,25 @@ template: ... # ------------------------------------------------------------ + # checklists/kdp-cover-ready-checklist.md + # ------------------------------------------------------------ + --- + checklist: - id: kdp-cover-ready-checklist - name: KDP Cover Ready Checklist - description: Ensure final cover meets Amazon KDP print specs. +id: kdp-cover-ready-checklist +name: KDP Cover Ready Checklist +description: Ensure final cover meets Amazon KDP print specs. items: - - "[ ] Correct trim size & bleed margins applied" - - "[ ] 300 DPI images" - - "[ ] CMYK color profile for print PDF" - - "[ ] Spine text ≥ 0.0625" away from edges" - - "[ ] Barcode zone clear of critical art" - - "[ ] No transparent layers" - - "[ ] File size < 40MB PDF" - - "[ ] Front & back text legible at thumbnail size" -... + +- "[ ] Correct trim size & bleed margins applied" +- "[ ] 300 DPI images" +- "[ ] CMYK color profile for print PDF" +- "[ ] Spine text ≥ 0.0625" away from edges" +- "[ ] Barcode zone clear of critical art" +- "[ ] No transparent layers" +- "[ ] File size < 40MB PDF" +- "[ ] Front & back text legible at thumbnail size" + ... diff --git a/expansion-packs/bmad-creative-writing/workflows/novel-greenfield-workflow.yaml b/expansion-packs/bmad-creative-writing/workflows/novel-greenfield-workflow.yaml index 419fbe32..bb1c4310 100644 --- a/expansion-packs/bmad-creative-writing/workflows/novel-greenfield-workflow.yaml +++ b/expansion-packs/bmad-creative-writing/workflows/novel-greenfield-workflow.yaml @@ -1,4 +1,4 @@ ---- +# workflow: id: novel-greenfield-workflow name: Greenfield Novel Workflow @@ -54,5 +54,3 @@ workflow: output: critic-review.md completion_criteria: - critic-review.md exists -... - diff --git a/expansion-packs/bmad-creative-writing/workflows/novel-serial-workflow.yaml b/expansion-packs/bmad-creative-writing/workflows/novel-serial-workflow.yaml index ac63bde5..96fe2c1e 100644 --- a/expansion-packs/bmad-creative-writing/workflows/novel-serial-workflow.yaml +++ b/expansion-packs/bmad-creative-writing/workflows/novel-serial-workflow.yaml @@ -1,3 +1,4 @@ +# --- workflow: id: novel-serial-workflow @@ -47,5 +48,3 @@ workflow: completion_criteria: - publication-log.md exists - critic-review.md exists -... - diff --git a/expansion-packs/bmad-creative-writing/workflows/novel-snowflake-workflow.yaml b/expansion-packs/bmad-creative-writing/workflows/novel-snowflake-workflow.yaml index 383803da..65f5ae48 100644 --- a/expansion-packs/bmad-creative-writing/workflows/novel-snowflake-workflow.yaml +++ b/expansion-packs/bmad-creative-writing/workflows/novel-snowflake-workflow.yaml @@ -1,3 +1,4 @@ +# --- workflow: id: novel-snowflake-workflow @@ -65,5 +66,4 @@ workflow: output: critic-review.md completion_criteria: - critic-review.md exists -... - +# end diff --git a/expansion-packs/bmad-creative-writing/workflows/novel-writing.yaml b/expansion-packs/bmad-creative-writing/workflows/novel-writing.yaml index d067eae4..6be6d77e 100644 --- a/expansion-packs/bmad-creative-writing/workflows/novel-writing.yaml +++ b/expansion-packs/bmad-creative-writing/workflows/novel-writing.yaml @@ -1,10 +1,10 @@ ---- +# # workflows/novel-writing.yaml name: novel-writing title: Novel Writing Workflow description: | End‑to‑end pipeline for drafting, revising, and polishing a full‑length novel - using the BMAD Creative Writing team. + using the BMAD™ Creative Writing team. triggers: - command: /novel @@ -89,4 +89,3 @@ steps: outputs: - final_manuscript - diff --git a/expansion-packs/bmad-creative-writing/workflows/screenplay-development.yaml b/expansion-packs/bmad-creative-writing/workflows/screenplay-development.yaml index 889dc734..4596e5ec 100644 --- a/expansion-packs/bmad-creative-writing/workflows/screenplay-development.yaml +++ b/expansion-packs/bmad-creative-writing/workflows/screenplay-development.yaml @@ -1,4 +1,4 @@ ---- +# # workflows/screenplay-development.yaml name: screenplay-development title: Screenplay Development Workflow @@ -83,4 +83,3 @@ steps: outputs: - final_screenplay - diff --git a/expansion-packs/bmad-creative-writing/workflows/series-planning.yaml b/expansion-packs/bmad-creative-writing/workflows/series-planning.yaml index 0436f6d4..b842979f 100644 --- a/expansion-packs/bmad-creative-writing/workflows/series-planning.yaml +++ b/expansion-packs/bmad-creative-writing/workflows/series-planning.yaml @@ -1,4 +1,4 @@ ---- +# # workflows/series-planning.yaml name: series-planning title: Series Planning Workflow @@ -76,4 +76,3 @@ steps: outputs: - final_series_plan - diff --git a/expansion-packs/bmad-creative-writing/workflows/short-story-creation.yaml b/expansion-packs/bmad-creative-writing/workflows/short-story-creation.yaml index 5e2c2e74..aa127d8e 100644 --- a/expansion-packs/bmad-creative-writing/workflows/short-story-creation.yaml +++ b/expansion-packs/bmad-creative-writing/workflows/short-story-creation.yaml @@ -1,4 +1,4 @@ ---- +# # workflows/short-story-creation.yaml name: short-story-creation title: Short Story Creation Workflow @@ -62,4 +62,3 @@ steps: outputs: - final_story - diff --git a/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.md b/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.md index 5ce3dea1..1e3641ff 100644 --- a/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.md +++ b/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.md @@ -1,3 +1,5 @@ + + # infra-devops-platform ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below. diff --git a/expansion-packs/bmad-infrastructure-devops/checklists/infrastructure-checklist.md b/expansion-packs/bmad-infrastructure-devops/checklists/infrastructure-checklist.md index 076b3c93..8628e640 100644 --- a/expansion-packs/bmad-infrastructure-devops/checklists/infrastructure-checklist.md +++ b/expansion-packs/bmad-infrastructure-devops/checklists/infrastructure-checklist.md @@ -1,3 +1,5 @@ + + # Infrastructure Change Validation Checklist This checklist serves as a comprehensive framework for validating infrastructure changes before deployment to production. The DevOps/Platform Engineer should systematically work through each item, ensuring the infrastructure is secure, compliant, resilient, and properly implemented according to organizational standards. diff --git a/expansion-packs/bmad-infrastructure-devops/config.yaml b/expansion-packs/bmad-infrastructure-devops/config.yaml index 653c1a46..80ce7850 100644 --- a/expansion-packs/bmad-infrastructure-devops/config.yaml +++ b/expansion-packs/bmad-infrastructure-devops/config.yaml @@ -1,3 +1,4 @@ +# name: bmad-infrastructure-devops version: 1.12.0 short-title: Infrastructure DevOps Pack diff --git a/expansion-packs/bmad-infrastructure-devops/data/bmad-kb.md b/expansion-packs/bmad-infrastructure-devops/data/bmad-kb.md index 0e704751..601e047a 100644 --- a/expansion-packs/bmad-infrastructure-devops/data/bmad-kb.md +++ b/expansion-packs/bmad-infrastructure-devops/data/bmad-kb.md @@ -1,3 +1,5 @@ + + # BMad Infrastructure DevOps Expansion Pack Knowledge Base ## Overview diff --git a/expansion-packs/bmad-infrastructure-devops/tasks/review-infrastructure.md b/expansion-packs/bmad-infrastructure-devops/tasks/review-infrastructure.md index 773ef025..465a7e77 100644 --- a/expansion-packs/bmad-infrastructure-devops/tasks/review-infrastructure.md +++ b/expansion-packs/bmad-infrastructure-devops/tasks/review-infrastructure.md @@ -1,3 +1,5 @@ + + # Infrastructure Review Task ## Purpose diff --git a/expansion-packs/bmad-infrastructure-devops/tasks/validate-infrastructure.md b/expansion-packs/bmad-infrastructure-devops/tasks/validate-infrastructure.md index 80091246..a9d2172b 100644 --- a/expansion-packs/bmad-infrastructure-devops/tasks/validate-infrastructure.md +++ b/expansion-packs/bmad-infrastructure-devops/tasks/validate-infrastructure.md @@ -1,3 +1,5 @@ + + # Infrastructure Validation Task ## Purpose diff --git a/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-architecture-tmpl.yaml b/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-architecture-tmpl.yaml index 87426507..d436d0fc 100644 --- a/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-architecture-tmpl.yaml +++ b/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-architecture-tmpl.yaml @@ -1,3 +1,4 @@ +# template: id: infrastructure-architecture-template-v2 name: Infrastructure Architecture diff --git a/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-platform-from-arch-tmpl.yaml b/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-platform-from-arch-tmpl.yaml index 58fd57f5..29d80d0b 100644 --- a/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-platform-from-arch-tmpl.yaml +++ b/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-platform-from-arch-tmpl.yaml @@ -1,3 +1,4 @@ +# template: id: infrastructure-platform-template-v2 name: Platform Infrastructure Implementation diff --git a/package.json b/package.json index 20e0a640..6797afc2 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "$schema": "https://json.schemastore.org/package.json", "name": "bmad-method", - "version": "4.39.0", + "version": "4.39.1", "description": "Breakthrough Method of Agile AI-driven Development", "keywords": [ "agile", diff --git a/tools/cli.js b/tools/cli.js index 0965b9a9..5014cf06 100644 --- a/tools/cli.js +++ b/tools/cli.js @@ -8,7 +8,7 @@ const program = new Command(); program .name('bmad-build') - .description('BMad-Method build tool for creating web bundles') + .description('BMAD-METHOD™ build tool for creating web bundles') .version('4.0.0'); program @@ -136,7 +136,7 @@ program program .command('upgrade') - .description('Upgrade a BMad-Method V3 project to V4') + .description('Upgrade a BMAD-METHOD™ V3 project to V4') .option('-p, --project ', 'Path to V3 project (defaults to current directory)') .option('--dry-run', 'Show what would be changed without making changes') .option('--no-backup', 'Skip creating backup (not recommended)') diff --git a/tools/flattener/main.js b/tools/flattener/main.js index a5e2a0e2..50a831bf 100644 --- a/tools/flattener/main.js +++ b/tools/flattener/main.js @@ -68,7 +68,7 @@ const program = new Command(); program .name('bmad-flatten') - .description('BMad-Method codebase flattener tool') + .description('BMAD-METHOD™ codebase flattener tool') .version('1.0.0') .option('-i, --input ', 'Input directory to flatten', process.cwd()) .option('-o, --output ', 'Output file path', 'flattened-codebase.xml') diff --git a/tools/installer/bin/bmad.js b/tools/installer/bin/bmad.js index ed20bdf2..b8272c14 100755 --- a/tools/installer/bin/bmad.js +++ b/tools/installer/bin/bmad.js @@ -216,7 +216,7 @@ async function promptInstallation() { type: 'input', name: 'directory', message: 'Enter the full path to your project directory where BMad should be installed:', - default: process.cwd(), + default: path.resolve('.'), validate: (input) => { if (!input.trim()) { return 'Please enter a valid project path'; diff --git a/tools/installer/config/install.config.yaml b/tools/installer/config/install.config.yaml index b2176a96..43013550 100644 --- a/tools/installer/config/install.config.yaml +++ b/tools/installer/config/install.config.yaml @@ -105,7 +105,7 @@ ide-configurations: format: custom-modes file: .kilocodemodes instructions: | - # To use BMAD agents in Kilo Code: + # To use BMAD™ agents in Kilo Code: # 1. Open the mode selector in VSCode # 2. Select a bmad-{agent} mode (e.g. "bmad-dev") # 3. The AI adopts that agent's persona and capabilities diff --git a/tools/installer/package.json b/tools/installer/package.json index f538ca10..fd5da503 100644 --- a/tools/installer/package.json +++ b/tools/installer/package.json @@ -1,6 +1,6 @@ { "name": "bmad-method", - "version": "5.1.3", + "version": "4.39.1", "description": "BMad Method installer - AI-powered Agile development framework", "keywords": [ "bmad", diff --git a/tools/shared/bannerArt.js b/tools/shared/bannerArt.js index 0ab7017c..afffb1a1 100644 --- a/tools/shared/bannerArt.js +++ b/tools/shared/bannerArt.js @@ -1,6 +1,6 @@ // ASCII banner art definitions extracted from banners.js to separate art from logic -const BMAD_TITLE = 'BMAD-METHOD'; +const BMAD_TITLE = 'BMAD-METHOD™'; const FLATTENER_TITLE = 'FLATTENER'; const INSTALLER_TITLE = 'INSTALLER'; @@ -65,7 +65,7 @@ const INSTALLER_MEDIUM = ` // Width: 30 columns total (28 inner) const BMAD_SMALL = ` ╭──────────────────────────╮ -│ BMAD-METHOD │ +│ BMAD-METHOD™ │ ╰──────────────────────────╯ `; @@ -82,7 +82,7 @@ const INSTALLER_SMALL = ` `; // Tiny (compact brackets) -const BMAD_TINY = `[ BMAD-METHOD ]`; +const BMAD_TINY = `[ BMAD-METHOD™ ]`; const FLATTENER_TINY = `[ FLATTENER ]`; const INSTALLER_TINY = `[ INSTALLER ]`; diff --git a/sync-version.sh b/tools/sync-version.sh similarity index 100% rename from sync-version.sh rename to tools/sync-version.sh