Into the unforgiving banality of software development we reflexively march, clutching our glowing API keys like torches against the impenetrable desolation of technical debt. The BMAD Method - us mad be-ings expedition into the tarred ocean of AI-assisted creation - transforms the milquetoast ritual of "vibe coding" into misty charades evoking a mouth full of chalk and clandestine photographs. Nine specialized personas stand ready, a psychogeographical stonehenge coaxing us into treacherous mountain passes of token gathering, cataclismic tomfoolery, and the final commit: deploying a containerized singularity which compiled once last Thursday.
Here, in this repository, lies our decrepit documentation of the journey - templates gesturing at meaning imposed upon the gaping void, workflows pretending the machine cares about our deadlines, and a methodology born from the quixotic dreams of script kiddies daring to believe AI could hypnotize the savage beast of framework debates.
🎯 Intelligent Claude Code Integration
- Smart Persona Routing: Claude automatically selects the right persona (Analyst, PM, Architect, Designer, Developer, DevOps, QA, Data Engineer, Orchestrator) based on your request
- Adaptive Formality: Process rigor adjusts to project complexity - quick fixes skip ceremony, complex features get full rigor
- Session Continuity: Multi-session planning with context preservation through documentation-driven workflows
⚡ Streamlined Development
- Direct Task Navigation: Jump to specific tasks without file browsing - just say what you need
- Architecture-Agnostic: Templates support any pattern (monolith, microservices, serverless, edge) without forced assumptions
- Quality Built-In: 13 validation checklists and comprehensive templates ensure professional standards
📊 Visual Progress Tracking
- Optional BMAD Dashboard: Next.js application for visualizing project ideas from exploration through MVP candidates
- Viability Metrics: Track business/technical balance with dual progress indicators
- Anthropic Design: Consistent branding with Claude Code's design system
Navigate to the root directory of your project and use the setup script to automatically configure BMAD:
macOS/Linux/WSL:
Single command (copy and paste entire block):
curl -O https://raw.githubusercontent.com/cabinlab/BMAD-CLAUDE-CODE/main/setup-bmad.sh && \
chmod +x setup-bmad.sh && \
./setup-bmad.shWindows Users: Since Claude Code requires WSL, run the above bash command in your WSL terminal, not PowerShell.
The script will:
- Copy all necessary BMAD files to your project
- Create the proper directory structure
- Initialize planning journal and session files
- Let you choose between basic and enhanced Claude.md
- Optional: Install the BMAD Dashboard for visual progress tracking
your-project/
├── CLAUDE.md # Claude Code instructions
├── BMAD-CLAUDE-CODE-GUIDE.md # Quick reference
├── bmad-agent/ # BMAD assets
│ ├── checklists/ # Quality checklists
│ ├── data/ # Knowledge base
│ ├── guides/ # Methodology and usage guides
│ ├── personas/ # Persona definitions
│ ├── tasks/ # Executable tasks
│ └── templates/ # Document templates
├── docs/ # Your project artifacts
│ ├── bmad-journal.md # Planning history
│ ├── .bmad-session/ # Session continuity
│ ├── project-brief.md # Vision document
│ ├── prd.md # Requirements
│ ├── architecture.md # Technical design
│ └── stories/ # User stories
├── bmad-dashboard/ # Optional visual dashboard
│ ├── app/ # Next.js application
│ └── components/ # UI components
└── src/ # Your code
The BMAD Dashboard provides visual tracking of your project ideas:
- Exploration Tracking: Low-commitment idea validation
- MVP Ranking: Prioritized candidates by viability
- Opportunity Banking: Validated ideas for future consideration
- Dual Progress Bars: Business vs Technical viability visualization
- Dark Mode: Automatic theme switching
If you chose to install the dashboard during setup:
cd bmad-dashboard
npm install
npm run dev
# Open http://localhost:3001- CLAUDE.md - Main instructions for Claude Code
- CLAUDE-ENHANCED.md - Enhanced version with full planning
- BMAD-CLAUDE-CODE-GUIDE.md - Quick reference
- BMAD-SESSION-CONTINUITY.md - Session management
📋 Setup Instructions
- Clone this repository or download the files
- Copy these to your project root:
bmad-agent/folder (personas, templates, tasks, checklists, data)CLAUDE.mdorCLAUDE-ENHANCED.md(rename to CLAUDE.md)BMAD-CLAUDE-CODE-GUIDE.md(optional quick reference)
- Create a
docs/folder in your project for BMAD artifacts - Start using BMAD with Claude Code!
Starting a New Project:
User: "Let's plan a new app using BMAD"
Claude Code: I'll help you start a new BMAD project. Let me set up the planning structure...
Continuing Work:
User: "Continue BMAD planning"
Claude Code: I see we were working on the PRD as the Product Manager...
Key Commands:
- "Act as the BMAD [Persona]" - Claude adopts specific persona mindset
- "Create a [document]" - Uses appropriate BMAD template
- "Run [checklist]" - Executes quality validation
- "Show planning status" - Reviews progress and next steps
Usage Examples:
- Direct Requests: "Build authentication" → [Developer] starts implementation
- Create Documents: "Create user stories" → [PM] drafts stories
- Design Systems: "Design the database" → [Data Engineer] creates schema
- Quality Gates: "Run architecture checklist" → Validates design decisions
⚙️ Session Management Options
Use for simple, single-session projects:
- Copy
CLAUDE.mdas-is to your project root - No session tracking needed
- Best for small features or quick prototypes
- All planning happens in one session
For complex, multi-session planning:
- Copy
CLAUDE-ENHANCED.mdto your project root and rename toCLAUDE.md - Includes efficiency enhancements, session continuity, and planning journal support
- Best for full application development with extended planning phases
📚 BMAD Method Details
The BMAD Method is a revolutionary approach that elevates "vibe coding" to advanced project planning, ensuring AI-driven development starts with clear vision and completes with explicit guidance. It provides a structured yet flexible framework to plan, execute, and manage software projects.
- Structured Planning: Move from idea to implementation with clear phases
- Quality Built-In: Checklists and templates ensure nothing is missed
- Context Preservation: Never lose planning decisions across sessions
- Role-Based Thinking: Claude Code adopts appropriate mindsets for each phase
- Document-Driven: All artifacts are markdown files, easy to review and version
Analyst persona investigates and challenges assumptions:
- Deep research into problem space and constraints
- Competitive analysis and market validation
- Edge case identification and risk assessment
Product Manager persona transforms research into requirements:
- Creates comprehensive PRD with prioritized features
- Defines user stories with clear acceptance criteria
- Establishes success metrics and MVP scope
Architect and Designer personas create system design:
- Architecture patterns for scalability and maintainability
- API specifications and security modeling
- User experience flows and interface design
Developer persona builds the solution:
- Clean code implementation following best practices
- Debugging and refactoring for maintainability
- Technical documentation and code reviews
QA Engineer persona ensures quality:
- Test strategy design and test automation
- Performance and security testing
- Independent quality validation
Data Engineer persona architects information flow:
- Database schema design and optimization
- Data migration and ETL pipeline creation
- Privacy compliance and data governance
DevOps Engineer persona enables deployment:
- CI/CD pipeline setup and automation
- Infrastructure design and monitoring
- Security hardening and cost optimization
Orchestrator persona maintains project discipline:
- Quality gates and validation checkpoints
- Change management and course correction
- Session continuity and knowledge preservation
🛠️ Available Resources
Core Templates:
project-brief-tmpl.md- Vision and problem definitionprd-tmpl.md- Product requirements with pattern guidancearchitecture-tmpl.md- System design with architecture patternsstory-tmpl.md- User stories with comprehensive DoD
Specialized Templates:
front-end-architecture-tmpl.md- Frontend technical designfront-end-spec-tmpl.md- UI/UX specificationstest-strategy-tmpl.md- Comprehensive testing approachsession-state-tmpl.md- Session continuity trackingplanning-journal-tmpl.md- Decision history across sessionsdoc-sharding-tmpl.md- Documentation organization
Core Tasks:
create-prd.md- Requirements definitioncreate-architecture.md- System designcreate-next-story.md- User story creationcreate-deep-research.md- Investigation and analysis
Design & Architecture Tasks:
create-api-specification.md- API design and contractscreate-frontend-architecture.md- Frontend system designcreate-ui-specification.md- UI/UX design specificationscreate-database-design.md- Database schema designsecurity-threat-model.md- Security analysis
Implementation Tasks:
implement-story.md- Guided code implementationcreate-test-strategy.md- Comprehensive testing approachgenerate-tests.md- Comprehensive test creationdebug-issue.md- Systematic debuggingcreate-deployment-pipeline.md- CI/CD setupcreate-data-migration-strategy.md- Data migration planning
Process Tasks:
coordinate-multi-persona-feature.md- Multi-persona coordinationcorrect-course.md- Change managementcore-dump.md- Session memory capturechecklist-run-task.md- Quality gate execution
Product & Requirements:
pm-checklist.md- PRD quality validationpo-master-checklist.md- Backlog readinessstory-draft-checklist.md- Story quality validationstory-dod-checklist.md- Definition of Done
Architecture & Design:
architect-checklist.md- System architecture reviewfrontend-architecture-checklist.md- Frontend design validationapi-design-checklist.md- API specification qualitysecurity-threat-model-checklist.md- Security analysis validation
Implementation & Quality:
implementation-quality-checklist.md- Code quality standardstest-suite-quality-checklist.md- Test coverage validationdeployment-pipeline-checklist.md- CI/CD quality validationdebug-process-checklist.md- Issue resolution validationchange-checklist.md- Change management validation
Example 1: Starting Fresh
User: "I want to build a task management app using BMAD"
Claude Code: I'll help you start a new BMAD project for your task management app.
Let me set up the planning structure and begin with discovery...
Example 2: Continuing Work
User: "Continue BMAD planning"
Claude Code: I see we were working on Epic 2 of your PRD. Last session we completed
the user authentication stories. Shall we continue with the task management stories?
Example 3: Running Checklists
User: "Run the architecture checklist"
Claude Code: I'll run through the architecture checklist for your current design.
Let's validate each aspect...
This fork is very experimental, and probably not at a point contributions make sense.
BMAD-CLAUDE-CODE is a fork of the original BMAD-METHOD by bmadcode, adapted specifically for Claude Code users.
