This repository provides a native Claude Code implementation of the BMAD agile development methodology, designed to transform Claude Code into a token-efficient, structured development environment. It targets developers using Claude Code, offering specialized agents, predefined workflows, and intelligent context management to streamline agile processes and significantly reduce token consumption.

How It Works

The project integrates the BMAD (Breakthrough Method for Agile AI-Driven Development) methodology directly into Claude Code's native features, including Skills, Commands, Memory, and Files. It achieves substantial token efficiency (70-85% optimization) by employing a reusable "helper pattern" and adopting a functional design that removes persona overhead. This approach allows for structured, multi-phase agile workflows—from product discovery to implementation—managed by specialized AI agents without requiring any external dependencies.

Quick Start & Requirements

• Primary install / run command:
  • Recommended: Provide the repository URL (https://github.com/aj-geddes/claude-code-bmad-skills) to Claude Code and request installation.
  • Manual (Linux/macOS/WSL): git clone https://github.com/aj-geddes/claude-code-bmad-skills.git && cd claude-code-bmad-skills && chmod +x install-v6.sh && ./install-v6.sh
  • Manual (Windows PowerShell): git clone https://github.com/aj-geddes/claude-code-bmad-skills.git && cd claude-code-bmad-skills && .\install-v6.ps1
• Non-default prerequisites and dependencies: Git, Claude Code, Bash (Linux/macOS/WSL) or PowerShell (Windows). No external software like Node.js or Python is required.
• Estimated setup time or resource footprint: Installation takes less than 5 seconds.
• Links:
  • Documentation Site: https://aj-geddes.github.io/claude-code-bmad-skills
  • Original BMAD Method: https://github.com/bmad-code-org/BMAD-METHOD

Highlighted Details

• Token Optimization: Employs a helper pattern and functional skills to reduce token usage by 70-85%, saving approximately 750-1,000 tokens per conversation.
• Specialized Agents & Commands: Features 9 specialized skills (e.g., Business Analyst, Product Manager, System Architect, Developer) and 15 workflow commands for structured agile phases (Analysis, Planning, Solutioning, Implementation).
• Cross-Platform Support: Fully functional on Windows, Linux, macOS, and WSL without external dependencies.
• Production Ready: All 8 phases of the BMAD methodology are implemented and tested, covering core workflows, extensibility, creative intelligence, and UX design.
• Extensibility: Includes a "Builder Module" enabling the creation of custom agents and workflows tailored to specific needs.

Maintenance & Community

The project acknowledges the BMAD Code Organization as the creators of the methodology. Community support links are provided for the original BMAD Method (Discord: `https://discord.gg/gk8jAdXWmj`). GitHub Issues and Discussions are available for this repository's implementation.

Licensing & Compatibility

The code in this repository is licensed under the MIT License. This license permits commercial use, modification, distribution, and sublicense of the software. However, the BMAD Method™ name, methodology, workflow patterns, and concepts remain the intellectual property of the BMAD Code Organization and are not covered by the MIT license.

Limitations & Caveats

This implementation is strictly dependent on the Claude Code environment and its native features; it will not function independently. While the code is permissively licensed, the underlying BMAD methodology is proprietary to the BMAD Code Organization.