ldy26098
/
BMAD-METHOD
mirror of https://github.com/bmad-code-org/BMAD-METHOD.git
1
0
Fork 0
Code Packages Projects Releases Wiki Activity
BMAD-METHOD/README.md

18 KiB
Raw Blame History

The BMAD-Method 4.0 (Breakthrough Method of Agile (ai-driven) Development)

Previous Versions: Prior Version 1 | Prior Version 2 | Prior Version 3.1

Major Update: Complete Documentation Enhancement Project

BMAD Method 4.0 represents a massive expansion with 100+ documents, 500+ pages, and comprehensive persona documentation packages. This release includes complete documentation ecosystems for all personas, integration guides, quality frameworks, and success metrics.

Do This First, and all will make sense

There are lots of docs here, but I HIGHLY suggest you just try the Web Agent - it takes just a few minutes to set up in Gemini - and you can use the BMad Agent to explain how this method works, how to set up in the IDE, how to set up in the Web, what should be done in the web or ide (although you can choose your own path also!) - all just by talking to the bmad agent!

Web Quickstart Project Setup (Recommended)

Orchestrator Uber BMad Agent that does it all - already pre-compiled in the web-build-sample folder.

  • The contents of Agent Prompt Sample text get pasted into the Gemini Gem, or ChatPGT customGPT customGPT 'Instructions' field.
  • The remaining files in that same folder folder just need to be attached as shown in the screenshot below. Give it a name (such as BMad Agent) and save it, and you now have the BMad Agent available to help you brainstorm, research, plan, execute on your vision, or understand how this all even works!
  • Once its running, start with typing /help, and then type option 2 when it presents 3 options to learn about the method!

How It Works: The BMAD Method Explained

The BMAD Method uses a powerful Orchestrator system that coordinates specialized AI personas to handle different aspects of your project:

Core Mechanics:

  1. Orchestrator: The central "brain" that manages all personas and tasks
  2. Personas: Specialized AI experts (PM, Architect, UX/UI Designer, etc.)
  3. Tasks: Specific workflows each persona can execute
  4. Templates: Standardized documents personas use to create deliverables

Workflow:

User Request ’ Orchestrator ’ Appropriate Persona ’ Task Execution ’ Deliverable

Environments:

  • Web-based: Run in ChatGPT or Gemini with attached knowledge files
  • IDE-based: Run directly in your code editor with full project context

Key Commands:

  • /persona [name] - Activate a specific persona (Web)
  • /task [name] - Execute a specific task (Web)
  • *persona [name] - Activate a specific persona (IDE)
  • *task [name] - Execute a specific task (IDE)

Learn more about BMAD orchestration | Detailed mechanics | Command reference

📚 Complete Documentation Ecosystem (NEW in 4.0)

BMAD Method 4.0 includes the most comprehensive AI-driven development documentation available, with complete persona packages, integration guides, and quality frameworks.

🎯 Complete Persona Documentation Packages

Each persona now has a complete documentation package including comprehensive guides, templates, quality standards, workflows, and success metrics:

Business Analysis & Product Management

Architecture & Development

Design & User Experience

Agile & Process Management

🔗 Integration & Architecture Documentation

🧠 How It Works Documentation

🗺️ User Journey Maps

🎨 Visual Design System

📋 Documentation Standards & Quality

Quick Start Guides

For Different Roles:

For Specific Personas:

🔧 IDE Integration & Setup

The BMAD Method supports multiple AI-powered development environments with specialized configurations:

IDE Environment Setup Guide Training Material Best For
Cursor AI Setup Guide Training Guide Advanced codebase integration
Cline (Claude Dev) Setup Guide Training Guide Project context awareness
Claude Code Setup Guide Training Guide Code quality standards
Roocode Setup Guide Training Guide Rapid prototyping
VS Code Setup Guide - Traditional development
JetBrains Setup Guide - Enterprise development

Complete IDE Documentation:

📊 Project Statistics (Version 4.0)

  • 100+ Total Documents - Comprehensive coverage of all aspects
  • 500+ Total Pages - In-depth documentation and guidance
  • 50+ Diagrams & Visualizations - Clear process flows and architectures
  • 20+ Templates - Ready-to-use templates for all personas
  • 15+ Examples - Real-world implementation examples
  • 8 Complete Persona Packages - Full documentation suites
  • 6 IDE Environments Supported - Flexible development options

