BMAD Planning & Orchestrator

June 20, 2026 · View on GitHub

Run in Smithery BMAD Method License: MIT

This repository is a Claude Code plugin marketplace. It ships one plugin — BMAD Planning & Orchestrator — that harnesses the BMAD Method to plan, document, and orchestrate software work as conflict-free parallel workstreams, then hands implementation off to your dev tools.

It plans and orchestrates. It does not write the code.

Documentation site: https://aj-geddes.github.io/claude-code-bmad-skills


🎯 Attribution & Credit

The BMAD Method™ (Breakthrough Method for Agile AI-Driven Development) is created and maintained by the BMAD Code Organization. This repository is an independent Claude Code harness for the method — not an official BMAD product, and no endorsement is implied. All methodology credit belongs to the BMAD Code Organization.

The methodology, agent roles, workflow patterns, document shapes, and all BMAD concepts are the intellectual property of the BMAD Code Organization. See bmad-planning-orchestrator/ATTRIBUTION.md.


Install

/plugin marketplace add aj-geddes/claude-code-bmad-skills
/plugin install bmad-planning-orchestrator@bmad-method-harness

Then /reload-plugins (or restart Claude Code). That's it — no installer script, no npx, no copying into ~/.claude. Updates flow through the marketplace.

Local development: claude --plugin-dir ./bmad-planning-orchestrator


What you get

The plugin runs the BMAD lifecycle — Analysis → Planning → Solutioning → Implementation-handoff — right-sized by an interactive track (Quick Flow / BMad Method / Enterprise), and stops at a ready-for-dev story file plus a tool-agnostic handoff manifest.

Its signature contribution is making parallel AI development safe:

  • One architecture prevents semantic conflicts (API style, data model, naming, security) across agents.
  • Stories scoped to disjoint files, dependency-ordered into parallel waves, prevent file/merge conflicts.
  • handoff-manifest.json lets any dev runner pick up the work.

Full skill catalog, flow diagram, and the handoff contract are in the plugin README: bmad-planning-orchestrator/README.md.


Why a plugin (and why planning-only)?

This project began as a suite of Claude Code skills installed by a bash/ PowerShell script. Two things changed:

  1. Claude Code added plugins + marketplaces — a first-class way to distribute and version a bundle of skills, agents, and hooks. We adopted it.
  2. The BMAD Method advanced to a skills-centric v6.x and the broader ecosystem grew capable dev tools. So we refocused: BMAD does what it is best at — planning and orchestration — and lets specialized tools do the coding. The developer/dev-story/lint/coverage pieces were removed.

If you used the old skills install, see MIGRATION.md.


Repository layout

claude-code-bmad-skills/
├── .claude-plugin/
│   └── marketplace.json          # the marketplace (one plugin)
├── bmad-planning-orchestrator/   # ← the plugin
│   ├── .claude-plugin/plugin.json
│   ├── skills/                   # 20 planning/orchestration skills
│   ├── agents/                   # planning subagents
│   ├── hooks/                    # next-step nudges
│   ├── scripts/  resources/      # shared utils + guides
│   ├── README.md  ATTRIBUTION.md  LICENSE  CHANGELOG.md
├── docs/                         # GitHub Pages site
├── CLAUDE.md  CONTRIBUTING.md  MIGRATION.md  LICENSE

Contributing

See CONTRIBUTING.md. The one rule that defines this project: every contribution stays on the planning/orchestration side of the line — nothing here writes, runs, tests, or reviews application code.

License

MIT — see LICENSE. The BMAD Method™ name and methodology belong to the BMAD Code Organization; this license covers only the Claude Code plugin implementation.