This alpha release represents a major leap forward in documentation, workflow intelligence, and usability. The BMM module now features professional documentation, context-aware planning workflows, and universal document management capabilities.
📚 Complete Documentation Overhaul
New Documentation Hub (src/modules/bmm/docs/)
Created centralized documentation system with 18 comprehensive guides (7000+ lines)
Clear learning paths for greenfield, brownfield, and quick spec flows
Professional technical writing standards throughout all documentation
Reading time estimates and cross-referenced navigation
New Documentation Files:
README.md - Complete documentation hub with topic navigation
quick-start.md - 15-minute getting started guide
agents-guide.md - Comprehensive 12-agent reference (45 min read)
party-mode.md - Multi-agent collaboration guide (20 min read)
scale-adaptive-system.md - Deep dive on Levels 0-4 (42 min read)
brownfield-guide.md - Existing codebase development (53 min read)
quick-spec-flow.md - Rapid Level 0-1 development (26 min read)
workflows-analysis.md - Phase 1 workflows deep-dive (12 min read)
workflows-planning.md - Phase 2 workflows deep-dive (19 min read)
workflows-solutioning.md - Phase 3 workflows deep-dive (13 min read)
workflows-implementation.md - Phase 4 workflows deep-dive (33 min read)
workflows-testing.md - Testing & QA workflows (29 min read)
Updated workflow manifest with new and restructured workflows
Better workflow-to-agent mappings across all documentation
Updated files manifest with all new documentation
Module Organization:
Streamlined BMM README to lean signpost format
Polished root README with better hierarchy and clear CTAs
Moved documentation from root docs/ to module-specific locations
Better separation of user docs vs developer reference
Data Infrastructure:
New CSV data files for project types and domain complexity
Enhanced workflow configuration with runtime variables
Better template variable mapping and tracking
🔄 Breaking Changes
File Removals:
Removed 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
New workflow triggers: create-epics-and-stories, validate-prd
Game Designer agent triggers renamed for consistency
📖 What's Next (Beta Roadmap)
Knowledge base integration for enhanced context management
Web bundle functionality completion
Additional specialized agents based on community feedback
Enhanced multi-agent collaboration patterns
Performance optimizations for large projects
Installation
npx bmad-method@6.0.0-alpha.4 install
For upgrading from alpha.3:
# Backup your customizations first
npx bmad-method@6.0.0-alpha.4 install
Migration Notes
If upgrading from v6.0.0-alpha.3:
New documentation is available in bmad/bmm/docs/ - review the README.md for navigation
Tech-spec workflow now has enhanced capabilities - review docs/quick-spec-flow.md
Product Brief and PRD workflows have new conversational approaches
Paige agent is now available for documentation tasks
No breaking changes to existing project structures
[6.0.0-alpha.3]
Codex Installer
Codex installer uses custom prompts in .codex/prompts/, instead of AGENTS.md
[6.0.0-alpha.0]
Release: September 28, 2025
Initial alpha release of a major rewrite and overhaul improvement of past versions.
Major New Features
Lean Core: The core of BMad is very simple - common tasks that apply to any future module or agents, along with common agents that will be added to any modules - bmad-web-orchestrator and bmad-master.
BMad Method: The new BMad Method (AKA bmm) is a complete overhaul of the v4 method, now a fully scale adaptive rewrite. The workflow now scales from small enhancements to massive undertakings across multiple services or architectures, supporting a new vast array of project type, including a full subclass of game development specifics.
BoMB: The BMad Builder (AKA BoMB) now is able to fully automate creation and conversion of expansion packs from v6 to modules in v6 along with the net new ideation and brainstorming through implementation and testing of net new Modules, Workflows (were tasks and templates), Module Agents, and Standalone Personal Agents
CIS: The Creative Intelligence Suite (AKA CIS)
[v6.0.0] - SKIPPED
Note: Version 5.0.0 was skipped due to NPX registry issues that corrupted the version. Development continues with v6.0.0-alpha.0.
The original BMAD Method was a tech demo showcasing how different custom agile personas could be used to build out artifacts for planning and executing complex applications from scratch. This initial version established the foundation of the AI-driven agile development approach.
Key Features
Introduction of specialized AI agent personas (PM, Architect, Developer, etc.)
Template-based document generation for planning artifacts
Emphasis on planning MVP scope with sufficient detail to guide developer agents
Hard-coded custom mode prompts integrated directly into agent configurations
The OG of Context Engineering in a structured way
Limitations
Limited customization options
Web usage was complicated and not well-documented
Rigid scope and purpose with templates coupled to agents