Skip to content

2026 AI Specification Frameworks Compared: OpenSpec, Spec Kit, Superpowers, BMAD & GSD

The problem

When I started planning my 2026 feature work with AI coding agents, I ran into a wall: five projects all claimed to make AI write better software, and I could not tell them apart. OpenSpec, GitHub Spec Kit, Superpowers, BMAD Method, and GSD Core all live in the same “spec-driven development” space, but they sit at different layers and enforce very different amounts of process.

Here is the direct answer for this AI specification framework comparison: there is no single best framework in 2026. OpenSpec is a lightweight, vendor-neutral spec format. GitHub Spec Kit is an opinionated Spec-Driven Development (SDD) toolkit with a specify CLI. Superpowers is a skills-library plugin, not a spec format. BMAD Method is a full phase-gated agile methodology. GSD Core is a context-engineering framework that enforces a phase loop. You pick by project size, how much enforcement you want, and which coding agent you run.

What is an AI specification framework?

A specification framework is a format plus a workflow that makes humans and AI agree on what to build before the AI writes code. Without it, requirements live only in chat history, and the agent turns unstated assumptions into working code.

These five projects are often lumped together, but they are not the same kind of thing:

  • Specification frameworks (a portable spec format): OpenSpec, GitHub Spec Kit
  • Full project methodologies (idea → code, phase-gated): BMAD Method, GSD Core
  • Skills / workflow layer (not a spec schema): Superpowers

This is the first thing to check before comparing them. Comparing OpenSpec to BMAD is like comparing a file format to a project management office.

Framework vs methodology layers
Portable spec format: OpenSpec, GitHub Spec Kit
Skills library: Superpowers
Full methodology: BMAD Method, GSD Core

The five at a glance

ProjectWhat it really isOne-line summary
OpenSpecPortable spec formatAlign humans + AI on what to build, across 30+ agents
GitHub Spec KitSDD toolkit + formatGitHub’s opinionated harness with a specify CLI
SuperpowersSkills library pluginA disciplined dev workflow layered on your agent
BMAD MethodFull agile methodologyIdea → code with phase gates and persona agents
GSD CoreContext-engineering frameworkEnforced phase loop that fights context degradation

OpenSpec — lightweight spec format

Repo: github.com/Fission-AI/OpenSpec

Positioning. A vendor-neutral spec format that aligns humans and AI on what to build before code is written. It works across 30+ coding agents and IDEs, which is why teams call it the most portable option here.

Workflow. Fluid and action-based: /opsx:explore/opsx:propose/opsx:apply/opsx:archive. openspec init installs the slash commands into your AI tool. In the newer artifact-guided workflow, /opsx:propose drafts a proposal, specs, design, and tasks in one pass.

Spec format. Plain Markdown. specs/[capability]/spec.md holds WHAT/WHY, an optional design.md holds HOW. Proposed changes live in changes/[change]/ with proposal.md, tasks.md, and complete future-state specs. No diff syntax and no special markup to learn.

Enforcement. Light and fluid. You can update any artifact at any time; there are no phase gates. Config profiles (openspec config profile) choose the delivery method (skills, commands, or both) and which workflows to enable.

AI support. Broad: GitHub Copilot, Codex, Claude, Cursor, Atlassian Rovo Dev, MiniMax Code, plus a generic agents target (--tools agents.agents/skills/). npm package: @fission-ai/openspec (v1.8.0 at time of writing).

Strengths. Low ceremony, portable across tools, brownfield-friendly — the changes/ layer sits neatly over an existing repo.

Trade-offs. Little enforcement. If you want the agent forced through gates, this is not it.

Target users. Teams using AI agents across multiple IDEs and CLIs that want a common spec format without buying into a methodology.

GitHub Spec Kit — opinionated SDD harness

Repo: github.com/github/spec-kit

Positioning. GitHub’s intent-driven toolkit for Spec-Driven Development (SDD). It ships a ready-to-use SDD process and is extensible through extensions, presets, and bundles.

Workflow. Structured SDD phases. specify init bootstraps the project and agent integration, then /speckit.constitution (governing principles) → /speckit.specify (what and why) → /speckit.plan (tech stack) → /speckit.tasks (task list) → /speckit.implement (execute tasks in dependency order). You can run it step by step or end to end.

