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