🎯 Available Personas & Capabilities

Core Business Personas:

  • Business Analyst (BA) - Requirements analysis, stakeholder management, process optimization
  • Product Manager (PM) - Product strategy, roadmap planning, feature prioritization
  • Product Owner (PO) - Backlog management, user story creation, acceptance criteria

Technical Personas:

  • System Architect - Technical architecture, system design, technology decisions
  • Developer - Code implementation, technical solutions, development best practices
  • Design Architect - Design systems, visual architecture, design standards

Specialized Personas:

  • v0 UX/UI Architect (Veronica/Victor) - AI-powered design-to-code workflows
  • Scrum Master - Agile facilitation, process improvement, team coaching

Process Personas:

  • DevOps/Platform Engineer - Infrastructure, deployment, operational excellence
  • Quality Assurance - Testing strategies, quality frameworks, validation processes

🔄 Integration & Workflow

The BMAD Method provides seamless integration between all personas through:

  • Cross-Persona Workflows - Standardized handoff procedures
  • Integration Architecture - Technical integration patterns
  • Communication Protocols - Structured information exchange
  • Quality Gates - Consistent quality assurance across all deliverables
  • Shared Templates - Common document formats and structures

📈 Success Metrics & Quality Framework

Every persona includes comprehensive success metrics and quality standards:

  • Performance Metrics - Quantitative success measurements
  • Quality Standards - Consistent output quality across all personas
  • Process Metrics - Workflow efficiency and effectiveness
  • Outcome Metrics - Business value and impact measurement
  • Continuous Improvement - Feedback loops and optimization processes

What's New - Version 4.0 Major Release

🎉 Documentation Enhancement Project Completed:

  • Complete Persona Documentation Packages - Every persona now has comprehensive documentation
  • Integration Architecture - Detailed integration guides showing how all personas work together
  • Quality Framework - Comprehensive quality standards and success metrics for all personas
  • Template Library - Extensive collection of templates for all processes and personas
  • Training Materials - Complete training guides for all environments and personas

🔧 Enhanced Capabilities:

  • Cross-Persona Workflows - Seamless collaboration between all personas
  • Quality Assurance Framework - Built-in quality validation and improvement processes
  • Success Metrics System - Comprehensive measurement and optimization framework
  • Documentation Standards - Consistent quality and formatting across all documentation

📚 New Documentation Categories:

  • Comprehensive Guides - In-depth documentation for each persona
  • Integration Guides - How personas work together in real projects
  • Template Guides - Complete template libraries with usage instructions
  • Quality Standards - Quality frameworks and validation procedures
  • Workflow Mapping - Detailed process flows and decision trees
  • Success Metrics - Measurement frameworks and optimization strategies

🎯 Enhanced User Experience:

  • Documentation Map - Easy navigation through the complete documentation ecosystem
  • Role-Based Quickstarts - Tailored getting-started guides for each persona
  • Integration Examples - Real-world examples of cross-persona collaboration
  • Quality Checklists - Validation tools for consistent output quality

📊 Project Deliverables:

  • 28 New Documentation Files - Comprehensive coverage of all personas
  • 8 Complete Persona Packages - Full documentation suites for each role
  • 4 Integration Guides - Cross-persona collaboration documentation
  • Multiple Quality Frameworks - Standards and metrics for all processes

Previous Versions: V1 | V2 | V3.1

📋 Navigation & Getting Started

New Users:

  1. Start Here: BMAD Method Quickstart
  2. Choose Environment: Web or IDE
  3. Select Your Role: Use the persona-specific quickstart guides above
  4. Explore Integration: Comprehensive Integration Guide

Existing Users:

  1. What's New: Release Notes
  2. Documentation Map: Complete Documentation Overview
  3. Integration Updates: Integration Architecture
  4. Quality Standards: Documentation Standards

Project Teams:

  1. Project Summary: Complete Project Overview
  2. Team Setup: Choose appropriate persona packages for your team members
  3. Workflow Integration: Cross-Persona Workflows
  4. Quality Assurance: Use the quality standards and success metrics for each persona

More Documentation, Explanations, and IDE Specifics available here!

End Matter

Thank you and enjoy - BMad!

License | Contributing Guidelines | Support

Interested in improving the BMAD Method? See the contributing guidelines.