BMAD Workflow Automation

BMAD Workflow Automation

A Bun TypeScript application that automates BMAD project workflows using Claude Code. This tool provides a complete story development pipeline from draft creation through commit and deployment, with crash recovery and Discord notifications.

Features

- Automated Story Pipeline: Complete workflow from draft to deployment
- Crash Recovery: Robust state persistence and recovery mechanisms
- Discord Integration: Real-time notifications for story completion
- Git Integration: Automated commit tracking and change detection
- Claude Code Integration: Seamless AI-assisted development workflow

Prerequisites

- Bun runtime
- Claude Code CLI with proper alias configuration
- Git repository for the target project
- Discord webhook URL (optional, for notifications)

Installation

1. Clone or download this repository
2. Install dependencies:

3. Create a .env file with your Discord webhook URL:

4. Ensure Claude Code is properly aliased in your zsh configuration:

Usage

Basic Usage

Run in the current directory:

Specify Project Directory

Run with a specific BMAD project directory:

Interactive Mode

If no directory is provided, the application will prompt you:

Workflow Process

The application follows a structured development pipeline:

1. Draft Phase:
   - Checks for existing drafts in docs/stories/
   - Creates new drafts via /BMad:agents:sm *draft if needed

2. Approval Phase:
   - Updates story status from "Draft" to "Approved" using markdown AST manipulation

3. Development Phase:
   - Executes /BMad:agents:dev *develop-story {story_name} to develop the complete story
   - Utilizes available MCP servers including context7 for up-to-date library documentation

4. Quality Assurance:
   - Runs /BMad:agents:qa *review for comprehensive quality…