BMad Method v6.0.0-alpha.7

🚀 BMAD Method v6.0.0-alpha.7

🎯 Highlights

This release focuses on web bundler improvements, module extraction, and critical bug fixes for workflow dependencies.

✨ New Features

• Web Bundle Support for BMM Module: Added 8 BMM agents and team-fullstack web bundles (~25k lines)

  • Agents: analyst, architect, dev, pm, sm, tea, tech-writer, ux-designer
  • Team: team-fullstack (complete BMAD Method team bundle)

• Workflow Vendoring System: Web bundler now supports vendoring child workflows into parent bundles

  • Enables complete standalone workflow bundles with all dependencies
  • Supports nested workflow references and proper file resolution

• BMGD Module Extraction: Game development module (BMGD) properly extracted with workflow vendoring support

🐛 Bug Fixes

• Critical: Fixed missing adv-elicit-methods.csv dependency

  • Added CSV file to architecture, PRD, and tech-spec workflows
  • Prevents runtime failures when advanced elicitation is invoked in bundled workflows
  • Ensures all 39 elicitation methods are available

• Fixed menu items for workflows with web_bundle: false

  • Workflows that can't be bundled no longer appear in web bundle menus

• Installation improvements: Fixed Claude/IDE tool installations to not add README files

  • Slash command regression fix
  • Cleanup of bmad folders in tools during install

• Improved dependency messaging: Show positive message when no missing dependencies found

📚 Documentation

• Updated TEA documentation to align with BMad 4-phase methodology
• Documentation and diagram improvements across the board

🔧 Infrastructure

• Web bundler improvements (part 1 of ongoing optimizations)
• Added Claude Code PR review workflow with GitHub token support

⚠️ Known Issues

• Web bundler still has optimizations and known issues being addressed in upcoming releases
• Additional fixes planned for future alpha releases

📦 Installation

npm install -g [email protected]

Or update existing installation:

npm update -g bmad-method

Full Changelog: v6.0.0-alpha.6...v6.0.0-alpha.7

v6.0.0-alpha.6

🐛 Bug Fixes

• Critical: Fixed manifestPath is not defined error in ide-config-manager that was causing installation failures
• UX: Fixed installer option display to show full descriptive labels instead of just values for single/multi-select questions (e.g., now shows "Beginner - New to development, explain concepts clearly" instead of just "beginner")

✨ Improvements

• New Feature: Added install_user_docs configuration option allowing users to opt out of installing documentation to their project directory (defaults to true)
• UX: Improved configuration question display with better formatting and descriptive labels
• Documentation: Updated CONTRIBUTING.md to remove references to non-existent 'next' branch

🧹 Maintenance

• Closed 54 legacy v4-era issues (older than 1 month) to maintain a clean issue tracker focused on v6

📦 Installation

npx bmad-method@latest install

Or update existing installation:

cd <your-project>
npx bmad-method@latest install

🔍 What's Changed Since alpha.5

Full commit history: v6.0.0-alpha.5...v6.0.0-alpha.6

BMad Method v6.0.0-alpha.4

Changelog

[Unreleased]

[6.0.0-alpha.4]

Release: November 2, 2025

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)
• workflow-architecture-reference.md - Architecture workflow technical reference
• workflow-document-project-reference.md - Document-project workflow technical reference
• enterprise-agentic-development.md - Team collaboration patterns
• faq.md - Comprehensive Q&A covering all common questions
• glossary.md - Complete BMM terminology reference
• troubleshooting.md - Common issues and solutions guide

Documentation Improvements:

• Removed version/date footers (git handles versioning automatically)
• Agent customization docs now include full rebuild process
• Consistent professional formatting and structure across all docs
• Better separation of user documentation vs developer reference

🤖 New Agent: Paige (Documentation Guide)

Introduced Paige, a specialized technical documentation agent:

• Expertise: Professional technical writing, information architecture, documentation structure
• Integration: Available across all BMM phases for continuous documentation support
• Customizable: Like all BMM agents, can be customized via sidecar files
• Status: Work in progress - will evolve as documentation needs grow

🚀 Quick Spec Flow - Intelligent Level 0-1 Planning

Major Tech-Spec Workflow Transformation:

