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-corehidden 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