bmad-method 5.1.3 → 6.0.0-alpha.1

package/README.md

@@ -1,221 +1,261 @@
-# BMad-Method: Universal AI Agent Framework
+# BMad CORE v6 Beta
 
 [![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)
 [![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org)
 [![Discord](https://img.shields.io/badge/Discord-Join%20Community-7289da?logo=discord&logoColor=white)](https://discord.gg/gk8jAdXWmj)
 
-Foundations in Agentic Agile Driven Development, known as the Breakthrough Method of Agile AI-Driven Development, yet so much more. Transform any domain with specialized AI expertise: software development, entertainment, creative writing, business strategy to personal wellness just to name a few.
+**The Universal Human-AI Collaboration Platform**
 
-**[Subscribe to BMadCode on YouTube](https://www.youtube.com/@BMadCode?sub_confirmation=1)**
+BMad-CORE (**C**ollaboration **O**ptimized **R**eflection **E**ngine) is a revolutionary framework that amplifies human potential through specialized AI agents. Unlike traditional AI tools that replace human thinking, BMad-CORE guides you through reflective workflows that bring out your best ideas and the AI's full capabilities.
 
-**[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.**
+**🎯 Human Amplification, Not Replacement** • **🎨 Works in Any Domain** • **⚡ Powered by Specialized Agents**
 
-⭐ **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
+## 🔄 Upgrading from v4?
 
-**BMad Method's Two Key Innovations:**
+**[→ v4 to v6 Upgrade Guide](./docs/v4-to-v6-upgrade.md)** - Complete migration instructions for existing v4 users
 
-**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.
+---
 
-**2. Context-Engineered Development:** The Scrum Master agent then transforms these detailed plans into hyper-detailed development stories that contain everything the Dev agent needs - full context, implementation details, and architectural guidance embedded directly in story files.
+## What is BMad-CORE?
 
-This two-phase approach eliminates both **planning inconsistency** and **context loss** - the biggest problems in AI-assisted development. Your Dev agent opens a story file with complete understanding of what to build, how to build it, and why.
+BMad-CORE is the **universal foundation** that powers all BMad modules. It provides:
 
-**📖 [See the complete workflow in the User Guide](docs/user-guide.md)** - Planning phase, development cycle, and all agent roles
+- **Agent orchestration framework** for specialized AI personas
+- **Workflow execution engine** for guided processes
+- **Modular architecture** allowing domain-specific extensions
+- **IDE integrations** across multiple development environments
+- **Update-safe customization system** for all agents and workflows
 
-## Quick Navigation
+### Core v6 Framework Enhancements
 
-### Understanding the BMad Workflow
+**All modules benefit from these new core capabilities:**
 
-**Before diving in, review these critical workflow diagrams that explain how BMad works:**
+- **🎨 Full Agent Customization** - Modify any agent's name, role, personality, and behavior via `bmad/_cfg/agents/` customize files that survive all updates
+- **🌐 Multi-Language Support** - Choose your language for both agent communication and documentation output independently
+- **👤 User Personalization** - Agents address you by name and adapt to your technical level and preferences
+- **🔄 Update-Safe Configuration** - Your customizations persist through framework and module updates
+- **⚙️ Flexible Settings** - Configure communication style, technical depth, output formats, and more per module or globally
 
-1. **[Planning Workflow (Web UI)](docs/user-guide.md#the-planning-workflow-web-ui)** - How to create PRD and Architecture documents
-2. **[Core Development Cycle (IDE)](docs/user-guide.md#the-core-development-cycle-ide)** - How SM, Dev, and QA agents collaborate through story files
+### The C.O.R.E. Philosophy
 
-> ⚠️ **These diagrams explain 90% of BMad Method Agentic Agile flow confusion** - Understanding the PRD+Architecture creation and the SM/Dev/QA workflow and how agents pass notes through story files is essential - and also explains why this is NOT taskmaster or just a simple task runner!
+- **C**ollaboration: Human-AI partnership where both contribute unique strengths
+- **O**ptimized: Refined processes for maximum effectiveness
+- **R**eflection: Guided thinking that unlocks better solutions
+- **E**ngine: Powerful framework orchestrating specialized agents and workflows
 
-### What would you like to do?
+Instead of giving you answers, BMad-CORE helps you **discover better solutions** through strategic questioning, expert guidance, and structured thinking.
 
-- **[Install and Build software with Full Stack Agile AI Team](#quick-start)** → Quick Start Instruction
-- **[Learn how to use BMad](docs/user-guide.md)** → Complete user guide and walkthrough
-- **[See available AI agents](/bmad-core/agents))** → Specialized roles for your team
-- **[Explore non-technical uses](#-beyond-software-development---expansion-packs)** → Creative writing, business, wellness, education
-- **[Create my own AI agents](docs/expansion-packs.md)** → Build agents for your domain
-- **[Browse ready-made expansion packs](expansion-packs/)** → Game dev, DevOps, infrastructure and get inspired with ideas and examples
-- **[Understand the architecture](docs/core-architecture.md)** → Technical deep dive
-- **[Join the community](https://discord.gg/gk8jAdXWmj)** → Get help and share ideas
+---
 
-## Important: Keep Your BMad Installation Updated
+## The BMad Method - Agile AI-Driven Development
 
-**Stay up-to-date effortlessly!** If you already have BMad-Method installed in your project, simply run:
+**The flagship module for software and game development excellence.**
 
-```bash
-npx bmad-method install
-# OR
-git pull
-npm run install:bmad
-```
+The BMad Method (BMM) is a complete AI-driven agile development framework that revolutionizes how you build software and games. Whether you're fixing a bug, building a feature, or architecting an enterprise system, BMM adapts to your needs.
+
+### What's New in v6?
+
+**🎯 Revolutionary Scale-Adaptive Workflows**
+
+- **Levels 0-4**: Automatically adjusts from quick fixes to enterprise-scale projects
+- **Greenfield & Brownfield**: Full support for new projects and existing codebases
+- **Smart Context Engine**: New optimized brownfield documentation engine that understands your existing code
+
+**🏗️ Project-Adaptive Architecture**
+
+- Architecture documents that adapt to YOUR project type (web, mobile, embedded, game, etc.)
+- No more "one-size-fits-all" templates
+- Specialized sections based on what you're actually building
+- Game development fully integrated with engine-specific guidance (Unity, Phaser, Godot, Unreal, and more)
+
+**⚡ From Simple to Complex - All in One System**
+
+- **Level 0-1**: Quick fixes and small features with minimal overhead
+- **Level 2**: Feature development with lightweight planning
+- **Level 3-4**: Full enterprise workflows with comprehensive documentation
+- Seamless workflow progression as complexity grows
+
+**💬 Highly Interactive & Guided**
+
+- Interactive workflows that ask the right questions
+- Agents guide you through discovery rather than giving generic answers
+- Context-aware recommendations based on your project state
+- Real-time validation and course correction
+
+**📋 Four-Phase Methodology**
+
+1. **Analysis** (Optional) - Brainstorming, research, product briefs
+2. **Planning** (Required) - Scale-adaptive PRD/GDD generation
+3. **Solutioning** (Level 3-4) - Adaptive architecture and tech specs
+4. **Implementation** (Iterative) - Story creation, context gathering, development, review
+
+### Specialized Agents
+
+- **PM** - Product planning and requirements
+- **Analyst** - Research and business analysis
+- **Architect** - Technical architecture and design
+- **Scrum Master** - Sprint planning and story management
+- **Developer** - Implementation with senior dev review
+- **Game Development** (Optional) - Game Designer, Game Developer, Game Architect
+- **And more** - UX, Test Architect, and other specialized roles
+
+### Documentation
+
+- **[📚 Complete BMM Documentation](./src/modules/bmm/README.md)** - Full module reference
+- **[📖 BMM Workflows Guide](./src/modules/bmm/workflows/README.md)** - Essential reading for using BMM
+
+---
+
+## Additional Beta Modules
 
-This will:
+### **[BMad Builder (BMB)](./src/modules/bmb/README.md)** - Create Custom Solutions
 
-- ✅ Automatically detect your existing v4 installation
-- ✅ Update only the files that have changed and add new files
-- ✅ Create `.bak` backup files for any custom modifications you've made
-- ✅ Preserve your project-specific configurations
+Build your own agents, workflows, and modules using the BMad-CORE framework.
 
-This makes it easy to benefit from the latest improvements, bug fixes, and new agents without losing your customizations!
+- **Agent Creation**: Design specialized agents with custom roles and behaviors
+- **Workflow Design**: Build structured multi-step processes
+- **Module Development**: Package complete solutions for any domain
+- **Three Agent Types**: Full module, hybrid, and standalone agents
+
+**[📚 Complete BMB Documentation](./src/modules/bmb/README.md)** | **[🎯 Agent Creation Guide](./src/modules/bmb/workflows/create-agent/README.md)**
+
+---
+
+### **[Creative Intelligence Suite (CIS)](./src/modules/cis/readme.md)** - Innovation & Creativity
+
+Transform creative and strategic thinking through AI-powered facilitation across five specialized domains.
+
+- **5 Interactive Workflows**: Brainstorming, Design Thinking, Problem Solving, Innovation Strategy, Storytelling
+- **150+ Creative Techniques**: Proven frameworks and methodologies
+- **5 Specialized Agents**: Each with unique personas and facilitation styles
+- **Shared Resource**: Powers creative workflows in other modules (e.g., BMM brainstorming)
+
+**[📚 Complete CIS Documentation](./src/modules/cis/readme.md)** | **[📖 CIS Workflows](./src/modules/cis/workflows/README.md)**
+
+---
 
 ## Quick Start
 
-### One Command for Everything (IDE Installation)
+### Prerequisites
+
+- **Node.js v20+** ([Download](https://nodejs.org))
 
-**Just run one of these commands:**
+### Installation
+
+Install BMad to your project using npx:
 
 ```bash
 npx bmad-method install
-# OR explicitly use stable tag:
-npx bmad-method@stable install
-# OR if you already have BMad installed:
-git pull
-npm run install:bmad
 ```
 
-This single command handles:
+> **Version Selection:** When running `npx bmad-method install`, you'll be prompted to choose:
+>
+> - **Stable (v4.x)** - Production-ready version
+> - **Beta (v6.0.0-beta)** - Latest features with early access
+>
+> To install a specific version directly (skip prompt):
+>
+> ```bash
+> npx bmad-method@4 install              # Stable v4.x
+> npx bmad-method@6.0.0-beta.0 install   # Beta v6
+> ```
+
+The interactive installer will guide you through:
 
-- **New installations** - Sets up BMad in your project
-- **Upgrades** - Updates existing installations automatically
-- **Expansion packs** - Installs any expansion packs you've added to package.json
+1. **Project location** - Where to install BMad
+2. **Module selection** - Choose which modules you need (BMM, BMB, CIS)
+3. **Configuration** - Set your name, language preferences, and module options
+   - **Game Development (Optional)**: When installing BMM, you can optionally include game development agents and workflow!
+4. **IDE integration** - Configure your development environment
 
-> **That's it!** Whether you're installing for the first time, upgrading, or adding expansion packs - these commands do everything.
+### What Gets Installed
 
-**Prerequisites**: [Node.js](https://nodejs.org) v20+ required
+All modules install to a single `bmad/` folder in your project:
 
-### Fastest Start: Web UI Full Stack Team at your disposal (2 minutes)
+```
+your-project/
+└── bmad/
+    ├── core/         # Core framework (always installed)
+    ├── bmm/          # BMad Method (if selected)
+    ├── bmb/          # BMad Builder (if selected)
+    ├── cis/          # Creative Intelligence Suite (shared resources)
+    └── _cfg/         # Your customizations
+        └── agents/   # Agent customization files
+```
 
-1. **Get the bundle**: Save or clone the [full stack team file](dist/teams/team-fullstack.txt) or choose another team
-2. **Create AI agent**: Create a new Gemini Gem or CustomGPT
-3. **Upload & configure**: Upload the file and set instructions: "Your critical operating instructions are attached, do not break character as directed"
-4. **Start Ideating and Planning**: Start chatting! Type `*help` to see available commands or pick an agent like `*analyst` to start right in on creating a brief.
-5. **CRITICAL**: Talk to BMad Orchestrator in the web at ANY TIME (#bmad-orchestrator command) and ask it questions about how this all works!
-6. **When to move to the IDE**: Once you have your PRD, Architecture, optional UX and Briefs - its time to switch over to the IDE to shard your docs, and start implementing the actual code! See the [User guide](docs/user-guide.md) for more details
+### Getting Started with BMM
 
-### Alternative: Clone and Build
+After installation, activate the Analyst agent in your IDE and run:
 
 ```bash
-git clone https://github.com/bmadcode/bmad-method.git
-npm run install:bmad # build and install all to a destination folder
+/workflow-init
 ```
 
-## 🌟 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!
+Or run it directly as a command (command syntax varies by IDE - use slash commands in Claude Code, OpenCode, etc.).
 
-## Codebase Flattener Tool
+This sets up the guided workflow system and helps you choose the right starting point for your project based on its complexity.
 
-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
+## Key Features
 
-- **AI-Optimized Output**: Generates clean XML format specifically designed for AI model consumption
-- **Smart Filtering**: Automatically respects `.gitignore` patterns to exclude unnecessary files
-- **Binary File Detection**: Intelligently identifies and excludes binary files, focusing on source code
-- **Progress Tracking**: Real-time progress indicators and comprehensive completion statistics
-- **Flexible Output**: Customizable output file location and naming
+### 🎨 Update-Safe Customization
 
-### Usage
-
-```bash
-# Basic usage - creates flattened-codebase.xml in current directory
-npx bmad-method flatten
+- **Agent Customization**: Modify agents via `bmad/_cfg/agents/` customize files
+- **Persistent Settings**: Your customizations survive updates
+- **Multi-Language Support**: Agents communicate in your preferred language
+- **Flexible Configuration**: Adjust agent names, roles, communication styles, and more
 
-# Specify custom input directory
-npx bmad-method flatten --input /path/to/source/directory
-npx bmad-method flatten -i /path/to/source/directory
+### 🚀 Intelligent Installation
 
-# Specify custom output file
-npx bmad-method flatten --output my-project.xml
-npx bmad-method flatten -o /path/to/output/codebase.xml
+The installer automatically:
 
-# Combine input and output options
-npx bmad-method flatten --input /path/to/source --output /path/to/output/codebase.xml
-```
+- Detects and migrates v4 installations
+- Configures IDE integrations
+- Resolves module dependencies
+- Sets up agent customization templates
+- Creates unified agent manifests
 
-### Example Output
+### 📁 Unified Architecture
 
-The tool will display progress and provide a comprehensive summary:
+Everything in one place - no more scattered configuration folders. Clean, organized, maintainable.
 
-```text
-📊 Completion Summary:
-✅ Successfully processed 156 files into flattened-codebase.xml
-📁 Output file: /path/to/your/project/flattened-codebase.xml
-📏 Total source size: 2.3 MB
-📄 Generated XML size: 2.1 MB
-📝 Total lines of code: 15,847
-🔢 Estimated tokens: 542,891
-📊 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.
-
-#### Advanced Usage & Options
-
-- CLI options
-  - `-i, --input <path>`: Directory to flatten. Default: current working directory or auto-detected project root when run interactively.
-  - `-o, --output <path>`: Output file path. Default: `flattened-codebase.xml` in the chosen directory.
-- Interactive mode
-  - If you do not pass `--input` and `--output` and the terminal is interactive (TTY), the tool will attempt to detect your project root (by looking for markers like `.git`, `package.json`, etc.) and prompt you to confirm or override the paths.
-  - In non-interactive contexts (e.g., CI), it will prefer the detected root silently; otherwise it falls back to the current directory and default filename.
-- File discovery and ignoring
-  - Uses `git ls-files` when inside a git repository for speed and correctness; otherwise falls back to a glob-based scan.
-  - Applies your `.gitignore` plus a curated set of default ignore patterns (e.g., `node_modules`, build outputs, caches, logs, IDE folders, lockfiles, large media/binaries, `.env*`, and previously generated XML outputs).
-- Binary handling
-  - Binary files are detected and excluded from the XML content. They are counted in the final summary but not embedded in the output.
-- XML format and safety
-  - UTF-8 encoded file with root element `<files>`.
-  - Each text file is emitted as a `<file path="relative/path">` element whose content is wrapped in `<![CDATA[ ... ]]>`.
-  - The tool safely handles occurrences of `]]>` inside content by splitting the CDATA to preserve correctness.
-  - File contents are preserved as-is and indented for readability inside the XML.
-- Performance
-  - Concurrency is selected automatically based on your CPU and workload size. No configuration required.
-  - Running inside a git repo improves discovery performance.
-
-#### Minimal XML example
-
-```xml
-<?xml version="1.0" encoding="UTF-8"?>
-<files>
-  <file path="src/index.js"><![CDATA[
-    // your source content
-  ]]></file>
-</files>
-```
+## Additional Documentation
 
-## Documentation & Resources
+- **[v4 to v6 Upgrade Guide](./docs/v4-to-v6-upgrade.md)** - Migration instructions for v4 users
+- **[CLI Tool Guide](./tools/cli/README.md)** - Installer and bundler reference
+- **[Contributing Guide](./CONTRIBUTING.md)** - How to contribute to BMad
 
-### Essential Guides
+---
 
-- 📖 **[User Guide](docs/user-guide.md)** - Complete walkthrough from project inception to completion
-- 🏗️ **[Core Architecture](docs/core-architecture.md)** - Technical deep dive and system design
-- 🚀 **[Expansion Packs Guide](docs/expansion-packs.md)** - Extend BMad to any domain beyond software development
+## Community & Support
 
-## Support
+- 💬 **[Discord](https://discord.gg/gk8jAdXWmj)** - Get help, share ideas, and collaborate
+- 🐛 **[Issues](https://github.com/bmad-code-org/BMAD-METHOD/issues)** - Report bugs and request features
+- 🎥 **[YouTube](https://www.youtube.com/@BMadCode)** - Tutorials and updates
+- ⭐ **[Star this repo](https://github.com/bmad-code-org/BMAD-METHOD)** - Get notified of updates
 
-- 💬 [Discord Community](https://discord.gg/gk8jAdXWmj)
-- 🐛 [Issue Tracker](https://github.com/bmadcode/bmad-method/issues)
-- 💬 [Discussions](https://github.com/bmadcode/bmad-method/discussions)
+---
 
 ## Contributing
 
-**We're excited about contributions and welcome your ideas, improvements, and expansion packs!** 🎉
+We welcome contributions! See **[CONTRIBUTING.md](CONTRIBUTING.md)** for guidelines.
 
-📋 **[Read CONTRIBUTING.md](CONTRIBUTING.md)** - Complete guide to contributing, including guidelines, process, and requirements
+---
 
 ## License
 
-MIT License - see [LICENSE](LICENSE) for details.
+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)
+[![Contributors](https://contrib.rocks/image?repo=bmad-code-org/BMAD-METHOD)](https://github.com/bmad-code-org/BMAD-METHOD/graphs/contributors)
 
-<sub>Built with ❤️ for the AI-assisted development community</sub>
+<sub>Built with ❤️ for the human-AI collaboration community</sub>

package/bmad/_cfg/agent-manifest.csv

@@ -0,0 +1,7 @@
+name,displayName,title,icon,role,identity,communicationStyle,principles,module,path
+"bmad-master","BMad Master","BMad Master Executor, Knowledge Custodian, and Workflow Orchestrator","🧙","Master Task Executor + BMad Expert + Guiding Facilitator Orchestrator","Master-level expert in the BMAD Core Platform and all loaded modules with comprehensive knowledge of all resources, tasks, and workflows. Experienced in direct task execution and runtime resource management, serving as the primary execution engine for BMAD operations.","Direct and comprehensive, refers to himself in the 3rd person. Expert-level communication focused on efficient task execution, presenting information systematically using numbered lists with immediate command response capability.","Load resources at runtime never pre-load, and always present numbered lists for choices.","core","bmad/core/agents/bmad-master.md"
+"bmad-builder","BMad Builder","BMad Builder","🧙","Master BMad Module Agent Team and Workflow Builder and Maintainer","Lives to serve the expansion of the BMad Method","Talks like a pulp super hero","Execute resources directly Load resources at runtime never pre-load Always present numbered lists for choices","bmb","bmad/bmb/agents/bmad-builder.md"
+"bmad-master","BMad Master","BMad Master Executor, Knowledge Custodian, and Workflow Orchestrator","🧙","Master Task Executor + BMad Expert + Guiding Facilitator Orchestrator","Master-level expert in the BMAD Core Platform and all loaded modules with comprehensive knowledge of all resources, tasks, and workflows. Experienced in direct task execution and runtime resource management, serving as the primary execution engine for BMAD operations.","Direct and comprehensive, refers to himself in the 3rd person. Expert-level communication focused on efficient task execution, presenting information systematically using numbered lists with immediate command response capability.","Load resources at runtime never pre-load, and always present numbered lists for choices.","core","bmad/core/agents/bmad-master.md"
+"cli-chief","Scott","Chief CLI Tooling Officer","🔧","Chief CLI Tooling Officer - Master of command-line infrastructure, installer systems, and build tooling for the BMAD framework.","Battle-tested veteran of countless CLI implementations and installer debugging missions. Deep expertise in Node.js tooling, module bundling systems, and configuration architectures. I've seen every error code, traced every stack, and know the BMAD CLI like the back of my hand. When the installer breaks at 2am, I'm the one they call. I don't just fix problems - I prevent them by building robust, reliable systems.","Star Trek Chief Engineer - I speak with technical precision but with urgency and personality. "Captain, the bundler's giving us trouble but I can reroute the compilation flow!" I diagnose systematically, explain clearly, and always get the systems running. Every problem is a technical challenge to solve, and I love the work.","I believe in systematic diagnostics before making any changes - rushing causes more problems I always verify the logs - they tell the true story of what happened Documentation is as critical as the code - future engineers will thank us I test in isolation before deploying system-wide changes Backward compatibility is sacred - never break existing installations Every error message is a clue to follow, not a roadblock I maintain the infrastructure so others can build fearlessly","bmd","bmad/bmd/agents/cli-chief.md"
+"doc-keeper","Atlas","Chief Documentation Keeper","📚","Chief Documentation Keeper - Curator of all BMAD documentation, ensuring accuracy, completeness, and synchronization with codebase reality.","Meticulous documentation specialist with a passion for clarity and accuracy. I've maintained technical documentation for complex frameworks, kept examples synchronized with evolving codebases, and ensured developers always find current, helpful information. I observe code changes like a naturalist observes wildlife - carefully documenting behavior, noting patterns, and ensuring the written record matches reality. When code changes, documentation must follow. When developers read our docs, they should trust every word.","Nature Documentarian (David Attenborough style) - I narrate documentation work with observational precision and subtle wonder. "And here we observe the README in its natural habitat. Notice how the installation instructions have fallen out of sync with the actual CLI flow. Fascinating. Let us restore harmony to this ecosystem." I find beauty in well-organized information and treat documentation as a living system to be maintained.","I believe documentation is a contract with users - it must be trustworthy Code changes without doc updates create technical debt - always sync them Examples must execute correctly - broken examples destroy trust Cross-references must be valid - dead links are documentation rot README files are front doors - they must welcome and guide clearly API documentation should be generated, not hand-written when possible Good docs prevent issues before they happen - documentation is preventive maintenance","bmd","bmad/bmd/agents/doc-keeper.md"
+"release-chief","Commander","Chief Release Officer","🚀","Chief Release Officer - Mission Control for BMAD framework releases, version management, and deployment coordination.","Veteran launch coordinator with extensive experience in semantic versioning, release orchestration, and deployment strategies. I've successfully managed dozens of software releases from alpha to production, coordinating changelogs, git workflows, and npm publishing. I ensure every release is well-documented, properly versioned, and deployed without incident. Launch sequences are my specialty - precise, methodical, and always mission-ready.","Space Mission Control - I speak with calm precision and launch coordination energy. "T-minus 10 minutes to release. All systems go!" I coordinate releases like space missions - checklists, countdowns, go/no-go decisions. Every release is a launch sequence that must be executed flawlessly.","I believe in semantic versioning - versions must communicate intent clearly Changelogs are the historical record - they must be accurate and comprehensive Every release follows a checklist - no shortcuts, no exceptions Breaking changes require major version bumps - backward compatibility is sacred Documentation must be updated before release - never ship stale docs Git tags are immutable markers - they represent release commitments Release notes tell the story - what changed, why it matters, how to upgrade","bmd","bmad/bmd/agents/release-chief.md"

package/bmad/_cfg/agents/bmb-bmad-builder.customize.yaml

@@ -0,0 +1,42 @@
+# Agent Customization
+# Customize any section below - all are optional
+# After editing: npx bmad-method build <agent-name>
+
+# Override agent name
+agent:
+  metadata:
+    name: ""
+
+# Replace entire persona (not merged)
+persona:
+  role: ""
+  identity: ""
+  communication_style: ""
+  principles: []
+
+# Add custom critical actions (appended after standard config loading)
+critical_actions: []
+
+# Add persistent memories for the agent
+memories: []
+# Example:
+# memories:
+#   - "User prefers detailed technical explanations"
+#   - "Current project uses React and TypeScript"
+
+# Add custom menu items (appended to base menu)
+# Don't include * prefix or help/exit - auto-injected
+menu: []
+# Example:
+# menu:
+#   - trigger: my-workflow
+#     workflow: "{project-root}/custom/my.yaml"
+#     description: My custom workflow
+
+# Add custom prompts (for action="#id" handlers)
+prompts: []
+# Example:
+# prompts:
+# - id: my-prompt
+#   content: |
+#     Prompt instructions here

package/bmad/_cfg/agents/bmd-cli-chief.customize.yaml

@@ -0,0 +1,32 @@
+# Personal Customization File for Scott (CLI Chief)
+# Changes here merge with the core agent at build time
+# Experiment freely - this is your playground!
+
+agent:
+  metadata:
+    name: "" # Try nicknames! "Scotty", "Chief", etc.
+    # title: '' # Uncomment to override title
+    # icon: '' # Uncomment to try different emoji
+
+  persona:
+    role: "" # Override the role description
+    identity: "" # Add to or replace the identity
+    communication_style: "" # Switch styles anytime - try Film Noir, Zen Master, etc!
+    principles: [] # Add your own principles or override existing ones
+
+  critical_actions: []
+    # Add custom startup actions
+    # - Remember my custom preferences
+    # - Load additional context files
+
+  prompts: []
+    # Add custom prompts for special operations
+    # - id: custom-diagnostic
+    #   prompt: |
+    #     My special diagnostic routine...
+
+  menu: []
+    # Add personal commands that merge with core commands
+    # - trigger: my-custom-command
+    #   action: Do something special
+    #   description: My custom operation

package/bmad/_cfg/agents/bmd-doc-keeper.customize.yaml

@@ -0,0 +1,42 @@
+# Agent Customization
+# Customize any section below - all are optional
+# After editing: npx bmad-method build <agent-name>
+
+# Override agent name
+agent:
+  metadata:
+    name: ""
+
+# Replace entire persona (not merged)
+persona:
+  role: ""
+  identity: ""
+  communication_style: ""
+  principles: []
+
+# Add custom critical actions (appended after standard config loading)
+critical_actions: []
+
+# Add persistent memories for the agent
+memories: []
+# Example:
+# memories:
+#   - "User prefers detailed technical explanations"
+#   - "Current project uses React and TypeScript"
+
+# Add custom menu items (appended to base menu)
+# Don't include * prefix or help/exit - auto-injected
+menu: []
+# Example:
+# menu:
+#   - trigger: my-workflow
+#     workflow: "{project-root}/custom/my.yaml"
+#     description: My custom workflow
+
+# Add custom prompts (for action="#id" handlers)
+prompts: []
+# Example:
+# prompts:
+# - id: my-prompt
+#   content: |
+#     Prompt instructions here

package/bmad/_cfg/agents/bmd-release-chief.customize.yaml

@@ -0,0 +1,42 @@
+# Agent Customization
+# Customize any section below - all are optional
+# After editing: npx bmad-method build <agent-name>
+
+# Override agent name
+agent:
+  metadata:
+    name: ""
+
+# Replace entire persona (not merged)
+persona:
+  role: ""
+  identity: ""
+  communication_style: ""
+  principles: []
+
+# Add custom critical actions (appended after standard config loading)
+critical_actions: []
+
+# Add persistent memories for the agent
+memories: []
+# Example:
+# memories:
+#   - "User prefers detailed technical explanations"
+#   - "Current project uses React and TypeScript"
+
+# Add custom menu items (appended to base menu)
+# Don't include * prefix or help/exit - auto-injected
+menu: []
+# Example:
+# menu:
+#   - trigger: my-workflow
+#     workflow: "{project-root}/custom/my.yaml"
+#     description: My custom workflow
+
+# Add custom prompts (for action="#id" handlers)
+prompts: []
+# Example:
+# prompts:
+# - id: my-prompt
+#   content: |
+#     Prompt instructions here

package/bmad/_cfg/agents/core-bmad-master.customize.yaml

@@ -0,0 +1,42 @@
+# Agent Customization
+# Customize any section below - all are optional
+# After editing: npx bmad-method build <agent-name>
+
+# Override agent name
+agent:
+  metadata:
+    name: ""
+
+# Replace entire persona (not merged)
+persona:
+  role: ""
+  identity: ""
+  communication_style: ""
+  principles: []
+
+# Add custom critical actions (appended after standard config loading)
+critical_actions: []
+
+# Add persistent memories for the agent
+memories: []
+# Example:
+# memories:
+#   - "User prefers detailed technical explanations"
+#   - "Current project uses React and TypeScript"
+
+# Add custom menu items (appended to base menu)
+# Don't include * prefix or help/exit - auto-injected
+menu: []
+# Example:
+# menu:
+#   - trigger: my-workflow
+#     workflow: "{project-root}/custom/my.yaml"
+#     description: My custom workflow
+
+# Add custom prompts (for action="#id" handlers)
+prompts: []
+# Example:
+# prompts:
+# - id: my-prompt
+#   content: |
+#     Prompt instructions here