Bmad Automated

bmad-automate

A CLI tool for automating BMAD-METHOD development workflows with Claude AI.

Overview

bmad-automate orchestrates Claude to run BMAD-METHOD development workflows including story creation, implementation, code review, and git operations. It's designed to automate repetitive development tasks by delegating them to Claude with predefined prompts.

Features

- Workflow Automation - Run predefined workflows (create-story, dev-story, code-review, git-commit)
- Status-Based Routing - Automatically determines next workflow based on story status
- Full Lifecycle Execution - Run a story from current status to completion with a single command
- Epic Processing - Process all stories in an epic in order
- Queue Processing - Process multiple stories in batch
- Dry Run Mode - Preview workflows without executing them
- Configurable Prompts - Customize workflow prompts via YAML configuration
- Streaming Output - Real-time feedback from Claude's execution
- Styled Terminal Output - Clean, readable output with progress indicators

Installation

Prerequisites

- Go 1.21 or later
- Claude CLI installed and configured
- just (optional, for running tasks)

From Source

Or using just:

Build Only

Usage

Single Workflow Commands

Full Lifecycle

Run a story from its current status to completion:

This executes all remaining workflows based on the story's current status:

- backlog → create-story → dev-story → code-review → git-commit → done
- ready-for-dev → dev-story → code-review → git-commit → done
- in-progress → dev-story → code-review → git-commit → done
- review → code-review → git-commit → done
- done → skipped (story already complete)

Status is automatically updated in sprint-status.yaml after each successful workflow.

Preview what workflows would run without…