• Transformed from template-filling into context-aware intelligent planning system
• Ideal for bug fixes, single endpoint additions, and small isolated changes
• Auto-detects project stack (package.json, requirements.txt, etc.)
• Analyzes brownfield codebases for conventions and patterns
• Integrates WebSearch for current framework versions and best practices

Context-Aware Intelligence:

• Interactive level detection (Level 0 vs Level 1)
• Brownfield convention detection with user confirmation
• Comprehensive context discovery (stack, patterns, dependencies, test frameworks)
• Auto-validation with quality scoring (no manual checklist needed)
• UX/UI considerations capture for user-facing changes

Enhanced Tech-Spec Template:

• Expanded from 8 to 23 sections for complete planning context
• New sections: Development Context, UX/UI Considerations, Integration Points
• Developer Resources section with file paths and testing guidance
• All sections populated via template-output tags during workflow

Story Generation Improvements:

• Level 0: Extract single story from comprehensive tech-spec
• Level 1: Story sequence validation with acceptance criteria quality checks
• User Story Template includes Dev Agent Record sections for implementation tracking
• Complete epic template rewrite with proper variable structure

Phase 4 Integration:

• Story Context and Create Story workflows now recognize tech-spec as authoritative source
• Seamless integration between Quick Spec Flow and traditional BMM workflows
• Tech-spec provides brownfield analysis, framework details, and existing patterns

📦 Universal Document Sharding

New Capability: Shard-Doc Workflow

• Split large markdown documents into organized, smaller files based on sections
• Dual-strategy loading: include individual shards OR single large document
• Configurable section level (default: level 2 headings)
• Automatic index.md generation with navigation links
• Ideal for large guides, API documentation, and knowledge bases

Use Cases:

• Breaking down massive planning documents for better context management
• Creating navigable documentation hierarchies
• Managing agent knowledge bases efficiently
• Optimizing context window usage during development

Integration:

• Available as BMad Core workflow: /bmad:core:tools:shard-doc
• Works with any markdown document in your project
• Preserves original file with automatic backups
• Generated shards maintain formatting and structure

🔧 Planning Workflow Enhancements

Intent-Driven Discovery (Product Brief & PRD):

• Transformed from rigid template-filling 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

Product Brief Workflow (96% BMAD v6 compliance):

• Intent-driven facilitation with context-appropriate probing
• Living document approach with continuous template updates
• Enhanced discovery areas: problem exploration, solution vision, user understanding
• Ruthless MVP scope management with feature prioritization
• Template improvements with context-aware conditional sections

PRD Workflow (improved from 65% to 85%+ compliance):

• Fixed critical config issues (missing date variable, status file extension mismatch)
• Scale-adaptive intelligence with project type detection (API/Web App/Mobile/SaaS)
• Domain complexity mapping (14 domain types with specialized considerations)
• Enhanced requirements coverage: project-type specific sections, domain considerations
• Separated epic planning into dedicated create-epics-and-stories child workflow

Architecture Workflow:

• Better integration with PRD outputs
• Domain complexity context support
• Enhanced technical decision capture framework

🛠️ Research Workflow Improvements

Enhanced Research Capabilities:

• Updated to use web search more frequently for current information
• Better understanding of current date context for finding latest documentation
• Improved deep research prompt generation options
• More accurate and up-to-date research results

🎨 User Experience Improvements

Installer Updates:

• Improved installation notes and guidance
• Better command examples (shard-doc uses npx command pattern)

Workflow Cleanup:

• Removed unused voice hooks functionality
• Cleaned up backup and temporary files
• Better workflow naming consistency

📋 Infrastructure & Quality

Agent & Workflow Manifests:

• Added Paige to agent manifest
• 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 [email protected] install

For upgrading from alpha.3:

# Backup your customizations first
npx [email protected] install

Migration Notes

If upgrading from v6.0.0-alpha.3:

1. New documentation is available in bmad/bmm/docs/ - review the README.md for navigation
2. Tech-spec workflow now has enhanced capabilities - review docs/quick-spec-flow.md
3. Product Brief and PRD workflows have new conversational approaches
4. Paige agent is now available for documentation tasks
5. 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 a...

BMad Method v4.44.1

🚀 What's New in v4.44.1

