f77babcd5e
This comprehensive update transforms the Product Brief and PRD workflows from rigid template-filling exercises into adaptive, context-aware discovery processes. Changes span workflow instructions, templates, agent configurations, and supporting infrastructure. ## Product Brief Workflow (96% audit compliance) ### Intent-Driven Facilitation - Transform from linear Q&A to natural conversational discovery - Adaptive questioning based on project context (hobby/startup/enterprise) - Real-time document building instead of end-of-session generation - Skill-level aware facilitation (expert/intermediate/beginner) - Context detection from user responses to guide exploration depth ### Living Document Approach - Continuous template updates throughout conversation - Progressive refinement vs batch generation - Template-output tags aligned with discovery flow - Better variable mapping between instructions and template ### Enhanced Discovery Areas - Problem exploration with context-appropriate probing - Solution vision shaping based on user's mental model - User understanding through storytelling vs demographics - Success metrics tailored to project type - Ruthless MVP scope management with feature prioritization ### Template Improvements - Added context-aware conditional sections - Better organization of optional vs required content - Clearer structure for different project types - Improved reference material handling ## PRD Workflow (improved from 65% to 85%+ compliance) ### Critical Fixes - Add missing `date: system-generated` config variable - Fix status file extension mismatch (.yaml not .md) - Remove 38% bloat (unused technical_decisions variables) - Add explicit template-output tags for runtime variables ### Scale-Adaptive Intelligence - Project type detection (API/Web App/Mobile/SaaS/etc) - Domain complexity mapping (14 domain types) - Automatic requirement tailoring based on detected context - CSV-driven project type and domain knowledge base ### Separated Epic Planning - Move epic/story breakdown to dedicated child workflow - Create create-epics-and-stories workflow for Phase 2 - Cleaner separation: PRD defines WHAT, epics define HOW - Updated PM agent menu with new workflow triggers ### Enhanced Requirements Coverage - Project-type specific requirement sections (endpoints, auth, platform) - Domain-specific considerations (healthcare compliance, fintech security) - UX principles with interaction patterns - Non-functional requirements with integration needs - Technical preferences capture ### Template Restructuring - Separate PRD template from epic planning - Context-aware conditional sections - Better scale level indicators (L0-L4) - Improved reference document handling - Clearer success criteria sections ## Architecture Workflow Updates ### Template Enhancements - Add domain complexity context support - Better integration with PRD outputs - Improved technical decision capture - Enhanced system architecture sections ### Instruction Improvements - Reference new domain-research workflow - Better handling of PRD inputs - Clearer architectural decision framework ## Agent Configuration Updates ### BMad Master Agent - Fix workflow invocation instructions - Better fuzzy matching guidance - Clearer menu handler documentation - Remove workflow invention warnings ### PM Agent - Add create-prd trigger (renamed from 'prd') - Add create-epics-and-stories workflow trigger - Add validate-prd workflow trigger with checklist - Better workflow status integration ### Game Designer Agent - Rename triggers for consistency (create-game-brief, create-gdd) - Align with PM agent naming conventions ## New Supporting Infrastructure ### Domain Research Workflow - New discovery workflow for domain-specific research - Complements product brief for complex domains - Web research integration for domain insights ### Create Epics and Stories Workflow - Dedicated epic/story breakdown process - Separates planning (PRD) from decomposition - Better Epic → Story → Task hierarchy - Acceptance criteria generation ### Data Files - project-types.csv: 12 project type definitions with requirements - domain-complexity.csv: 14 domain types with complexity indicators ## Quality Improvements ### Validation & Compliance - Product Brief: 96% BMAD v6 compliance (EXCELLENT rating) - PRD: Improved from 65% to ~85% after critical fixes - Zero bloat in Product Brief (0%) - Reduced PRD bloat from 38% to ~15% ### Template Variable Mapping - All template variables explicitly populated via template-output tags - Runtime variables properly tracked - Config variables consistently used - Better separation of concerns ### Web Bundle Configuration - Complete web_bundle sections for all workflows - Proper child workflow references - Data file inclusions (CSV files) - Correct bmad/-relative paths ## Breaking Changes ### File Removals - Delete src/modules/bmm/workflows/2-plan-workflows/prd/epics-template.md (replaced by create-epics-and-stories child workflow) ### Workflow Trigger Changes - PM agent: 'prd' → 'create-prd' - PM agent: 'gdd' → 'create-gdd' - New: 'create-epics-and-stories' - New: 'validate-prd' ## Impact This update significantly improves the BMM module's ability to: - Adapt to different project types and scales - Guide users through discovery naturally vs mechanically - Generate higher quality planning documents - Support complex domains with specialized knowledge - Scale from Level 0 quick changes to Level 4 enterprise projects The workflows now feel like collaborative discovery sessions with an expert consultant rather than form-filling exercises. |
||
|---|---|---|
| .claude/commands/bmad | ||
| .github | ||
| .husky | ||
| .vscode | ||
| bmad | ||
| bmd | ||
| docs | ||
| src | ||
| test | ||
| tools | ||
| .gitignore | ||
| .npmrc | ||
| .nvmrc | ||
| .prettierignore | ||
| CHANGELOG.md | ||
| CONTRIBUTING.md | ||
| LICENSE | ||
| README.md | ||
| eslint.config.mjs | ||
| package-lock.json | ||
| package.json | ||
| prettier.config.mjs | ||
| v6-open-items.md | ||
README.md
BMad CORE + BMad Method
🚨 ALPHA VERSION DOCUMENTATION
- Install v6 Alpha:
npx bmad-method@alpha install- Install stable v4:
npx bmad-method install- View v4 documentation
Universal Human-AI Collaboration Platform
BMad-CORE (Collaboration Optimized Reflection Engine) 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 • 🎨 Domain Agnostic • ⚡ Agent-Powered
Table of Contents
Quick Start
- New to v6? → BMad Method V6 Quick Start Guide
- Upgrading? → v4 to v6 Upgrade Guide
What is BMad-CORE?
Foundation framework powering all BMad modules:
- 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
- Collaboration: Human-AI partnership leveraging unique strengths
- Optimized: Refined processes for maximum effectiveness
- Reflection: Guided thinking unlocking better solutions
- Engine: 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
- Analysis - Brainstorming, research, briefs
- Planning - Scale-adaptive PRD/GDD
- Solutioning - Architecture and tech specs
- Implementation - Stories, development, review
Specialized Agents: PM, Analyst, Architect, Scrum Master, Developer, Game Designer/Developer/Architect, UX, Test Architect
Documentation: 📚 BMM Module | 📖 Workflows Guide
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 - Complete module reference
- 🎯 Create Agent - Agent builder workflow
- 📋 Create Workflow - Workflow designer
- 📦 Create Module - 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 | 📖 CIS Workflows
Installation
Prerequisites: Node.js v20+ (Download)
# Install v6 Alpha
npx bmad-method@alpha install
# Install stable v4
npx bmad-method install
Interactive installer guides you through:
- Project location - Installation directory
- Module selection - BMM, BMB, CIS
- Configuration - Name, language, game dev options
- IDE integration - Environment setup
Project Structure
your-project/
└── bmad/
├── core/ # Core framework
├── bmm/ # BMad Method
├── bmb/ # BMad Builder
├── cis/ # Creative Intelligence
└── _cfg/ # Your customizations
└── agents/ # Agent configs
Getting Started
After installation, activate Analyst agent and run:
/workflow-init
This initializes the workflow system and helps choose your starting point.
Key Features
🎨 Update-Safe Customization
- Agent modification via
bmad/_cfg/agents/ - Persistent settings through updates
- Multi-language support
- Flexible configuration
🚀 Intelligent Installation
- Auto-detects v4 installations
- Configures IDE integrations
- Resolves dependencies
- Creates unified manifests
📁 Unified Architecture
Single bmad/ folder - clean, organized, maintainable.
Documentation
- 📚 Documentation Index - Complete documentation map
- v4 to v6 Upgrade Guide - Migration instructions
- CLI Tool Guide - Installer reference
- Contributing Guide - Contribution guidelines
Community & Support
- 💬 Discord - Community help
- 🐛 Issues - Bug reports
- 🎥 YouTube - Tutorials
- ⭐ Star this repo - Updates
Contributing
See CONTRIBUTING.md for guidelines.
License
MIT License - See LICENSE
Trademark: BMAD™ and BMAD-METHOD™ are trademarks of BMad Code, LLC.
Built with ❤️ for the human-AI collaboration community