Spec format. Structured spec Markdown plus tasks.md. Skills-based mode writes speckit-<name>/SKILL.md files under .github/skills/; a legacy .agent.md + .prompt.md mode exists but is deprecated.

Enforcement. Moderate. The SDD phases are opinionated, but nothing stops you from running the commands manually in any order.

AI support. --integration copilot|claude|gemini, with Copilot as the default. Extensions cover Jira (/speckit.jira.specstoissues) and Linear (/speckit.linear.sync).

Strengths. Tight GitHub/Copilot ecosystem fit, an active extension and preset system, and community bundles for role-based setups.

Trade-offs. More ceremony than OpenSpec and a heavier setup (uv plus Python 3.11+ required).

Target users. Organizations on GitHub and Copilot that want spec-led AI development with optional Jira/Linear sync.

Superpowers — skills library plugin

Repo: github.com/obra/superpowers

Positioning. Not a spec format. Superpowers is a skills-library plugin — a software development methodology built on composable skills plus initial instructions that make your agent use them. It started on Claude Code and now supports many harnesses.

Workflow. A basic dev sequence via skills: brainstorming → using-git-worktrees → writing-plans → subagent-driven-development / executing-plans → test-driven-development (RED-GREEN-REFACTOR) → requesting-code-review → finishing-a-development-branch. Skills trigger automatically; you do not type slash commands for each step.

Spec/format. Skills are Markdown SKILL.md files with frontmatter. The writing-plans skill produces bite-sized task plans (2–5 minutes each, with exact file paths and verification steps). There is no rigid spec schema.

Enforcement. Moderate. Where a skill activates, TDD is enforced and critical code-review issues block progress. But skills are composable and opt-in.

AI support. Claude Code is primary (install via plugin marketplace). OpenCode, Antigravity, Codex, Cursor, Gemini CLI, Kimi, Copilot CLI, and Pi are also supported.

Strengths. Batteries-included skills library, strong TDD discipline, and a large community.

Trade-offs. Not a portable spec format. Its workflow is tied to the agent harness you install it into.

Target users. Developers on Claude Code (or a supported harness) who want a disciplined workflow without adopting a separate spec schema.

BMAD Method — full agile methodology

Repo: github.com/bmad-code-org/bmad-method (renders as BMAD-METHOD)

Positioning. A full AI-driven agile development methodology from ideation to implementation. It is distributed as an npm package (bmad-method) that installs specialized agents and guided workflows into your dev environment.

Workflow. Four phase-gated phases, with a delivery loop that sizes itself to the work — small changes can go straight to build:

  1. Analysis (optional): bmad-brainstorming, bmad-forge-idea, bmad-deep-recon, bmad-product-brief, bmad-prfaq (working backwards).
  2. Planning: bmad-prd, bmad-ux, bmad-spec — distills intent into a SPEC.md contract.
  3. Solutioning: bmad-architecture (→ ARCHITECTURE-SPINE.md), bmad-create-epics-and-stories, bmad-sprint-planning (a PASS/CONCERNS/FAIL readiness gate).
  4. Implementation: bmad-build, bmad-code-review, bmad-correct-course, bmad-retrospective.

Spec/format. A rich artifact set: SPEC.md, prd.md, ARCHITECTURE-SPINE.md, epic files, stories.yaml, and validation reports.

Enforcement. High. Phase-locked with readiness gates and persona-based agents (for example, a strategic business analyst persona named Mary).

AI support. The npm package installs specialized agents and guided workflows; persona-based multi-agent collaboration.

Strengths. Covers the whole path from a vague idea to shipped code and keeps decisions explicit as durable context.

Trade-offs. The most process to absorb. Overkill for a small solo project.

Target users. Teams that want end-to-end, phase-gated AI-driven development on larger or complex projects.

GSD Core — context engineering with an enforced phase loop

Repo: github.com/open-gsd/gsd-core

Positioning. A meta-prompting, context-engineering, and spec-driven development framework. It sits between you and the agent and solves context degradation (context rot) by running heavy research, planning, and execution in fresh-context subagents while your main session stays lean.

