BAD — BMad Autonomous Development

🤖 Autonomous development orchestrator for the BMad Method. Runs fully autonomous parallel multi-agent pipelines through the full story lifecycle (create → dev → review → PR) driven by your sprint backlog and dependency graph.

What It Does

BAD is a BMad Method module that automates your entire sprint execution. A lightweight coordinator orchestrates the pipeline — it never reads files or writes code itself. Every unit of work is delegated to a dedicated subagent with a fresh context window, keeping each agent fully focused on its single task.

Once your epics and stories are planned, BAD takes over:

1. (MODEL_STANDARD subagent) Builds a dependency graph from your sprint backlog — maps story dependencies, syncs GitHub PR status, and identifies what’s ready to work on
2. Picks ready stories from the graph, respecting epic ordering and dependencies
3. Runs up to MAX_PARALLEL_STORIES stories simultaneously — each in its own isolated git worktree — each through a sequential 7-step pipeline:
   • Step 1 (MODEL_STANDARD subagent) — bmad-create-story: generates and validates the story spec
   • Step 2 (MODEL_STANDARD subagent) — bmad-testarch-atdd: generates failing acceptance tests
   • Step 3 (MODEL_STANDARD subagent) — bmad-dev-story: implements the code
   • Step 4 (MODEL_STANDARD subagent) — bmad-testarch-test-review: reviews test quality, applies fixes
   • Step 5 (MODEL_QUALITY subagent) — bmad-code-review: reviews and fixes the implementation
   • Step 6 (MODEL_STANDARD subagent) — commit, push, open PR, monitor CI, fix any failing checks
   • Step 7 (MODEL_STANDARD subagent) — PR code review: reviews diff, applies fixes, pushes clean
4. (MODEL_STANDARD subagent) Optionally auto-merges batch PRs sequentially (lowest story number first), resolving any conflicts
5. Waits, then loops back for the next batch — until the entire sprint is done

Requirements

• BMad Method installed in your project npx bmad-method install --modules bmm,tea
• A sprint plan with epics, stories, and sprint-status.yaml
• Git + GitHub CLI (gh) installed and authenticated:
  1. brew install gh
  2. gh auth login
  3. Add to your .zshrc so BAD’s subagents can connect to GitHub:

     export GITHUB_PERSONAL_ACCESS_TOKEN=$(gh auth token)
     

  4. If running Claude Code with sandbox mode, allow gh to reach GitHub’s API — add to .claude/settings.json:

     {
       "sandbox": {
         ...
         "enableWeakerNetworkIsolation": true
       }
     }
     

Installation

npx skills add https://github.com/stephenleo/bmad-autonomous-development

Then run setup in your project:

/bad setup

Usage

BAD spawns subagents for every step of the pipeline. For the full autonomous experience — no permission prompts — start Claude Code with:

claude --dangerously-skip-permissions

Then run:

/bad

BAD can also be triggered naturally: “run BAD”, “kick off the sprint”, “automate the sprint”, “start autonomous development”, “run the pipeline”, “start the dev pipeline”

Run with optional overrides:

/bad MAX_PARALLEL_STORIES=2 AUTO_PR_MERGE=true MODEL_STANDARD=opus

Configuration

BAD is configured at install time (/bad setup) and stores settings in the bad: section of _bmad/config.yaml. All values can be overridden at runtime with KEY=VALUE args.

Agent Harness Support

BAD is harness-agnostic. Setup detects your installed harnesses (Claude Code, Cursor, GitHub Copilot, etc.) and configures platform-specific settings (models, rate limit thresholds, timer support) accordingly.

Structure

bmad-autonomous-development/
├── .claude-plugin/
│   └── marketplace.json       # Module manifest
├── skills/
│   └── bad/
│       ├── SKILL.md           # Main skill — coordinator logic
│       ├── references/        # Phase-specific reference docs
│       ├── assets/            # Module registration files
│       └── scripts/           # Config merge scripts
└── docs/

License

MIT © 2026 Marie Stephen Leo