How do I install claude-code-bmad-skills?

Run these in Claude Code: /plugin marketplace add aj-geddes/claude-code-bmad-skills then /plugin install bmad-planning-orchestrator@bmad-method-harness. Then prompt normally.

Does claude-code-bmad-skills auto-invoke its skills?

Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.

Is claude-code-bmad-skills free?

Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.

Development

Plugin

claude-code-bmad-skills

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

FLOW.md

aj-geddes@aj-geddes

GitHub

Plugin Signal69/100Solid

maintained74

capable66

documented75

adopted57

Install on Claude Code

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

Stats

Bash PowerShell GitHub Anthropic

473

Stars

Forks

Maintained

Maintenance

Shell

Language

1mo ago

Last commit

9mo ago

Created

Repo: aj-geddes/claude-code-bmad-skills

What's inside

Skills

/bmad-architectureSolutioning skill (Winston, the Architect). Produces architecture.md with ADRs and systematic NFR coverage, mapping every FR/NFR from the PRD to a concrete design decision. ONE architecture forces all future parallel dev agents to share the same API style, data model, state /bmad-brainstormFacilitates structured ideation sessions using proven brainstorming techniques (SCAMPER, SWOT, 5 Whys, Mind Mapping, Six Thinking Hats, Reverse Brainstorming, Starbursting, Brainwriting). Produces a brainstorming-report.md of organized ideas and actionable insights. Operates in /bmad-builderMeta-skill for scaffolding and validating custom PLANNING/ORCHESTRATION skills within the BMAD Planning & Orchestrator plugin. Produces the full skill directory: SKILL.md, scripts, and templates — all pre-targeted at this plugin's path conventions. Includes a scope-violation /bmad-correct-courseCROSS-PHASE mid-stream scope correction. Re-enters planning when requirements, features, architecture, or constraints change after planning has started. Re-shards affected epics/stories, re-sequences sprint-status.yaml, appends rationale to decision-log.md. Routes to /bmad-document-projectBROWNFIELD planning input. Scans an existing codebase READ-ONLY and writes project-documentation.md — ground truth for stack, structure, key flows, conventions, and integration points — so downstream BMAD planning skills start from reality. Does NOT modify code; produces only /bmad-epics-and-storiesSolutioning flagship — shards a PRD + architecture into epics.md and individual {epic}.{story}.{slug}.story.md context objects, the LAST planning artifact before external dev handoff. Each story is a self-contained ~8K-token compiled context object: Dev Notes with SOURCE

Show all 20 skills

/bmad-handoffEmits a dev-tool-agnostic handoff manifest from ready-for-dev stories so an external dev plugin or runner can pick up and execute the work. Use when the user says "generate a handoff", "create handoff manifest", "export stories for dev", "hand off to dev tool", "produce handoff /bmad-helpOrchestration spine and "what do I do next?" router for the BMAD Planning & Orchestrator plugin. Detects current planning state by scanning the output folder for which artifacts exist (project-context.md, decision-log.md, product-brief, prd/tech-spec, architecture, ux, epics,/bmad-initInitialize a BMAD planning workspace: pick a scale-adaptive TRACK (Quick Flow / BMad Method / Enterprise) interactively, then scaffold the output folder, a config file, an empty decision-log.md, and a project-context.md "constitution". Use when the user says "initialize BMAD",/bmad-investigateForensic bug and issue triage. Produces a graded investigation case file: symptoms, evidence (graded A/B/C by confidence), ranked hypotheses, suspected components, and a recommended planning response. INVESTIGATES and DOCUMENTS only — does NOT fix code, run tests, or implement./bmad-parallel-planTurns a sequential, ready-for-dev story backlog into conflict-free CONCURRENT WAVES. Builds a dependency DAG from epic order, per-story dependency maps, and Owned File/Module Scope overlaps, then topologically sorts it into parallel waves of mutually disjoint,/bmad-prdPRD facilitator (John the PM). Authors and maintains the Product Requirements Document — functional requirements (FR-###), non-functional requirements (NFR-###), an epics outline, user stories, acceptance criteria, and MoSCoW/RICE prioritization. Supports three intents: CREATE a /bmad-prfaqAmazon-style Working-Backwards PRFAQ: a future press release plus internal and external FAQs that stress-test a product concept before any building begins. Produces prfaq.md in the configured output folder. Use when the user says: "write a PRFAQ", "working backwards", "press /bmad-product-briefLean facilitator for creating, updating, and validating a product brief — the Analysis-phase foundation of the BMAD Method. Captures problem statement, target users, core features, goals, constraints, and success metrics. Use when the user says: "create a product brief", "I need /bmad-readiness-checkSOLUTIONING GATE — validates cohesion across planning artifacts before any implementation begins. Cross-references PRD (or tech-spec), architecture document, and epics/stories for coverage consistency and missing pieces. Returns a verdict of PASS, CONCERNS, or FAIL with /bmad-researchConducts market, competitive, domain, and technical research using live web sources, producing a cited research-report.md to inform BMAD planning decisions. Use when the user says: - "research [topic/market/technology]" - "competitive analysis" or "who are the competitors" -/bmad-specDistills ANY messy input — brain dump, transcript, long PRD, stakeholder notes, feature request, voice memo — into a tight five-field SPEC.md kernel that any downstream planning skill can consume. The five fields are: Problem, Capabilities, Constraints, Non-Goals, Success /bmad-sprint-planningOrchestration handoff bridge: emits and maintains sprint-status.yaml as the project's sequencing system-of-record. Orders stories by epic then dependency, assigns parallel-set (wave) membership, and drives the status lifecycle (backlog → ready-for-dev → in-progress → review →/bmad-tech-specQuick Flow lightweight technical specification for small-scope work (1-15 stories). Replaces the full PRD + architecture pair when scope is small and requirements are clear. Produces bmad-output/tech-spec.md as the single planning artifact before story creation. Use when the /bmad-uxSolutioning-phase UX planning skill (optional; activate when the project has a UI). Produces TWO planning documents: DESIGN.md (the visual system — design tokens, color palette, typography, spacing, component specs, WCAG 2.1 AA contract) and EXPERIENCE.md (user journeys, flow

Agents

epic-scoperPLANNING SUBAGENT — scopes ONE epic into an ordered list of stories with disjoint Owned File/Module Scope boundaries, making the epic's stories safe for parallel execution by the story-author subagents that follow. Receives: one epic's requirements slice (from epics.md or the readiness-auditorPLANNING SUBAGENT — independently audits one or more planning artifacts and returns a structured verdict of PASS, CONCERNS, or FAIL with itemized findings. Designed for parallel deployment: spawn one auditor per artifact domain (requirements, architecture, stories) and let the story-authorPLANNING SUBAGENT — compiles ONE story file as a fully source-cited context object in isolation. Receives a single story assignment (epic number, story number, slug, and the shared sharding-context path) and produces one {epic}.{story}.{slug}.story.md that is self-contained (~8K

Badges

README

Read on GitHub

BMAD Planning & Orchestrator — a Claude Code plugin

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.

Repository: https://github.com/bmad-code-org/BMAD-METHOD
Documentation: https://docs.bmad-method.org/
Website: https://bmadcodes.com/bmad-method/
YouTube: @BMadCode · Discord: https://discord.gg/gk8jAdXWmj

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:

Claude Code added plugins + marketplaces — a first-class way to distribute and version a bundle of skills, agents, and hooks. We adopted it.
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.

File tree

119

aj-geddes/claude-code-bmad-skillsView on GitHub

.claude-plugin/
  marketplace.json
.gitignore
bmad-planning-orchestrator/
  .claude-plugin/
    plugin.json
  agents/
    epic-scoper.md
    readiness-auditor.md
    story-author.md
  ATTRIBUTION.md
  CHANGELOG.md
  examples/
    parallelization-plan.example.md
  hooks/
    hooks.json
    scripts/
      session-start.sh
      suggest-next.sh
  LICENSE
  README.md
  resources/
    bmad-method-mapping.md
    conflict-avoidance-guide.md
    helpers.md
    story-sizing-guide.md
    track-selection-guide.md
  scripts/
    check-phase.sh
    load-config.sh
    scope-conflict-check.sh
    select-track.sh
    update-status.sh
  skills/
    bmad-architecture/
      REFERENCE.md
      scripts/
        nfr-checklist.sh
        validate-architecture.sh
      SKILL.md
      templates/
        adr.template.md
        architecture.template.md
    bmad-brainstorm/
      scripts/
        scamper-prompts.sh
        swot-template.sh
      SKILL.md
      templates/
        brainstorm-session.template.md
    bmad-builder/
      scripts/
        scaffold-skill.sh
        validate-skill.sh
      SKILL.md
      templates/
        document.template.md
        skill.template.md
    bmad-correct-course/
      SKILL.md
      templates/
        course-correction.template.md
    bmad-document-project/
      SKILL.md
      templates/
        project-documentation.template.md
    bmad-epics-and-stories/
      REFERENCE.md
      scripts/
        generate-story-id.sh
      SKILL.md
      templates/
        epic.template.md
        story.template.md
    bmad-handoff/
      REFERENCE.md
      SKILL.md
      templates/
        handoff-manifest.schema.json
        handoff-manifest.template.json
    bmad-help/
      REFERENCE.md
      scripts/
        detect-state.sh
        recommend-next.sh
      SKILL.md
    bmad-init/
      REFERENCE.md
      scripts/
        init-project.sh
        select-track.sh
      SKILL.md
      templates/
        config.template.yaml
        decision-log.template.md
        project-context.template.md
    bmad-investigate/
      SKILL.md
      templates/
        investigation.template.md
    bmad-parallel-plan/
      REFERENCE.md
      scripts/
        build-dependency-graph.py
        plan-parallel-waves.py
      SKILL.md
      templates/
        parallelization-plan.template.md
    bmad-prd/
      REFERENCE.md
      scripts/
        prioritize.py
        validate-prd.sh
      SKILL.md
      templates/
        addendum.template.md
        prd.template.md
    bmad-prfaq/
      SKILL.md
      templates/
        prfaq.template.md
    bmad-product-brief/
      scripts/
        discovery-checklist.sh
        validate-brief.sh
      SKILL.md
      templates/
        product-brief.template.md
    bmad-readiness-check/
      scripts/
        readiness-check.sh
      SKILL.md
      templates/
        readiness-report.template.md
    bmad-research/
      scripts/
        research-sources.sh
      SKILL.md
      templates/
        research-report.template.md
    bmad-spec/
      REFERENCE.md
      SKILL.md
      templates/
        spec.template.md
    bmad-sprint-planning/
      scripts/
        init-sprint-status.sh
        sequence-stories.sh
      SKILL.md
      templates/
        sprint-status.template.yaml
    bmad-tech-spec/
      SKILL.md
      templates/
        tech-spec.template.md
    bmad-ux/
      REFERENCE.md
      scripts/
        contrast-check.py
        responsive-breakpoints.sh
        wcag-checklist.sh
      SKILL.md
      templates/
        design.template.md
        experience.template.md
CLAUDE.md
CONTRIBUTING.md
docs/
  _config.yml
  assets/
    main.scss
  commands/
    index.md
  configuration.md
  examples/
    index.md
  getting-started.md
  index.md
  skills/
    index.md
  subagent-patterns.md
  troubleshooting.md
LICENSE
MIGRATION.md
README.md

FAQ

claude-code-bmad-skills is a Claude Code plugin with 20 hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. It includes bmad-architecture, bmad-brainstorm, bmad-builder. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.

What is claude-code-bmad-skills?: 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
How do I install claude-code-bmad-skills?: Run these in Claude Code: /plugin marketplace add aj-geddes/claude-code-bmad-skills then /plugin install bmad-planning-orchestrator@bmad-method-harness. Then prompt normally.
Does claude-code-bmad-skills auto-invoke its skills?: Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
Is claude-code-bmad-skills free?: Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.