Breakthrough Method for Agile Ai Driven Development
Go to file
Kayvan Sylvan fdfaa1f81f
chore: add VSCode settings and update README.md (markdown-lint) (#209)
* chore: add VSCode settings and update README for clarity**

### CHANGES
- Add recommended extensions for VSCode in `extensions.json`
- Create `settings.json` for custom spell-checker words
- Update README to specify plaintext in code block

* chore: add other technical words to cspell dictionary

---------

Co-authored-by: Brian <bmadcode@gmail.com>
2025-06-13 19:35:17 -05:00
.bmad-core moved bmad-core to dot folder so when adding to project it is clear its not part of the project it is added to 2025-06-13 19:11:17 -05:00
.vscode chore: add VSCode settings and update README.md (markdown-lint) (#209) 2025-06-13 19:35:17 -05:00
docs docs update 2025-06-13 07:27:22 -05:00
expansion-packs moved bmad-core to dot folder so when adding to project it is clear its not part of the project it is added to 2025-06-13 19:11:17 -05:00
tools moved bmad-core to dot folder so when adding to project it is clear its not part of the project it is added to 2025-06-13 19:11:17 -05:00
.gitignore installer functional 2025-06-12 22:38:24 -05:00
CONTRIBUTING.md docs update 2025-06-13 07:27:22 -05:00
LICENSE docs update 2025-06-13 07:27:22 -05:00
README.md chore: add VSCode settings and update README.md (markdown-lint) (#209) 2025-06-13 19:35:17 -05:00
package-lock.json fix: Add glob dependency for installer 2025-06-13 08:52:51 -05:00
package.json moved bmad-core to dot folder so when adding to project it is clear its not part of the project it is added to 2025-06-13 19:11:17 -05:00

README.md

BMAD-METHOD

AI agent orchestration framework for software development. Provides specialized AI agents that function as a complete Agile development team.

Overview

BMAD-METHOD (Breakthrough Method of AgileAI Driven Development) transforms software development workflows by providing 10 specialized AI agents that handle different aspects of the development lifecycle.

Features

Specialized Agents

  • Business Analyst: Requirements gathering and project briefs
  • Product Manager: Product roadmaps and PRDs
  • UX Expert: User experience design and UI specifications
  • Solution Architect: System design and technical architecture
  • Product Owner: Story validation and backlog management
  • Scrum Master: Story generation and sprint planning
  • Developer: Code implementation
  • QA Specialist: Testing and quality assurance
  • BMAD Orchestrator: Role transformation via slash commands and BMAD Method Tutor
  • BMAD Master: Universal executor of all capabilities without role switching

Team Configurations

  • Team All: Complete agile team with all roles
  • Team Fullstack: Full-stack application development focus
  • Team No-UI: Backend/service development without UX roles

Structured Workflows

  • Greenfield: New project workflows (fullstack, service, UI)
  • Brownfield: Existing project workflows (fullstack, service, UI)
  • Decision guidance for complex and simple project paths

Installation

Option 1: Web Bundles (No Installation)

  1. Download pre-built bundles from .bmad-core/web-bundles/
  2. Upload to ChatGPT or Gemini
  3. Set instructions: "Your critical operating instructions are attached, you ARE the BMad Agent..."
  4. Start with /help command if unsure what to do!

Option 2: IDE Integration

  1. Copy .bmad-core/ to project root
  2. Use agents from .bmad-core/agents/
  3. Configure IDE slash commands

Option 3: Build Custom Bundles

git clone [repository]
npm install
npm run build

Find bundles in dist/

Build Commands

npm run build          # Build all bundles
npm run build:agents   # Build agent bundles only
npm run build:teams    # Build team bundles only
npm run list:agents    # List available agents
npm run validate       # Validate configurations

Project Structure

.bmad-core/
├── agents/          # Individual agent definitions
├── agent-teams/     # Team configurations
├── workflows/       # Development workflows
├── templates/       # Document templates
├── tasks/          # Reusable task definitions
├── checklists/     # Quality checklists
├── data/           # Knowledge base
└── web-bundles/    # Pre-built bundles

expansion-packs/     # Modular extensions
tools/              # Build and CLI tools

Technical Details

  • Language: JavaScript
  • Runtime: Node.js 14.0.0+
  • Configuration: YAML-based
  • License: MIT

Contributing

See CONTRIBUTING.md for guidelines.

Author

Brian (BMad) Madison

Version

4.0.0

See versions.md for previous versions and history.