{"id":47852112,"url":"https://github.com/ikunin/bmad-autopilot-addon","last_synced_at":"2026-04-13T11:01:21.124Z","repository":{"id":349000401,"uuid":"1194137508","full_name":"ikunin/bmad-autopilot-addon","owner":"ikunin","description":"BMAD addon adding autopilot, multi agent parallel execution and git worktree \u0026 PR support ","archived":false,"fork":false,"pushed_at":"2026-04-03T22:06:26.000Z","size":12485,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-03T22:34:02.149Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ikunin.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-03-28T00:55:41.000Z","updated_at":"2026-04-03T22:06:04.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ikunin/bmad-autopilot-addon","commit_stats":null,"previous_names":["ikunin/bmad-autopilot-addon"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/ikunin/bmad-autopilot-addon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ikunin%2Fbmad-autopilot-addon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ikunin%2Fbmad-autopilot-addon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ikunin%2Fbmad-autopilot-addon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ikunin%2Fbmad-autopilot-addon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ikunin","download_url":"https://codeload.github.com/ikunin/bmad-autopilot-addon/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ikunin%2Fbmad-autopilot-addon/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31749763,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-13T09:16:15.125Z","status":"ssl_error","status_checked_at":"2026-04-13T09:16:05.023Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-03T22:04:40.008Z","updated_at":"2026-04-13T11:01:21.118Z","avatar_url":"https://github.com/ikunin.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BMAD Autopilot Add-On v1.0.15\n\n[![npm version](https://img.shields.io/npm/v/bmad-autopilot-addon.svg?style=flat)](https://www.npmjs.com/package/bmad-autopilot-addon)\n[![npm downloads](https://img.shields.io/npm/dm/bmad-autopilot-addon.svg?style=flat)](https://www.npmjs.com/package/bmad-autopilot-addon)\n[![License MIT](https://img.shields.io/badge/license-MIT-blue.svg?style=flat)](LICENSE)\n[![BMAD Method](https://img.shields.io/badge/BMAD-v6.2%2B-green.svg?style=flat)](https://github.com/bmad-code-org/BMAD-METHOD)\n[![Node.js](https://img.shields.io/badge/node-%3E%3D14-brightgreen.svg?style=flat)](https://nodejs.org)\n[![Tools](https://img.shields.io/badge/tools-9%20supported-orange.svg?style=flat)](#supported-tools)\n[![GitHub stars](https://img.shields.io/github/stars/ikunin/bmad-autopilot-addon.svg?style=flat)](https://github.com/ikunin/bmad-autopilot-addon/stargazers)\n\nAutonomous end-to-end software delivery powered by the [BMAD Method](https://github.com/bmad-code-org/BMAD-METHOD). One command takes your project from sprint plan to reviewed, tested, PR-ready code — with full git workflow and multi-agent intelligence.\n\n## Included Skills\n\n| Skill | Description |\n|-------|-------------|\n| `/bmad-autopilot-on` | Engage autonomous sprint execution |\n| `/bmad-autopilot-off` | Disengage and show status |\n| `/bmad-ma-code-review` | Parallel 3-layer adversarial code review |\n| `/bmad-ma-codebase-map` | 5-stream brownfield codebase analysis |\n| `/bmad-ma-assess` | Tech debt and dependency audit |\n| `/bmad-ma-reverse-architect` | Extract architecture from existing code |\n| `/bmad-ma-migrate` | Legacy migration planning |\n| `/bmad-ma-research` | Parallel web research fan-out |\n| `/bmad-ma-party-mode` | Multi-persona agent discussions |\n\n## The Problem\n\nBMAD provides a structured development workflow with 50+ skills and agent personas. But using it manually means invoking each skill one at a time, navigating menus, making routine decisions, and handling git operations yourself. For a sprint with 10 stories across 3 epics, that's dozens of manual steps, context switches, and session restarts.\n\n## The Solution: BMAD Autopilot\n\n```\n/bmad-autopilot-on\n```\n\nThat's it. The autopilot takes over and drives your entire sprint to completion:\n\n### What it does, story by story\n\n1. **Reads your sprint plan** — picks the next story from `sprint-status.yaml`\n2. **Creates an isolated worktree** — each story gets its own branch via `git worktree add`, keeping `main` clean\n3. **Implements the story** — invokes `bmad-dev-story` which writes code and tests following TDD (RED then GREEN)\n4. **Lints the code** — auto-detects your language (Python, JS/TS, Rust, Go, Ruby) and runs the appropriate linter on changed files only\n5. **Stages explicitly** — never runs `git add -A`. Stages only changed files with pre-commit checks: secrets scanning, file size limits, binary detection\n6. **Commits with conventional messages** — `feat(epic): story title (story-key)` with all placeholders resolved from your sprint artifacts\n7. **Runs code review** — invokes `bmad-code-review` on the worktree diff\n8. **Applies every patch** — auto-accepts all review findings, commits each fix separately for clean git history\n9. **Pushes and creates a PR** (configurable) — auto-detects your platform (GitHub/GitLab) and creates a PR/MR with a detailed body. With `create_pr: false`, merges directly to main instead.\n10. **Moves to the next story** — syncs status, exits the worktree, commits artifacts to main, picks up the next story\n11. **Runs retrospective** — when all stories in an epic are done, runs `bmad-retrospective` and lists all PR URLs for merge\n\n### What makes it autonomous\n\nThe autopilot handles everything that normally requires you to be present:\n\n- **Menu navigation** — BMAD skills present menus, confirmations, and choices. The autopilot auto-selects \"Continue\", \"Create Mode\", and makes context-appropriate decisions from your PRD and architecture docs.\n- **Decision making** — when a skill asks a design question, the autopilot derives the answer from existing project artifacts (PRD, architecture, story specs). Only truly unanswerable questions pause execution.\n- **Session management** — after 3 stories, the autopilot checkpoints state to disk and tells you to start a fresh session. `/bmad-autopilot-on` in the new session resumes exactly where it left off. No work is ever repeated.\n- **Crash recovery** — if a session crashes mid-story, the next boot detects orphaned worktrees, recovers committed work (pushes it), and cleans up stale state.\n\n### When it stops (and only when)\n\nThe autopilot runs until the sprint is done or hits one of exactly 5 true blockers:\n\n1. A skill needs **original creative input** not in any project document (e.g., product vision for a PRD)\n2. A **new external dependency** is needed that isn't in the project\n3. **3 consecutive test failures** with no forward progress\n4. A **security vulnerability** requiring architectural decisions beyond the story scope\n5. **Conflicting acceptance criteria** that can't be resolved from project docs\n\nEverything else — it decides, documents the decision in one sentence, and moves on.\n\n### The git workflow in detail\n\nControlled by `git.push.create_pr` in `_bmad-addons/modules/git/config.yaml`:\n\n**PR flow** (`create_pr: true`, default) — stories are pushed and PRs are created. No auto-merge. Code reaches `main` only after PR approval.\n\n```\nmain ─────────────────────────────────────────────────────────\n  │                                          (artifacts only)\n  ├── story/1-1 ──→ push + PR #42 (→ main)\n  │        │\n  │        └── story/1-2 ──→ push + PR #43 (→ story/1-1)\n  │                 │\n  │                 └── story/1-3 ──→ push + PR #44 (→ story/1-2)\n  │\n  Epic 1 complete → retrospective\n  → \"Ready to merge: PR #42, #43, #44\"\n```\n\nWhen previous stories have pending PRs, the autopilot creates **stacked PRs** — each story branches from the previous story's branch and targets it. When a PR is merged on the platform, subsequent PRs automatically retarget.\n\n**Direct merge flow** (`create_pr: false`) — stories are merged to `main` immediately after push:\n\n```\nmain ── story/1-1 ──→ merge ── story/1-2 ──→ merge ── story/1-3 ──→ merge\n```\n\nEach story is fully isolated in its own worktree. No half-finished code on `main`. The autopilot tracks git metadata in its own `git-status.yaml` (commit SHA, push status, PR URL, lint results) — it never modifies BMAD's `sprint-status.yaml`. Implementation artifacts (sprint status, story files, planning docs) are always committed to `main` after each story, regardless of merge strategy.\n\nSee [`modules/git/branching-and-pr-strategy.md`](_bmad-addons/modules/git/branching-and-pr-strategy.md) for the full branching and PR decision matrix.\n\n---\n\n## Multi-Agent Intelligence\n\nBeyond the autopilot, the add-on includes 7 multi-agent skills that launch parallel subagents for tasks that benefit from diverse perspectives:\n\n### Parallel Code Review (`/bmad-ma-code-review`)\n\nThree independent reviewers run simultaneously on the same diff:\n\n| Agent | Perspective | Access |\n|-------|------------|--------|\n| **Blind Hunter** | Pure adversarial — finds bugs from code alone | Diff only, no project context |\n| **Edge Case Hunter** | Boundary conditions, race conditions, missing validation | Full codebase access |\n| **Acceptance Auditor** | Verifies every acceptance criterion is met | Diff + story spec |\n\nResults are triaged: duplicates merged, contradictions flagged, findings classified as PATCH / WARN / DISMISS.\n\n### Brownfield Analysis Pipeline\n\n\u003e Codebase mapping inspired by [GSD's map-codebase](https://github.com/gsd-build/get-shit-done). Adapted with distinct output format, enriched agent prompts, and BMAD-specific downstream integration.\n\nFor existing codebases, three skills chain together:\n\n**`/bmad-ma-codebase-map`** — 5 parallel agents scan the codebase simultaneously:\n- Stack Analyzer (languages, frameworks, versions)\n- Architecture Mapper (modules, patterns, data flow)\n- Quality Assessor (tests, CI/CD, conventions)\n- Concerns Hunter (TODOs, deprecated APIs, security issues, dead code)\n- Integration Mapper (external APIs, databases, env vars)\n\n**`/bmad-ma-assess`** — 3 parallel agents produce actionable findings:\n- Dependency Auditor (CVEs, outdated packages, upgrade paths)\n- Debt Classifier (prioritized tech debt with effort estimates)\n- Migration Analyzer (framework upgrade paths and phased roadmap)\n\n**`/bmad-ma-reverse-architect`** — 3 parallel agents extract architecture from code:\n- Component Mapper (module boundaries, dependency graph)\n- Data Flow Tracer (request lifecycle, state management)\n- Pattern Extractor (design patterns, conventions, error handling)\n\nOutput: a BMAD-compatible `architecture.md` that feeds directly into `bmad-create-epics-and-stories`.\n\n### Migration Planning (`/bmad-ma-migrate`)\n\nA 12-step workflow for taking a codebase from one stack to another. 4 subagent fan-outs across the process:\n\n1. Validate prerequisites and get target stack from user\n2. Auto-recommend migration strategy (strangler fig / big bang / branch-by-abstraction / parallel run)\n3. **Parallel**: Stack Mapper + Dependency Analyzer produce compatibility matrix\n4. Design coexistence layer (old + new code running together)\n5. Build phased roadmap ordered by dependency graph\n6. Generate per-component migration cards with effort/risk\n7. Plan data migration (schema changes, dual-write, backfill)\n8. Design API compatibility (versioning, deprecation timeline)\n9. **Parallel**: Test Parity Analyzer maps old tests to new equivalents\n10. **Parallel**: Risk Assessor produces per-phase risk matrix with rollback triggers\n11. Generate BMAD-compatible epics for sprint planning\n12. Finalize migration plan, epics, and tracking artifacts\n\n### Research and Discussion\n\n**`/bmad-ma-research`** — Fan out research across multiple topics in parallel, each with web search access. Results synthesized into a unified report.\n\n**`/bmad-ma-party-mode`** — Launch 2-3 BMAD personas (architect, PM, QA, dev, etc.) as parallel agents debating a topic. Multiple rounds where personas respond to each other. Produces consensus points, disagreements, and action items.\n\n---\n\n## Quick Start\n\n```bash\n# 1. Install BMAD with the core method and Test Architect module\n#    (interactive — you'll be prompted to pick your tool)\nnpx bmad-method install --modules bmm,tea\n```\n\nThis installs:\n- **BMM** (BMad Method) — the core development workflow with 34+ skills\n- **TEA** (Test Architect Enterprise) — risk-based test strategy, ATDD, CI quality gates, test framework scaffolding\n\nFor full interactive setup (module *and* tool selection):\n```bash\nnpx bmad-method install\n```\n\n```bash\n# 2. Install the autopilot add-on (interactive — select your tool when prompted)\nnpx bmad-autopilot-addon\n\n# 3. Start the autopilot in your IDE\n/bmad-autopilot-on\n```\n\nSee [Supported Tools](#supported-tools) below for the full list of `--tools` values if you prefer non-interactive installs.\n\n## Supported Tools\n\nThe add-on uses the universal SKILL.md format — same skills work across all 9 tools:\n\n| Tool | Directory |\n|------|-----------|\n| Claude Code | `.claude/skills/` |\n| Cursor | `.cursor/skills/` |\n| Windsurf | `.windsurf/skills/` |\n| Gemini CLI | `.gemini/skills/` |\n| Cline | `.cline/skills/` |\n| Roo Code | `.roo/skills/` |\n| Trae | `.trae/skills/` |\n| Kiro | `.kiro/skills/` |\n| GitHub Copilot | `.github/copilot/skills/` |\n\nFor non-interactive installs, pass one or more tool keys via `--tools`:\n```bash\nnpx bmad-autopilot-addon install --tools \u003ctool1\u003e,\u003ctool2\u003e --yes\n```\nValid values: `claude-code`, `cursor`, `windsurf`, `gemini-cli`, `cline`, `roo`, `trae`, `kiro`, `github-copilot`, or `all`.\n\n## Git Platforms\n\n| Platform | CLI | Auto-Detect | API Fallback |\n|----------|-----|-------------|-------------|\n| GitHub | `gh` | `github.com` | No |\n| GitLab | `glab` | `gitlab.*` | No |\n| Bitbucket | `bb` | `bitbucket.org` | Yes (`BITBUCKET_TOKEN`) |\n| Gitea | `tea` | Explicit config | Yes (`GITEA_TOKEN` + `base_url`) |\n\nNo CLI installed? The addon falls back to **git_only mode** (direct merge, no PRs).\n\nTo explicitly choose between PR and direct merge regardless of platform:\n```yaml\n# _bmad-addons/modules/git/config.yaml\ngit:\n  push:\n    create_pr: true   # PR flow (default) — push + PR, no auto-merge\n    create_pr: false  # Direct merge — merge to main after each story\n```\n\n## Supported Languages (Linting)\n\n| Language | Linters | Language | Linters |\n|----------|---------|----------|---------|\n| Python | ruff, flake8, pylint | Java | checkstyle, pmd |\n| JavaScript/TS | eslint, biome | C/C++ | cppcheck, clang-tidy |\n| Rust | cargo clippy | C# | dotnet format |\n| Go | golangci-lint | Swift | swiftlint |\n| Ruby | rubocop | PL/SQL | sqlfluff |\n| Kotlin | ktlint, detekt | PHP | phpstan, phpcs |\n\nFirst found wins per language. Multi-language projects (monorepos) lint all languages in one pass. See [Extending](docs/EXTENDING.md) to add more.\n\n## Configuration\n\nAll settings live in two YAML files — edit after install to customize behavior.\n\n### Git Workflow (`_bmad-addons/modules/git/config.yaml`)\n\n| Setting | Default | Description |\n|---------|---------|-------------|\n| `git.enabled` | `true` | Enable/disable all git operations |\n| `git.base_branch` | `main` | Branch PRs target |\n| `git.branch_prefix` | `story/` | Story branch naming (e.g., `story/1-2-user-auth`) |\n| `git.lint.enabled` | `true` | Lint changed files after implementation |\n| `git.lint.blocking` | `false` | `true` = lint errors halt autopilot |\n| `git.push.auto` | `true` | Auto-push branches after commit |\n| `git.push.create_pr` | `true` | Create PR (`false` = direct merge to base branch) |\n| `git.platform.provider` | `auto` | `auto` \\| `github` \\| `gitlab` \\| `bitbucket` \\| `gitea` \\| `git_only` |\n| `git.lock.stale_timeout_minutes` | `30` | Auto-remove orphaned lock files |\n| `git.worktree.cleanup_on_merge` | `true` | Delete worktrees after merge |\n\n### Multi-Agent (`_bmad-addons/modules/ma/config.yaml`)\n\n| Setting | Default | Description |\n|---------|---------|-------------|\n| `multi_agent.enabled` | `true` | Enable parallel agent skills |\n| `multi_agent.max_parallel_research` | `3` | Concurrent research agents per batch |\n| `multi_agent.max_parallel_analysis` | `5` | Concurrent codebase analysis agents |\n\nSee the [Configuration Reference](docs/CONFIGURATION.md) for the full list.\n\n## Requirements\n\n- [BMAD Method](https://github.com/bmad-code-org/BMAD-METHOD) v6.2.0+\n- A supported AI code agent (see table above)\n- Git repository with at least one commit\n- Platform CLI for PR creation (optional — see table above)\n\n## Documentation\n\n- [Installation Guide](docs/INSTALLATION.md)\n- [Usage Guide](docs/USAGE.md)\n- [Architecture](docs/ARCHITECTURE.md)\n- [Configuration Reference](docs/CONFIGURATION.md)\n- [Extending (Platforms \u0026 Languages)](docs/EXTENDING.md)\n- [Contributing](docs/CONTRIBUTING.md)\n- [Changelog](CHANGELOG.md)\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fikunin%2Fbmad-autopilot-addon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fikunin%2Fbmad-autopilot-addon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fikunin%2Fbmad-autopilot-addon/lists"}