bmad-method 6.0.0-alpha.0 → 6.0.0-alpha.1

package/.claude/settings.local.json

@@ -0,0 +1,41 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npm run lint:*)",
+      "Bash(node -e:*)",
+      "Bash(mkdir:*)",
+      "WebSearch",
+      "WebFetch(domain:microsoft.github.io)",
+      "WebFetch(domain:github.com)",
+      "Bash(chmod:*)",
+      "Bash(node tools/format-workflow-md.js:*)",
+      "Bash(cat:*)",
+      "Bash(find:*)",
+      "Bash(wc:*)",
+      "Bash(do gh issue delete $issue --yes)",
+      "Bash(done)",
+      "Bash(git branch:*)",
+      "Bash(git push:*)",
+      "Bash(git fetch:*)",
+      "Bash(git log:*)",
+      "Bash(npm run lint:fix:*)",
+      "Bash(git ls-tree:*)",
+      "Bash(node:*)",
+      "Read(//private/tmp/**)",
+      "Bash(bmad --version:*)",
+      "Bash(bmad-method:*)",
+      "Bash(npm pack)",
+      "Bash(npx:*)",
+      "Bash(timeout 3 npx:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(.claude/hooks/play-tts.sh:*)",
+      "Bash(while read file)",
+      "Bash(do echo \"=== $file ===\")"
+    ],
+    "deny": [],
+    "ask": []
+  },
+  "outputStyle": "default",
+  "spinnerTipsEnabled": false
+}

package/.github/ISSUE_TEMPLATE/config.yaml

@@ -1 +1,5 @@
 blank_issues_enabled: false
+contact_links:
+  - name: Discord Community Support
+    url: https://discord.gg/gk8jAdXWmj
+    about: Please join our Discord server for general questions and community discussion before opening an issue.

package/.github/ISSUE_TEMPLATE/idea_submission.md

@@ -1,6 +1,6 @@
 ---
-name: V5 Idea Submission
-about: Suggest an idea for v5
+name: V6 Idea Submission
+about: Suggest an idea for v6
 title: ''
 labels: ''
 assignees: ''

package/.github/workflows/{format-check.yaml → lint.yaml}

@@ -1,4 +1,4 @@
-name: format-check
+name: lint
 
 "on":
   pull_request:
@@ -41,3 +41,21 @@ jobs:
 
       - name: ESLint
         run: npm run lint
+
+  schema-validation:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: ".nvmrc"
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Validate YAML schemas
+        run: npm run validate:schemas

package/.prettierignore

@@ -0,0 +1,2 @@
+# Test fixtures with intentionally broken/malformed files
+test/fixtures/**

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [Unreleased]
+
+### Codex Installer
+
+- Codex installer uses custom prompts in `.codex/prompts/`, instead of `AGENTS.md`
+
 ## [6.0.0-alpha.0]
 
 **Release: September 28, 2025**
@@ -10,10 +16,10 @@ Initial alpha release of a major rewrite and overhaul improvement of past versio
 
 - **Lean Core**: The core of BMad is very simple - common tasks that apply to any future module or agents, along with common agents that will be added to any modules - bmad-web-orchestrator and bmad-master.
 - **BMad Method**: The new BMad Method (AKA bmm) is a complete overhaul of the v4 method, now a fully scale adaptive rewrite. The workflow now scales from small enhancements to massive undertakings across multiple services or architectures, supporting a new vast array of project type, including a full subclass of game development specifics.
-- **BoMB**: The BMad Builder (AKA BoMB) now is able to fully automate creation and conversion of expansion packs from v5 to modules in v5 along with the net new ideation and brainstorming through implementation and testing of net new Modules, Workflows (were tasks and templates), Module Agents, and Standalone Personal Agents
+- **BoMB**: The BMad Builder (AKA BoMB) now is able to fully automate creation and conversion of expansion packs from v6 to modules in v6 along with the net new ideation and brainstorming through implementation and testing of net new Modules, Workflows (were tasks and templates), Module Agents, and Standalone Personal Agents
 - **CIS**: The Creative Intelligence Suite (AKA CIS)
 
-## [v5.0.0] - SKIPPED
+## [v6.0.0] - SKIPPED
 
 **Note**: Version 5.0.0 was skipped due to NPX registry issues that corrupted the version. Development continues with v6.0.0-alpha.0.
 

package/CONTRIBUTING.md

@@ -256,6 +256,7 @@ Each commit should represent one logical change:
 - Web/planning agents can be larger with more complex tasks
 - Everything is natural language (markdown) - no code in core framework
 - Use bmad modules for domain-specific features
+- Validate YAML schemas with `npm run validate:schemas` before committing
 
 ## Code of Conduct
 

package/README.md

@@ -0,0 +1,261 @@
+# 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)
+
+**The Universal Human-AI Collaboration Platform**
+
+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.
+
+**🎯 Human Amplification, Not Replacement** • **🎨 Works in Any Domain** • **⚡ Powered by Specialized Agents**
+
+---
+
+## 🔄 Upgrading from v4?
+
+**[→ v4 to v6 Upgrade Guide](./docs/v4-to-v6-upgrade.md)** - Complete migration instructions for existing v4 users
+
+---
+
+## What is BMad-CORE?
+
+BMad-CORE is the **universal foundation** that powers all BMad modules. It provides:
+
+- **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
+
+### Core v6 Framework Enhancements
+
+**All modules benefit from these new core capabilities:**
+
+- **🎨 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
+
+### The C.O.R.E. Philosophy
+
+- **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
+
+Instead of giving you answers, BMad-CORE helps you **discover better solutions** through strategic questioning, expert guidance, and structured thinking.
+
+---
+
+## The BMad Method - Agile AI-Driven Development
+
+**The flagship module for software and game development excellence.**
+
+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
+
+### **[BMad Builder (BMB)](./src/modules/bmb/README.md)** - Create Custom Solutions
+
+Build your own agents, workflows, and modules using the BMad-CORE framework.
+
+- **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
+
+### Prerequisites
+
+- **Node.js v20+** ([Download](https://nodejs.org))
+
+### Installation
+
+Install BMad to your project using npx:
+
+```bash
+npx bmad-method install
+```
+
+> **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:
+
+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
+
+### What Gets Installed
+
+All modules install to a single `bmad/` folder in your project:
+
+```
+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
+```
+
+### Getting Started with BMM
+
+After installation, activate the Analyst agent in your IDE and run:
+
+```bash
+/workflow-init
+```
+
+Or run it directly as a command (command syntax varies by IDE - use slash commands in Claude Code, OpenCode, etc.).
+
+This sets up the guided workflow system and helps you choose the right starting point for your project based on its complexity.
+
+---
+
+## Key Features
+
+### 🎨 Update-Safe Customization
+
+- **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
+
+### 🚀 Intelligent Installation
+
+The installer automatically:
+
+- Detects and migrates v4 installations
+- Configures IDE integrations
+- Resolves module dependencies
+- Sets up agent customization templates
+- Creates unified agent manifests
+
+### 📁 Unified Architecture
+
+Everything in one place - no more scattered configuration folders. Clean, organized, maintainable.
+
+---
+
+## Additional Documentation
+
+- **[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
+
+---
+
+## Community & 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
+
+---
+
+## Contributing
+
+We welcome contributions! See **[CONTRIBUTING.md](CONTRIBUTING.md)** for guidelines.
+
+---
+
+## License
+
+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=bmad-code-org/BMAD-METHOD)](https://github.com/bmad-code-org/BMAD-METHOD/graphs/contributors)
+
+<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