BMAD-METHOD/docs/getting-started/index.md

5.0 KiB

Getting Started with BMad Method

Welcome to BMad Method! This section will guide you through everything needed to become productive with AI-assisted development using the BMad methodology.

Your Journey to BMad Mastery

Follow this path to go from installation to your first successful project:

graph LR
    A[Install] --> B[Verify]
    B --> C[First Project]
    C --> D[Enhanced Memory]
    D --> E[Learn Commands]
    E --> F[Master Workflows]
    
    style A fill:#e1f5fe
    style B fill:#f3e5f5
    style C fill:#e8f5e8
    style D fill:#e3f2fd
    style E fill:#fff3e0
    style F fill:#fce4ec

Step 1: Installation

Get BMad Method installed and configured on your development machine.

Time Required: 5-10 minutes

:octicons-arrow-right-24: Start Installation{ .md-button .md-button--primary }

What you'll learn:

  • How to clone and set up the BMad Method repository
  • Required dependencies and configuration
  • IDE setup for optimal BMad experience

Step 2: Verification

Validate that your installation is correct and all components are working.

Time Required: 2-3 minutes

:octicons-arrow-right-24: Verify Setup{ .md-button .md-button--primary }

What you'll learn:

  • How to run the verification script
  • How to interpret validation results
  • How to troubleshoot common setup issues

Step 3: First Project

Build a complete project using BMad Method to experience the full workflow.

Time Required: 30-45 minutes

:octicons-arrow-right-24: Build Your First Project{ .md-button .md-button--primary }

What you'll learn:

  • How to initialize a BMad project
  • Basic persona switching and task execution
  • Quality gates and validation in practice
  • End-to-end development workflow

Step 4: Enhanced Memory (Optional)

Unlock advanced memory capabilities for persistent learning and context management.

Time Required: 10-15 minutes

:octicons-arrow-right-24: Setup OpenMemory MCP{ .md-button }

What you'll gain:

  • Persistent memory across sessions and projects
  • Automatic pattern recognition and learning
  • Enhanced context awareness in multi-session workflows
  • Cross-project insight sharing

!!! tip "Recommended for Teams" OpenMemory MCP dramatically improves BMad Method effectiveness, especially for teams and long-running projects.


Quick Reference

Once you've completed the getting started journey, these references will be invaluable:

  • :fontawesome-solid-terminal:{ .lg .middle } Commands


    Complete reference for all BMad Method commands and their usage.

  • :fontawesome-solid-diagram-project:{ .lg .middle } Workflows


    Proven workflows for different project types and development scenarios.

  • :fontawesome-solid-code:{ .lg .middle } Examples


    Real-world examples and common use cases with detailed walkthroughs.

  • :fontawesome-solid-book:{ .lg .middle } Reference


    Technical reference for personas, tasks, and system components.

Common Questions

??? question "How long does it take to learn BMad Method?"

**Basic productivity**: 1-2 hours (complete this getting started guide)

**Intermediate proficiency**: 1-2 weeks of regular use

**Advanced mastery**: 1-2 months with multiple projects

??? question "What if I run into issues during setup?"

1. Check the troubleshooting section in the first project guide
2. Run the verification script to identify specific issues
3. Review common setup problems in our examples
4. Create an issue on GitHub if you need additional help

??? question "Can I use BMad Method with my existing projects?"

Yes! BMad Method can be integrated into existing projects. See our first project guide for best practices.

??? question "Do I need special IDE extensions?"

BMad Method works with any IDE, but we provide optimized configurations for:

- VS Code (recommended)
- Cursor
- JetBrains IDEs

See the [installation guide](installation.md) for setup instructions.

Prerequisites

Before starting, ensure you have:

  • Git installed and configured
  • Modern IDE (VS Code, Cursor, or JetBrains recommended)
  • Terminal access (bash, zsh, or equivalent)
  • Basic familiarity with command line operations
  • AI coding assistant (Cursor, GitHub Copilot, or similar)

!!! note "No Programming Language Required" BMad Method is language-agnostic. You can use it with Python, JavaScript, TypeScript, Java, or any other programming language. The methodology focuses on process and quality, not specific technologies.


Ready to begin? Start with the Installation Guide and you'll be building better software with AI assistance in under an hour!