Enterprise-grade agile development workflow automation with multi-agent orchestration
BMAD (Business-Minded Agile Development) transforms your development process into a fully automated agile workflow with role-based AI agents and quality gates.
/bmad-pilot "Build e-commerce checkout system with payment integration"
# Automated: Product β Architecture β Sprint β Dev β Review β QAgraph LR
PO[Product Owner] -->|PRD 90+| Architect
Architect -->|Design 90+| SM[Scrum Master]
SM -->|Sprint Plan| Dev
Dev -->|Code| Review
Review -->|Pass/Fail| QA
QA -->|Tests| Done
- π€ 6 Specialized Agents: PO, Architect, SM, Dev, Review, QA
- π Quality Gates: 90% thresholds with automatic optimization
- β Approval Points: User confirmation at critical phases
- π Persistent Artifacts: All documents saved to
./.claude/specs/ - π Iterative Refinement: Automatic improvement until quality met
| Agent | Role | Quality Gate | Output |
|---|---|---|---|
| bmad-po (Sarah) | Product requirements gathering | 90/100 PRD score | 01-product-requirements.md |
| bmad-architect (Winston) | Technical design & architecture | 90/100 design score | 02-system-architecture.md |
| bmad-sm (Mike) | Sprint planning & task breakdown | User approval | 03-sprint-plan.md |
| bmad-dev (Alex) | Feature implementation | Code completion | Implementation files |
| bmad-review | Independent code review | Pass/Risk/Fail | 04-dev-reviewed.md |
| bmad-qa (Emma) | Testing & quality assurance | Test execution | 05-qa-report.md |
# List available plugins
/plugin list
# Install specific workflow plugins
/plugin install bmad-agile-workflow # BMAD methodology
/plugin install requirements-driven-development # Requirements workflow
/plugin install development-essentials # Core dev commands
/plugin install advanced-ai-agents # GPT-5 integration
# View plugin details
/plugin info bmad-agile-workflow# Clone the repository
git clone https://github.com/your-repo/claude-code-workflows.git
cd claude-code-workflows
# Install everything with make
make install
# Or deploy specific workflows
make deploy-bmad # Deploy BMAD workflow only
make deploy-requirements # Deploy Requirements workflow only
make deploy-all # Deploy all commands and agents# Full agile workflow with all phases
/bmad-pilot "User authentication system with OAuth2 and MFA"
# Skip testing for quick prototypes
/bmad-pilot "Admin dashboard" --skip-tests
# Direct development (skip sprint planning)
/bmad-pilot "Bug fix for login issue" --direct-dev
# Skip repository scanning (use existing context)
/bmad-pilot "Add feature" --skip-scanEach BMAD run creates structured documentation:
.claude/specs/user-authentication/
βββ 00-repository-context.md # Repository analysis
βββ 01-product-requirements.md # PRD with business goals
βββ 02-system-architecture.md # Technical design
βββ 03-sprint-plan.md # Sprint tasks
βββ 04-dev-reviewed.md # Code review report (NEW v3.1)
βββ 05-qa-report.md # Test results
The BMAD workflow uses a specialized output style that:
- Creates phase-separated contexts
- Manages agent handoffs
- Tracks quality scores
- Handles approval gates
- Supports Codex CLI integration
This project now includes native Claude Code plugin support with 4 ready-to-use plugin packages:
| Plugin | Description | Commands | Agents |
|---|---|---|---|
| bmad-agile-workflow | Full BMAD methodology with role-based agents | /bmad-pilot |
bmad-po, bmad-architect, bmad-sm, bmad-dev, bmad-qa |
| requirements-driven-development | Streamlined requirements workflow | /requirements-pilot |
requirements-generate, requirements-code, requirements-review |
| development-essentials | Core development commands | /code, /debug, /test, /optimize |
code, bugfix, debug, develop |
| advanced-ai-agents | GPT-5 deep analysis integration | - | gpt5 |
# List all available plugins
/plugin list
# Get detailed information about a plugin
/plugin info bmad-agile-workflow
# Install a plugin to activate its commands and agents
/plugin install requirements-driven-development
# Remove an installed plugin
/plugin remove development-essentialsPlugins are defined in .claude-plugin/marketplace.json following the Claude Code plugin specification. Each plugin includes:
- Commands (slash commands)
- Agents (specialized AI agents)
- Metadata (version, author, keywords)
- Category classification
- bmad-review: Automated review between Dev and QA
- Dual Version Support:
- Standard: Native Claude Code review
- Enhanced: GPT-5 via Codex CLI
- Three-tier Status: Pass / Pass with Risk / Fail
- Dev β Review β QA quality chain
- Automatic Sprint plan updates
- Targeted QA test recommendations
- Business Value: 30
- Functional Requirements: 25
- User Experience: 20
- Technical Constraints: 15
- Scope & Priorities: 10
- Design Quality: 30
- Technology Selection: 25
- Scalability: 20
- Security: 15
- Feasibility: 10
- Pass: No issues, proceed to QA
- Pass with Risk: Non-critical issues
- Fail: Must return to Dev
BMAD automatically scans your repository to understand:
- Technology stack
- Project structure
- Existing patterns
- Dependencies
- Conventions
Each phase supports iterative improvement:
PO: "Here's the PRD (Score: 75/100)"
User: "Add mobile support and offline mode"
PO: "Updated PRD (Score: 92/100) β
"
Critical phases require explicit confirmation:
Architect: "Technical design complete (Score: 93/100)"
System: "Ready to proceed? (yes/no)"
User: yes
An alternative lightweight workflow for simpler projects:
/requirements-pilot "Implement JWT authentication"
# Automated: Requirements β Code β Review β Test- 90% quality gates
- Automatic optimization loops
- Implementation-focused specs
- Pragmatic over architectural
/ask- Technical consultation/code- Direct implementation/debug- Systematic debugging/test- Testing strategies/review- Code validation/optimize- Performance tuning/bugfix- Bug resolution/refactor- Code improvement/docs- Documentation/think- Advanced analysis
/ask "Design patterns for real-time messaging"
/code "Implement WebSocket server"
/test "Create integration tests"
/review "Validate security"MIT License - see LICENSE file
- Documentation: Check
/commands/and/agents/directories - Plugin Guide: See PLUGIN_README.md for plugin system details
- Issues: GitHub issues for bugs and features
- Makefile Help: Run
make helpfor all deployment options - Claude Code Docs: Plugin System
make install # Install everything to Claude Code
make deploy-bmad # Deploy BMAD workflow only
make deploy-requirements # Deploy Requirements workflow only
make deploy-commands # Deploy all slash commands
make deploy-agents # Deploy all agent configurations
make test-bmad # Test BMAD workflow sample
make test-requirements # Test Requirements workflow sample
make clean # Clean generated artifacts
make help # Show all available commandsTransform your development with BMAD - One command, complete agile workflow, quality assured.
Install with /plugin install bmad-agile-workflow or use traditional installation methods.
Let specialized AI agents handle specialized work.