docs updates
This commit is contained in:
Brian Madison
parent
ec111972a0
commit
663b76a072
340
README.md
340
README.md
|
|
@ -7,262 +7,202 @@
|
||||||
|
|
||||||
> **🚨 ALPHA VERSION DOCUMENTATION**
|
> **🚨 ALPHA VERSION DOCUMENTATION**
|
||||||
>
|
>
|
||||||
> This README documents **BMad v6 (Alpha)** - currently under active development.
|
> - **Install v6 Alpha:** `npx bmad-method@alpha install`
|
||||||
>
|
> - **Install stable v4:** `npx bmad-method install`
|
||||||
> **To install v6 Alpha:** `npx bmad-method@alpha install`
|
> - **[View v4 documentation](https://github.com/bmad-code-org/BMAD-METHOD/tree/V4)**
|
||||||
>
|
|
||||||
> **Looking for stable v4 documentation?** [View v4 README](https://github.com/bmad-code-org/BMAD-METHOD/tree/V4)
|
|
||||||
>
|
|
||||||
> **Want the stable version?** `npx bmad-method install` (installs v4.x)
|
|
||||||
|
|
||||||
## The Universal Human-AI Collaboration Platform
|
## 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.
|
BMad-CORE (**C**ollaboration **O**ptimized **R**eflection **E**ngine) amplifies human potential through specialized AI agents. Unlike tools that replace thinking, BMad-CORE guides reflective workflows that bring out your best ideas and AI's full capabilities.
|
||||||
|
|
||||||
**🎯 Human Amplification, Not Replacement** • **🎨 Works in Any Domain** • **⚡ Powered by Specialized Agents**
|
**🎯 Human Amplification** • **🎨 Domain Agnostic** • **⚡ Agent-Powered**
|
||||||
|
|
||||||
---
|
## Table of Contents
|
||||||
|
|
||||||
## 🚀 New to v6? Start Here!
|
- [Quick Start](#quick-start)
|
||||||
|
- [What is BMad-CORE?](#what-is-bmad-core)
|
||||||
**[→ BMad Method V6 Quick Start Guide](./docs/BMad-Method-V6-Quick-Start.md)** - **NEW!** Get up and running with v6 in minutes
|
- [Modules](#modules)
|
||||||
|
- [BMad Method (BMM)](#bmad-method-bmm---agile-ai-development)
|
||||||
Learn how to build your first greenfield project with BMad Method v6 using our brand new quick start guide!
|
- [BMad Builder (BMB)](#bmad-builder-bmb---create-custom-solutions)
|
||||||
|
- [Creative Intelligence Suite (CIS)](#creative-intelligence-suite-cis---innovation--creativity)
|
||||||
---
|
- [Installation](#installation)
|
||||||
|
- [Key Features](#key-features)
|
||||||
## 🔄 Upgrading from v4?
|
- [Documentation](#documentation)
|
||||||
|
- [Community & Support](#community--support)
|
||||||
**[→ 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
|
## Quick Start
|
||||||
|
|
||||||
### Prerequisites
|
- **New to v6?** [→ BMad Method V6 Quick Start Guide](./docs/BMad-Method-V6-Quick-Start.md)
|
||||||
|
- **Upgrading?** [→ v4 to v6 Upgrade Guide](./docs/v4-to-v6-upgrade.md)
|
||||||
|
|
||||||
- **Node.js v20+** ([Download](https://nodejs.org))
|
## What is BMad-CORE?
|
||||||
|
|
||||||
### Installation
|
Foundation framework powering all BMad modules:
|
||||||
|
|
||||||
Install BMad to your project using npx:
|
- **Agent Orchestration** - Specialized AI personas with unique capabilities
|
||||||
|
- **Workflow Engine** - Guided multi-step processes
|
||||||
|
- **Modular Architecture** - Domain-specific extensions
|
||||||
|
- **IDE Integration** - Works across development environments
|
||||||
|
- **Update-Safe Customization** - Persistent configuration through updates
|
||||||
|
|
||||||
|
### v6 Core Enhancements
|
||||||
|
|
||||||
|
- **🎨 Agent Customization** - Modify names, roles, personalities via `bmad/_cfg/agents/`
|
||||||
|
- **🌐 Multi-Language** - Independent language settings for communication and output
|
||||||
|
- **👤 Personalization** - Agents adapt to your name, technical level, preferences
|
||||||
|
- **🔄 Persistent Config** - Customizations survive all updates
|
||||||
|
- **⚙️ Flexible Settings** - Module or global configuration options
|
||||||
|
|
||||||
|
### C.O.R.E. Philosophy
|
||||||
|
|
||||||
|
- **C**ollaboration: Human-AI partnership leveraging unique strengths
|
||||||
|
- **O**ptimized: Refined processes for maximum effectiveness
|
||||||
|
- **R**eflection: Guided thinking unlocking better solutions
|
||||||
|
- **E**ngine: Framework orchestrating specialized agents and workflows
|
||||||
|
|
||||||
|
BMad-CORE helps you **discover better solutions** through strategic questioning and structured thinking.
|
||||||
|
|
||||||
|
## Modules
|
||||||
|
|
||||||
|
### BMad Method (BMM) - Agile AI Development
|
||||||
|
|
||||||
|
AI-driven agile framework revolutionizing software and game development. Adapts from bug fixes to enterprise systems.
|
||||||
|
|
||||||
|
#### v6 Highlights
|
||||||
|
|
||||||
|
**🎯 Scale-Adaptive Workflows (Levels 0-4)**
|
||||||
|
|
||||||
|
- Automatically adjusts complexity from quick fixes to enterprise projects
|
||||||
|
- Greenfield & brownfield support with smart context engine
|
||||||
|
|
||||||
|
**🏗️ Project-Adaptive Architecture**
|
||||||
|
|
||||||
|
- Documents adapt to project type (web, mobile, embedded, game)
|
||||||
|
- Engine-specific game development (Unity, Phaser, Godot, Unreal)
|
||||||
|
|
||||||
|
**📋 Four-Phase Methodology**
|
||||||
|
|
||||||
|
1. **Analysis** - Brainstorming, research, briefs
|
||||||
|
2. **Planning** - Scale-adaptive PRD/GDD
|
||||||
|
3. **Solutioning** - Architecture and tech specs
|
||||||
|
4. **Implementation** - Stories, development, review
|
||||||
|
|
||||||
|
**Specialized Agents**: PM, Analyst, Architect, Scrum Master, Developer, Game Designer/Developer/Architect, UX, Test Architect
|
||||||
|
|
||||||
|
**Documentation**: [📚 BMM Module](./src/modules/bmm/README.md) | [📖 Workflows Guide](./src/modules/bmm/workflows/README.md)
|
||||||
|
|
||||||
|
### BMad Builder (BMB) - Create Custom Solutions
|
||||||
|
|
||||||
|
Build custom agents, workflows, and modules using BMad-CORE framework.
|
||||||
|
|
||||||
|
- **Agent Creation** - Custom roles and behaviors
|
||||||
|
- **Workflow Design** - Structured multi-step processes
|
||||||
|
- **Module Development** - Complete domain solutions
|
||||||
|
- **Three Agent Types** - Full module, hybrid, standalone
|
||||||
|
|
||||||
|
**Documentation**:
|
||||||
|
|
||||||
|
- [📚 BMB Module](./src/modules/bmb/README.md) - Complete module reference
|
||||||
|
- [🎯 Create Agent](./src/modules/bmb/workflows/create-agent/README.md) - Agent builder workflow
|
||||||
|
- [📋 Create Workflow](./src/modules/bmb/workflows/create-workflow/README.md) - Workflow designer
|
||||||
|
- [📦 Create Module](./src/modules/bmb/workflows/create-module/README.md) - Module scaffolding
|
||||||
|
|
||||||
|
### Creative Intelligence Suite (CIS) - Innovation & Creativity
|
||||||
|
|
||||||
|
AI-powered creative facilitation across five domains.
|
||||||
|
|
||||||
|
- **5 Interactive Workflows** - Brainstorming, Design Thinking, Problem Solving, Innovation Strategy, Storytelling
|
||||||
|
- **150+ Creative Techniques** - Proven frameworks and methodologies
|
||||||
|
- **5 Specialized Agents** - Unique personas and facilitation styles
|
||||||
|
- **Shared Resource** - Powers creative workflows in other modules
|
||||||
|
|
||||||
|
**Documentation**: [📚 CIS Module](./src/modules/cis/README.md) | [📖 CIS Workflows](./src/modules/cis/workflows/README.md)
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
**Prerequisites**: Node.js v20+ ([Download](https://nodejs.org))
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Install v6 Alpha (this version)
|
# Install v6 Alpha
|
||||||
npx bmad-method@alpha install
|
npx bmad-method@alpha install
|
||||||
|
|
||||||
# Install stable v4 (production-ready)
|
# Install stable v4
|
||||||
npx bmad-method install
|
npx bmad-method install
|
||||||
```
|
```
|
||||||
|
|
||||||
The interactive installer will guide you through:
|
Interactive installer guides you through:
|
||||||
|
|
||||||
1. **Project location** - Where to install BMad
|
1. **Project location** - Installation directory
|
||||||
2. **Module selection** - Choose which modules you need (BMM, BMB, CIS)
|
2. **Module selection** - BMM, BMB, CIS
|
||||||
3. **Configuration** - Set your name, language preferences, and module options
|
3. **Configuration** - Name, language, game dev options
|
||||||
- **Game Development (Optional)**: When installing BMM, you can optionally include game development agents and workflow!
|
4. **IDE integration** - Environment setup
|
||||||
4. **IDE integration** - Configure your development environment
|
|
||||||
|
|
||||||
### What Gets Installed
|
### Project Structure
|
||||||
|
|
||||||
All modules install to a single `bmad/` folder in your project:
|
|
||||||
|
|
||||||
```
|
```
|
||||||
your-project/
|
your-project/
|
||||||
└── bmad/
|
└── bmad/
|
||||||
├── core/ # Core framework (always installed)
|
├── core/ # Core framework
|
||||||
├── bmm/ # BMad Method (if selected)
|
├── bmm/ # BMad Method
|
||||||
├── bmb/ # BMad Builder (if selected)
|
├── bmb/ # BMad Builder
|
||||||
├── cis/ # Creative Intelligence Suite (shared resources)
|
├── cis/ # Creative Intelligence
|
||||||
└── _cfg/ # Your customizations
|
└── _cfg/ # Your customizations
|
||||||
└── agents/ # Agent customization files
|
└── agents/ # Agent configs
|
||||||
```
|
```
|
||||||
|
|
||||||
### Getting Started with BMM
|
### Getting Started
|
||||||
|
|
||||||
After installation, activate the Analyst agent in your IDE and run:
|
After installation, activate Analyst agent and run:
|
||||||
|
|
||||||
```bash
|
```
|
||||||
/workflow-init
|
/workflow-init
|
||||||
```
|
```
|
||||||
|
|
||||||
Or run it directly as a command (command syntax varies by IDE - use slash commands in Claude Code, OpenCode, etc.).
|
This initializes the workflow system and helps choose your starting point.
|
||||||
|
|
||||||
This sets up the guided workflow system and helps you choose the right starting point for your project based on its complexity.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Key Features
|
## Key Features
|
||||||
|
|
||||||
### 🎨 Update-Safe Customization
|
### 🎨 Update-Safe Customization
|
||||||
|
|
||||||
- **Agent Customization**: Modify agents via `bmad/_cfg/agents/` customize files
|
- Agent modification via `bmad/_cfg/agents/`
|
||||||
- **Persistent Settings**: Your customizations survive updates
|
- Persistent settings through updates
|
||||||
- **Multi-Language Support**: Agents communicate in your preferred language
|
- Multi-language support
|
||||||
- **Flexible Configuration**: Adjust agent names, roles, communication styles, and more
|
- Flexible configuration
|
||||||
|
|
||||||
### 🚀 Intelligent Installation
|
### 🚀 Intelligent Installation
|
||||||
|
|
||||||
The installer automatically:
|
- Auto-detects v4 installations
|
||||||
|
|
||||||
- Detects and migrates v4 installations
|
|
||||||
- Configures IDE integrations
|
- Configures IDE integrations
|
||||||
- Resolves module dependencies
|
- Resolves dependencies
|
||||||
- Sets up agent customization templates
|
- Creates unified manifests
|
||||||
- Creates unified agent manifests
|
|
||||||
|
|
||||||
### 📁 Unified Architecture
|
### 📁 Unified Architecture
|
||||||
|
|
||||||
Everything in one place - no more scattered configuration folders. Clean, organized, maintainable.
|
Single `bmad/` folder - clean, organized, maintainable.
|
||||||
|
|
||||||
---
|
## Documentation
|
||||||
|
|
||||||
## Additional Documentation
|
- **[📚 Documentation Index](./docs/index.md)** - Complete documentation map
|
||||||
|
- **[v4 to v6 Upgrade Guide](./docs/v4-to-v6-upgrade.md)** - Migration instructions
|
||||||
- **[v4 to v6 Upgrade Guide](./docs/v4-to-v6-upgrade.md)** - Migration instructions for v4 users
|
- **[CLI Tool Guide](./tools/cli/README.md)** - Installer reference
|
||||||
- **[CLI Tool Guide](./tools/cli/README.md)** - Installer and bundler reference
|
- **[Contributing Guide](./CONTRIBUTING.md)** - Contribution guidelines
|
||||||
- **[Contributing Guide](./CONTRIBUTING.md)** - How to contribute to BMad
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Community & Support
|
## Community & Support
|
||||||
|
|
||||||
- 💬 **[Discord](https://discord.gg/gk8jAdXWmj)** - Get help, share ideas, and collaborate
|
- 💬 **[Discord](https://discord.gg/gk8jAdXWmj)** - Community help
|
||||||
- 🐛 **[Issues](https://github.com/bmad-code-org/BMAD-METHOD/issues)** - Report bugs and request features
|
- 🐛 **[Issues](https://github.com/bmad-code-org/BMAD-METHOD/issues)** - Bug reports
|
||||||
- 🎥 **[YouTube](https://www.youtube.com/@BMadCode)** - Tutorials and updates
|
- 🎥 **[YouTube](https://www.youtube.com/@BMadCode)** - Tutorials
|
||||||
- ⭐ **[Star this repo](https://github.com/bmad-code-org/BMAD-METHOD)** - Get notified of updates
|
- ⭐ **[Star this repo](https://github.com/bmad-code-org/BMAD-METHOD)** - Updates
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Contributing
|
## Contributing
|
||||||
|
|
||||||
We welcome contributions! See **[CONTRIBUTING.md](CONTRIBUTING.md)** for guidelines.
|
See **[CONTRIBUTING.md](CONTRIBUTING.md)** for guidelines.
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
MIT License - See [LICENSE](LICENSE) for details.
|
MIT License - See [LICENSE](LICENSE)
|
||||||
|
|
||||||
**Trademark Notice**: BMAD™ and BMAD-METHOD™ are trademarks of BMad Code, LLC. All rights reserved.
|
**Trademark**: BMAD™ and BMAD-METHOD™ are trademarks of BMad Code, LLC.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -37,7 +37,10 @@ The interactive installer will guide you through setup and create a `bmad/` fold
|
||||||
|
|
||||||
### Step 1: Initialize Your Workflow
|
### Step 1: Initialize Your Workflow
|
||||||
|
|
||||||
1. **Load the Analyst agent** in your IDE (activate it from the bmad/core/agents/ folder)
|
1. **Load the Analyst agent** in your IDE - See your IDE-specific instructions in [docs/ide-info](../docs/ide-info/) for how to activate agents:
|
||||||
|
- [Claude Code](../docs/ide-info/claude-code.md)
|
||||||
|
- [VS Code/Cursor/Windsurf](../docs/ide-info/) - Check your IDE folder
|
||||||
|
- Other IDEs also supported
|
||||||
2. **Wait for the agent's menu** to appear
|
2. **Wait for the agent's menu** to appear
|
||||||
3. **Tell the agent**: "Run workflow-init" or type "\*workflow-init" or select the menu item number
|
3. **Tell the agent**: "Run workflow-init" or type "\*workflow-init" or select the menu item number
|
||||||
|
|
||||||
|
|
@ -104,7 +107,7 @@ The next TRULY REQUIRED step is:
|
||||||
|
|
||||||
When an agent tells you to run a workflow (like `/bmad:bmm:workflows:prd`):
|
When an agent tells you to run a workflow (like `/bmad:bmm:workflows:prd`):
|
||||||
|
|
||||||
1. **Start a new chat** with the specified agent (e.g., PM)
|
1. **Start a new chat** with the specified agent (e.g., PM) - See [docs/ide-info](../docs/ide-info/) for your IDE's specific instructions
|
||||||
2. **Wait for the menu** to appear
|
2. **Wait for the menu** to appear
|
||||||
3. **Tell the agent** to run it using any of these formats:
|
3. **Tell the agent** to run it using any of these formats:
|
||||||
- Type the shorthand: `*prd`
|
- Type the shorthand: `*prd`
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,229 @@
|
||||||
|
# BMad Documentation Index
|
||||||
|
|
||||||
|
Complete map of all BMad Method v6 documentation with recommended reading paths.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🎯 Getting Started (Start Here!)
|
||||||
|
|
||||||
|
**New users:** Start with one of these based on your situation:
|
||||||
|
|
||||||
|
| Your Situation | Start Here | Then Read |
|
||||||
|
| ---------------------- | ---------------------------------------------------- | ------------------------------------------------------------- |
|
||||||
|
| **Brand new to BMad** | [Quick Start Guide](./BMad-Method-V6-Quick-Start.md) | [BMM Workflows Guide](../src/modules/bmm/workflows/README.md) |
|
||||||
|
| **Upgrading from v4** | [v4 to v6 Upgrade Guide](./v4-to-v6-upgrade.md) | [Quick Start Guide](./BMad-Method-V6-Quick-Start.md) |
|
||||||
|
| **Brownfield project** | [Brownfield Guide](./bmad-brownfield-guide.md) | [Quick Start Guide](./BMad-Method-V6-Quick-Start.md) |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📋 Core Documentation
|
||||||
|
|
||||||
|
### Project-Level Docs (Root)
|
||||||
|
|
||||||
|
- **[README.md](../README.md)** - Main project overview, feature summary, and module introductions
|
||||||
|
- **[CONTRIBUTING.md](../CONTRIBUTING.md)** - How to contribute, pull request guidelines, code style
|
||||||
|
- **[CHANGELOG.md](../CHANGELOG.md)** - Version history and breaking changes
|
||||||
|
- **[CLAUDE.md](../CLAUDE.md)** - Claude Code specific guidelines for this project
|
||||||
|
|
||||||
|
### Installation & Setup
|
||||||
|
|
||||||
|
- **[BMad Method V6 Quick Start](./BMad-Method-V6-Quick-Start.md)** - Step-by-step guide to building your first project with BMM
|
||||||
|
- **[v4 to v6 Upgrade Guide](./v4-to-v6-upgrade.md)** - Migration path for v4 users
|
||||||
|
- **[Brownfield Guide](./bmad-brownfield-guide.md)** - Guidance for working with existing codebases
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🏗️ Module Documentation
|
||||||
|
|
||||||
|
### BMad Method (BMM) - Software & Game Development
|
||||||
|
|
||||||
|
The flagship module for agile AI-driven development.
|
||||||
|
|
||||||
|
- **[BMM Module README](../src/modules/bmm/README.md)** - Module overview, agents, and structure
|
||||||
|
- **[BMM Workflows Guide](../src/modules/bmm/workflows/README.md)** - **ESSENTIAL READING** - Complete v6 workflow system explanation
|
||||||
|
- Phase 1: Analysis (optional)
|
||||||
|
- Phase 2: Planning (required, scale-adaptive)
|
||||||
|
- Phase 3: Solutioning (complex projects)
|
||||||
|
- Phase 4: Implementation (iterative)
|
||||||
|
- **[Test Architect Guide](../src/modules/bmm/testarch/README.md)** - Testing strategy and quality assurance
|
||||||
|
|
||||||
|
### BMad Builder (BMB) - Create Custom Solutions
|
||||||
|
|
||||||
|
Build your own agents, workflows, and modules.
|
||||||
|
|
||||||
|
- **[BMB Module README](../src/modules/bmb/README.md)** - Module overview and capabilities
|
||||||
|
- **[Agent Creation Guide](../src/modules/bmb/workflows/create-agent/README.md)** - Design custom agents
|
||||||
|
|
||||||
|
### Creative Intelligence Suite (CIS) - Innovation & Creativity
|
||||||
|
|
||||||
|
AI-powered creative thinking and brainstorming.
|
||||||
|
|
||||||
|
- **[CIS Module README](../src/modules/cis/README.md)** - Module overview and workflows
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🖥️ IDE-Specific Guides
|
||||||
|
|
||||||
|
Instructions for loading agents and running workflows in your development environment.
|
||||||
|
|
||||||
|
**Popular IDEs:**
|
||||||
|
|
||||||
|
- [Claude Code](./ide-info/claude-code.md)
|
||||||
|
- [Cursor](./ide-info/cursor.md)
|
||||||
|
- [VS Code](./ide-info/windsurf.md)
|
||||||
|
|
||||||
|
**Other Supported IDEs:**
|
||||||
|
|
||||||
|
- [Augment](./ide-info/auggie.md)
|
||||||
|
- [Cline](./ide-info/cline.md)
|
||||||
|
- [Codex](./ide-info/codex.md)
|
||||||
|
- [Crush](./ide-info/crush.md)
|
||||||
|
- [Gemini](./ide-info/gemini.md)
|
||||||
|
- [GitHub Copilot](./ide-info/github-copilot.md)
|
||||||
|
- [IFlow](./ide-info/iflow.md)
|
||||||
|
- [Kilo](./ide-info/kilo.md)
|
||||||
|
- [OpenCode](./ide-info/opencode.md)
|
||||||
|
- [Qwen](./ide-info/qwen.md)
|
||||||
|
- [Roo](./ide-info/roo.md)
|
||||||
|
- [Trae](./ide-info/trae.md)
|
||||||
|
|
||||||
|
**Key concept:** Every reference to "load an agent" or "activate an agent" in the main docs links to the [ide-info](./ide-info/) directory for IDE-specific instructions.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔧 Advanced Topics
|
||||||
|
|
||||||
|
### Installation & Bundling
|
||||||
|
|
||||||
|
- [IDE Injections Reference](./installers-bundlers/ide-injections.md) - How agents are installed to IDEs
|
||||||
|
- [Installers & Platforms Reference](./installers-bundlers/installers-modules-platforms-reference.md) - CLI tool and platform support
|
||||||
|
- [Web Bundler Usage](./installers-bundlers/web-bundler-usage.md) - Creating web-compatible bundles
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📊 Documentation Map
|
||||||
|
|
||||||
|
```
|
||||||
|
docs/
|
||||||
|
├── index.md (this file)
|
||||||
|
├── BMad-Method-V6-Quick-Start.md
|
||||||
|
├── v4-to-v6-upgrade.md
|
||||||
|
├── bmad-brownfield-guide.md
|
||||||
|
├── ide-info/
|
||||||
|
│ ├── claude-code.md
|
||||||
|
│ ├── cursor.md
|
||||||
|
│ ├── windsurf.md
|
||||||
|
│ └── [14+ other IDEs]
|
||||||
|
└── installers-bundlers/
|
||||||
|
├── ide-injections.md
|
||||||
|
├── installers-modules-platforms-reference.md
|
||||||
|
└── web-bundler-usage.md
|
||||||
|
|
||||||
|
src/
|
||||||
|
├── modules/
|
||||||
|
│ ├── bmm/
|
||||||
|
│ │ ├── README.md
|
||||||
|
│ │ ├── workflows/README.md (ESSENTIAL)
|
||||||
|
│ │ └── testarch/README.md
|
||||||
|
│ ├── bmb/
|
||||||
|
│ │ ├── README.md
|
||||||
|
│ │ └── workflows/create-agent/README.md
|
||||||
|
│ └── cis/
|
||||||
|
│ └── README.md
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🎓 Recommended Reading Paths
|
||||||
|
|
||||||
|
### Path 1: Brand New to BMad (Software Project)
|
||||||
|
|
||||||
|
1. [README.md](../README.md) - Understand the vision
|
||||||
|
2. [Quick Start Guide](./BMad-Method-V6-Quick-Start.md) - Get hands-on
|
||||||
|
3. [BMM Module README](../src/modules/bmm/README.md) - Understand agents
|
||||||
|
4. [BMM Workflows Guide](../src/modules/bmm/workflows/README.md) - Master the methodology
|
||||||
|
5. [Your IDE guide](./ide-info/) - Optimize your workflow
|
||||||
|
|
||||||
|
### Path 2: Game Development Project
|
||||||
|
|
||||||
|
1. [README.md](../README.md) - Understand the vision
|
||||||
|
2. [Quick Start Guide](./BMad-Method-V6-Quick-Start.md) - Get hands-on
|
||||||
|
3. [BMM Module README](../src/modules/bmm/README.md) - Game agents are included
|
||||||
|
4. [BMM Workflows Guide](../src/modules/bmm/workflows/README.md) - Game workflows
|
||||||
|
5. [Your IDE guide](./ide-info/) - Optimize your workflow
|
||||||
|
|
||||||
|
### Path 3: Upgrading from v4
|
||||||
|
|
||||||
|
1. [v4 to v6 Upgrade Guide](./v4-to-v6-upgrade.md) - Understand what changed
|
||||||
|
2. [Quick Start Guide](./BMad-Method-V6-Quick-Start.md) - Reorient yourself
|
||||||
|
3. [BMM Workflows Guide](../src/modules/bmm/workflows/README.md) - Learn new v6 workflows
|
||||||
|
|
||||||
|
### Path 4: Working with Existing Codebase (Brownfield)
|
||||||
|
|
||||||
|
1. [Brownfield Guide](./bmad-brownfield-guide.md) - Approach for legacy code
|
||||||
|
2. [Quick Start Guide](./BMad-Method-V6-Quick-Start.md) - Follow the process
|
||||||
|
3. [BMM Workflows Guide](../src/modules/bmm/workflows/README.md) - Master the methodology
|
||||||
|
|
||||||
|
### Path 5: Building Custom Solutions
|
||||||
|
|
||||||
|
1. [BMB Module README](../src/modules/bmb/README.md) - Understand capabilities
|
||||||
|
2. [Agent Creation Guide](../src/modules/bmb/workflows/create-agent/README.md) - Create agents
|
||||||
|
3. [BMM Workflows Guide](../src/modules/bmm/workflows/README.md) - Understand workflow structure
|
||||||
|
|
||||||
|
### Path 6: Contributing to BMad
|
||||||
|
|
||||||
|
1. [CONTRIBUTING.md](../CONTRIBUTING.md) - Contribution guidelines
|
||||||
|
2. Relevant module README - Understand the area you're contributing to
|
||||||
|
3. [Code Style section in CONTRIBUTING.md](../CONTRIBUTING.md#code-style) - Follow standards
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔍 Quick Reference
|
||||||
|
|
||||||
|
**What is each module for?**
|
||||||
|
|
||||||
|
- **BMM** - AI-driven software and game development
|
||||||
|
- **BMB** - Create custom agents and workflows
|
||||||
|
- **CIS** - Creative thinking and brainstorming
|
||||||
|
|
||||||
|
**How do I load an agent?**
|
||||||
|
→ See [ide-info](./ide-info/) folder for your IDE
|
||||||
|
|
||||||
|
**I'm stuck, what's next?**
|
||||||
|
→ Check the [BMM Workflows Guide](../src/modules/bmm/workflows/README.md) or run `workflow-status`
|
||||||
|
|
||||||
|
**I want to contribute**
|
||||||
|
→ Start with [CONTRIBUTING.md](../CONTRIBUTING.md)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📚 Important Concepts
|
||||||
|
|
||||||
|
### Fresh Chats
|
||||||
|
|
||||||
|
Each workflow should run in a fresh chat with the specified agent to avoid context limitations. This is emphasized throughout the docs because it's critical to successful workflows.
|
||||||
|
|
||||||
|
### Scale Levels
|
||||||
|
|
||||||
|
BMM adapts to project complexity (Levels 0-4). Documentation is scale-adaptive - you only need what's relevant to your project size.
|
||||||
|
|
||||||
|
### Update-Safe Customization
|
||||||
|
|
||||||
|
All agent customizations go in `bmad/_cfg/agents/` and survive updates. See your IDE guide and module README for details.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🆘 Getting Help
|
||||||
|
|
||||||
|
- **Discord**: [Join the BMad Community](https://discord.gg/gk8jAdXWmj)
|
||||||
|
- #general-dev - Technical questions
|
||||||
|
- #bugs-issues - Bug reports
|
||||||
|
- **Issues**: [GitHub Issue Tracker](https://github.com/bmad-code-org/BMAD-METHOD/issues)
|
||||||
|
- **YouTube**: [BMad Code Channel](https://www.youtube.com/@BMadCode)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**Version**: v6-alpha
|
||||||
|
**Last Updated**: 2025-10-30
|
||||||
|
|
||||||
|
---
|
||||||
|
|
@ -196,14 +196,16 @@ If you're using:
|
||||||
|
|
||||||
After installation:
|
After installation:
|
||||||
|
|
||||||
```bash
|
1. **Load the Analyst agent** - See your IDE-specific instructions in [docs/ide-info](./ide-info/) for how to activate agents:
|
||||||
# Start the analyst and tell the analyst after it loads - claude code instructions:
|
- [Claude Code](./ide-info/claude-code.md)
|
||||||
claude # wait for claude to launch in terminal
|
- [Cursor](./ide-info/cursor.md)
|
||||||
- `/analyst` # wait for analyst greeting and menu
|
- [VS Code/Windsurf](./ide-info/) - Check your IDE folder
|
||||||
- `*workflow-init` # v6 now supports much better natural language fuzzy matching - so you could also say `workflow init` or possibly `please init the workflow`
|
|
||||||
```
|
|
||||||
|
|
||||||
Since you are migrating an existing project from v4, its most likely **Level 3 or 4** you will want to suggest when asked - if you've already completed PRD/architecture in v4.
|
2. **Wait for the agent's menu** to appear
|
||||||
|
|
||||||
|
3. **Tell the agent**: `*workflow-init` - v6 supports excellent natural language fuzzy matching, so you could also say "workflow init" or "please init the workflow"
|
||||||
|
|
||||||
|
Since you are migrating an existing project from v4, it's most likely **Level 3 or 4** you will want to suggest when asked - if you've already completed PRD/architecture in v4.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,132 +1,194 @@
|
||||||
# BMB - BMad Builder Module
|
# BMB - BMad Builder Module
|
||||||
|
|
||||||
The BMB (BMad Builder Module) provides specialized tools and workflows for creating, customizing, and extending BMad Method components, including custom agents, workflows, and integrations.
|
Specialized tools and workflows for creating, customizing, and extending BMad components including agents, workflows, and complete modules.
|
||||||
|
|
||||||
|
## Table of Contents
|
||||||
|
|
||||||
|
- [Module Structure](#module-structure)
|
||||||
|
- [Core Workflows](#core-workflows)
|
||||||
|
- [Agent Types](#agent-types)
|
||||||
|
- [Quick Start](#quick-start)
|
||||||
|
- [Best Practices](#best-practices)
|
||||||
|
|
||||||
## Module Structure
|
## Module Structure
|
||||||
|
|
||||||
### 🤖 `/agents`
|
### 🤖 Agents
|
||||||
|
|
||||||
Builder-specific agents that help create and customize BMad Method components:
|
**BMad Builder** - Master builder agent orchestrating all creation workflows with deep knowledge of BMad architecture and conventions.
|
||||||
|
|
||||||
- Agent creation and configuration specialists
|
### 📋 Workflows
|
||||||
- Workflow designers
|
|
||||||
- Integration builders
|
|
||||||
|
|
||||||
### 📋 `/workflows`
|
Comprehensive suite for building and maintaining BMad components.
|
||||||
|
|
||||||
Specialized workflows for building and extending BMad Method capabilities:
|
## Core Workflows
|
||||||
|
|
||||||
#### Core Builder Workflows
|
### Creation Workflows
|
||||||
|
|
||||||
- `create-agent` - Design and implement custom agents
|
**[create-agent](./workflows/create-agent/README.md)** - Build BMad agents
|
||||||
- `create-workflow` - Build new workflow definitions
|
|
||||||
- `create-team` - Configure agent teams
|
|
||||||
- `bundle-agent` - Package agents for distribution
|
|
||||||
- `create-method` - Design custom development methodologies
|
|
||||||
|
|
||||||
#### Integration Workflows
|
- Interactive persona development
|
||||||
|
- Command structure design
|
||||||
|
- YAML source compilation to .md
|
||||||
|
|
||||||
- `integrate-tool` - Connect external tools and services
|
**[create-workflow](./workflows/create-workflow/README.md)** - Design workflows
|
||||||
- `create-adapter` - Build API adapters
|
|
||||||
- `setup-environment` - Configure development environments
|
|
||||||
|
|
||||||
## Key Features
|
- Structured multi-step processes
|
||||||
|
- Configuration validation
|
||||||
|
- Web bundle support
|
||||||
|
|
||||||
### Agent Builder
|
**[create-module](./workflows/create-module/README.md)** - Build complete modules
|
||||||
|
|
||||||
Create custom agents with:
|
- Full module infrastructure
|
||||||
|
- Agent and workflow integration
|
||||||
|
- Installation automation
|
||||||
|
|
||||||
- Role-specific instructions
|
**[module-brief](./workflows/module-brief/README.md)** - Strategic planning
|
||||||
- Tool configurations
|
|
||||||
- Behavior patterns
|
|
||||||
- Integration points
|
|
||||||
|
|
||||||
### Workflow Designer
|
- Module blueprint creation
|
||||||
|
- Vision and architecture
|
||||||
|
- Comprehensive analysis
|
||||||
|
|
||||||
Design workflows that:
|
### Editing Workflows
|
||||||
|
|
||||||
- Orchestrate multiple agents
|
**[edit-agent](./workflows/edit-agent/README.md)** - Modify existing agents
|
||||||
- Define process flows
|
|
||||||
- Handle different project scales
|
|
||||||
- Integrate with existing systems
|
|
||||||
|
|
||||||
### Team Configuration
|
- Persona refinement
|
||||||
|
- Command updates
|
||||||
|
- Best practice compliance
|
||||||
|
|
||||||
Build teams that:
|
**[edit-workflow](./workflows/edit-workflow/README.md)** - Update workflows
|
||||||
|
|
||||||
- Combine complementary agent skills
|
- Structure maintenance
|
||||||
- Coordinate on complex tasks
|
- Configuration updates
|
||||||
- Share context effectively
|
- Documentation sync
|
||||||
- Deliver cohesive results
|
|
||||||
|
**[edit-module](./workflows/edit-module/README.md)** - Module enhancement
|
||||||
|
|
||||||
|
- Component modifications
|
||||||
|
- Dependency management
|
||||||
|
- Version control
|
||||||
|
|
||||||
|
### Maintenance Workflows
|
||||||
|
|
||||||
|
**[convert-legacy](./workflows/convert-legacy/README.md)** - Migration tool
|
||||||
|
|
||||||
|
- v4 to v6 conversion
|
||||||
|
- Structure compliance
|
||||||
|
- Convention updates
|
||||||
|
|
||||||
|
**[audit-workflow](./workflows/audit-workflow/README.md)** - Quality validation
|
||||||
|
|
||||||
|
- Structure verification
|
||||||
|
- Config standards check
|
||||||
|
- Bloat detection
|
||||||
|
- Web bundle completeness
|
||||||
|
|
||||||
|
**[redoc](./workflows/redoc/README.md)** - Auto-documentation
|
||||||
|
|
||||||
|
- Reverse-tree approach
|
||||||
|
- Technical writer quality
|
||||||
|
- Convention compliance
|
||||||
|
|
||||||
|
## Agent Types
|
||||||
|
|
||||||
|
BMB creates three agent architectures:
|
||||||
|
|
||||||
|
### Full Module Agent
|
||||||
|
|
||||||
|
- Complete persona and role definition
|
||||||
|
- Command structure with fuzzy matching
|
||||||
|
- Workflow integration
|
||||||
|
- Module-specific capabilities
|
||||||
|
|
||||||
|
### Hybrid Agent
|
||||||
|
|
||||||
|
- Shared core capabilities
|
||||||
|
- Module-specific extensions
|
||||||
|
- Cross-module compatibility
|
||||||
|
|
||||||
|
### Standalone Agent
|
||||||
|
|
||||||
|
- Independent operation
|
||||||
|
- Minimal dependencies
|
||||||
|
- Specialized single purpose
|
||||||
|
|
||||||
## Quick Start
|
## Quick Start
|
||||||
|
|
||||||
```bash
|
1. **Load BMad Builder agent** in your IDE
|
||||||
# Create a new custom agent
|
2. **Choose creation type:**
|
||||||
bmad bmb create-agent
|
```
|
||||||
|
*create-agent # New agent
|
||||||
|
*create-workflow # New workflow
|
||||||
|
*create-module # Complete module
|
||||||
|
```
|
||||||
|
3. **Follow interactive prompts**
|
||||||
|
|
||||||
# Design a new workflow
|
### Example: Creating an Agent
|
||||||
bmad bmb create-workflow
|
|
||||||
|
|
||||||
# Bundle an agent for sharing
|
```
|
||||||
bmad bmb bundle-agent
|
User: I need a code review agent
|
||||||
|
Builder: *create-agent
|
||||||
|
|
||||||
# Create a custom team configuration
|
[Interactive session begins]
|
||||||
bmad bmb create-team
|
- Brainstorming phase (optional)
|
||||||
|
- Persona development
|
||||||
|
- Command structure
|
||||||
|
- Integration points
|
||||||
```
|
```
|
||||||
|
|
||||||
## Use Cases
|
## Use Cases
|
||||||
|
|
||||||
### Custom Agent Development
|
### Custom Development Teams
|
||||||
|
|
||||||
Build specialized agents for:
|
Build specialized agents for:
|
||||||
|
|
||||||
- Domain-specific expertise
|
- Domain expertise (legal, medical, finance)
|
||||||
- Company-specific processes
|
- Company processes
|
||||||
- Tool integrations
|
- Tool integrations
|
||||||
- Automation tasks
|
- Automation tasks
|
||||||
|
|
||||||
### Workflow Customization
|
### Workflow Extensions
|
||||||
|
|
||||||
Create workflows for:
|
Create workflows for:
|
||||||
|
|
||||||
- Unique development processes
|
|
||||||
- Compliance requirements
|
- Compliance requirements
|
||||||
- Quality gates
|
- Quality gates
|
||||||
- Deployment pipelines
|
- Deployment pipelines
|
||||||
|
|
||||||
### Team Orchestration
|
|
||||||
|
|
||||||
Configure teams for:
|
|
||||||
|
|
||||||
- Large-scale projects
|
|
||||||
- Cross-functional collaboration
|
|
||||||
- Specialized domains
|
|
||||||
- Custom methodologies
|
- Custom methodologies
|
||||||
|
|
||||||
## Integration with BMM
|
### Complete Solutions
|
||||||
|
|
||||||
BMB works alongside BMM to:
|
Package modules for:
|
||||||
|
|
||||||
- Extend core BMM capabilities
|
- Industry verticals
|
||||||
- Create custom implementations
|
- Technology stacks
|
||||||
- Build domain-specific solutions
|
- Business processes
|
||||||
- Integrate with existing tools
|
- Educational frameworks
|
||||||
|
|
||||||
## Best Practices
|
## Best Practices
|
||||||
|
|
||||||
1. **Start with existing patterns** - Study BMM agents and workflows before creating new ones
|
1. **Study existing patterns** - Review BMM/CIS implementations
|
||||||
2. **Keep it modular** - Build reusable components
|
2. **Follow conventions** - Use established structures
|
||||||
3. **Document thoroughly** - Clear documentation helps others use your creations
|
3. **Document thoroughly** - Clear instructions essential
|
||||||
4. **Test extensively** - Validate agents and workflows before production use
|
4. **Test iteratively** - Validate during creation
|
||||||
5. **Share and collaborate** - Contribute useful components back to the community
|
5. **Consider reusability** - Build modular components
|
||||||
|
|
||||||
|
## Integration
|
||||||
|
|
||||||
|
BMB components integrate with:
|
||||||
|
|
||||||
|
- **BMad Core** - Framework foundation
|
||||||
|
- **BMM** - Extend development capabilities
|
||||||
|
- **CIS** - Leverage creative workflows
|
||||||
|
- **Custom Modules** - Your domain solutions
|
||||||
|
|
||||||
## Related Documentation
|
## Related Documentation
|
||||||
|
|
||||||
- [BMM Module](../bmm/README.md) - Core method implementation
|
- **[Agent Creation Guide](./workflows/create-agent/README.md)** - Detailed instructions
|
||||||
- [Agent Creation Guide](./workflows/create-agent/README.md) - Detailed agent building instructions
|
- **[Module Structure](./workflows/create-module/module-structure.md)** - Architecture patterns
|
||||||
- [Workflow Design Patterns](./workflows/README.md) - Best practices for workflow creation
|
- **[BMM Module](../bmm/README.md)** - Reference implementation
|
||||||
|
- **[Core Framework](../../core/README.md)** - Foundation concepts
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
BMB empowers you to extend and customize the BMad Method to fit your specific needs while maintaining the power and consistency of the core framework.
|
BMB empowers you to extend BMad Method for your specific needs while maintaining framework consistency and power.
|
||||||
|
|
|
||||||
|
|
@ -1,320 +1,203 @@
|
||||||
# Build Agent
|
# Create Agent Workflow
|
||||||
|
|
||||||
## Overview
|
Interactive agent builder creating BMad Core compliant agents as YAML source files that compile to .md during installation.
|
||||||
|
|
||||||
The Build Agent workflow is an interactive agent builder that guides you through creating BMAD Core compliant agents as YAML source files that compile to final `.md` during install. It supports three agent types: Simple (self-contained), Expert (with sidecar resources), and Module (full-featured with workflows).
|
## Table of Contents
|
||||||
|
|
||||||
## Key Features
|
- [Quick Start](#quick-start)
|
||||||
|
- [Agent Types](#agent-types)
|
||||||
|
- [Workflow Phases](#workflow-phases)
|
||||||
|
- [Output Structure](#output-structure)
|
||||||
|
- [Installation](#installation)
|
||||||
|
- [Examples](#examples)
|
||||||
|
|
||||||
- **Optional Brainstorming**: Creative ideation session before agent building to explore concepts and personalities
|
## Quick Start
|
||||||
- **Three Agent Types**: Simple, Expert, and Module agents with appropriate structures
|
|
||||||
- **Persona Development**: Guided creation of role, identity, communication style, and principles
|
|
||||||
- **Command Builder**: Interactive command definition with workflow/task/action patterns
|
|
||||||
- **Validation Built-In**: Ensures YAML structure and BMAD Core compliance
|
|
||||||
- **Customize Support**: Optional `customize.yaml` for persona/menu overrides and critical actions
|
|
||||||
- **Sidecar Resources**: Setup for Expert agents with domain-specific data
|
|
||||||
|
|
||||||
## Usage
|
|
||||||
|
|
||||||
### Basic Invocation
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
|
# Direct workflow
|
||||||
workflow create-agent
|
workflow create-agent
|
||||||
```
|
|
||||||
|
|
||||||
### Through BMad Builder Agent
|
# Via BMad Builder
|
||||||
|
|
||||||
```
|
|
||||||
*create-agent
|
*create-agent
|
||||||
```
|
```
|
||||||
|
|
||||||
### With Brainstorming Session
|
## Agent Types
|
||||||
|
|
||||||
The workflow includes an optional brainstorming phase (Step -1) that helps you explore agent concepts, personalities, and capabilities before building. This is particularly useful when you have a vague idea and want to develop it into a concrete agent concept.
|
### Simple Agent
|
||||||
|
|
||||||
### What You'll Be Asked
|
- Self-contained functionality
|
||||||
|
- Basic command structure
|
||||||
|
- No external resources
|
||||||
|
|
||||||
0. **Optional brainstorming** (vague idea → refined concept)
|
### Expert Agent
|
||||||
1. Agent type (Simple, Expert, or Module)
|
|
||||||
2. Basic identity (name, title, icon, filename)
|
|
||||||
3. Module assignment (for Module agents)
|
|
||||||
4. Sidecar resources (for Expert agents)
|
|
||||||
5. Persona elements (role, identity, style, principles)
|
|
||||||
6. Commands and their implementations
|
|
||||||
7. Critical actions (optional)
|
|
||||||
8. Activation rules (optional, rarely needed)
|
|
||||||
|
|
||||||
## Workflow Structure
|
- Sidecar resources for domain knowledge
|
||||||
|
- Extended capabilities
|
||||||
|
- Knowledge base integration
|
||||||
|
|
||||||
### Files Included
|
### Module Agent
|
||||||
|
|
||||||
```
|
- Full-featured with workflows
|
||||||
create-agent/
|
- Module-specific commands
|
||||||
├── workflow.yaml # Configuration
|
- Integrated with module structure
|
||||||
├── instructions.md # Step-by-step guide
|
|
||||||
├── checklist.md # Validation criteria
|
|
||||||
├── README.md # This file
|
|
||||||
├── agent-types.md # Agent type documentation
|
|
||||||
├── agent-architecture.md # Architecture patterns
|
|
||||||
├── agent-command-patterns.md # Command patterns reference
|
|
||||||
└── communication-styles.md # Style examples
|
|
||||||
```
|
|
||||||
|
|
||||||
## Workflow Process
|
## Workflow Phases
|
||||||
|
|
||||||
### Phase 0: Optional Brainstorming (Step -1)
|
### Phase 0: Optional Brainstorming
|
||||||
|
|
||||||
- Creative ideation session using diverse brainstorming techniques
|
- Creative ideation session
|
||||||
- Explore agent concepts, personalities, and capabilities
|
- Explore concepts and personalities
|
||||||
- Generate character ideas, expertise areas, and command concepts
|
- Generate command ideas
|
||||||
- Output feeds directly into agent identity and persona development
|
- Output feeds into persona development
|
||||||
|
|
||||||
### Phase 1: Agent Setup (Steps 0-2)
|
### Phase 1: Agent Setup
|
||||||
|
|
||||||
- Load agent building documentation and patterns
|
1. Choose agent type (Simple/Expert/Module)
|
||||||
- Choose agent type (Simple/Expert/Module)
|
2. Define identity (name, title, icon, filename)
|
||||||
- Define basic identity (name, title, icon, filename) - informed by brainstorming if completed
|
3. Assign to module (if Module agent)
|
||||||
- Assign to module (for Module agents)
|
|
||||||
|
|
||||||
### Phase 2: Persona Development (Steps 2-3)
|
### Phase 2: Persona Development
|
||||||
|
|
||||||
- Define role and responsibilities - leveraging brainstorming insights if available
|
- Define role and responsibilities
|
||||||
- Craft unique identity and backstory
|
- Craft unique identity/backstory
|
||||||
- Select communication style - can use brainstormed personality concepts
|
- Select communication style
|
||||||
- Establish guiding principles
|
- Establish guiding principles
|
||||||
- Add critical actions (optional)
|
- Add critical actions (optional)
|
||||||
|
|
||||||
### Phase 3: Command Building (Step 4)
|
### Phase 3: Command Building
|
||||||
|
|
||||||
- Add *help and *exit commands (required)
|
- Add required commands (*help, *exit)
|
||||||
- Define workflow commands (most common)
|
- Define workflow commands
|
||||||
- Add task commands (for single operations)
|
- Add task commands
|
||||||
- Create action commands (inline logic)
|
- Create action commands
|
||||||
- Configure command attributes
|
- Configure attributes
|
||||||
|
|
||||||
### Phase 4: Finalization (Steps 5-10)
|
### Phase 4: Finalization
|
||||||
|
|
||||||
- Confirm activation behavior (mostly automatic)
|
- Generate .agent.yaml file
|
||||||
- Generate `.agent.yaml` file
|
- Create customize file (optional)
|
||||||
- Optionally create a customize file for overrides
|
- Setup sidecar resources (Expert agents)
|
||||||
- Setup sidecar resources (for Expert agents)
|
- Validate and compile
|
||||||
- Validate YAML and compile to `.md`
|
|
||||||
- Provide usage instructions
|
- Provide usage instructions
|
||||||
|
|
||||||
## Output
|
## Output Structure
|
||||||
|
|
||||||
### Generated Files
|
### Generated Files
|
||||||
|
|
||||||
#### For Standalone Agents (not part of a module)
|
**Standalone Agents:**
|
||||||
|
|
||||||
- **YAML Source**: `{custom_agent_location}/{{agent_filename}}.agent.yaml` (default: `bmad/agents/`)
|
- Source: `bmad/agents/{filename}.agent.yaml`
|
||||||
- **Installation Location**: `{project-root}/bmad/agents/{{agent_filename}}.md`
|
- Compiled: `bmad/agents/{filename}.md`
|
||||||
- **Compilation**: Run the BMAD Method installer and select "Compile Agents (Quick rebuild of all agent .md files)"
|
|
||||||
|
|
||||||
#### For Module Agents
|
**Module Agents:**
|
||||||
|
|
||||||
- **YAML Source**: `src/modules/{{target_module}}/agents/{{agent_filename}}.agent.yaml`
|
- Source: `src/modules/{module}/agents/{filename}.agent.yaml`
|
||||||
- **Installation Location**: `{project-root}/bmad/{{module}}/agents/{{agent_filename}}.md`
|
- Compiled: `bmad/{module}/agents/{filename}.md`
|
||||||
- **Compilation**: Automatic during module installation
|
|
||||||
|
|
||||||
### YAML Agent Structure (simplified)
|
### YAML Structure
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
agent:
|
agent:
|
||||||
metadata:
|
metadata:
|
||||||
id: bmad/{{module}}/agents/{{agent_filename}}.md
|
id: bmad/{module}/agents/{filename}.md
|
||||||
name: { { agent_name } }
|
name: Agent Name
|
||||||
title: { { agent_title } }
|
title: Agent Title
|
||||||
icon: { { agent_icon } }
|
icon: 🤖
|
||||||
module: { { module } }
|
module: module-name
|
||||||
persona:
|
persona:
|
||||||
role: '...'
|
role: '...'
|
||||||
identity: '...'
|
identity: '...'
|
||||||
communication_style: '...'
|
communication_style: '...'
|
||||||
principles: ['...', '...']
|
principles: ['...', '...']
|
||||||
menu:
|
menu:
|
||||||
- trigger: example
|
- trigger: command-name
|
||||||
workflow: '{project-root}/path/to/workflow.yaml'
|
workflow: path/to/workflow.yaml
|
||||||
description: Do the thing
|
description: Command description
|
||||||
```
|
```
|
||||||
|
|
||||||
### Optional Customize File
|
### Optional Customize File
|
||||||
|
|
||||||
If created, generates at:
|
Location: `bmad/_cfg/agents/{module}-{filename}.customize.yaml`
|
||||||
`{project-root}/bmad/_cfg/agents/{{module}}-{{agent_filename}}.customize.yaml`
|
|
||||||
|
|
||||||
## Installation and Compilation
|
Allows persona and menu overrides that persist through updates.
|
||||||
|
|
||||||
### Agent Installation Locations
|
## Installation
|
||||||
|
|
||||||
Agents are installed to different locations based on their type:
|
### Compilation Methods
|
||||||
|
|
||||||
1. **Standalone Agents** (not part of a module)
|
**Quick Rebuild:**
|
||||||
- Source: Created in your custom agent location (default: `bmad/agents/`)
|
|
||||||
- Installed to: `{project-root}/bmad/agents/`
|
|
||||||
- Compilation: Run BMAD Method installer and select "Compile Agents"
|
|
||||||
|
|
||||||
2. **Module Agents** (part of BMM, BMB, or custom modules)
|
|
||||||
- Source: Created in `src/modules/{module}/agents/`
|
|
||||||
- Installed to: `{project-root}/bmad/{module}/agents/`
|
|
||||||
- Compilation: Automatic during module installation
|
|
||||||
|
|
||||||
### Compilation Process
|
|
||||||
|
|
||||||
The installer compiles YAML agent definitions to Markdown:
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# For standalone agents
|
bmad compile-agents
|
||||||
npm run build:agents
|
|
||||||
|
|
||||||
# For all BMad components (includes agents)
|
|
||||||
npm run install:bmad
|
|
||||||
|
|
||||||
# Using the installer menu
|
|
||||||
npm run installer
|
|
||||||
# Then select: Compile Agents
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### Build Commands
|
**During Module Install:**
|
||||||
|
Automatic compilation when installing modules
|
||||||
|
|
||||||
Additional build commands for agent management:
|
**Manual Compilation:**
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Build specific agent types
|
node tools/cli/bmad-cli.js compile-agents
|
||||||
npx bmad-method build:agents # Build standalone agents
|
|
||||||
npx bmad-method build:modules # Build module agents (with modules)
|
|
||||||
|
|
||||||
# Full rebuild
|
|
||||||
npx bmad-method build:all # Rebuild everything
|
|
||||||
```
|
```
|
||||||
|
|
||||||
## Requirements
|
## Examples
|
||||||
|
|
||||||
- BMAD Core v6 project structure
|
### Creating a Code Review Agent
|
||||||
- Module to host the agent (for Module agents)
|
|
||||||
- Understanding of agent purpose and commands
|
|
||||||
- Workflows/tasks to reference in commands (or mark as "todo")
|
|
||||||
|
|
||||||
## Brainstorming Integration
|
```
|
||||||
|
User: I need a code review agent
|
||||||
|
Builder: Let's brainstorm first...
|
||||||
|
|
||||||
The optional brainstorming phase (Step -1) provides a seamless path from vague idea to concrete agent concept:
|
[Brainstorming generates ideas for strict vs friendly reviewer]
|
||||||
|
|
||||||
### When to Use Brainstorming
|
Builder: Now let's build your agent:
|
||||||
|
- Type: Simple
|
||||||
|
- Name: Code Reviewer
|
||||||
|
- Role: Senior developer conducting thorough reviews
|
||||||
|
- Style: Professional but approachable
|
||||||
|
- Commands:
|
||||||
|
- *review-pr: Review pull request
|
||||||
|
- *review-file: Review single file
|
||||||
|
- *review-standards: Check coding standards
|
||||||
|
```
|
||||||
|
|
||||||
- **Vague concept**: "I want an agent that helps with data stuff"
|
### Creating a Domain Expert
|
||||||
- **Creative exploration**: Want to discover unique personality and approach
|
|
||||||
- **Team building**: Creating agents for a module with specific roles
|
|
||||||
- **Character development**: Need to flesh out agent personality and voice
|
|
||||||
|
|
||||||
### Brainstorming Flow
|
```
|
||||||
|
Type: Expert
|
||||||
|
Name: Legal Advisor
|
||||||
|
Sidecar: legal-knowledge/
|
||||||
|
Commands:
|
||||||
|
- *contract-review
|
||||||
|
- *compliance-check
|
||||||
|
- *risk-assessment
|
||||||
|
```
|
||||||
|
|
||||||
1. **Step -1**: Optional brainstorming session
|
## Workflow Files
|
||||||
- Uses CIS brainstorming workflow with agent-specific context
|
|
||||||
- Explores identity, personality, expertise, and command concepts
|
|
||||||
- Generates detailed character and capability ideas
|
|
||||||
|
|
||||||
2. **Steps 0-2**: Agent setup informed by brainstorming
|
```
|
||||||
- Brainstorming output guides agent type selection
|
create-agent/
|
||||||
- Character concepts inform basic identity choices
|
├── workflow.yaml # Configuration
|
||||||
- Personality insights shape persona development
|
├── instructions.md # Step guide
|
||||||
|
├── checklist.md # Validation
|
||||||
3. **Seamless transition**: Vague idea → brainstormed concept → built agent
|
├── README.md # This file
|
||||||
|
├── agent-types.md # Type details
|
||||||
### Key Principle
|
├── agent-architecture.md # Patterns
|
||||||
|
├── agent-command-patterns.md # Commands
|
||||||
Users can go from **vague idea → brainstormed concept → built agent** in one continuous flow, with brainstorming output directly feeding into agent development.
|
└── communication-styles.md # Styles
|
||||||
|
```
|
||||||
|
|
||||||
## Best Practices
|
## Best Practices
|
||||||
|
|
||||||
### Before Starting
|
1. **Use brainstorming** for complex agents
|
||||||
|
2. **Start simple** - Add commands incrementally
|
||||||
|
3. **Test commands** before finalizing
|
||||||
|
4. **Document thoroughly** in descriptions
|
||||||
|
5. **Follow naming conventions** consistently
|
||||||
|
|
||||||
1. Review example agents in `/bmad/bmm/agents/` for patterns
|
## Related Documentation
|
||||||
2. Consider using brainstorming if you have a vague concept to develop
|
|
||||||
3. Have a clear vision of the agent's role and personality (or use brainstorming to develop it)
|
|
||||||
4. List the commands/capabilities the agent will need
|
|
||||||
5. Identify any workflows or tasks the agent will invoke
|
|
||||||
|
|
||||||
### During Execution
|
- [Agent Types](./agent-types.md)
|
||||||
|
- [Command Patterns](./agent-command-patterns.md)
|
||||||
1. **Agent Names**: Use memorable names that reflect personality
|
- [Communication Styles](./communication-styles.md)
|
||||||
2. **Icons**: Choose an emoji that represents the agent's role
|
- [BMB Module](../../README.md)
|
||||||
3. **Persona**: Make it distinct and consistent with communication style
|
|
||||||
4. **Commands**: Use kebab-case, start custom commands with letter (not \*)
|
|
||||||
5. **Workflows**: Reference existing workflows or mark as "todo" to implement later
|
|
||||||
|
|
||||||
### After Completion
|
|
||||||
|
|
||||||
1. **Compile the agent**:
|
|
||||||
- For standalone agents: Run `npm run build:agents` or use the installer menu
|
|
||||||
- For module agents: Automatic during module installation
|
|
||||||
2. **Test the agent**: Use the compiled `.md` agent in your IDE
|
|
||||||
3. **Implement placeholders**: Complete any "todo" workflows referenced
|
|
||||||
4. **Refine as needed**: Use customize file for persona adjustments
|
|
||||||
5. **Evolve over time**: Add new commands as requirements emerge
|
|
||||||
|
|
||||||
## Agent Types
|
|
||||||
|
|
||||||
### Simple Agent
|
|
||||||
|
|
||||||
- **Best For**: Self-contained utilities, simple assistants
|
|
||||||
- **Characteristics**: Embedded logic, no external dependencies
|
|
||||||
- **Example**: Calculator agent, random picker, simple formatter
|
|
||||||
|
|
||||||
### Expert Agent
|
|
||||||
|
|
||||||
- **Best For**: Domain-specific agents with data/memory
|
|
||||||
- **Characteristics**: Sidecar folders, domain restrictions, memory files
|
|
||||||
- **Example**: Diary keeper, project journal, personal knowledge base
|
|
||||||
|
|
||||||
### Module Agent
|
|
||||||
|
|
||||||
- **Best For**: Full-featured agents with workflows
|
|
||||||
- **Characteristics**: Part of module, commands invoke workflows
|
|
||||||
- **Example**: Product manager, architect, research assistant
|
|
||||||
|
|
||||||
## Troubleshooting
|
|
||||||
|
|
||||||
### Issue: Agent won't load
|
|
||||||
|
|
||||||
- **Solution**: Validate XML structure is correct
|
|
||||||
- **Check**: Ensure all required tags present (persona, cmds)
|
|
||||||
|
|
||||||
### Issue: Commands don't work
|
|
||||||
|
|
||||||
- **Solution**: Verify workflow paths are correct or marked "todo"
|
|
||||||
- **Check**: Test workflow invocation separately first
|
|
||||||
|
|
||||||
### Issue: Persona feels generic
|
|
||||||
|
|
||||||
- **Solution**: Review communication styles guide
|
|
||||||
- **Check**: Make identity unique and specific to role
|
|
||||||
|
|
||||||
## Customization
|
|
||||||
|
|
||||||
To modify agent building process:
|
|
||||||
|
|
||||||
1. Edit `instructions.md` to change steps
|
|
||||||
2. Update `agent-types.md` to add new agent patterns
|
|
||||||
3. Modify `agent-command-patterns.md` for new command types
|
|
||||||
4. Edit `communication-styles.md` to add personality examples
|
|
||||||
|
|
||||||
## Version History
|
|
||||||
|
|
||||||
- **v6.0.0** - BMAD Core v6 compatible
|
|
||||||
- Three agent types (Simple/Expert/Module)
|
|
||||||
- Enhanced persona development
|
|
||||||
- Command pattern library
|
|
||||||
- Validation framework
|
|
||||||
|
|
||||||
## Support
|
|
||||||
|
|
||||||
For issues or questions:
|
|
||||||
|
|
||||||
- Review example agents in `/bmad/bmm/agents/`
|
|
||||||
- Check agent documentation in this workflow folder
|
|
||||||
- Test with simple agents first, then build complexity
|
|
||||||
- Consult BMAD Method v6 documentation
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
_Part of the BMad Method v6 - BMB (BMad Builder) Module_
|
|
||||||
|
|
|
||||||
|
|
@ -1,220 +1,229 @@
|
||||||
# Build Module Workflow
|
# Create Module Workflow
|
||||||
|
|
||||||
## Overview
|
Interactive scaffolding system creating complete BMad modules with agents, workflows, tasks, and installation infrastructure.
|
||||||
|
|
||||||
The Build Module workflow is an interactive scaffolding system that creates complete BMAD modules with agents, workflows, tasks, and installation infrastructure. It serves as the primary tool for building new modules in the BMAD ecosystem, guiding users through the entire module creation process from concept to deployment-ready structure.
|
## Table of Contents
|
||||||
|
|
||||||
## Key Features
|
- [Quick Start](#quick-start)
|
||||||
|
- [Workflow Phases](#workflow-phases)
|
||||||
|
- [Output Structure](#output-structure)
|
||||||
|
- [Module Components](#module-components)
|
||||||
|
- [Best Practices](#best-practices)
|
||||||
|
|
||||||
- **Interactive Module Planning** - Collaborative session to define module concept, scope, and architecture
|
## Quick Start
|
||||||
- **Intelligent Scaffolding** - Automatic creation of proper directory structures and configuration files
|
|
||||||
- **Component Integration** - Seamless integration with create-agent and create-workflow workflows
|
|
||||||
- **Installation Infrastructure** - Complete installer setup with configuration templates
|
|
||||||
- **Module Brief Integration** - Can use existing module briefs as blueprints for accelerated development
|
|
||||||
- **Validation and Documentation** - Built-in validation checks and comprehensive README generation
|
|
||||||
|
|
||||||
## Usage
|
|
||||||
|
|
||||||
### Basic Invocation
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
|
# Basic invocation
|
||||||
workflow create-module
|
workflow create-module
|
||||||
|
|
||||||
|
# With module brief input
|
||||||
|
workflow create-module --input module-brief-{name}-{date}.md
|
||||||
|
|
||||||
|
# Via BMad Builder
|
||||||
|
*create-module
|
||||||
```
|
```
|
||||||
|
|
||||||
### With Module Brief Input
|
## Workflow Phases
|
||||||
|
|
||||||
```bash
|
### Phase 1: Concept Definition
|
||||||
# If you have a module brief from the module-brief workflow
|
|
||||||
workflow create-module --input module-brief-my-module-2024-09-26.md
|
|
||||||
```
|
|
||||||
|
|
||||||
### Configuration
|
- Define module purpose and audience
|
||||||
|
- Establish module code (kebab-case) and name
|
||||||
|
- Choose category (Domain, Creative, Technical, Business, Personal)
|
||||||
|
- Plan component architecture
|
||||||
|
|
||||||
The workflow loads critical variables from the BMB configuration:
|
**Module Brief Integration:**
|
||||||
|
|
||||||
- **custom_module_location**: Where custom modules are created (default: `bmad/`)
|
- Auto-detects existing briefs
|
||||||
- **user_name**: Module author information
|
- Uses as pre-populated blueprint
|
||||||
- **date**: Automatic timestamp for versioning
|
- Accelerates planning phase
|
||||||
|
|
||||||
## Workflow Structure
|
### Phase 2: Architecture Planning
|
||||||
|
|
||||||
### Files Included
|
- Create directory hierarchy
|
||||||
|
- Setup configuration system
|
||||||
|
- Define installer structure
|
||||||
|
- Establish component folders
|
||||||
|
|
||||||
|
### Phase 3: Component Creation
|
||||||
|
|
||||||
|
- Optional first agent creation
|
||||||
|
- Optional first workflow creation
|
||||||
|
- Component placeholder generation
|
||||||
|
- Integration validation
|
||||||
|
|
||||||
|
### Phase 4: Installation Setup
|
||||||
|
|
||||||
|
- Create install-config.yaml
|
||||||
|
- Configure deployment questions
|
||||||
|
- Setup installer logic
|
||||||
|
- Post-install messaging
|
||||||
|
|
||||||
|
### Phase 5: Documentation
|
||||||
|
|
||||||
|
- Generate comprehensive README
|
||||||
|
- Create development roadmap
|
||||||
|
- Provide quick commands
|
||||||
|
- Document next steps
|
||||||
|
|
||||||
|
## Output Structure
|
||||||
|
|
||||||
|
### Generated Directory
|
||||||
|
|
||||||
```
|
```
|
||||||
create-module/
|
bmad/{module-code}/
|
||||||
├── workflow.yaml # Configuration and metadata
|
├── agents/ # Agent definitions
|
||||||
├── instructions.md # Step-by-step execution guide
|
├── workflows/ # Workflow processes
|
||||||
├── checklist.md # Validation criteria
|
├── tasks/ # Reusable tasks
|
||||||
├── module-structure.md # Module architecture guide
|
├── templates/ # Document templates
|
||||||
├── installer-templates/ # Installation templates
|
├── data/ # Module data files
|
||||||
|
├── _module-installer/ # Installation logic
|
||||||
│ ├── install-config.yaml
|
│ ├── install-config.yaml
|
||||||
│ └── installer.js
|
│ └── installer.js
|
||||||
└── README.md # This file
|
├── README.md # Module documentation
|
||||||
|
├── TODO.md # Development roadmap
|
||||||
|
└── config.yaml # Runtime configuration
|
||||||
```
|
```
|
||||||
|
|
||||||
## Workflow Process
|
### Configuration Files
|
||||||
|
|
||||||
### Phase 1: Concept Definition (Steps 1-2)
|
**install-config.yaml** - Installation questions
|
||||||
|
|
||||||
**Module Vision and Identity**
|
```yaml
|
||||||
|
questions:
|
||||||
|
- id: user_name
|
||||||
|
prompt: 'Your name?'
|
||||||
|
default: 'User'
|
||||||
|
- id: output_folder
|
||||||
|
prompt: 'Output location?'
|
||||||
|
default: './output'
|
||||||
|
```
|
||||||
|
|
||||||
- Define module concept, purpose, and target audience
|
**config.yaml** - Generated from user answers during install
|
||||||
- Establish module code (kebab-case) and friendly name
|
|
||||||
- Choose module category (Domain-Specific, Creative, Technical, Business, Personal)
|
|
||||||
- Plan component architecture with agent and workflow specifications
|
|
||||||
|
|
||||||
**Module Brief Integration**
|
```yaml
|
||||||
|
user_name: 'John Doe'
|
||||||
|
output_folder: './my-output'
|
||||||
|
```
|
||||||
|
|
||||||
- Automatically detects existing module briefs in output folder
|
## Module Components
|
||||||
- Can load and use briefs as pre-populated blueprints
|
|
||||||
- Accelerates planning when comprehensive brief exists
|
|
||||||
|
|
||||||
### Phase 2: Architecture Planning (Steps 3-4)
|
### Agents
|
||||||
|
|
||||||
**Directory Structure Creation**
|
- Full module agents with workflows
|
||||||
|
- Expert agents with sidecars
|
||||||
|
- Simple utility agents
|
||||||
|
|
||||||
- Creates complete module directory hierarchy
|
### Workflows
|
||||||
- Sets up agent, workflow, task, template, and data folders
|
|
||||||
- Establishes installer directory with proper configuration
|
|
||||||
|
|
||||||
**Module Configuration**
|
- Multi-step guided processes
|
||||||
|
- Configuration-driven
|
||||||
|
- Web bundle support
|
||||||
|
|
||||||
- Defines configuration questions in install-config.yaml (config.yaml generated during installation)
|
### Tasks
|
||||||
- Configures component counts and references
|
|
||||||
- Sets up output and data folder specifications
|
|
||||||
|
|
||||||
### Phase 3: Component Creation (Steps 5-6)
|
- Reusable operations
|
||||||
|
- Agent-agnostic
|
||||||
|
- Modular components
|
||||||
|
|
||||||
**Interactive Component Building**
|
### Templates
|
||||||
|
|
||||||
- Optional creation of first agent using create-agent workflow
|
- Document structures
|
||||||
- Optional creation of first workflow using create-workflow workflow
|
- Output formats
|
||||||
- Creates placeholders for components to be built later
|
- Report templates
|
||||||
|
|
||||||
**Workflow Integration**
|
|
||||||
|
|
||||||
- Seamlessly invokes sub-workflows for component creation
|
|
||||||
- Ensures proper file placement and structure
|
|
||||||
- Maintains module consistency across components
|
|
||||||
|
|
||||||
### Phase 4: Installation and Documentation (Steps 7-9)
|
|
||||||
|
|
||||||
**Installer Infrastructure**
|
|
||||||
|
|
||||||
- Creates install-config.yaml with configuration questions for deployment
|
|
||||||
- Sets up optional installer.js for complex installation logic
|
|
||||||
- Configures post-install messaging and instructions
|
|
||||||
|
|
||||||
**Comprehensive Documentation**
|
|
||||||
|
|
||||||
- Generates detailed README.md with usage examples
|
|
||||||
- Creates development roadmap for remaining components
|
|
||||||
- Provides quick commands for continued development
|
|
||||||
|
|
||||||
### Phase 5: Validation and Finalization (Step 10)
|
|
||||||
|
|
||||||
**Quality Assurance**
|
|
||||||
|
|
||||||
- Validates directory structure and configuration files
|
|
||||||
- Checks component references and path consistency
|
|
||||||
- Ensures installer configuration is deployment-ready
|
|
||||||
- Provides comprehensive module summary and next steps
|
|
||||||
|
|
||||||
## Output
|
|
||||||
|
|
||||||
### Generated Files
|
|
||||||
|
|
||||||
- **Module Directory**: Complete module structure at `{project-root}/bmad/{module_code}/`
|
|
||||||
- **Configuration Files**:
|
|
||||||
- Source: install-config.yaml (configuration questions)
|
|
||||||
- Target: config.yaml (generated from user answers during installation)
|
|
||||||
- **Documentation**: README.md, TODO.md development roadmap
|
|
||||||
- **Component Placeholders**: Structured folders for agents, workflows, and tasks
|
|
||||||
|
|
||||||
### Output Structure
|
|
||||||
|
|
||||||
The workflow creates a complete module ready for development:
|
|
||||||
|
|
||||||
1. **Module Identity** - Name, code, version, and metadata
|
|
||||||
2. **Directory Structure** - Proper BMAD module hierarchy
|
|
||||||
3. **Configuration System** - Runtime and installation configs
|
|
||||||
4. **Component Framework** - Ready-to-use agent and workflow scaffolding
|
|
||||||
5. **Installation Infrastructure** - Deployment-ready installer
|
|
||||||
6. **Documentation Suite** - README, roadmap, and development guides
|
|
||||||
|
|
||||||
## Requirements
|
|
||||||
|
|
||||||
- **Module Brief** (optional but recommended) - Use module-brief workflow first for best results
|
|
||||||
- **BMAD Core Configuration** - Properly configured BMB config.yaml
|
|
||||||
- **Build Tools Access** - create-agent and create-workflow workflows must be available
|
|
||||||
|
|
||||||
## Best Practices
|
## Best Practices
|
||||||
|
|
||||||
### Before Starting
|
### Planning
|
||||||
|
|
||||||
1. **Create a Module Brief** - Run module-brief workflow for comprehensive planning
|
1. **Use module-brief workflow first** - Creates comprehensive blueprint
|
||||||
2. **Review Existing Modules** - Study similar modules in `/bmad/` for patterns and inspiration
|
2. **Define clear scope** - Avoid feature creep
|
||||||
3. **Define Clear Scope** - Have a concrete vision of what the module will accomplish
|
3. **Plan component interactions** - Map agent/workflow relationships
|
||||||
|
|
||||||
### During Execution
|
### Structure
|
||||||
|
|
||||||
1. **Use Module Briefs** - Load existing briefs when prompted for accelerated development
|
1. **Follow conventions** - Use established patterns
|
||||||
2. **Start Simple** - Create one core agent and workflow, then expand iteratively
|
2. **Keep components focused** - Single responsibility
|
||||||
3. **Leverage Sub-workflows** - Use create-agent and create-workflow for quality components
|
3. **Document thoroughly** - Clear README and inline docs
|
||||||
4. **Validate Early** - Review generated structure before proceeding to next phases
|
|
||||||
|
|
||||||
### After Completion
|
### Development
|
||||||
|
|
||||||
1. **Follow the Roadmap** - Use generated TODO.md for systematic development
|
1. **Start with core agent** - Build primary functionality first
|
||||||
2. **Test Installation** - Validate installer with `bmad install {module_code}`
|
2. **Create key workflows** - Essential processes before edge cases
|
||||||
3. **Iterate Components** - Use quick commands to add agents and workflows
|
3. **Test incrementally** - Validate as you build
|
||||||
4. **Document Progress** - Update README.md as the module evolves
|
|
||||||
|
|
||||||
## Troubleshooting
|
### Installation
|
||||||
|
|
||||||
### Common Issues
|
1. **Minimal config questions** - Only essential settings
|
||||||
|
2. **Smart defaults** - Sensible out-of-box experience
|
||||||
|
3. **Clear post-install** - Guide users to first steps
|
||||||
|
|
||||||
**Issue**: Module already exists at target location
|
## Integration Points
|
||||||
|
|
||||||
- **Solution**: Choose a different module code or remove existing module
|
### With Other Workflows
|
||||||
- **Check**: Verify output folder permissions and available space
|
|
||||||
|
|
||||||
**Issue**: Sub-workflow invocation fails
|
- **module-brief** - Strategic planning input
|
||||||
|
- **create-agent** - Agent component creation
|
||||||
|
- **create-workflow** - Workflow building
|
||||||
|
- **redoc** - Documentation maintenance
|
||||||
|
|
||||||
- **Solution**: Ensure create-agent and create-workflow workflows are available
|
### With BMad Core
|
||||||
- **Check**: Validate workflow paths in config.yaml
|
|
||||||
|
|
||||||
**Issue**: Installation configuration invalid
|
- Uses core framework capabilities
|
||||||
|
- Integrates with module system
|
||||||
|
- Follows BMad conventions
|
||||||
|
|
||||||
- **Solution**: Review install-config.yaml syntax and paths
|
## Examples
|
||||||
- **Check**: Ensure all referenced paths use {project-root} variables correctly
|
|
||||||
|
|
||||||
## Customization
|
### Domain-Specific Module
|
||||||
|
|
||||||
To customize this workflow:
|
```
|
||||||
|
Category: Domain-Specific
|
||||||
|
Code: legal-advisor
|
||||||
|
Components:
|
||||||
|
- Contract Review Agent
|
||||||
|
- Compliance Workflow
|
||||||
|
- Legal Templates
|
||||||
|
```
|
||||||
|
|
||||||
1. **Modify Instructions** - Update instructions.md to adjust scaffolding steps
|
### Creative Module
|
||||||
2. **Extend Templates** - Add new installer templates in installer-templates/
|
|
||||||
3. **Update Validation** - Enhance checklist.md with additional quality checks
|
|
||||||
4. **Add Components** - Integrate additional sub-workflows for specialized components
|
|
||||||
|
|
||||||
## Version History
|
```
|
||||||
|
Category: Creative
|
||||||
|
Code: story-builder
|
||||||
|
Components:
|
||||||
|
- Narrative Agent
|
||||||
|
- Plot Workflow
|
||||||
|
- Character Templates
|
||||||
|
```
|
||||||
|
|
||||||
- **v1.0.0** - Initial release
|
### Technical Module
|
||||||
- Interactive module scaffolding
|
|
||||||
- Component integration with create-agent and create-workflow
|
|
||||||
- Complete installation infrastructure
|
|
||||||
- Module brief integration support
|
|
||||||
|
|
||||||
## Support
|
```
|
||||||
|
Category: Technical
|
||||||
|
Code: api-tester
|
||||||
|
Components:
|
||||||
|
- Test Runner Agent
|
||||||
|
- API Validation Workflow
|
||||||
|
- Test Report Templates
|
||||||
|
```
|
||||||
|
|
||||||
For issues or questions:
|
## Workflow Files
|
||||||
|
|
||||||
- Review the workflow creation guide at `/bmad/bmb/workflows/create-workflow/workflow-creation-guide.md`
|
```
|
||||||
- Study module structure patterns at `module-structure.md`
|
create-module/
|
||||||
- Validate output using `checklist.md`
|
├── workflow.yaml # Configuration
|
||||||
- Consult existing modules in `/bmad/` for examples
|
├── instructions.md # Step guide
|
||||||
|
├── checklist.md # Validation
|
||||||
|
├── module-structure.md # Architecture
|
||||||
|
├── installer-templates/ # Install files
|
||||||
|
└── README.md # This file
|
||||||
|
```
|
||||||
|
|
||||||
---
|
## Related Documentation
|
||||||
|
|
||||||
_Part of the BMad Method v6 - BMB (Builder) Module_
|
- [Module Structure](./module-structure.md)
|
||||||
|
- [Module Brief Workflow](../module-brief/README.md)
|
||||||
|
- [Create Agent](../create-agent/README.md)
|
||||||
|
- [Create Workflow](../create-workflow/README.md)
|
||||||
|
- [BMB Module](../../README.md)
|
||||||
|
|
|
||||||
|
|
@ -1,141 +1,144 @@
|
||||||
# BMM - BMad Method Module
|
# BMM - BMad Method Module
|
||||||
|
|
||||||
The BMM (BMad Method Module) is the core orchestration system for the BMad Method, providing comprehensive software development lifecycle management through specialized agents, workflows, teams, and tasks.
|
Core orchestration system for AI-driven agile development, providing comprehensive lifecycle management through specialized agents and workflows.
|
||||||
|
|
||||||
## 📚 Essential Reading
|
## Table of Contents
|
||||||
|
|
||||||
**Before using BMM, you MUST read the [BMM v6 Workflows Guide](./workflows/README.md).** This document explains the revolutionary v6a workflow system and how all components work together.
|
- [Essential Reading](#essential-reading)
|
||||||
|
- [Module Structure](#module-structure)
|
||||||
|
- [Quick Start](#quick-start)
|
||||||
|
- [Key Concepts](#key-concepts)
|
||||||
|
- [Scale Levels](#scale-levels)
|
||||||
|
- [Story Lifecycle](#story-lifecycle)
|
||||||
|
- [Best Practices](#best-practices)
|
||||||
|
|
||||||
|
## Essential Reading
|
||||||
|
|
||||||
|
**[📖 BMM v6 Workflows Guide](./workflows/README.md)** - Required reading before using BMM. Explains the revolutionary workflow system and component integration.
|
||||||
|
|
||||||
## Module Structure
|
## Module Structure
|
||||||
|
|
||||||
### 🤖 `/agents`
|
### 🤖 Agents
|
||||||
|
|
||||||
Specialized AI agents for different development roles:
|
**Core Development Roles:**
|
||||||
|
|
||||||
- **PM** (Product Manager) - Product planning and requirements
|
- **PM** - Product Manager for planning and requirements
|
||||||
- **Analyst** - Business analysis and research
|
- **Analyst** - Business analysis and research
|
||||||
- **Architect** - Technical architecture and design
|
- **Architect** - Technical architecture and design
|
||||||
- **SM** (Scrum Master) - Sprint and story management
|
- **SM** - Scrum Master for sprint and story management
|
||||||
- **DEV** (Developer) - Code implementation
|
- **DEV** - Developer for implementation
|
||||||
- **TEA** (Test Architect) - Test Architect
|
- **TEA** - Test Architect for quality assurance
|
||||||
- **UX** - User experience design
|
- **UX** - User experience design
|
||||||
- And more specialized roles
|
|
||||||
|
|
||||||
**Game Development Agents** (Optional):
|
**Game Development** (Optional):
|
||||||
During installation, you can optionally include game development specialists:
|
|
||||||
|
|
||||||
- **Game Designer** - Creative vision and game design documents (GDD)
|
- **Game Designer** - Creative vision and GDD creation
|
||||||
- **Game Developer** - Game-specific implementation
|
- **Game Developer** - Game-specific implementation
|
||||||
- **Game Architect** - Game systems and technical infrastructure
|
- **Game Architect** - Game systems and infrastructure
|
||||||
|
|
||||||
These agents come with specialized workflows (`brainstorm-game`, `game-brief`, `gdd`) and are only installed if you select "Include Game Planning Agents and Workflows" during BMM installation.
|
### 📋 Workflows
|
||||||
|
|
||||||
### 📋 `/workflows`
|
Four-phase methodology adapting to project complexity:
|
||||||
|
|
||||||
The heart of BMM - structured workflows for the four development phases:
|
**1. Analysis** (Optional)
|
||||||
|
|
||||||
1. **Analysis Phase** (Optional)
|
- `brainstorm-project` - Project ideation
|
||||||
- `brainstorm-project` - Project ideation
|
- `research` - Market/technical research
|
||||||
- `research` - Market/technical research
|
- `product-brief` - Product strategy
|
||||||
- `product-brief` - Product strategy
|
|
||||||
|
|
||||||
2. **Planning Phase** (Required)
|
**2. Planning** (Required)
|
||||||
- `prd` - Scale-adaptive project planning
|
|
||||||
- Routes to appropriate documentation based on project complexity
|
|
||||||
|
|
||||||
3. **Solutioning Phase** (Level 3-4 projects)
|
- `prd` - Scale-adaptive planning
|
||||||
- `3-solutioning` - Architecture design
|
- Routes to appropriate documentation level
|
||||||
- `tech-spec` - Epic-specific technical specifications
|
|
||||||
|
|
||||||
4. **Implementation Phase** (Iterative)
|
**3. Solutioning** (Level 3-4)
|
||||||
- `create-story` - Story drafting (SM agent)
|
|
||||||
- `story-ready` - Approve story for development (SM agent)
|
|
||||||
- `story-context` - Expertise injection (SM agent)
|
|
||||||
- `dev-story` - Implementation (DEV agent)
|
|
||||||
- `story-done` - Mark story done (DEV agent)
|
|
||||||
- `code-review` - Quality validation (DEV/SR agent)
|
|
||||||
- `correct-course` - Issue resolution
|
|
||||||
- `retrospective` - Continuous improvement
|
|
||||||
|
|
||||||
### 👥 `/teams`
|
- `architecture` - System design
|
||||||
|
- `tech-spec` - Epic technical specifications
|
||||||
|
|
||||||
Pre-configured agent teams for different project types and phases. Teams coordinate multiple agents working together on complex tasks.
|
**4. Implementation** (Iterative)
|
||||||
|
|
||||||
### 📝 `/tasks`
|
- `create-story` - Draft stories
|
||||||
|
- `story-context` - Inject expertise
|
||||||
|
- `dev-story` - Implement
|
||||||
|
- `code-review` - Validate quality
|
||||||
|
|
||||||
Reusable task definitions that agents execute within workflows. These are the atomic units of work that compose into larger workflows.
|
### 👥 Teams
|
||||||
|
|
||||||
### 🔧 `/sub-modules`
|
Pre-configured agent groups for coordinated complex tasks.
|
||||||
|
|
||||||
Extension modules that add specialized capabilities to BMM.
|
### 📝 Tasks
|
||||||
|
|
||||||
### 🏗️ `/testarch`
|
Atomic work units composing into larger workflows.
|
||||||
|
|
||||||
Test architecture and quality assurance components. The **[Test Architect (TEA) Guide](./testarch/README.md)** provides comprehensive testing strategy across 9 workflows: framework setup, CI/CD, test design, ATDD, automation, traceability, NFR assessment, quality gates, and test review.
|
### 🏗️ Test Architecture
|
||||||
|
|
||||||
|
**[TEA Guide](./testarch/README.md)** - Comprehensive testing strategy across 9 specialized workflows.
|
||||||
|
|
||||||
## Quick Start
|
## Quick Start
|
||||||
|
|
||||||
```bash
|
1. **Load PM agent** in your IDE
|
||||||
# Load the PM agent - either via slash command or drag and drop or @ the agent file.
|
2. **Wait for menu** to appear
|
||||||
# Once loaded, the agent should greet you and offer a menu of options. You can enter:
|
3. **Run workflow:**
|
||||||
`*prd`
|
```
|
||||||
```
|
*prd
|
||||||
|
```
|
||||||
|
|
||||||
|
**IDE Instructions:**
|
||||||
|
|
||||||
|
- [Claude Code](../../docs/ide-info/claude-code.md)
|
||||||
|
- [Cursor](../../docs/ide-info/cursor.md)
|
||||||
|
- [VS Code](../../docs/ide-info/windsurf.md)
|
||||||
|
- [Others](../../docs/ide-info/)
|
||||||
|
|
||||||
## Key Concepts
|
## Key Concepts
|
||||||
|
|
||||||
### Scale Levels
|
### Scale Levels
|
||||||
|
|
||||||
BMM automatically adapts to project complexity:
|
BMM automatically adapts complexity:
|
||||||
|
|
||||||
- **Level 0**: Single atomic change
|
| Level | Stories | Documentation |
|
||||||
- **Level 1**: 1-10 stories, minimal documentation
|
| ----- | ------------- | ----------------- |
|
||||||
- **Level 2**: 5-15 stories, focused PRD
|
| 0 | Single change | Minimal |
|
||||||
- **Level 3**: 12-40 stories, full architecture
|
| 1 | 1-10 | Light PRD |
|
||||||
- **Level 4**: 40+ stories, enterprise scale
|
| 2 | 5-15 | Focused PRD |
|
||||||
|
| 3 | 12-40 | Full architecture |
|
||||||
|
| 4 | 40+ | Enterprise scale |
|
||||||
|
|
||||||
### Just-In-Time Design
|
### Story Lifecycle
|
||||||
|
|
||||||
Technical specifications are created one epic at a time during implementation, not all upfront, allowing for learning and adaptation.
|
Four-state machine tracked in status file:
|
||||||
|
|
||||||
### Story State Machine
|
|
||||||
|
|
||||||
Stories flow through a 4-state lifecycle tracked in the status file:
|
|
||||||
|
|
||||||
```
|
```
|
||||||
BACKLOG → TODO → IN PROGRESS → DONE
|
BACKLOG → TODO → IN PROGRESS → DONE
|
||||||
```
|
```
|
||||||
|
|
||||||
- **BACKLOG**: Ordered list of stories to be drafted (populated at phase transition)
|
- **BACKLOG** - Ordered stories to draft
|
||||||
- **TODO**: Single story ready for SM to draft (or drafted, awaiting approval)
|
- **TODO** - Ready for SM drafting
|
||||||
- **IN PROGRESS**: Single story approved for DEV to implement
|
- **IN PROGRESS** - Approved for DEV
|
||||||
- **DONE**: Completed stories with dates and points
|
- **DONE** - Completed with metrics
|
||||||
|
|
||||||
Agents never search for "next story" - they always read the exact story from the status file. Simple workflows (`story-ready`, `story-done`) advance the queue automatically.
|
### Just-In-Time Design
|
||||||
|
|
||||||
|
Technical specifications created per epic during implementation, enabling learning and adaptation.
|
||||||
|
|
||||||
### Context Injection
|
### Context Injection
|
||||||
|
|
||||||
Story-specific technical guidance is generated dynamically, providing developers with exactly the expertise needed for each task.
|
Dynamic technical guidance generated for each story, providing exact expertise when needed.
|
||||||
|
|
||||||
## Integration with BMad Core
|
|
||||||
|
|
||||||
BMM integrates seamlessly with the BMad Core framework, leveraging:
|
|
||||||
|
|
||||||
- The agent execution engine
|
|
||||||
- Workflow orchestration
|
|
||||||
- Task management
|
|
||||||
- Team coordination
|
|
||||||
|
|
||||||
## Related Documentation
|
|
||||||
|
|
||||||
- [BMM Workflows Guide](./workflows/README.md) - **Start here!**
|
|
||||||
- [Test Architect (TEA) Guide](./testarch/README.md) - Quality assurance and testing strategy
|
|
||||||
|
|
||||||
## Best Practices
|
## Best Practices
|
||||||
|
|
||||||
1. **Always start with the workflows** - Let workflows guide your process
|
1. **Start with workflows** - Let process guide you
|
||||||
2. **Respect the scale** - Don't over-document small projects
|
2. **Respect scale** - Don't over-document small projects
|
||||||
3. **Trust the process** - The methodology has been carefully designed
|
3. **Trust the process** - Methodology carefully designed
|
||||||
|
4. **Use status file** - Single source of truth for stories
|
||||||
|
|
||||||
|
## Related Documentation
|
||||||
|
|
||||||
|
- **[Workflows Guide](./workflows/README.md)** - Complete workflow reference
|
||||||
|
- **[Test Architect Guide](./testarch/README.md)** - Testing strategy
|
||||||
|
- **[IDE Setup](../../docs/ide-info/)** - Environment configuration
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
For detailed information about the complete BMad Method workflow system, see the [BMM Workflows README](./workflows/README.md).
|
For complete BMad Method workflow system details, see the [BMM Workflows README](./workflows/README.md).
|
||||||
|
|
|
||||||
|
|
@ -1,29 +1,113 @@
|
||||||
---
|
|
||||||
last-redoc-date: 2025-10-01
|
|
||||||
---
|
|
||||||
|
|
||||||
# Project Brainstorming Workflow
|
# Project Brainstorming Workflow
|
||||||
|
|
||||||
This workflow facilitates structured ideation for non-game software projects through systematic exploration of problem spaces, architectures, and implementation strategies. Unlike traditional requirement gathering, it employs creative techniques to uncover non-obvious approaches and identify innovative solutions that address core business needs while considering technical constraints and organizational capabilities.
|
Structured ideation for software projects exploring problem spaces, architectures, and innovative solutions beyond traditional requirements gathering.
|
||||||
|
|
||||||
The workflow operates through a project-specific context framework that captures business objectives, technical environment, stakeholder needs, and organizational constraints. It generates multiple solution vectors through parallel ideation tracks: architectural approaches, user experience paradigms, integration patterns, and value delivery mechanisms. Each track produces concrete proposals that are evaluated against feasibility, impact, and alignment with strategic objectives.
|
## Table of Contents
|
||||||
|
|
||||||
Critical differentiators include its focus on solution innovation rather than requirement enumeration, emphasis on technical-business alignment from inception, and structured approach to surfacing hidden assumptions. The workflow produces actionable outputs that directly feed into Product Brief development, ensuring that creative exploration translates into concrete planning artifacts.
|
- [Purpose](#purpose)
|
||||||
|
- [Usage](#usage)
|
||||||
|
- [Process](#process)
|
||||||
|
- [Inputs & Outputs](#inputs--outputs)
|
||||||
|
- [Integration](#integration)
|
||||||
|
|
||||||
|
## Purpose
|
||||||
|
|
||||||
|
Generate multiple solution approaches for software projects through:
|
||||||
|
|
||||||
|
- Parallel ideation tracks (architecture, UX, integration, value delivery)
|
||||||
|
- Technical-business alignment from inception
|
||||||
|
- Hidden assumption discovery
|
||||||
|
- Innovation beyond obvious solutions
|
||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
bmad bmm 1-analysis brainstorm-project
|
# Run brainstorming session
|
||||||
|
bmad bmm *brainstorm-project
|
||||||
|
|
||||||
|
# Or via Analyst agent
|
||||||
|
*brainstorm-project
|
||||||
```
|
```
|
||||||
|
|
||||||
## Inputs
|
## Process
|
||||||
|
|
||||||
- **Project Context Document**: Business objectives, technical environment, stakeholder landscape, organizational constraints, success criteria, and known pain points
|
### 1. Context Capture
|
||||||
- **Problem Statement** (optional): Core business challenge or opportunity driving the project
|
|
||||||
|
|
||||||
## Outputs
|
- Business objectives and constraints
|
||||||
|
- Technical environment
|
||||||
|
- Stakeholder needs
|
||||||
|
- Success criteria
|
||||||
|
|
||||||
- **Architecture Proposals**: Multiple technical approaches with trade-off analysis and feasibility assessments
|
### 2. Parallel Ideation
|
||||||
- **Value Delivery Framework**: Prioritized feature concepts aligned with business objectives and user needs
|
|
||||||
- **Risk and Opportunity Analysis**: Identified technical dependencies, integration challenges, and innovation opportunities
|
- **Architecture Track**: Technical approaches with trade-offs
|
||||||
- **Strategic Recommendation**: Synthesized direction with rationale and implementation considerations
|
- **UX Track**: Interface paradigms and user journeys
|
||||||
|
- **Integration Track**: System connection patterns
|
||||||
|
- **Value Track**: Feature prioritization and delivery
|
||||||
|
|
||||||
|
### 3. Solution Synthesis
|
||||||
|
|
||||||
|
- Evaluate feasibility and impact
|
||||||
|
- Align with strategic objectives
|
||||||
|
- Surface hidden assumptions
|
||||||
|
- Generate recommendations
|
||||||
|
|
||||||
|
## Inputs & Outputs
|
||||||
|
|
||||||
|
### Inputs
|
||||||
|
|
||||||
|
| Input | Type | Purpose |
|
||||||
|
| ----------------- | -------- | --------------------------------------------- |
|
||||||
|
| Project Context | Document | Business objectives, environment, constraints |
|
||||||
|
| Problem Statement | Optional | Core challenge or opportunity |
|
||||||
|
|
||||||
|
### Outputs
|
||||||
|
|
||||||
|
| Output | Content |
|
||||||
|
| ------------------------ | ------------------------------------------- |
|
||||||
|
| Architecture Proposals | Multiple approaches with trade-off analysis |
|
||||||
|
| Value Framework | Prioritized features aligned to objectives |
|
||||||
|
| Risk Analysis | Dependencies, challenges, opportunities |
|
||||||
|
| Strategic Recommendation | Synthesized direction with rationale |
|
||||||
|
|
||||||
|
## Integration
|
||||||
|
|
||||||
|
### Workflow Chain
|
||||||
|
|
||||||
|
1. **brainstorm-project** ← Current step
|
||||||
|
2. research (optional deep dive)
|
||||||
|
3. product-brief (strategic document)
|
||||||
|
4. Phase 2 planning (PRD/tech-spec)
|
||||||
|
|
||||||
|
### Feed Into
|
||||||
|
|
||||||
|
- Product Brief development
|
||||||
|
- Architecture decisions
|
||||||
|
- PRD requirements
|
||||||
|
- Epic prioritization
|
||||||
|
|
||||||
|
## Best Practices
|
||||||
|
|
||||||
|
1. **Prepare context** - Gather business and technical background
|
||||||
|
2. **Think broadly** - Explore non-obvious approaches
|
||||||
|
3. **Document assumptions** - Capture implicit beliefs
|
||||||
|
4. **Consider constraints** - Technical, organizational, resource
|
||||||
|
5. **Focus on value** - Align to business objectives
|
||||||
|
|
||||||
|
## Configuration
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
# bmad/bmm/config.yaml
|
||||||
|
output_folder: ./output
|
||||||
|
project_name: Your Project
|
||||||
|
```
|
||||||
|
|
||||||
|
## Related Workflows
|
||||||
|
|
||||||
|
- [Research](../research/README.md) - Deep investigation
|
||||||
|
- [Product Brief](../product-brief/README.md) - Strategic planning
|
||||||
|
- [PRD](../../2-plan-workflows/prd/README.md) - Requirements document
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
Part of BMad Method v6 - Phase 1 Analysis workflows
|
||||||
|
|
|
||||||
|
|
@ -1,129 +1,146 @@
|
||||||
---
|
|
||||||
last-redoc-date: 2025-10-01
|
|
||||||
---
|
|
||||||
|
|
||||||
# Create Story Workflow
|
# Create Story Workflow
|
||||||
|
|
||||||
The create-story workflow is the entry point for v6's just-in-time story generation approach, run exclusively by the Scrum Master (SM) agent. Unlike batch processing methodologies, this workflow generates exactly ONE story at a time based on the current epic backlog state, ensuring stories are created only when needed and with the most current context. The SM analyzes the epic's progress, identifies what needs to be built next based on epics.md enumeration, and generates a complete story specification including acceptance criteria, technical approach, and implementation guidance pulled directly from tech specs, PRD, and architecture documentation.
|
Just-in-time story generation creating one story at a time based on epic backlog state. Run by Scrum Master (SM) agent to ensure planned stories align with approved epics.
|
||||||
|
|
||||||
This workflow represents a fundamental shift from traditional upfront planning to adaptive story generation. By creating stories one at a time and enforcing strict verification against epics.md, the SM ensures that only planned and approved stories are created. The workflow operates in non-interactive "#yolo" mode by default, minimizing prompts while maintaining quality through rigorous source document grounding. It will HALT if epics.md doesn't explicitly enumerate the next story, forcing proper planning through the correct-course workflow rather than allowing ad-hoc story creation.
|
## Table of Contents
|
||||||
|
|
||||||
The workflow's intelligent document discovery system automatically finds the relevant tech spec for the current epic (using pattern `tech-spec-epic-{epic_num}-*.md`), loads all architecture documents from both docs/ and output folders, and synthesizes requirements from multiple sources in priority order. After story creation, it can optionally trigger the story-context workflow to generate just-in-time technical expertise for the developer.
|
- [Usage](#usage)
|
||||||
|
- [Key Features](#key-features)
|
||||||
|
- [Inputs & Outputs](#inputs--outputs)
|
||||||
|
- [Workflow Behavior](#workflow-behavior)
|
||||||
|
- [Integration](#integration)
|
||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# SM initiates story creation for the next piece of work
|
# SM initiates next story creation
|
||||||
bmad sm *create-story
|
bmad sm *create-story
|
||||||
```
|
```
|
||||||
|
|
||||||
The SM runs this workflow when:
|
**When to run:**
|
||||||
|
|
||||||
- The current sprint has capacity for new work
|
- Sprint has capacity for new work
|
||||||
- The previous story status is "Done" or "Approved"
|
- Previous story is Done/Approved
|
||||||
- The team is ready for the next planned story in the epic
|
- Team ready for next planned story
|
||||||
- Story preparation is needed before development
|
|
||||||
|
|
||||||
## Inputs
|
|
||||||
|
|
||||||
**Required Context Files:**
|
|
||||||
|
|
||||||
- **epics.md**: MANDATORY - Must explicitly enumerate the next story or workflow halts
|
|
||||||
- **tech-spec-epic-{N}-\*.md**: Epic-specific technical specification (auto-discovered)
|
|
||||||
- **PRD.md**: Product requirements document (fallback for requirements)
|
|
||||||
- **Architecture Documents**: Automatically discovered from docs/ and output folders:
|
|
||||||
- tech-stack.md, unified-project-structure.md, coding-standards.md
|
|
||||||
- testing-strategy.md, backend-architecture.md, frontend-architecture.md
|
|
||||||
- data-models.md, database-schema.md, rest-api-spec.md, external-apis.md
|
|
||||||
|
|
||||||
**Workflow Variables:**
|
|
||||||
|
|
||||||
- `story_dir`: From config `dev_story_location` - where stories are saved
|
|
||||||
- `epic_num`: Current epic number (auto-detected from existing stories)
|
|
||||||
- `story_num`: Next story number (incremented from last completed story)
|
|
||||||
- `auto_run_context`: Default true - runs story-context workflow after creation
|
|
||||||
- `non_interactive`: Default true - operates in "#yolo" mode with minimal prompts
|
|
||||||
|
|
||||||
## Outputs
|
|
||||||
|
|
||||||
**Primary Deliverable:**
|
|
||||||
|
|
||||||
- **Story Document** (`{story_dir}/story-{epic_num}.{story_num}.md`): Complete story specification including:
|
|
||||||
- User story statement (role, action, benefit)
|
|
||||||
- Acceptance criteria extracted from tech spec or epics.md
|
|
||||||
- Tasks and subtasks mapped to ACs
|
|
||||||
- Testing requirements per testing strategy
|
|
||||||
- Dev notes with source citations
|
|
||||||
- Status: "Draft" (requires approval before development)
|
|
||||||
|
|
||||||
**Validation Safeguards:**
|
|
||||||
|
|
||||||
- **Epic Enumeration Check**: If epics.md doesn't list the next story, workflow HALTS with:
|
|
||||||
```
|
|
||||||
"No planned next story found in epics.md for epic {epic_num}.
|
|
||||||
Please load either PM or SM agent and run *correct-course to add/modify epic stories."
|
|
||||||
```
|
|
||||||
- **Status Check**: Won't create new story if current story isn't Done/Approved
|
|
||||||
- **Document Grounding**: All requirements traced to source documents (no invention)
|
|
||||||
|
|
||||||
## Key Features
|
## Key Features
|
||||||
|
|
||||||
**Strict Planning Enforcement**: The workflow will NOT create stories that aren't explicitly planned in epics.md. This prevents scope creep and ensures all work is properly approved through the planning process.
|
### Strict Planning Enforcement
|
||||||
|
|
||||||
**Intelligent Document Discovery**: Automatically finds the latest tech spec for the epic using glob patterns, discovers all architecture documents across multiple directories, and builds a prioritized document set for requirement extraction.
|
- **Only creates stories enumerated in epics.md**
|
||||||
|
- Halts if story not found in epic plan
|
||||||
|
- Prevents scope creep through validation
|
||||||
|
|
||||||
**Source Document Grounding**: Every requirement, acceptance criterion, and technical constraint is traced to a specific source document. The workflow explicitly forbids inventing domain facts not present in source materials.
|
### Intelligent Document Discovery
|
||||||
|
|
||||||
**Non-Interactive by Default**: Operates in "#yolo" mode to minimize interruptions, only prompting when absolutely necessary (like missing critical configuration). This enables smooth automated story preparation.
|
- Auto-finds tech spec: `tech-spec-epic-{N}-*.md`
|
||||||
|
- Discovers architecture docs across directories
|
||||||
|
- Builds prioritized requirement sources
|
||||||
|
|
||||||
**Automatic Context Generation**: When `auto_run_context` is true (default), automatically triggers the story-context workflow to generate developer expertise injection for the newly created story.
|
### Source Document Grounding
|
||||||
|
|
||||||
## Integration with v6 Flow
|
- Every requirement traced to source
|
||||||
|
- No invention of domain facts
|
||||||
|
- Citations included in output
|
||||||
|
|
||||||
The create-story workflow is step 1 in the v6 implementation cycle:
|
### Non-Interactive Mode
|
||||||
|
|
||||||
1. **SM: create-story** ← You are here
|
- Default "#yolo" mode minimizes prompts
|
||||||
2. SM: story-context (adds JIT technical expertise)
|
- Smooth automated story preparation
|
||||||
3. DEV: dev-story (implements with generated context)
|
- Only prompts when critical
|
||||||
4. DEV/SR: code-review (validates completion)
|
|
||||||
5. If needed: correct-course (adjusts direction)
|
|
||||||
6. After epic: retrospective (captures learnings)
|
|
||||||
|
|
||||||
This workflow establishes the "what" that needs to be built, strictly based on planned epics. The story-context workflow will later add the "how" through just-in-time technical expertise injection.
|
## Inputs & Outputs
|
||||||
|
|
||||||
## Document Priority Order
|
### Required Files
|
||||||
|
|
||||||
The workflow uses this priority for extracting requirements:
|
| File | Purpose | Priority |
|
||||||
|
| ------------------------ | ----------------------------- | -------- |
|
||||||
|
| epics.md | Story enumeration (MANDATORY) | Critical |
|
||||||
|
| tech-spec-epic-{N}-\*.md | Epic technical spec | High |
|
||||||
|
| PRD.md | Product requirements | Medium |
|
||||||
|
| Architecture docs | Technical constraints | Low |
|
||||||
|
|
||||||
1. **tech_spec_file**: Epic-scoped technical specification (highest priority)
|
### Auto-Discovered Docs
|
||||||
2. **epics_file**: Acceptance criteria and story breakdown
|
|
||||||
3. **prd_file**: Business requirements and constraints
|
- `tech-stack.md`, `unified-project-structure.md`
|
||||||
4. **Architecture docs**: Constraints, patterns, and technical guidance
|
- `testing-strategy.md`, `backend/frontend-architecture.md`
|
||||||
|
- `data-models.md`, `database-schema.md`, `api-specs.md`
|
||||||
|
|
||||||
|
### Output
|
||||||
|
|
||||||
|
**Story Document:** `{story_dir}/story-{epic}.{story}.md`
|
||||||
|
|
||||||
|
- User story statement (role, action, benefit)
|
||||||
|
- Acceptance criteria from tech spec/epics
|
||||||
|
- Tasks mapped to ACs
|
||||||
|
- Testing requirements
|
||||||
|
- Dev notes with sources
|
||||||
|
- Status: "Draft"
|
||||||
|
|
||||||
## Workflow Behavior
|
## Workflow Behavior
|
||||||
|
|
||||||
**Story Number Management:**
|
### Story Number Management
|
||||||
|
|
||||||
- Automatically detects next story number from existing files
|
- Auto-detects next story number
|
||||||
- Won't skip numbers or create duplicates
|
- No duplicates or skipped numbers
|
||||||
- Maintains epic.story numbering convention
|
- Maintains epic.story convention
|
||||||
|
|
||||||
**Update vs Create:**
|
### Update vs Create
|
||||||
|
|
||||||
- If latest story status != Done/Approved: Updates existing story
|
- **If current story not Done:** Updates existing
|
||||||
- If latest story status == Done/Approved: Creates next story (if enumerated in epics.md)
|
- **If current story Done:** Creates next (if planned)
|
||||||
|
|
||||||
**Epic Advancement:**
|
### Validation Safeguards
|
||||||
|
|
||||||
- In non-interactive mode: Stays within current epic
|
**No Story Found:**
|
||||||
- Interactive mode: Can prompt for new epic number
|
|
||||||
|
```
|
||||||
|
"No planned next story found in epics.md for epic {N}.
|
||||||
|
Run *correct-course to add/modify epic stories."
|
||||||
|
```
|
||||||
|
|
||||||
|
**Missing Config:**
|
||||||
|
Ensure `dev_story_location` set in config.yaml
|
||||||
|
|
||||||
|
## Integration
|
||||||
|
|
||||||
|
### v6 Implementation Cycle
|
||||||
|
|
||||||
|
1. **create-story** ← Current step (defines "what")
|
||||||
|
2. story-context (adds technical "how")
|
||||||
|
3. dev-story (implementation)
|
||||||
|
4. code-review (validation)
|
||||||
|
5. correct-course (if needed)
|
||||||
|
6. retrospective (after epic)
|
||||||
|
|
||||||
|
### Document Priority
|
||||||
|
|
||||||
|
1. **tech_spec_file** - Epic-specific spec
|
||||||
|
2. **epics_file** - Story breakdown
|
||||||
|
3. **prd_file** - Business requirements
|
||||||
|
4. **architecture_docs** - Technical guidance
|
||||||
|
|
||||||
|
## Configuration
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
# bmad/bmm/config.yaml
|
||||||
|
dev_story_location: ./stories
|
||||||
|
output_folder: ./output
|
||||||
|
|
||||||
|
# workflow.yaml defaults
|
||||||
|
non_interactive: true
|
||||||
|
auto_run_context: true
|
||||||
|
```
|
||||||
|
|
||||||
## Troubleshooting
|
## Troubleshooting
|
||||||
|
|
||||||
**"No planned next story found in epics.md"**: The next story isn't enumerated in epics.md. Run SM or PM agent's `*correct-course` to properly plan and add the story to the epic.
|
| Issue | Solution |
|
||||||
|
| ----------------------- | ------------------------------------------ |
|
||||||
|
| "No planned next story" | Run `*correct-course` to add story to epic |
|
||||||
|
| Missing story_dir | Set `dev_story_location` in config |
|
||||||
|
| Tech spec not found | Use naming: `tech-spec-epic-{N}-*.md` |
|
||||||
|
| No architecture docs | Add docs to docs/ or output/ folder |
|
||||||
|
|
||||||
**Missing story_dir Configuration**: Ensure `dev_story_location` is set in bmad/bmm/config.yaml
|
---
|
||||||
|
|
||||||
**Tech Spec Not Found**: The workflow looks for `tech-spec-epic-{N}-*.md` pattern. Ensure tech specs follow this naming convention.
|
For workflow details, see [instructions.md](./instructions.md) and [checklist.md](./checklist.md).
|
||||||
|
|
||||||
**Architecture Documents Missing**: While not fatal, missing architecture docs reduce story context quality. Ensure key docs exist in docs/ or output folder.
|
|
||||||
|
|
|
||||||
|
|
@ -1,577 +1,215 @@
|
||||||
---
|
# BMM Workflows - Complete v6 Guide
|
||||||
last-redoc-date: 2025-10-12
|
|
||||||
---
|
|
||||||
|
|
||||||
# BMM Workflows - The Complete v6 Flow
|
Master guide for BMM's four-phase methodology that adapts to project scale (Level 0-4) and context (greenfield/brownfield).
|
||||||
|
|
||||||
The BMM (BMAD Method Module) orchestrates software development through four distinct phases, each with specialized workflows that adapt to project scale (Level 0-4) and context (greenfield vs brownfield). This document serves as the master guide for understanding how these workflows interconnect to deliver the revolutionary v6 methodology.
|
## Table of Contents
|
||||||
|
|
||||||
## Core v6 Innovations
|
- [Core Innovations](#core-innovations)
|
||||||
|
- [Universal Entry Point](#universal-entry-point)
|
||||||
|
- [Four Phases Overview](#four-phases-overview)
|
||||||
|
- [Phase Details](#phase-details)
|
||||||
|
- [Documentation Prerequisite](#documentation-prerequisite)
|
||||||
|
- [Phase 1: Analysis](#phase-1-analysis)
|
||||||
|
- [Phase 2: Planning](#phase-2-planning)
|
||||||
|
- [Phase 3: Solutioning](#phase-3-solutioning)
|
||||||
|
- [Phase 4: Implementation](#phase-4-implementation)
|
||||||
|
- [Scale Levels](#scale-levels)
|
||||||
|
- [Greenfield vs Brownfield](#greenfield-vs-brownfield)
|
||||||
|
- [Critical Rules](#critical-rules)
|
||||||
|
|
||||||
**Scale-Adaptive Planning**: Projects automatically route through different workflows based on complexity (Level 0-4), ensuring appropriate documentation and process overhead.
|
## Core Innovations
|
||||||
|
|
||||||
**Just-In-Time Design**: Technical specifications are created one epic at a time during implementation, not all upfront, incorporating learnings as the project evolves.
|
- **Scale-Adaptive Planning** - Automatic routing based on complexity (Level 0-4)
|
||||||
|
- **Just-In-Time Design** - Tech specs created per epic during implementation
|
||||||
|
- **Dynamic Expertise Injection** - Story-specific technical guidance
|
||||||
|
- **Continuous Learning Loop** - Retrospectives improve each cycle
|
||||||
|
|
||||||
**Dynamic Expertise Injection**: Story-context workflows provide targeted technical guidance per story, replacing static documentation with contextual expertise.
|
## Universal Entry Point
|
||||||
|
|
||||||
**Continuous Learning Loop**: Retrospectives feed improvements back into workflows, making each epic smoother than the last.
|
**Always start with `workflow-status` or `workflow-init`**
|
||||||
|
|
||||||
## The Four Phases (Plus Documentation Prerequisite)
|
### workflow-status
|
||||||
|
|
||||||
|
- Checks for existing workflow status file
|
||||||
|
- Displays current phase and progress
|
||||||
|
- Routes to appropriate next workflow
|
||||||
|
- Shows Phase 4 implementation state
|
||||||
|
|
||||||
|
### workflow-init
|
||||||
|
|
||||||
|
- Creates initial bmm-workflow-status.md
|
||||||
|
- Detects greenfield vs brownfield
|
||||||
|
- Routes undocumented brownfield to document-project
|
||||||
|
- Sets up workflow tracking
|
||||||
|
|
||||||
|
## Four Phases Overview
|
||||||
|
|
||||||
```
|
```
|
||||||
┌──────────────────────────────────────────────────────────────┐
|
PREREQUISITE: document-project (brownfield without docs)
|
||||||
│ PREREQUISITE: PROJECT DOCUMENTATION (Conditional) │
|
↓
|
||||||
│ For brownfield projects without adequate docs │
|
PHASE 1: Analysis (optional)
|
||||||
│ OR post-completion cleanup │
|
brainstorm → research → brief
|
||||||
├──────────────────────────────────────────────────────────────┤
|
↓
|
||||||
│ document-project ──→ Comprehensive project documentation │
|
PHASE 2: Planning (required, scale-adaptive)
|
||||||
└────────────────────────────────────────────────────────┼─────┘
|
Level 0-1: tech-spec only
|
||||||
↓
|
Level 2-4: PRD + epics
|
||||||
┌──────────────────────────────────────────────────────────────┐
|
↓
|
||||||
│ PHASE 1: ANALYSIS │
|
PHASE 3: Solutioning (Level 2-4 only)
|
||||||
│ (Optional) │
|
architecture → validation → gate-check
|
||||||
├──────────────────────────────────────────────────────────────┤
|
↓
|
||||||
│ brainstorm-game ──┐ │
|
PHASE 4: Implementation (iterative)
|
||||||
│ brainstorm-project ├──→ research ──→ product-brief ──┐ │
|
sprint-planning → epic-context → story cycle
|
||||||
│ or game-brief │ │
|
|
||||||
└────────────────────────────────────────────────────────┼─────┘
|
|
||||||
↓
|
|
||||||
┌──────────────────────────────────────────────────────────────┐
|
|
||||||
│ PHASE 2: PLANNING │
|
|
||||||
│ (Scale-Adaptive Router - by type) │
|
|
||||||
├──────────────────────────────────────────────────────────────┤
|
|
||||||
│ SOFTWARE: prd/tech-spec GAMES: gdd/narrative │
|
|
||||||
│ ├──→ Level 0: tech-spec only ├──→ GDD (all levels) │
|
|
||||||
│ ├──→ Level 1: tech-spec only └──→ Narrative (opt) │
|
|
||||||
│ ├──→ Level 2: PRD + Epics ──────────────────────────┐ │
|
|
||||||
│ └──→ Level 3-4: PRD + Epics ────────────────────────┼┐ │
|
|
||||||
│ UX: create-ux-design (conditional) ││ │
|
|
||||||
└──────────────────────────────────────────────────────────┼┼──┘
|
|
||||||
↓↓
|
|
||||||
┌──────────────────────────────────────────────────────────────┐
|
|
||||||
│ PHASE 3: SOLUTIONING │
|
|
||||||
│ (Software Levels 2-4 / Complex Games) │
|
|
||||||
├──────────────────────────────────────────────────────────────┤
|
|
||||||
│ create-architecture ──→ architecture.md │
|
|
||||||
│ validate-architecture (optional) │
|
|
||||||
│ solutioning-gate-check (recommended/required) │
|
|
||||||
└────────────────────────────────────────────────────────────┬─┘
|
|
||||||
↓
|
|
||||||
┌──────────────────────────────────────────────────────────────┐
|
|
||||||
│ PHASE 4: IMPLEMENTATION │
|
|
||||||
│ (Sprint-Based Cycle) │
|
|
||||||
├──────────────────────────────────────────────────────────────┤
|
|
||||||
│ sprint-planning ──→ sprint-status.yaml │
|
|
||||||
│ ↓ │
|
|
||||||
│ ┌─→ epic-tech-context (per epic) │
|
|
||||||
│ │ ↓ │
|
|
||||||
│ │ create-story ──→ story-context ──→ dev-story ─┐ │
|
|
||||||
│ │ ↓ │
|
|
||||||
│ │ retrospective ←── [epic done] ←─── code-review │
|
|
||||||
│ │ ↓ │
|
|
||||||
│ └──────────── correct-course ←──[if issues]───────┘ │
|
|
||||||
└──────────────────────────────────────────────────────────────┘
|
|
||||||
```
|
```
|
||||||
|
|
||||||
## Universal Entry Point: workflow-status
|
## Phase Details
|
||||||
|
|
||||||
**Before starting any workflow, check your status!**
|
### Documentation Prerequisite
|
||||||
|
|
||||||
The `workflow-status` workflow is the **universal entry point** for all BMM workflows, if you have not already set up your workflow, run `workflow-init`, but even if you just run the workflow-status and the file does not exist you should still be directed to run workflow-init.
|
**When:** Brownfield projects without documentation OR post-completion cleanup
|
||||||
|
|
||||||
**What it does:**
|
| Workflow | Purpose | Output |
|
||||||
|
| ---------------- | ----------------------------- | ------------------ |
|
||||||
|
| document-project | Analyze and document codebase | Comprehensive docs |
|
||||||
|
|
||||||
- ✅ Checks for existing workflow status file
|
**Use Cases:**
|
||||||
- ✅ Displays current phase, progress, and next action
|
|
||||||
- ✅ Helps new users plan their workflow approach
|
|
||||||
- ✅ Guides brownfield projects to documentation first
|
|
||||||
- ✅ Routes to appropriate workflows based on context
|
|
||||||
|
|
||||||
**No status file?** It will:
|
1. **Pre-Phase 1**: Understand existing brownfield code
|
||||||
|
2. **Post-Phase 4**: Create clean documentation replacing scattered artifacts
|
||||||
|
|
||||||
1. Ask about project context (greenfield vs brownfield)
|
### Phase 1: Analysis
|
||||||
2. Generate your bmm-workflow-status.md file.
|
|
||||||
|
|
||||||
**Status file exists?** It will:
|
**Optional workflows for discovery and requirements gathering**
|
||||||
|
|
||||||
1. Display current phase and progress
|
| Workflow | Agent | Purpose | Output |
|
||||||
2. Show Phase 4 implementation state (BACKLOG/TODO/IN PROGRESS/DONE)
|
| ------------------ | ------------- | --------------------- | ---------------------- |
|
||||||
3. Recommend exact next action
|
| brainstorm-project | Analyst | Software ideation | Architecture proposals |
|
||||||
4. Offer to change workflow or display menu
|
| brainstorm-game | Game Designer | Game concept ideation | Concept proposals |
|
||||||
|
| research | Analyst | Multi-mode research | Research artifacts |
|
||||||
|
| product-brief | Analyst | Strategic planning | Product brief |
|
||||||
|
| game-brief | Game Designer | Game foundation | Game brief |
|
||||||
|
|
||||||
**All phase 1-3 workflows should check workflow-status on start of the workflow.**
|
### Phase 2: Planning
|
||||||
|
|
||||||
---
|
**Required phase with scale-adaptive routing**
|
||||||
|
|
||||||
## Documentation Prerequisite (Brownfield Projects)
|
| Workflow | Agent | Output | Levels |
|
||||||
|
| ---------------- | ------------- | -------------- | ----------- |
|
||||||
|
| prd | PM | PRD.md + epics | 2-4 |
|
||||||
|
| tech-spec | PM | tech-spec.md | 0-1 |
|
||||||
|
| gdd | Game Designer | GDD.md | Games |
|
||||||
|
| create-ux-design | UX | ux-design.md | Conditional |
|
||||||
|
|
||||||
**NOT a numbered phase** - this is a prerequisite workflow for brownfield projects without adequate documentation, OR a post-completion tool for creating clean source-of-truth documentation after Phases 1-4 are complete.
|
### Phase 3: Solutioning
|
||||||
|
|
||||||
### Purpose
|
**Architecture phase for Level 2-4 projects**
|
||||||
|
|
||||||
The `document-project` workflow serves TWO critical purposes:
|
| Workflow | Agent | Purpose | Output |
|
||||||
|
| ---------------------- | --------- | ----------------- | ---------------------- |
|
||||||
|
| create-architecture | Architect | System design | architecture.md + ADRs |
|
||||||
|
| validate-architecture | Architect | Design validation | Validation report |
|
||||||
|
| solutioning-gate-check | Architect | PRD/UX/arch check | Gate report |
|
||||||
|
|
||||||
1. **Pre-Phase 1 Prerequisite (Brownfield)**: Run BEFORE planning to understand existing codebases
|
### Phase 4: Implementation
|
||||||
2. **Post-Phase 4 Documentation (Any Project)**: Run AFTER completion to create superior documentation that replaces scattered PRD/architecture/story artifacts
|
|
||||||
|
|
||||||
### Workflows
|
**Sprint-based development cycle**
|
||||||
|
|
||||||
| Workflow | Agent | Purpose | Output | When to Use |
|
#### Sprint Status System
|
||||||
| -------------------- | ------- | ----------------------------------- | ----------------------------------- | -------------------------------------------------------------- |
|
|
||||||
| **document-project** | Analyst | Analyze and document entire project | Comprehensive project documentation | Brownfield without docs OR post-completion cleanup (any scale) |
|
|
||||||
|
|
||||||
### Use Cases
|
**Epic Flow:** `backlog → contexted`
|
||||||
|
|
||||||
**Use Case 1: Brownfield Prerequisite**
|
**Story Flow:** `backlog → drafted → ready-for-dev → in-progress → review → done`
|
||||||
|
|
||||||
|
#### Implementation Workflows
|
||||||
|
|
||||||
|
| Workflow | Agent | Purpose | Status Updates |
|
||||||
|
| ----------------- | ----- | ----------------------- | ------------------------------------------- |
|
||||||
|
| sprint-planning | SM | Initialize tracking | Creates sprint-status.yaml |
|
||||||
|
| epic-tech-context | SM | Epic technical context | Epic: backlog → contexted |
|
||||||
|
| create-story | SM | Draft story files | Story: backlog → drafted |
|
||||||
|
| story-context | SM | Implementation guidance | Story: drafted → ready-for-dev |
|
||||||
|
| dev-story | DEV | Implement | Story: ready-for-dev → in-progress → review |
|
||||||
|
| code-review | DEV | Quality validation | No auto update |
|
||||||
|
| retrospective | SM | Capture learnings | Retrospective: optional → completed |
|
||||||
|
| correct-course | SM | Handle issues | Adaptive |
|
||||||
|
|
||||||
|
#### Implementation Loop
|
||||||
|
|
||||||
```
|
```
|
||||||
workflow-init detects undocumented brownfield
|
sprint-planning (creates sprint-status.yaml)
|
||||||
↓
|
↓
|
||||||
document-project (generates index.md, architecture.md, etc.)
|
For each epic:
|
||||||
|
epic-tech-context
|
||||||
|
↓
|
||||||
|
For each story:
|
||||||
|
create-story → story-context → dev-story → code-review
|
||||||
|
↓
|
||||||
|
Mark done in sprint-status.yaml
|
||||||
↓
|
↓
|
||||||
Phase 1 (optional) → Phase 2 (planning with full context)
|
retrospective (epic complete)
|
||||||
```
|
```
|
||||||
|
|
||||||
**Use Case 2: Post-Completion Documentation**
|
## Scale Levels
|
||||||
|
|
||||||
|
| Level | Scope | Documentation | Path |
|
||||||
|
| ----- | ------------- | --------------------- | --------------- |
|
||||||
|
| 0 | Single change | tech-spec only | Phase 2 → 4 |
|
||||||
|
| 1 | 1-10 stories | tech-spec only | Phase 2 → 4 |
|
||||||
|
| 2 | 5-15 stories | PRD + architecture | Phase 2 → 3 → 4 |
|
||||||
|
| 3 | 12-40 stories | PRD + full arch | Phase 2 → 3 → 4 |
|
||||||
|
| 4 | 40+ stories | PRD + enterprise arch | Phase 2 → 3 → 4 |
|
||||||
|
|
||||||
|
## Greenfield vs Brownfield
|
||||||
|
|
||||||
|
### Greenfield (New Projects)
|
||||||
|
|
||||||
```
|
```
|
||||||
Phase 4 Implementation Complete
|
Phase 1 (optional) → Phase 2 → Phase 3 (L2-4) → Phase 4
|
||||||
↓
|
|
||||||
document-project (scans final codebase)
|
|
||||||
↓
|
|
||||||
Produces clean, LLM-optimized docs > scattered phase artifacts
|
|
||||||
```
|
```
|
||||||
|
|
||||||
**Why it's superior**: Creates comprehensive, consistent documentation that both humans and LLMs can use to understand projects of any size or complexity - often better than manually-maintained PRDs, architecture docs, and story files.
|
- Clean slate for design
|
||||||
|
- No existing constraints
|
||||||
|
- Direct to planning
|
||||||
|
|
||||||
|
### Brownfield (Existing Code)
|
||||||
|
|
||||||
|
```
|
||||||
|
document-project (if needed) → Phase 1 (optional) → Phase 2 → Phase 3 (L2-4) → Phase 4
|
||||||
|
```
|
||||||
|
|
||||||
|
- Must understand existing patterns
|
||||||
|
- Documentation prerequisite if undocumented
|
||||||
|
- Consider technical debt in planning
|
||||||
|
|
||||||
|
## Critical Rules
|
||||||
|
|
||||||
|
### Phase Transitions
|
||||||
|
|
||||||
|
1. **Check workflow-status** before any Phase 1-3 workflow
|
||||||
|
2. **Document brownfield** before planning if undocumented
|
||||||
|
3. **Complete planning** before solutioning
|
||||||
|
4. **Complete architecture** (L2-4) before implementation
|
||||||
|
|
||||||
|
### Implementation Rules
|
||||||
|
|
||||||
|
1. **Epic context first** - Must context epic before drafting stories
|
||||||
|
2. **Sequential by default** - Work stories in order within epic
|
||||||
|
3. **Learning transfer** - Draft next story after previous done
|
||||||
|
4. **Manual status updates** - Update sprint-status.yaml as needed
|
||||||
|
|
||||||
|
### Story Management
|
||||||
|
|
||||||
|
1. **Single source of truth** - sprint-status.yaml tracks everything
|
||||||
|
2. **No story search** - Agents read exact story from status file
|
||||||
|
3. **Context injection** - Each story gets specific technical guidance
|
||||||
|
4. **Retrospective learning** - Capture improvements per epic
|
||||||
|
|
||||||
|
### Best Practices
|
||||||
|
|
||||||
|
1. **Trust the process** - Let workflows guide you
|
||||||
|
2. **Respect scale** - Don't over-document small projects
|
||||||
|
3. **Use status tracking** - Always know where you are
|
||||||
|
4. **Iterate and learn** - Each epic improves the next
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Phase 1: Analysis (Optional)
|
For specific workflow details, see individual workflow READMEs in their respective directories.
|
||||||
|
|
||||||
Optional workflows for project discovery and requirements gathering. Output feeds into Phase 2 planning.
|
|
||||||
|
|
||||||
### Workflows
|
|
||||||
|
|
||||||
| Workflow | Agent | Purpose | Output | When to Use |
|
|
||||||
| ---------------------- | ------------- | ------------------------------------------- | ------------------------- | --------------------- |
|
|
||||||
| **workflow-status** | Analyst | Universal entry point and status checker | Status display + guidance | **Start here!** |
|
|
||||||
| **workflow-init** | Analyst | Generate an initial workflow status file | Status display + guidance | **OR start here!** |
|
|
||||||
| **brainstorm-game** | Game Designer | Game concept ideation using 5 methodologies | Concept proposals | New game projects |
|
|
||||||
| **brainstorm-project** | Analyst | Software solution exploration | Architecture proposals | New software projects |
|
|
||||||
| **game-brief** | Game Designer | Structured game design foundation | Game brief document | Before GDD creation |
|
|
||||||
| **product-brief** | Analyst | Strategic product planning culmination | Product brief | End of analysis phase |
|
|
||||||
| **research** | Analyst | Multi-mode research (market/technical/deep) | Research artifacts | When evidence needed |
|
|
||||||
|
|
||||||
### Flow
|
|
||||||
|
|
||||||
```
|
|
||||||
workflow-status (check) → Brainstorming → Research → Brief → Planning (Phase 2)
|
|
||||||
```
|
|
||||||
|
|
||||||
## Phase 2: Planning (Required)
|
|
||||||
|
|
||||||
### Scale Levels
|
|
||||||
|
|
||||||
| Level | Scope | Outputs | Next Phase |
|
|
||||||
| ----- | ------------------------ | ------------------------------ | ------------------------------ |
|
|
||||||
| **0** | Single atomic change | tech-spec + 1 story | → Implementation |
|
|
||||||
| **1** | 1-10 stories, 1 epic | tech-spec + epic + 2-3 stories | → Implementation |
|
|
||||||
| **2** | 5-15 stories, 1-2 epics | PRD + epics | → Solutioning → Implementation |
|
|
||||||
| **3** | 12-40 stories, 2-5 epics | PRD + epics | → Solutioning → Implementation |
|
|
||||||
| **4** | 40+ stories, 5+ epics | PRD + epics | → Solutioning → Implementation |
|
|
||||||
|
|
||||||
### Available Workflows
|
|
||||||
|
|
||||||
| Workflow | Agent | Purpose | Output | Levels |
|
|
||||||
| -------------------- | ----------- | ------------------------------------ | -------------- | ----------- |
|
|
||||||
| **prd** | PM | Product Requirements Document | PRD.md + epics | 2-4 |
|
|
||||||
| **tech-spec** | PM | Technical specification | tech-spec.md | 0-1 |
|
|
||||||
| **gdd** | PM | Game Design Document | GDD.md | Games (all) |
|
|
||||||
| **narrative** | PM | Game narrative design | narrative.md | Games (opt) |
|
|
||||||
| **create-ux-design** | UX Designer | User experience and interface design | ux-design.md | Conditional |
|
|
||||||
|
|
||||||
### Key Outputs
|
|
||||||
|
|
||||||
- **PRD.md**: Product Requirements Document (Levels 2-4)
|
|
||||||
- **Epics.md**: Epic breakdown with stories (Levels 2-4)
|
|
||||||
- **tech-spec.md**: Technical specification (Levels 0-1)
|
|
||||||
- **story-{slug}.md**: Single user story (Level 0)
|
|
||||||
- **story-{slug}-1.md, story-{slug}-2.md, story-{slug}-3.md**: User stories (Level 1)
|
|
||||||
- **GDD.md**: Game Design Document (game projects)
|
|
||||||
- **narrative.md**: Narrative design (game projects, optional)
|
|
||||||
- **ux-design.md**: UX specification (conditional, UI-heavy projects)
|
|
||||||
- **bmm-workflow-status.md**: Versioned workflow state tracking
|
|
||||||
|
|
||||||
## Phase 3: Solutioning (Levels 2-4)
|
|
||||||
|
|
||||||
Architecture and technical design phase for medium to complex projects.
|
|
||||||
|
|
||||||
### Workflows
|
|
||||||
|
|
||||||
| Workflow | Agent | Purpose | Output | When |
|
|
||||||
| -------------------------- | --------- | -------------------------------- | ------------------------- | ----------- |
|
|
||||||
| **create-architecture** | Architect | Create system-wide architecture | architecture.md with ADRs | Levels 2-4 |
|
|
||||||
| **validate-architecture** | Architect | Validate architecture design | Validation report | Optional |
|
|
||||||
| **solutioning-gate-check** | Architect | Validate PRD + UX + architecture | Gate check report | Recommended |
|
|
||||||
|
|
||||||
### Architecture Scope by Level
|
|
||||||
|
|
||||||
- **Level 2**: Lightweight architecture document focusing on key technical decisions
|
|
||||||
- **Level 3-4**: Comprehensive architecture with detailed ADRs, system diagrams, integration patterns
|
|
||||||
|
|
||||||
## Phase 4: Implementation (Iterative)
|
|
||||||
|
|
||||||
The core development cycle that transforms requirements into working software through sprint-based iteration.
|
|
||||||
|
|
||||||
### Sprint Planning - The Phase 4 Entry Point
|
|
||||||
|
|
||||||
Phase 4 begins with the **sprint-planning** workflow, which generates a `sprint-status.yaml` file that serves as the single source of truth for all implementation tracking.
|
|
||||||
|
|
||||||
**What sprint-planning does:**
|
|
||||||
|
|
||||||
1. Extracts all epics and stories from epic files
|
|
||||||
2. Creates ordered status tracking for every work item
|
|
||||||
3. Auto-detects existing story files and contexts
|
|
||||||
4. Maintains status through the development lifecycle
|
|
||||||
|
|
||||||
### The Sprint Status System
|
|
||||||
|
|
||||||
Phase 4 uses a 6-state lifecycle tracked in `sprint-status.yaml`:
|
|
||||||
|
|
||||||
**Epic Status Flow:**
|
|
||||||
|
|
||||||
```
|
|
||||||
backlog → contexted
|
|
||||||
```
|
|
||||||
|
|
||||||
**Story Status Flow:**
|
|
||||||
|
|
||||||
```
|
|
||||||
backlog → drafted → ready-for-dev → in-progress → review → done
|
|
||||||
```
|
|
||||||
|
|
||||||
**Retrospective Status:**
|
|
||||||
|
|
||||||
```
|
|
||||||
optional ↔ completed
|
|
||||||
```
|
|
||||||
|
|
||||||
#### Status Definitions
|
|
||||||
|
|
||||||
**Epic Statuses:**
|
|
||||||
|
|
||||||
- **backlog**: Epic exists in epic file but not yet contexted
|
|
||||||
- **contexted**: Epic technical context created (prerequisite for drafting stories)
|
|
||||||
|
|
||||||
**Story Statuses:**
|
|
||||||
|
|
||||||
- **backlog**: Story only exists in epic file, not yet drafted
|
|
||||||
- **drafted**: Story file created (e.g., `stories/1-3-plant-naming.md`)
|
|
||||||
- **ready-for-dev**: Draft approved + story context created
|
|
||||||
- **in-progress**: Developer actively working on implementation
|
|
||||||
- **review**: Under SM review (via code-review workflow)
|
|
||||||
- **done**: Story completed and deployed
|
|
||||||
|
|
||||||
**Retrospective Statuses:**
|
|
||||||
|
|
||||||
- **optional**: Can be done but not required
|
|
||||||
- **completed**: Retrospective has been completed
|
|
||||||
|
|
||||||
### Phase 4: The Implementation Loop
|
|
||||||
|
|
||||||
```
|
|
||||||
Phase Transition (Phase 2 or 3 → Phase 4)
|
|
||||||
↓
|
|
||||||
┌─────────────────────────────────────────────────┐
|
|
||||||
│ SM: sprint-planning │
|
|
||||||
│ Creates: sprint-status.yaml with all epics/ │
|
|
||||||
│ stories set to 'backlog' │
|
|
||||||
└───────────────────┬─────────────────────────────┘
|
|
||||||
↓
|
|
||||||
┌─────────────────────────────────────────────────┐
|
|
||||||
│ SM: epic-tech-context (for current epic) │
|
|
||||||
│ Creates: epic-N-context.md │
|
|
||||||
│ Updates: Epic status to 'contexted' │
|
|
||||||
└───────────────────┬─────────────────────────────┘
|
|
||||||
↓
|
|
||||||
┌─────────────────────────────────────────────────┐
|
|
||||||
│ SM: create-story (drafts next backlog story) │
|
|
||||||
│ Creates: story-{key}.md │
|
|
||||||
│ Updates: Story status to 'drafted' │
|
|
||||||
└───────────────────┬─────────────────────────────┘
|
|
||||||
↓
|
|
||||||
┌─────────────────────────────────────────────────┐
|
|
||||||
│ SM: story-context (creates implementation ctx) │
|
|
||||||
│ Creates: story-{key}-context.md │
|
|
||||||
│ Updates: Story status to 'ready-for-dev' │
|
|
||||||
└───────────────────┬─────────────────────────────┘
|
|
||||||
↓
|
|
||||||
┌─────────────────────────────────────────────────┐
|
|
||||||
│ DEV: dev-story (implements story) │
|
|
||||||
│ Reads: story + context files │
|
|
||||||
│ Updates: Story status to 'in-progress' │
|
|
||||||
│ then to 'review' when complete │
|
|
||||||
└───────────────────┬─────────────────────────────┘
|
|
||||||
↓
|
|
||||||
┌─────────────────────────────────────────────────┐
|
|
||||||
│ DEV: code-review (validates implementation) │
|
|
||||||
│ Reviews: Code changes against DoD │
|
|
||||||
│ Feedback: Iteration or approval │
|
|
||||||
└───────────────────┬─────────────────────────────┘
|
|
||||||
↓
|
|
||||||
┌─────────────────────────────────────────────────┐
|
|
||||||
│ DEV/SM: Updates story status to 'done' │
|
|
||||||
│ Manual update to sprint-status.yaml │
|
|
||||||
└───────────────────┬─────────────────────────────┘
|
|
||||||
↓
|
|
||||||
┌───────┴────────┐
|
|
||||||
│ More stories? │
|
|
||||||
└───────┬────────┘
|
|
||||||
┌───┴───┐
|
|
||||||
↓ ↓
|
|
||||||
[Yes: Loop] [No: Epic Complete]
|
|
||||||
↓
|
|
||||||
┌───────────────────┐
|
|
||||||
│ SM: retrospective│
|
|
||||||
│ Updates: epic-N- │
|
|
||||||
│ retrospective to │
|
|
||||||
│ 'completed' │
|
|
||||||
└───────────────────┘
|
|
||||||
```
|
|
||||||
|
|
||||||
### Workflow Responsibilities
|
|
||||||
|
|
||||||
| Workflow | Agent | Purpose | Status Updates |
|
|
||||||
| --------------------- | ----- | -------------------------------------- | ------------------------------------------- |
|
|
||||||
| **sprint-planning** | SM | Initialize sprint status tracking | Creates sprint-status.yaml |
|
|
||||||
| **epic-tech-context** | SM | Create epic-specific technical context | Epic: backlog → contexted |
|
|
||||||
| **create-story** | SM | Draft individual story files | Story: backlog → drafted |
|
|
||||||
| **story-context** | SM | Generate implementation context/XML | Story: drafted → ready-for-dev |
|
|
||||||
| **dev-story** | DEV | Implement story | Story: ready-for-dev → in-progress → review |
|
|
||||||
| **code-review** | DEV | Quality validation and feedback | (No automatic state change) |
|
|
||||||
| **retrospective** | SM | Capture epic learnings | Retrospective: optional → completed |
|
|
||||||
| **correct-course** | SM | Handle issues/scope changes | (Adaptive based on situation) |
|
|
||||||
|
|
||||||
### Key Guidelines
|
|
||||||
|
|
||||||
1. **Epic Context First**: Epics should be `contexted` before their stories can be `drafted`
|
|
||||||
2. **Sequential by Default**: Stories are typically worked in order within an epic
|
|
||||||
3. **Parallel Work Supported**: Multiple stories can be `in-progress` if team capacity allows
|
|
||||||
4. **Learning Transfer**: SM drafts next story after previous is `done` to incorporate learnings
|
|
||||||
5. **Flexible Status Updates**: Agents and users can manually update sprint-status.yaml as needed
|
|
||||||
|
|
||||||
## Greenfield vs Brownfield Paths
|
|
||||||
|
|
||||||
### Greenfield Projects (New Code)
|
|
||||||
|
|
||||||
**Path:** Phase 1 (optional) → Phase 2 → Phase 3 (Levels 2-4) → Phase 4
|
|
||||||
|
|
||||||
- **Level 0-1**: Skip Phase 3, go straight to implementation with tech-spec
|
|
||||||
- **Level 2-4**: Full solutioning with architecture before implementation
|
|
||||||
- Clean slate for architectural decisions
|
|
||||||
- No existing patterns to constrain design
|
|
||||||
|
|
||||||
### Brownfield Projects (Existing Code)
|
|
||||||
|
|
||||||
**Path:** Documentation Prerequisite (if undocumented) → Phase 1 (optional) → Phase 2 → Phase 3 (Levels 2-4) → Phase 4
|
|
||||||
|
|
||||||
**Documentation Prerequisite (Conditional):**
|
|
||||||
|
|
||||||
```
|
|
||||||
workflow-status/workflow-init
|
|
||||||
├─→ Check: Is existing codebase documented?
|
|
||||||
│ ├─→ YES: Proceed to Phase 1 or 2
|
|
||||||
│ └─→ NO: REQUIRED - Run document-project workflow first
|
|
||||||
│ ├─→ Analyzes existing code
|
|
||||||
│ ├─→ Documents current architecture
|
|
||||||
│ ├─→ Identifies technical debt
|
|
||||||
│ ├─→ Creates comprehensive baseline documentation
|
|
||||||
│ └─→ Produces superior docs for LLM + human understanding
|
|
||||||
└─→ Continue with scale-adaptive planning (Phases 1-4)
|
|
||||||
```
|
|
||||||
|
|
||||||
**Critical for Brownfield**:
|
|
||||||
|
|
||||||
- Must understand existing patterns before planning
|
|
||||||
- Integration points need documentation
|
|
||||||
- Technical debt must be visible in planning
|
|
||||||
- Constraints from existing system affect scale decisions
|
|
||||||
|
|
||||||
**Post-Completion Option**: After Phase 4 completes, run `document-project` again to create clean source-of-truth documentation that supersedes scattered phase artifacts.
|
|
||||||
|
|
||||||
## Agent Participation by Phase
|
|
||||||
|
|
||||||
| Phase/Step | Primary Agents | Supporting Agents | Key Workflows |
|
|
||||||
| ---------------------------------- | ---------------------- | -------------------- | ------------------------------------------- |
|
|
||||||
| **Prerequisite: Documentation** | Analyst | - | document-project (conditional) |
|
|
||||||
| **Phase 1: Analysis** | Analyst, Game Designer | PM, Researcher | brainstorm-_, research, _-brief |
|
|
||||||
| **Phase 2: Planning** | PM | UX Designer, Analyst | prd, tech-spec, gdd, narrative |
|
|
||||||
| **Phase 3: Solutioning** | Architect | PM, Tech Lead | create-architecture, solutioning-gate-check |
|
|
||||||
| **Phase 4: Implementation** | SM, DEV | SR (code-review) | sprint-planning, create-story, dev-story |
|
|
||||||
| **Post-Completion: Documentation** | Analyst | - | document-project (optional cleanup) |
|
|
||||||
|
|
||||||
## Key Files and Artifacts
|
|
||||||
|
|
||||||
### Tracking Documents
|
|
||||||
|
|
||||||
- **bmm-workflow-status.md**: Phase and workflow tracking (updated by workflow-status)
|
|
||||||
- Current phase and progress
|
|
||||||
- Workflow history
|
|
||||||
- Next recommended actions
|
|
||||||
- Project metadata and configuration
|
|
||||||
|
|
||||||
- **sprint-status.yaml**: Implementation tracking (Phase 4 only)
|
|
||||||
- All epics, stories, and retrospectives
|
|
||||||
- Current status for each item (backlog → done)
|
|
||||||
- Single source of truth for Phase 4 progression
|
|
||||||
- Updated by agents as work progresses
|
|
||||||
|
|
||||||
- **Epics.md**: Master epic/story definitions (source of truth for planning, Level 2-4)
|
|
||||||
|
|
||||||
### Phase Outputs
|
|
||||||
|
|
||||||
- **Documentation Prerequisite (if run)**:
|
|
||||||
- Comprehensive project documentation (index.md, architecture.md, source-tree-analysis.md, component-inventory.md, etc.)
|
|
||||||
- Superior to manually-maintained docs for LLM understanding
|
|
||||||
|
|
||||||
- **Phase 1**:
|
|
||||||
- Product briefs, game briefs, research documents
|
|
||||||
|
|
||||||
- **Phase 2**:
|
|
||||||
- Level 0: tech-spec.md + story-{slug}.md
|
|
||||||
- Level 1: tech-spec.md + epic breakdown + story-{slug}-N.md files
|
|
||||||
- Level 2-4: PRD.md + epics.md (+ optional ux-design.md, narrative.md)
|
|
||||||
|
|
||||||
- **Phase 3**:
|
|
||||||
- architecture.md (with ADRs)
|
|
||||||
- Validation reports
|
|
||||||
- Gate check documentation
|
|
||||||
|
|
||||||
- **Phase 4**:
|
|
||||||
- sprint-status.yaml (tracking file)
|
|
||||||
- epic-N-context.md files (per epic)
|
|
||||||
- story-{key}.md files (per story)
|
|
||||||
- story-{key}-context.md files (per story)
|
|
||||||
- Implemented code and tests
|
|
||||||
|
|
||||||
## Best Practices
|
|
||||||
|
|
||||||
### 1. Respect the Scale
|
|
||||||
|
|
||||||
- Don't create PRDs for Level 0-1 changes (use tech-spec only)
|
|
||||||
- Don't skip architecture for Level 2-4 projects
|
|
||||||
- Let the workflow paths determine appropriate artifacts
|
|
||||||
- Level 2 still requires Phase 3 solutioning (lighter than 3-4)
|
|
||||||
|
|
||||||
### 2. Use Sprint Planning Effectively
|
|
||||||
|
|
||||||
- Run sprint-planning at the start of Phase 4
|
|
||||||
- Context epics before drafting their stories (epic-tech-context)
|
|
||||||
- Update sprint-status.yaml as work progresses
|
|
||||||
- Re-run sprint-planning to auto-detect new files/contexts
|
|
||||||
|
|
||||||
### 3. Maintain Flow Integrity
|
|
||||||
|
|
||||||
- Stories must be defined in Epics.md before sprint-planning
|
|
||||||
- Complete epic context before story drafting
|
|
||||||
- Create story context before implementation
|
|
||||||
- Each phase completes before the next begins
|
|
||||||
|
|
||||||
### 4. Document Brownfield First (Prerequisite)
|
|
||||||
|
|
||||||
- Never plan without understanding existing code
|
|
||||||
- Run document-project if codebase is undocumented (PREREQUISITE, not Phase 0)
|
|
||||||
- Technical debt must be visible in planning
|
|
||||||
- Integration points need documentation
|
|
||||||
- Can also run post-Phase 4 for superior final documentation
|
|
||||||
|
|
||||||
### 5. Learn Continuously
|
|
||||||
|
|
||||||
- Run retrospectives after each epic
|
|
||||||
- Incorporate learnings into next story drafts
|
|
||||||
- Update workflows based on team feedback
|
|
||||||
- Share patterns across teams
|
|
||||||
|
|
||||||
## Common Pitfalls and Solutions
|
|
||||||
|
|
||||||
| Pitfall | Solution |
|
|
||||||
| ------------------------------------- | ----------------------------------------------------- |
|
|
||||||
| Skipping sprint-planning | Always run at Phase 4 start - it creates status file |
|
|
||||||
| Creating stories without epic context | Run epic-tech-context before create-story |
|
|
||||||
| Skipping story-context generation | Always run after create-story for better dev guidance |
|
|
||||||
| Not updating sprint-status.yaml | Update statuses as work progresses |
|
|
||||||
| Thinking Level 2 skips Phase 3 | Level 2 DOES require architecture (just lighter) |
|
|
||||||
| Planning brownfield without docs | Run document-project first if undocumented |
|
|
||||||
| Not running retrospectives | Complete after every epic for learning transfer |
|
|
||||||
| Manually tracking stories elsewhere | Use sprint-status.yaml as single source of truth |
|
|
||||||
|
|
||||||
## Quick Reference Commands
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# Universal Entry Point (Start Here!)
|
|
||||||
bmad analyst workflow-status # Check status and get recommendations
|
|
||||||
|
|
||||||
# Documentation Prerequisite (Brownfield without docs OR post-completion cleanup)
|
|
||||||
bmad analyst document-project
|
|
||||||
|
|
||||||
# Phase 1: Analysis (Optional)
|
|
||||||
bmad analyst brainstorm-project # Software ideation
|
|
||||||
bmad game-designer brainstorm-game # Game ideation
|
|
||||||
bmad analyst research # Market/technical research
|
|
||||||
bmad analyst product-brief # Software brief
|
|
||||||
bmad game-designer game-brief # Game brief
|
|
||||||
|
|
||||||
# Phase 2: Planning (Required)
|
|
||||||
bmad pm prd # Level 2-4 software projects
|
|
||||||
bmad pm tech-spec # Level 0-1 software projects
|
|
||||||
bmad pm gdd # Game projects (all levels)
|
|
||||||
bmad pm narrative # Game narrative (optional)
|
|
||||||
bmad ux-designer create-ux-design # UI-heavy projects
|
|
||||||
|
|
||||||
# Phase 3: Solutioning (Levels 2-4)
|
|
||||||
bmad architect create-architecture # System architecture
|
|
||||||
bmad architect validate-architecture # Validation (optional)
|
|
||||||
bmad architect solutioning-gate-check # Gate check
|
|
||||||
|
|
||||||
# Phase 4: Implementation (Sprint-Based)
|
|
||||||
bmad sm sprint-planning # FIRST: Initialize sprint tracking
|
|
||||||
bmad sm epic-tech-context # Create epic context (per epic)
|
|
||||||
bmad sm create-story # Draft story file
|
|
||||||
bmad sm story-context # Create story context
|
|
||||||
bmad dev dev-story # Implement story
|
|
||||||
bmad sm code-review # Quality validation
|
|
||||||
# (Update sprint-status.yaml to 'done' manually or via workflow)
|
|
||||||
bmad sm retrospective # After epic complete
|
|
||||||
bmad sm correct-course # If issues arise
|
|
||||||
```
|
|
||||||
|
|
||||||
## Future Enhancements
|
|
||||||
|
|
||||||
### Coming Soon
|
|
||||||
|
|
||||||
- **Automated status updates**: Workflows automatically update sprint-status.yaml
|
|
||||||
- **Workflow orchestration**: Automatic phase transitions and validation
|
|
||||||
- **Progress dashboards**: Real-time workflow status visualization
|
|
||||||
- **Team synchronization**: Multi-developer story coordination
|
|
||||||
|
|
||||||
### Under Consideration
|
|
||||||
|
|
||||||
- AI-assisted retrospectives with pattern detection
|
|
||||||
- Automated story sizing based on historical data
|
|
||||||
- Predictive epic planning with risk assessment
|
|
||||||
- Cross-project learning transfer
|
|
||||||
- Enhanced brownfield analysis with architectural debt scoring
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
**Version**: v6-alpha
|
|
||||||
**Last Updated**: 2025-10-26
|
|
||||||
|
|
||||||
This document serves as the authoritative guide to BMM v6a workflow execution. For detailed information about individual workflows, see their respective README files in the workflow folders.
|
|
||||||
|
|
||||||
## Related Documentation
|
|
||||||
|
|
||||||
- **Workflow Paths**: See `workflow-status/paths/` for detailed greenfield/brownfield routing by level
|
|
||||||
- **Phase 2 Planning**: See `2-plan-workflows/README.md` for scale-adaptive planning details
|
|
||||||
- **Phase 4 Sprint Planning**: See `4-implementation/sprint-planning/README.md` for sprint status system
|
|
||||||
- **Individual Workflows**: Each workflow directory contains its own README with specific instructions
|
|
||||||
|
|
|
||||||
|
|
@ -1,86 +1,153 @@
|
||||||
---
|
# CIS - Creative Intelligence Suite
|
||||||
last-redoc-date: 2025-09-28
|
|
||||||
---
|
|
||||||
|
|
||||||
<!-- Powered by BMAD-CORE™ -->
|
AI-powered creative facilitation transforming strategic thinking through expert coaching across five specialized domains.
|
||||||
|
|
||||||
# Creative Intelligence System (CIS)
|
## Table of Contents
|
||||||
|
|
||||||
**Purpose:** Transform creative and strategic thinking through AI-powered facilitation across five specialized domains. The CIS module provides expert coaching for brainstorming, design thinking, problem-solving, innovation strategy, and storytelling.
|
- [Core Capabilities](#core-capabilities)
|
||||||
|
- [Specialized Agents](#specialized-agents)
|
||||||
|
- [Interactive Workflows](#interactive-workflows)
|
||||||
|
- [Quick Start](#quick-start)
|
||||||
|
- [Key Differentiators](#key-differentiators)
|
||||||
|
- [Configuration](#configuration)
|
||||||
|
|
||||||
**Overview:** The Creative Intelligence System equips teams and individuals with structured creative methodologies delivered through distinctive agent personas. Each agent facilitates interactive workflows that guide users through proven techniques while adapting to context, energy levels, and goals. Unlike traditional creative tools, CIS agents act as master facilitators who ask questions to draw out insights rather than generating solutions directly.
|
## Core Capabilities
|
||||||
|
|
||||||
## Workflows
|
CIS provides structured creative methodologies through distinctive agent personas who act as master facilitators, drawing out insights through strategic questioning rather than generating solutions directly.
|
||||||
|
|
||||||
|
## Specialized Agents
|
||||||
|
|
||||||
|
[View detailed agent descriptions →](./agents/README.md)
|
||||||
|
|
||||||
|
- **Carson** - Brainstorming Specialist (energetic facilitator)
|
||||||
|
- **Maya** - Design Thinking Maestro (jazz-like improviser)
|
||||||
|
- **Dr. Quinn** - Problem Solver (detective-scientist hybrid)
|
||||||
|
- **Victor** - Innovation Oracle (bold strategic precision)
|
||||||
|
- **Sophia** - Master Storyteller (whimsical narrator)
|
||||||
|
|
||||||
|
## Interactive Workflows
|
||||||
|
|
||||||
[View all workflows →](./workflows/README.md)
|
[View all workflows →](./workflows/README.md)
|
||||||
|
|
||||||
The module includes **5 interactive workflows** with over 150 creative techniques and frameworks:
|
**5 Workflows** with **150+ Creative Techniques:**
|
||||||
|
|
||||||
- **Brainstorming** - 36 creative techniques across 7 categories for ideation
|
### Brainstorming
|
||||||
- **Design Thinking** - Complete 5-phase human-centered design process
|
|
||||||
- **Problem Solving** - Systematic root cause analysis and solution generation
|
|
||||||
- **Innovation Strategy** - Business model innovation and disruption analysis
|
|
||||||
- **Storytelling** - 25 story frameworks for compelling narratives
|
|
||||||
|
|
||||||
## Agents
|
36 techniques across 7 categories for ideation
|
||||||
|
|
||||||
[View all agents →](./agents/README.md)
|
- Divergent/convergent thinking
|
||||||
|
- Lateral connections
|
||||||
|
- Forced associations
|
||||||
|
|
||||||
Five specialized agents with unique personas and communication styles:
|
### Design Thinking
|
||||||
|
|
||||||
- **Carson** - Elite Brainstorming Specialist (energetic facilitator)
|
Complete 5-phase human-centered process
|
||||||
- **Maya** - Design Thinking Maestro (jazz-like improviser)
|
|
||||||
- **Dr. Quinn** - Master Problem Solver (detective-scientist hybrid)
|
|
||||||
- **Victor** - Disruptive Innovation Oracle (bold strategic precision)
|
|
||||||
- **Sophia** - Master Storyteller (flowery, whimsical narrator)
|
|
||||||
|
|
||||||
## Configuration
|
- Empathize → Define → Ideate → Prototype → Test
|
||||||
|
- User journey mapping
|
||||||
|
- Rapid iteration
|
||||||
|
|
||||||
The module uses `/bmad/cis/config.yaml` for:
|
### Problem Solving
|
||||||
|
|
||||||
- `output_folder` - Where workflow results are saved
|
Systematic root cause analysis
|
||||||
- `user_name` - Session participant identification
|
|
||||||
- `communication_language` - Facilitation language preference
|
|
||||||
|
|
||||||
## Usage
|
- 5 Whys, Fishbone diagrams
|
||||||
|
- Solution generation
|
||||||
|
- Impact assessment
|
||||||
|
|
||||||
|
### Innovation Strategy
|
||||||
|
|
||||||
|
Business model disruption
|
||||||
|
|
||||||
|
- Blue Ocean Strategy
|
||||||
|
- Jobs-to-be-Done
|
||||||
|
- Disruptive innovation patterns
|
||||||
|
|
||||||
|
### Storytelling
|
||||||
|
|
||||||
|
25 narrative frameworks
|
||||||
|
|
||||||
|
- Hero's Journey
|
||||||
|
- Story circles
|
||||||
|
- Compelling pitch structures
|
||||||
|
|
||||||
|
## Quick Start
|
||||||
|
|
||||||
|
### Direct Workflow
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Direct workflow invocation
|
# Start interactive session
|
||||||
workflow brainstorming
|
workflow brainstorming
|
||||||
workflow design-thinking --data /path/to/context.md
|
|
||||||
|
|
||||||
# Agent-facilitated sessions
|
# With context document
|
||||||
|
workflow design-thinking --data /path/to/context.md
|
||||||
|
```
|
||||||
|
|
||||||
|
### Agent-Facilitated
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Load agent
|
||||||
agent cis/brainstorming-coach
|
agent cis/brainstorming-coach
|
||||||
|
|
||||||
|
# Start workflow
|
||||||
> *brainstorm
|
> *brainstorm
|
||||||
```
|
```
|
||||||
|
|
||||||
## Key Differentiators
|
## Key Differentiators
|
||||||
|
|
||||||
- **Facilitation Over Generation:** Agents guide users to discover their own insights through strategic questioning
|
- **Facilitation Over Generation** - Guides discovery through questions
|
||||||
- **Energy-Aware Sessions:** Built-in checkpoints monitor and adapt to user engagement levels
|
- **Energy-Aware Sessions** - Adapts to engagement levels
|
||||||
- **Context Integration:** All workflows accept optional context documents for domain-specific guidance
|
- **Context Integration** - Domain-specific guidance support
|
||||||
- **Persona-Driven Experience:** Each agent embodies a unique communication style matching their expertise
|
- **Persona-Driven** - Unique communication styles
|
||||||
- **Rich Method Libraries:** 150+ proven techniques and frameworks across creative disciplines
|
- **Rich Method Libraries** - 150+ proven techniques
|
||||||
|
|
||||||
## Installation
|
## Configuration
|
||||||
|
|
||||||
The CIS module installer (`_module-installer/`) configures the complete creative intelligence suite including all agents, workflows, and technique libraries.
|
Edit `/bmad/cis/config.yaml`:
|
||||||
|
|
||||||
## Module Architecture
|
```yaml
|
||||||
|
output_folder: ./creative-outputs
|
||||||
|
user_name: Your Name
|
||||||
|
communication_language: english
|
||||||
|
```
|
||||||
|
|
||||||
|
## Module Structure
|
||||||
|
|
||||||
```
|
```
|
||||||
cis/
|
cis/
|
||||||
├── agents/ # 5 specialized creative agents
|
├── agents/ # 5 specialized facilitators
|
||||||
├── workflows/ # 5 interactive workflows
|
├── workflows/ # 5 interactive processes
|
||||||
│ ├── brainstorming/
|
│ ├── brainstorming/
|
||||||
│ ├── design-thinking/
|
│ ├── design-thinking/
|
||||||
│ ├── innovation-strategy/
|
│ ├── innovation-strategy/
|
||||||
│ ├── problem-solving/
|
│ ├── problem-solving/
|
||||||
│ └── storytelling/
|
│ └── storytelling/
|
||||||
├── tasks/ # Supporting task operations
|
├── tasks/ # Supporting operations
|
||||||
└── teams/ # Agent team configurations
|
└── teams/ # Agent collaborations
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Integration Points
|
||||||
|
|
||||||
|
CIS workflows integrate with:
|
||||||
|
|
||||||
|
- **BMM** - Powers project brainstorming
|
||||||
|
- **BMB** - Creative module design
|
||||||
|
- **Custom Modules** - Shared creative resource
|
||||||
|
|
||||||
|
## Best Practices
|
||||||
|
|
||||||
|
1. **Set clear objectives** before starting sessions
|
||||||
|
2. **Provide context documents** for domain relevance
|
||||||
|
3. **Trust the process** - Let facilitation guide you
|
||||||
|
4. **Take breaks** when energy flags
|
||||||
|
5. **Document insights** as they emerge
|
||||||
|
|
||||||
|
## Related Documentation
|
||||||
|
|
||||||
|
- **[Workflow Guide](./workflows/README.md)** - Detailed workflow instructions
|
||||||
|
- **[Agent Personas](./agents/README.md)** - Full agent descriptions
|
||||||
|
- **[BMM Integration](../bmm/README.md)** - Development workflow connection
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
_Part of the BMAD Method v6.0 - Transform your creative potential with expert AI facilitation_
|
Part of BMad Method v6.0 - Transform creative potential through expert AI facilitation.
|
||||||
|
|
|
||||||
|
|
@ -1,67 +1,139 @@
|
||||||
---
|
|
||||||
last-redoc-date: 2025-09-28
|
|
||||||
---
|
|
||||||
|
|
||||||
# CIS Workflows
|
# CIS Workflows
|
||||||
|
|
||||||
The Creative Intelligence System includes five interactive workflows that facilitate different creative and strategic processes. Each workflow uses curated technique libraries and structured facilitation to guide users through proven methodologies.
|
Five interactive workflows facilitating creative and strategic processes through curated technique libraries and structured facilitation.
|
||||||
|
|
||||||
## Available Workflows
|
## Table of Contents
|
||||||
|
|
||||||
|
- [Workflow Overview](#workflow-overview)
|
||||||
|
- [Common Features](#common-features)
|
||||||
|
- [Usage](#usage)
|
||||||
|
- [Configuration](#configuration)
|
||||||
|
|
||||||
|
## Workflow Overview
|
||||||
|
|
||||||
### [Brainstorming](./brainstorming)
|
### [Brainstorming](./brainstorming)
|
||||||
|
|
||||||
Facilitates interactive ideation sessions using 36 creative techniques across 7 categories. AI acts as master facilitator using "Yes, and..." methodology. Supports user-selected, AI-recommended, random, or progressive technique flows.
|
**Purpose:** Interactive ideation using 36 techniques across 7 categories
|
||||||
|
|
||||||
**Key Feature:** Comprehensive technique library spanning collaborative, structured, creative, deep, theatrical, wild, and introspective approaches.
|
**Approach:** Master facilitation with "Yes, and..." methodology
|
||||||
|
|
||||||
|
**Techniques:** Collaborative, structured, creative, deep, theatrical, wild, introspective
|
||||||
|
|
||||||
|
**Selection Modes:** User-selected, AI-recommended, random, or progressive
|
||||||
|
|
||||||
### [Design Thinking](./design-thinking)
|
### [Design Thinking](./design-thinking)
|
||||||
|
|
||||||
Guides human-centered design through the complete five-phase methodology: Empathize, Define, Ideate, Prototype, and Test. Emphasizes divergent thinking before convergent action with rapid prototyping focus.
|
**Purpose:** Human-centered design through five phases
|
||||||
|
|
||||||
**Key Feature:** Phase-specific method library and systematic user empathy development.
|
**Process:** Empathize → Define → Ideate → Prototype → Test
|
||||||
|
|
||||||
|
**Focus:** Divergent thinking before convergent action
|
||||||
|
|
||||||
|
**Output:** User empathy insights and rapid prototypes
|
||||||
|
|
||||||
### [Innovation Strategy](./innovation-strategy)
|
### [Innovation Strategy](./innovation-strategy)
|
||||||
|
|
||||||
Identifies disruption opportunities and architects business model innovation. Analyzes markets, competitive dynamics, and value chains using frameworks like Jobs-to-be-Done and Blue Ocean Strategy.
|
**Purpose:** Identify disruption opportunities and business model innovation
|
||||||
|
|
||||||
**Key Feature:** Strategic focus on sustainable competitive advantage over feature innovation.
|
**Frameworks:** Jobs-to-be-Done, Blue Ocean Strategy, Value Chain Analysis
|
||||||
|
|
||||||
|
**Focus:** Sustainable competitive advantage over features
|
||||||
|
|
||||||
|
**Output:** Strategic innovation roadmap
|
||||||
|
|
||||||
### [Problem Solving](./problem-solving)
|
### [Problem Solving](./problem-solving)
|
||||||
|
|
||||||
Applies systematic problem-solving methodologies combining TRIZ, Theory of Constraints, Systems Thinking, and Root Cause Analysis. Detective approach treats challenges as elegant puzzles.
|
**Purpose:** Systematic challenge resolution
|
||||||
|
|
||||||
**Key Feature:** Relentless root cause focus using framework-driven analysis.
|
**Methods:** TRIZ, Theory of Constraints, Systems Thinking, Root Cause Analysis
|
||||||
|
|
||||||
|
**Approach:** Detective-style puzzle solving
|
||||||
|
|
||||||
|
**Output:** Root cause identification and solution strategies
|
||||||
|
|
||||||
### [Storytelling](./storytelling)
|
### [Storytelling](./storytelling)
|
||||||
|
|
||||||
Crafts compelling narratives using proven story frameworks (Hero's Journey, Three-Act Structure, Story Brand). Tailors emotional psychology and structure to platform and audience.
|
**Purpose:** Craft compelling narratives
|
||||||
|
|
||||||
**Key Feature:** Whimsical facilitation style that embodies master storytelling craft.
|
**Frameworks:** Hero's Journey, Three-Act Structure, Story Brand (25 total)
|
||||||
|
|
||||||
## Common Patterns
|
**Customization:** Platform and audience-specific adaptation
|
||||||
|
|
||||||
All CIS workflows share these characteristics:
|
**Style:** Whimsical master storyteller facilitation
|
||||||
|
|
||||||
- **Interactive Facilitation**: AI guides rather than generates, asking questions to draw out user insights
|
## Common Features
|
||||||
- **Technique Libraries**: CSV databases of methods, frameworks, and approaches
|
|
||||||
- **Context Awareness**: Accept optional context documents via data attribute
|
All workflows share:
|
||||||
- **Structured Output**: Comprehensive reports capturing insights, decisions, and action plans
|
|
||||||
- **Energy Monitoring**: Check-ins throughout to adapt pace and approach
|
- **Interactive Facilitation** - AI guides through questions, not generation
|
||||||
|
- **Technique Libraries** - CSV databases of proven methods
|
||||||
|
- **Context Integration** - Optional document input for domain relevance
|
||||||
|
- **Structured Output** - Comprehensive reports with insights and actions
|
||||||
|
- **Energy Monitoring** - Adaptive pacing based on engagement
|
||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
```bash
|
### Basic Invocation
|
||||||
# Basic invocation
|
|
||||||
workflow [workflow-name]
|
|
||||||
|
|
||||||
# With context document
|
```bash
|
||||||
|
workflow brainstorming
|
||||||
|
workflow design-thinking
|
||||||
|
workflow innovation-strategy
|
||||||
|
workflow problem-solving
|
||||||
|
workflow storytelling
|
||||||
|
```
|
||||||
|
|
||||||
|
### With Context
|
||||||
|
|
||||||
|
```bash
|
||||||
workflow [workflow-name] --data /path/to/context.md
|
workflow [workflow-name] --data /path/to/context.md
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Via Agent
|
||||||
|
|
||||||
|
```bash
|
||||||
|
agent cis/brainstorming-coach
|
||||||
|
> *brainstorm
|
||||||
|
```
|
||||||
|
|
||||||
## Configuration
|
## Configuration
|
||||||
|
|
||||||
All workflows reference `/bmad/cis/config.yaml` for:
|
Edit `/bmad/cis/config.yaml`:
|
||||||
|
|
||||||
- `output_folder` - Where workflow results are saved
|
| Setting | Purpose | Default |
|
||||||
- `user_name` - Session participant identification
|
| ---------------------- | ----------------------- | ------------------ |
|
||||||
- `communication_language` - Facilitation language preference
|
| output_folder | Result storage location | ./creative-outputs |
|
||||||
|
| user_name | Session participant | User |
|
||||||
|
| communication_language | Facilitation language | english |
|
||||||
|
|
||||||
|
## Workflow Structure
|
||||||
|
|
||||||
|
Each workflow contains:
|
||||||
|
|
||||||
|
```
|
||||||
|
workflow-name/
|
||||||
|
├── workflow.yaml # Configuration
|
||||||
|
├── instructions.md # Facilitation guide
|
||||||
|
├── techniques.csv # Method library
|
||||||
|
└── README.md # Documentation
|
||||||
|
```
|
||||||
|
|
||||||
|
## Best Practices
|
||||||
|
|
||||||
|
1. **Prepare context** - Provide background documents for better results
|
||||||
|
2. **Set clear objectives** - Define goals before starting
|
||||||
|
3. **Trust the process** - Let facilitation guide discovery
|
||||||
|
4. **Capture everything** - Document insights as they emerge
|
||||||
|
5. **Take breaks** - Pause when energy drops
|
||||||
|
|
||||||
|
## Integration
|
||||||
|
|
||||||
|
CIS workflows integrate with:
|
||||||
|
|
||||||
|
- **BMM** - Project brainstorming and ideation
|
||||||
|
- **BMB** - Creative module design
|
||||||
|
- **Custom Modules** - Shared creative resource
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
For detailed workflow instructions, see individual workflow directories.
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue