e979b47fe5
* update 2024 to 2025 * fix(workflows): remove hardcoded years from WebSearch queries Years in search queries (2024/2025) do not improve results - search engines already prioritize current documentation. Tested all patterns and confirmed identical quality results with/without years. Removes years from: - step-03-starter.md (5 queries) - step-04-decisions.md (2 queries) - game-architecture/instructions.md (2 queries) Leaves file-utils.md unchanged (test fixture data, not a search query). 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * fix(workflows): remove year placeholders from research WebSearch queries Search engines return current results regardless of year - removes {{current_year}} and hardcoded 2025 from step-05-technical-trends.md 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * refactor(workflows): replace {{current_year}} with semantic alternatives Replaces year placeholder with context-appropriate wording: - 'current data' for up-to-date information - 'web searches' without year qualifier - Updated failure mode to focus on using web searches 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * fix(workflows): clarify failure mode about stale training data Rephrased to explicitly mention training data cutoff as the reason to use web searches for current technology trends. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * refactor(workflows): make web search references platform-agnostic - Remove hardcoded year references from WebSearch queries - Replace `WebSearch` tool name with natural language "search the web" - Soften "training data is stale" to "verify and supplement your knowledge" - Add web search prerequisite check to research workflow - Add platform-agnostic design note to CLAUDE.md This framework targets 15+ agentic platforms, not just Claude Code. Tool-specific syntax like `WebSearch:` won't work across all platforms. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * refactor(research): clean up prompts and routing --------- Co-authored-by: Pomazan Bohdan <pomazan.bogdan@gmail.com> Co-authored-by: Brian <bmadcode@gmail.com> Co-authored-by: Claude <noreply@anthropic.com>
BMad Method & BMad Core
AI-Driven Agile Development That Scales From Bug Fixes to Enterprise
Build More, Architect Dreams (BMAD) with 19 specialized AI agents and 50+ guided workflows that adapt to your project's complexity—from quick bug fixes to enterprise platforms.
🚀 v6 is a MASSIVE upgrade from v4! Complete architectural overhaul, scale-adaptive intelligence, visual workflows, and the powerful BMad Core framework. v4 users: this changes everything. See what's new →
📌 v6 Alpha Status: Near-beta quality with vastly improved stability. Documentation is being finalized. New videos coming soon to BMadCode YouTube.
🎯 Why BMad Method?
Unlike generic AI coding assistants, BMad Method provides structured, battle-tested workflows powered by specialized agents who understand agile development. Each agent has deep domain expertise—from product management to architecture to testing—working together seamlessly.
✨ Key Benefits:
- Scale-Adaptive Intelligence - Automatically adjusts planning depth from bug fixes to enterprise systems
- Complete Development Lifecycle - Analysis → Planning → Architecture → Implementation
- Specialized Expertise - 19 agents with specific roles (PM, Architect, Developer, UX Designer, etc.)
- Proven Methodologies - Built on agile best practices with AI amplification
- IDE Integration - Works with Claude Code, Cursor, Windsurf, VS Code
🏗️ The Power of BMad Core
BMad Method is actually a sophisticated module built on top of BMad Core (Collaboration Optimized Reflection Engine). This revolutionary architecture means:
- BMad Core provides the universal framework for human-AI collaboration
- BMad Method leverages Core to deliver agile development workflows
- BMad Builder lets YOU create custom modules as powerful as BMad Method itself
With BMad Builder, you can architect both simple agents and vastly complex domain-specific modules (legal, medical, finance, education, creative) that will soon be sharable in an official community marketplace. Imagine building and sharing your own specialized AI team!
📊 See It In Action
Complete BMad Method workflow showing all phases, agents, and decision points
🚀 Get Started in 3 Steps
1. Install BMad Method
# Install v6 Alpha (recommended)
npx bmad-method@alpha install
# Or stable v4 for production
npx bmad-method install
2. Initialize Your Project
Load any agent in your IDE and run:
*workflow-init
This analyzes your project and recommends the right workflow track.
3. Choose Your Track
BMad Method adapts to your needs with three intelligent tracks:
| Track | Use For | Planning | Time to Start |
|---|---|---|---|
| ⚡ Quick Flow | Bug fixes, small features | Tech spec only | < 5 minutes |
| 📋 BMad Method | Products, platforms | PRD + Architecture + UX | < 15 minutes |
| 🏢 Enterprise | Compliance, scale | Full governance suite | < 30 minutes |
Not sure? Run
*workflow-initand let BMad analyze your project goal.
🔄 How It Works: 4-Phase Methodology
BMad Method guides you through a proven development lifecycle:
- 📊 Analysis (Optional) - Brainstorm, research, and explore solutions
- 📝 Planning - Create PRDs, tech specs, or game design documents
- 🏗️ Solutioning - Design architecture, UX, and technical approach
- ⚡ Implementation - Story-driven development with continuous validation
Each phase has specialized workflows and agents working together to deliver exceptional results.
🤖 Meet Your Team
12 Specialized Agents working in concert:
| Development | Architecture | Product | Leadership |
|---|---|---|---|
| Developer | Architect | PM | Scrum Master |
| UX Designer | Test Architect | Analyst | BMad Master |
| Tech Writer | Game Architect | Game Designer | Game Developer |
Test Architect integrates with @seontechnologies/playwright-utils for production-ready fixture-based utilities.
Each agent brings deep expertise and can be customized to match your team's style.
📦 What's Included
Core Modules
-
BMad Method (BMM) - Complete agile development framework
- 12 specialized agents
- 34 workflows across 4 phases
- Scale-adaptive planning
- → Documentation Hub
-
BMad Builder (BMB) - Create custom agents and workflows
- Build anything from simple agents to complex modules
- Create domain-specific solutions (legal, medical, finance, education)
- Share your creations in the upcoming community marketplace
- → Builder Guide
-
Creative Intelligence Suite (CIS) - Innovation & problem-solving
- Brainstorming, design thinking, storytelling
- 5 creative facilitation workflows
- → Creative Workflows
Key Features
- 🎨 Customizable Agents - Modify personalities, expertise, and communication styles
- 🌐 Multi-Language Support - Separate settings for communication and code output
- 📄 Document Sharding - 90% token savings for large projects
- 🔄 Update-Safe - Your customizations persist through updates
- 🚀 Web Bundles - Use in ChatGPT, Claude Projects, or Gemini Gems
📚 Documentation
Quick Links
- Quick Start Guide - 15-minute introduction
- Complete BMM Documentation - All guides and references
- Agent Customization - Personalize your agents
- All Documentation - Complete documentation index
For v4 Users
💬 Community & Support
- Discord Community - Get help, share projects
- GitHub Issues - Report bugs, request features
- YouTube Channel - Video tutorials and demos
- Web Bundles - Pre-built agent bundles
🛠️ Development
For contributors working on the BMad codebase:
# Run all quality checks
npm test
# Development commands
npm run lint:fix # Fix code style
npm run format:fix # Auto-format code
npm run bundle # Build web bundles
See CONTRIBUTING.md for full development guidelines.
What's New in v6
v6 represents a complete architectural revolution from v4:
🚀 Major Upgrades
- BMad Core Framework - Modular architecture enabling custom domain solutions
- Scale-Adaptive Intelligence - Automatic adjustment from bug fixes to enterprise
- Visual Workflows - Beautiful SVG diagrams showing complete methodology
- BMad Builder Module - Create and share your own AI agent teams
- 50+ Workflows - Up from 20 in v4, covering every development scenario
- 19 Specialized Agents - Enhanced with customizable personalities and expertise
- Update-Safe Customization - Your configs persist through all updates
- Web Bundles - Use agents in ChatGPT, Claude, and Gemini
- Multi-Language Support - Separate settings for communication and code
- Document Sharding - 90% token savings for large projects
🔄 For v4 Users
- Comprehensive Upgrade Guide - Step-by-step migration
- v4 Documentation Archive - Legacy reference
- Backwards compatibility where possible
- Smooth migration path with installer detection
📄 License
MIT License - See LICENSE for details.
Trademarks: BMAD™ and BMAD-METHOD™ are trademarks of BMad Code, LLC.
Built with ❤️ for the human-AI collaboration community