Workflow. Each milestone repeats the same phase loop, one phase at a time:

  1. Discuss — capture implementation decisions in CONTEXT.md before anything is planned.
  2. Plan — a research gate blocks while RESEARCH.md has open questions. The Planner writes PLAN.md files, then a Plan Checker verifies them (max 3 times). Requirement and decision-coverage gates are blocking.
  3. Execute — plans run in parallel waves; each executor starts with a clean 200k-token context and makes atomic commits; a Verifier writes VERIFICATION.md.
  4. Verify/gsd-verify-work produces UAT.md; an optional UI review writes UI-REVIEW.md.
  5. Ship — create the PR, archive the phase, repeat.

Spec/format. Structured artifacts: CONTEXT.md, RESEARCH.md, PLAN.md (plans in XML format, 2–3 tasks each sized to one context window, with acceptance criteria), SUMMARY.md, VERIFICATION.md, STATE.md, UAT.md.

Enforcement. Highest of the five. Blocking research and decision-coverage gates, verification loops, package-legitimacy checks, and cross-AI reviewer lanes.

AI support. Multi-runtime and tier-1: Claude Code, Codex, Antigravity CLI, Kimi CLI, Copilot, Cursor, Windsurf, OpenCode, Kilo.

Strengths. Built for long-running projects where context degradation is the enemy; enforced verification and cross-AI review.

Trade-offs. Heavy process. The XML plan format and the gates take time to learn.

Target users. Long or complex projects, and multi-agent setups that want enforced verification.

Full comparison table

GitHub star counts below are approximate, pulled from each repo’s GitHub page on 2026-08-07. They move quickly, so re-check before you quote them.

FrameworkPrimary positioningWorkflowSpec formatEnforcementAI tool / agent supportTypical use casesGitHub Stars*
OpenSpecLightweight vendor-neutral spec formatFluid: explore → propose → apply → archive (/opsx:*)Markdown specs (spec.md / design.md + changes/)Light, configurable profilesCopilot, Codex, Claude, Cursor, Rovo Dev, MiniMax, generic agentsSpec-first changes across multiple IDEs/CLIs~64k
GitHub Spec KitOpinionated SDD harness with specify CLIspecify init/speckit.specify/speckit.plan/speckit.tasks/speckit.implementStructured spec Markdown + tasks.md; skills-based or legacy promptsModerate, structured SDD phasesCopilot (default), Claude, Gemini; Jira/Linear extensionsOrgs on GitHub/Copilot wanting spec-led AI dev + tracker sync~126k
SuperpowersSkills-library plugin (not a spec format)brainstorm → worktree → writing-plans → subagent/executing-plans → TDD → code-review → finish branchSkills (SKILL.md); task plans via writing-plansModerate; TDD + review gates where activatedClaude Code (primary), OpenCode, Codex, Cursor, Gemini, Copilot, and moreBatteries-included skills + disciplined workflow on your agent~268k
BMAD MethodFull AI-driven agile methodology (idea → code)4 phase-gated phases: Analysis → Planning → Solutioning → Implementation (bmad-*)SPEC.md + PRD + ARCHITECTURE-SPINE.md + epics/storiesHigh; phase-locked readiness gates, persona agentsnpm installs specialized agents/personasLarger/complex projects wanting structured end-to-end AI dev~52k
GSD CoreContext-engineering + spec-driven phase loopdiscuss → plan (blocking research + coverage gates) → execute (waves + verifier) → verify (/gsd-*)CONTEXT.md, RESEARCH.md, PLAN.md (XML plans) + VERIFICATION.md / UAT.md / STATE.mdHighest; blocking gates, verify loops, cross-AI reviewTier-1 multi-runtime: Claude Code, Codex, Antigravity, Kimi, Copilot, Cursor, Windsurf, OpenCode, KiloLong/complex projects fighting context degradation~8k

*Approximate stars as of 2026-08-07. Superpowers leads by far in adoption, but its repo is a skills library, not a spec schema.

Positioning scatter
enforcement
(high) │
│ GSD Core ● BMAD ●
│ Spec Kit ●
│ Superpowers ●
│ OpenSpec ●
(low) │
└─────────────────────────────────
spec format full methodology
(breadth)

Which one should you choose?

Read these as scenario → recommendation, not a ranking. Each option names the why and a caveat.