✨ New Features

• feat: implement fork-friendly CI/CD with opt-in mechanism (#476)
• feat(installer): add Codex CLI + Codex Web modes, generate AGENTS.md, inject npm scripts, and docs (#529)
• feat: add PR validation workflow and contribution checks
• feat: Add Auggie CLI (Augment Code) Integration (#520)
• feat: enhance file exclusion capabilities with .bmad-flattenignore support (#531)
• feat: add iflow cli support to bmad installer. (#510)
• feat(opencode): add JSON-only integration and compact AGENTS.md generator (#570)

🐛 Bug Fixes

• fix: update installer version display to show 4.39.0
• fix: prettier fixes
• fix: previous merge set wrong default install location
• fix: documentation and trademark updates
• fix: remove incorrect else branch causing flatten command regression (#452)
• fix: correct dependency path format in bmad-master agent (#495)
• fix: Codex options missing from the IDE selection menu (#535)
• Fixed: "glob" is not defined (#504)
• fix: Template file extension in validation next story steps (#523)
• fix: update .gitignore to correct cursor file entry (#485)
• fix: update workflow file extensions from .md to .yaml in bmad-master.md (#562)
• fix: Changed title to coding standards section of brownfield architecture template (#564)
• fix: BMAD Brownfield Document Naming Inconsistency Bug (#627)

📦 Other Changes

• patch: move script to tools folder
• typo in README.md (#515)
• Update dev.md (#491)
• test: trigger PR validation (#533)
• docs: remove misplaced Codex section from README
• Expansion pack doc correction
• added gemini cli custom commands! (#549)
• Update ide-setup.js - add missing glob require (#514)
• Godot Game Dev expansion pack for BMAD (#532)
• documentation updates
• remove errant command from readme
• version up

🔧 Maintenance

• chore: bump to 4.39.1 to fix installer version display
• chore: update project dependencies and development tooling (#508)
• chore: bump version to 4.42.0 for release
• chore: sync version to 4.42.1 after release

📦 Installation

npx bmad-method install

Full Changelog: v4.39.0...v4.44.1

Version 4.43 - Maturity & Ecosystem Expansion

Release: August-September 2025 (v4.31.0 - v4.43.1)

Focus on stability, ecosystem growth, and professional tooling.

Major Integrations

• Codex CLI & Web: Full Codex integration with web and CLI modes
• Auggie CLI: Augment Code integration
• iFlow CLI: iFlow support in installer
• Gemini CLI Custom Commands: Enhanced Gemini CLI capabilities

Expansion Packs

• Godot Game Development: Complete game dev workflow
• Creative Writing: Professional writing agent system
• Agent System Templates: Template expansion pack (Part 2)

Advanced Features

• AGENTS.md Generation: Auto-generated agent documentation
• NPM Script Injection: Automatic package.json updates
• File Exclusion: .bmad-flattenignore support for flattener
• JSON-only Integration: Compact integration mode

Quality & Stability

• PR Validation Workflow: Automated contribution checks
• Fork-Friendly CI/CD: Opt-in mechanism for forks
• Code Formatting: Prettier integration with pre-commit hooks
• Update Checker: npx bmad-method update-check command

Flattener Improvements

• Detailed statistics with emoji-enhanced .stats.md
• Improved project root detection
• Modular component architecture
• Binary directory exclusions (venv, node_modules, etc.)

Documentation & Community

• Brownfield document naming consistency fixes
• Architecture template improvements
• Trademark and licensing clarity
• Contributing guidelines refinement

Developer Experience

• Version synchronization scripts
• Manual release workflow enhancements
• Automatic release notes generation
• Changelog file path configuration

View v4.43.1 tag

Version 4.30 - IDE Innovation & Claude Code

Release: July 2025 (v4.21.0 - v4.30.4)

Introduction of advanced IDE integrations and command systems.

Claude Code Integration

• Slash Commands: Native Claude Code slash command support for agents
• Task Commands: Direct task invocation via slash commands
• BMad Subdirectory: Organized command structure
• Nested Organization: Clean command hierarchy

Agent Enhancements

• BMad-master knowledge base loading
• Improved brainstorming facilitation
• Better agent task following with cost-saving model combinations
• Direct commands in agent definitions

Installer Improvements

• Memory-efficient processing
• Clear multi-select IDE prompts
• GitHub Copilot support with improved UX
• ASCII logo (because why not)

Platform Support

• Windows compatibility improvements (regex fixes, newline handling)
• Roo modes configuration
• Support for multiple CLI tools simultaneously

Expansion Ecosystem

• 2D Unity Game Development expansion pack
• Improved expansion pack documentation
• Better isolated expansion pack installations

View v4.30.4 tag

Version 4.20 - Documentation Revolution & QA Enhancement

Release: June 2025 (v4.11.0 - v4.20.0)

Major focus on documentation quality and expanding QA agent capabilities.

Documentation Overhaul

• Workflow Diagrams: Visual explanations of planning and development cycles
• QA Role Expansion: QA agent transformed into senior code reviewer
• User Guide Refresh: Complete rewrite with clearer explanations
• Contributing Guidelines: Clarified principles and contribution process

QA Agent Transformation

• Elevated from simple tester to senior developer/code reviewer
• Code quality analysis and architectural feedback
• Pre-implementation review capabilities
• Integration with dev cycle for quality gates

IDE Ecosystem Growth

• Cline IDE Support: Added configuration for Cline
• Gemini CLI Integration: Native Gemini CLI support
• Expansion Pack Installation: Automated expansion agent setup across IDEs

New Capabilities

• Markdown-tree integration for document sharding
• Quality gates to prevent task completion with failures
• Enhanced brownfield workflow documentation
• Team-based agent bundling improvements

Developer Tools

• Better expansion pack isolation
• Automatic rule generation for all supported IDEs
• Common files moved to shared locations
• Hardcoded dependencies removed from installer

View v4.20.0 tag

Version 4.10 - Configuration & Flexibility

Release: June 2025 (v4.3.0 - v4.10.3)

This release focused on making BMAD more configurable and adaptable to different project structures.

Configuration System

• Optional Core Config: Document sharding and core configuration made optional
• Flexible File Resolution: Support for non-standard document structures
• Debug Logging: Configurable debug mode for agent troubleshooting
• Fast Update Mode: Quick updates without breaking customizations

Agent Improvements

• Clearer file resolution instructions for all agents
• Fuzzy task resolution for better agent autonomy
• Web orchestrator knowledge base expansion
• Better handling of deviant PRD/Architecture structures

Installation Enhancements

• V4 early detection for improved update flow
• Prevented double installation during updates
• Better handling of YAML manifest files
• Expansion pack dependencies properly included

Bug Fixes

• SM agent file resolution issues
• Installer upgrade path corrections
• Bundle build improvements
• Template formatting fixes

View v4.10.3 tag

Version 1.0 - The Original Vision

Initial Release: April 6, 2025

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

Limitations

• Limited customization options
• Web usage was complicated and not well-documented
• Rigid scope and purpose with templates coupled to agents
• Not optimized for IDE integration

View V1 Branch

Version 4.0 - Enterprise Framework & NPM Distribution

Release: June 20, 2025 (v4.0.0 - v4.2.0)

Version 4 represented a complete architectural overhaul, transforming BMAD from a collection of prompts into a professional, distributable framework.

Framework Transformation

• NPM Package: Professional distribution via npx bmad-method install
• Modular Architecture: Move to .bmad-core hidden folder structure
• Multi-IDE Support: Unified support for Claude, Cursor, Roo, Windsurf, and more
• Schema Standardization: YAML-based agent and team definitions
• Automated Installation: One-command setup with upgrade detection

Agent System Overhaul

• Agent team workflows (fullstack, no-ui, all agents)
• Web bundle generation for platform-agnostic deployment
• Task-based architecture (separate task definitions from agents)
• IDE-specific agent activation (slash commands for Claude Code, rules for Cursor, etc.)

New Capabilities

• Brownfield project support (existing codebases)
• Greenfield project workflows (new projects)
• Expansion pack architecture for domain specialization
• Document sharding for better context management
• Automatic semantic versioning and releases

Developer Experience

• Automatic upgrade path from v3 to v4
• Backup creation for user customizations
• VSCode settings and markdown linting
• Comprehensive documentation restructure

View v4.2.0 tag