BMAD Enhanced

Break My AGILE Down - Enhanced Edition

Transform hours of AGILE ceremony into minutes of AI-assisted productivity.

---

📚 Quick Navigation

New to BMAD Enhanced? Start here:

• Quick Start ⭐ - Get started fast
• Choosing Your Approach ⭐ - Direct Skills or Subagents?
• User Guide - Complete guide
• Workflow Guide - Practical examples
• Troubleshooting - Fix common issues

See Documentation Index for all guides

---

What is BMAD Enhanced?

BMAD Enhanced is a Claude Code native AI agent framework that implements the proven BMAD Method v4 workflow. It transforms 10-17 hours of manual AGILE work into 48-63 minutes of AI-assisted productivity.

Time Savings: 85-90% reduction in AGILE overhead

---

Two Ways to Use BMAD Enhanced

BMAD Enhanced gives you two approaches for different use cases:

1️⃣ Slash Commands (Direct Skills) - For Structured Tasks

When to use: You know exactly what you want to do

/create-task-spec "User authentication"     # Creates task specification
/implement-feature task-001                 # Implements the feature
/quality-gate task-001                      # Runs quality checks

Best for:

• ✅ Clear, specific tasks with known requirements
• ✅ Repeatable workflows (planning, implementation, testing)
• ✅ Fast, deterministic results
• ✅ When you want direct skill execution

2️⃣ Subagents (Conversational) - For Exploration & Guidance

When to use: You need help figuring out what to do

@james "Help me debug this login issue"            # Interactive debugging
@winston "Should I use microservices or monolith?" # Architecture advice
@orchestrator *workflow feature-delivery "Social login"  # Complete workflow

Best for:

• 💬 Need guidance or don't know where to start
• 🔍 Exploring options or debugging issues
• 🤝 Want conversational interaction
• 🎯 Complex workflows requiring coordination

---

Quick Decision Guide

Do you know EXACTLY what needs to be done?
│
├─ YES → Use /slash-commands (Direct Skills)
│         Fast, deterministic, structured output
│
└─ NO  → Use @subagents (Conversational)
          Get guidance, explore options, interactive help

Examples:

---

Quick Start

Installation

# Clone the repository
git clone https://github.com/yourusername/bmad-enhanced.git
cd bmad-enhanced

# Verify structure
ls -la .claude/

See Installation Guide for detailed setup

---

How to Use: Choose Your Approach

Approach 1: Direct Skills (Slash Commands)

Use /command when you know what you need:

# Complete workflow - structured tasks
/create-task-spec "User authentication feature"
/implement-feature task-auth-001
/run-tests --coverage
/quality-gate task-auth-001

All Available Commands:

• Planning: /create-task-spec, /breakdown-epic, /estimate-stories, /sprint-plan
• Architecture: /analyze-architecture, /create-architecture, /validate-architecture
• Development: /implement-feature, /run-tests, /fix-issue, /refactor-code
• Quality: /quality-gate, /nfr-assess, /trace-requirements, /test-design

Approach 2: Subagents (Conversational)

Use @agent when you need guidance:

# Get help and interact
@alex "I have a feature request for user login, how should I break this down?"
@winston "Should I use REST or GraphQL for my API?"
@james "The tests are failing but I'm not sure why"
@quinn "Is this code ready for production?"

Available Subagents:

• @alex - Planning & Requirements (creates specs, breaks down work)
• @james - Development (implements, debugs, explains code)
• @quinn - Quality Assurance (reviews, validates, assesses)
• @winston - Architecture (designs, analyzes, advises)
• @orchestrator - Workflow Coordination (runs complete workflows)

---

Common Workflows

Workflow 1: Simple Feature (Direct Skills Approach)

When you know what to build:

# 1. Create specification
/create-task-spec "User login endpoint with JWT"

# 2. Implement
/implement-feature task-login-001

# 3. Quality check
/quality-gate task-login-001

Why this approach: Clear requirements, structured output, fast

...