ScenarioTry firstWhyCaveat
Solo developer, small greenfield projectOpenSpec, or Superpowers on Claude CodeOpenSpec is light and portable; Superpowers adds discipline without a schemaSuperpowers is harness-specific
Startup, GitHub/Copilot-centric, spec-ledGitHub Spec KitFirst-class Copilot support and Jira/Linear syncHeavier setup (uv + Python)
Enterprise or regulated, needs gates and auditGSD Core or BMAD MethodEnforced coverage gates, cross-AI review, phase gatesHighest process cost
Large complex product, idea → codeBMAD MethodFull analysis → solutioning → implementation lifecycleYou must follow the phases
Brownfield (existing codebase)OpenSpec or GSD CoreOpenSpec’s changes/ layer overlays an existing repo; GSD has an onboard modeSpec Kit/Superpowers/BMAD are greener-field oriented, though adaptable
Greenfield from scratchBMAD or GSD CoreFull lifecycle (BMAD) or greenfield research mode (GSD)Both are heavy for small projects
Multi-agent / multi-tool shopGSD Core or OpenSpecGSD is tier-1 multi-runtime; OpenSpec is vendor-neutralGSD adds real ceremony
Just want a disciplined dev workflow, not a spec schemaSuperpowersComposable skills, enforced TDDNot portable across agents by default

Can you combine them?

Only combinations that are documented or widely adopted, with uncertainty called out:

  • OpenSpec + a coding agent’s native skills — documented. OpenSpec explicitly supports skills/commands/both delivery and a vendor-neutral agents directory.
  • Spec Kit + Jira/Linear — documented. The extension system ships /speckit.jira.specstoissues and /speckit.linear.sync.
  • BMAD bmad-spec + its own implementer — documented within BMAD. The SPEC.md contract feeds bmad-build downstream.
  • GSD Core cross-AI reviewer lanes — documented (for example, a Codex reviewer lane via codex exec).
  • Superpowers + OpenSpec skills — plausible: both write to .agents/skills/-style locations, but they are not officially documented together. Verify before relying on it.
  • BMAD planning phases inside GSD Core’s phase loop, or Spec Kit tasks.md driving BMAD epicsnot documented. These may conflict in enforcement semantics, so treat them as untested.

If a combination is not listed above, assume it is not officially supported until you see docs or a widely adopted example.

FAQ

What is an AI specification framework vs a full project methodology? A framework is a spec format and workflow (OpenSpec, Spec Kit). A methodology is an end-to-end process from idea to code with gates (BMAD, and arguably GSD). Superpowers is neither — it is a skills layer.

Is OpenSpec a specification framework or a methodology? A framework. It gives you a Markdown spec format and slash commands, with no enforced phase gates.

Which is best for GitHub Copilot? Spec Kit, since Copilot is its default integration. OpenSpec also supports Copilot.

Which enforces the most discipline / gates? GSD Core, then BMAD. GSD has blocking research and decision-coverage gates; BMAD has phase-locked readiness gates.

Can I use Superpowers with OpenSpec or Spec Kit? Superpowers is harness-specific. Both OpenSpec and Superpowers target .agents/skills/-style locations, so co-existence is plausible, but combining them is not officially documented — verify first.

Do these work on brownfield codebases? OpenSpec and GSD Core are the best documented for existing code. The others are greener-field oriented but can be adapted.

Are GitHub star counts stable? No. They change daily. I date-stamped the numbers above as of 2026-08-07; re-verify before you quote them.

Which supports the most coding agents? GSD Core lists the widest tier-1 set (9+ runtimes), while OpenSpec advertises 30+ tools via slash commands and a vendor-neutral agents target.

Summary

In this post, I compared five AI specification frameworks for 2026 — OpenSpec, GitHub Spec Kit, Superpowers, BMAD Method, and GSD Core — across positioning, workflow, spec format, enforcement, and agent support. The key takeaway: they live at different layers (format, skills, methodology), so pick by project size, the enforcement level you want, and the coding agent you run. Read the linked repos and the decision guide before you adopt one.

Sources

All facts in this post come from those official repos and docs. Star counts and versions were checked on 2026-08-07 and may have changed since.

Final Words + More Resources

My intention with this article was to help others share my knowledge and experience. If you want to contact me, you can contact by email: Email me

Here are also the most important links from this article along with some further resources that will help you in this scope:

Oh, and if you found these resources useful, don’t forget to support me by starring the repo on GitHub!

Comments