TL;DR
- OpenSpec (Fission AI, MIT, npm CLI
@fission-ai/openspec) is a spec artifact system: living specs, per-change folders, delta specs, and/opsx:*workflows backed by a CLI that skills query for structured state. - Superpowers (Jesse Vincent / Prime Radiant, MIT, plugin) is a methodology enforcement layer: auto-triggering skills that shape how the agent brainstorms, plans, implements (TDD), reviews, and finishes branches — without prescribing a repo spec layout.
- They solve different failure modes. OpenSpec keeps requirements from drifting out of chat into durable, mergeable specs. Superpowers keeps agents from skipping design, tests, reviews, and worktree hygiene.
- Spec generation: OpenSpec produces structured artifacts (
proposal.md, deltaspec.md,design.md,tasks.md) underopenspec/changes/. Superpowers produces conversational design chunks and a micro-task plan via thebrainstormingandwriting-plansskills — not a formal spec tree unless you add one. - Implementation: OpenSpec’s
/opsx:applywalkstasks.mdand updates checkboxes. Superpowers dispatchessubagent-driven-developmentorexecuting-plans, enforces RED/GREEN TDD, and runs two-stage review (spec compliance, then code quality). - They can stack. OpenSpec for what to build and traceability; Superpowers for how the agent executes with discipline. Neither replaces the other by default.
What You Will Learn Here
- What OpenSpec and Superpowers each optimize for — and why they are not direct substitutes
- A feature-by-feature comparison of built-in workflows, artifacts, and agent surfaces
- How spec generation differs: structured delta specs vs conversational design + plans
- How implementation differs: task-driven apply vs TDD + subagent/review pipelines
- Platform caveats (especially Cursor limitations for Superpowers subagents)
- A decision table for when to pick one, the other, or both
- A concrete example routing the same feature through each toolkit
- How to use the Spec workflow picker sidebar to jump between all three-tool comparisons on this site
On July 14, 2026, I reviewed the current OpenSpec docs (opsx.md, workflows.md, commands.md, README), npm metadata for @fission-ai/openspec@1.6.0, the Superpowers README and release v6.1.1 (July 2, 2026), Superpowers skill files (writing-plans, executing-plans, subagent-driven-development), release notes, and Jesse Vincent’s original Superpowers announcement. Comparative conclusions about team fit and combining the tools are editorial inference unless tied to a primary source.
Why These Two Tools Show Up Together
Both projects landed in the same conversation window (late 2025 – mid 2026) as answers to the same headline problem: AI coding assistants move fast, but process collapses when everything lives in chat.
They diverge on the cure:
| Lens | OpenSpec | Superpowers |
|---|---|---|
| Primary metaphor | Living specs + change deltas | Mandatory skills + SDLC discipline |
| What gets saved to git | openspec/specs/, openspec/changes/<name>/ | Default plans under docs/superpowers/plans/; design docs skill-dependent (no delta-spec tree) |
| Process shape | Fluid actions (propose, apply, archive) | Auto-triggered skill chain (brainstorm → plan → implement → review) |
| Runtime | Node.js 20.19+, @fission-ai/openspec CLI | Plugin per harness (Cursor, Claude Code, Codex, …) |
| Agent surface | Skills and /opsx:* commands (30+ tools) | Composable SKILL.md files + session-start bootstrap |
| Brownfield posture | Explicit: specs describe current behavior; changes are deltas | Neutral: works in any git repo; emphasizes worktrees + TDD |
| Customization | schema.yaml, templates, openspec/config.yaml | Edit skills locally; upstream accepts limited skill PRs |
OpenSpec compares itself to Spec Kit and Kiro in its README. Superpowers compares itself to ad-hoc agent coding in its README and launch post. They are adjacent layers, not the same product category — which is why a side-by-side review is useful.
┌─────────────────────────────────────┐
│ Your coding agent │
└─────────────────┬───────────────────┘
│
┌───────────────────────┴───────────────────────┐
│ │
▼ ▼
┌──────────────────────┐ ┌──────────────────────┐
│ Superpowers │ │ OpenSpec │
│ HOW the agent works │ │ WHAT you're building │
│ TDD, reviews, │ │ specs, deltas, │
│ worktrees, subagents│ │ archive, sync │
└──────────────────────┘ └──────────────────────┘
│ │
└───────────────────────┬───────────────────────┘
▼
Application code + tests
Side-by-Side Setup
OpenSpec
npm install -g @fission-ai/openspec@latest
cd your-repo
openspec init
# optional: openspec init --tools cursor,claude
# optional: openspec config profile && openspec update # expanded workflows
After init, OpenSpec creates openspec/specs/, openspec/changes/, optional openspec/config.yaml, and harness-specific skills/commands (for example .cursor/skills/openspec-propose/SKILL.md and .cursor/commands/opsx-propose.md).
Superpowers
In Cursor Agent chat:
/add-plugin superpowers
Or install from the plugin marketplace in Claude Code, Codex, Factory Droid, Copilot CLI, OpenCode, Pi, Kimi Code, and others. No repo init step — the plugin injects the using-superpowers bootstrap at session start.
OpenSpec entry points Superpowers entry points
───────────────────── ────────────────────────
Terminal: openspec init Plugin: /add-plugin superpowers
Terminal: openspec list|validate Automatic: skills trigger on context
AI chat: /opsx:propose Implicit: "help me build X" → brainstorming
AI chat: /opsx:apply Implicit: approved design → writing-plans → implement
Built-In Features: Side-by-Side
Core workflow (source-backed)
| Capability | OpenSpec | Superpowers |
|---|---|---|
| Pre-code exploration | /opsx:explore — thinking partner, optional artifact capture | brainstorming — Socratic questions, design in digestible sections |
| Spec / design generation | /opsx:propose or expanded /opsx:continue — proposal, specs, design, tasks | brainstorming → saved design doc; writing-plans → micro-task plan |
| Living requirements | Delta specs under openspec/changes/<name>/specs/; main specs in openspec/specs/ | No first-class delta-spec model; plan is the contract during implementation |
| Implementation driver | /opsx:apply — walks tasks.md, checks boxes | subagent-driven-development or executing-plans — task dispatch + review |
| Test discipline | Mentioned in apply instructions; not centrally enforced | test-driven-development — mandatory RED/GREEN/REFACTOR; deletes pre-test code |
| Code review | Not a dedicated built-in phase | requesting-code-review + two-stage review in subagent flow |
| Branch isolation | Your git workflow; OpenSpec does not manage worktrees | using-git-worktrees — creates branch/worktree after design approval |
| Verify before done | /opsx:verify (expanded profile) | verification-before-completion, finishing-a-development-branch |
| Archive / merge specs | /opsx:archive, /opsx:sync, /opsx:bulk-archive | finishing-a-development-branch — merge/PR/discard options |
| Debugging workflow | Not specialized | systematic-debugging — 4-phase root cause process |
| Cross-repo planning | Stores (beta) — shared OpenSpec repo | Not built-in |
Agent surface
| Surface | OpenSpec | Superpowers |
|---|---|---|
| Skills | openspec-propose, openspec-explore, openspec-apply-change, openspec-sync-specs, openspec-archive-change, … | 14 documented skills across Testing, Debugging, Collaboration, Meta |
| Slash commands | /opsx:propose, /opsx:apply, /opsx:archive, … (profile-dependent) | No equivalent command suite — behavior is skill-driven |
| CLI integration | Core — openspec status --json, openspec instructions --json | None — skills are self-contained markdown |
| Session bootstrap | Per-command or per-skill invocation | Session-start hook loads using-superpowers automatically |
| Trigger model | User invokes command or skill | Agent must search and apply relevant skills before acting |
OpenSpec skills are not decorative prompts. They query the CLI for structured state before writing one artifact at a time:
User: /opsx:continue
│
├─► openspec status --change add-dark-mode --json
├─► openspec instructions specs --change add-dark-mode --json
├─► read dependency artifacts (proposal.md, …)
└─► write ONE artifact (e.g. delta spec)
Superpowers inverts that model: the agent checks for applicable skills before every task, and skills encode mandatory behavior (TDD, review gates, worktree setup).
Default artifact graph (OpenSpec spec-driven schema)
OpenSpec’s default schema produces four linked artifact types:
proposal ──→ specs ──→ design ──→ tasks ──→ /opsx:apply
Delta specs use ADDED / MODIFIED / REMOVED sections so brownfield changes stay auditable. On archive, deltas merge into openspec/specs/<capability>/spec.md.
Superpowers’ default chain (from the README):
brainstorming ──→ using-git-worktrees ──→ writing-plans
│
└──► subagent-driven-development | executing-plans
│
├── test-driven-development (during each task)
├── requesting-code-review (between tasks)
└── finishing-a-development-branch
The Superpowers plan emphasizes 2–5 minute tasks with exact file paths, verification steps, and enough detail that a “junior engineer with poor taste” could execute it — a different granularity than OpenSpec’s tasks.md, which tracks implementation checklist items tied to specs.
Spec Generation: Where They Actually Differ
This is the heart of the comparison for architects.
OpenSpec: specs as durable repo artifacts
OpenSpec treats specifications as first-class, versioned files:
- Main specs describe current system behavior (
openspec/specs/). - Change folders hold proposal, delta specs, design, and tasks (
openspec/changes/<name>/). - Archive moves completed changes to
openspec/changes/archive/and optionally syncs deltas into main specs. - Project config (
openspec/config.yaml) injects stack context and per-artifact rules (for example Given/When/Then scenarios).
Advantages (source-backed + inference):
| Advantage | Why it matters |
|---|---|
| Brownfield delta model | Requirements changes are explicit ADDED/MODIFIED/REMOVED — not rewrites of mystery docs |
| Team-readable spec history | PMs and other engineers can read specs without replaying chat |
| CLI-validated artifact graph | Dependencies between artifacts are machine-checkable |
| Custom schemas | Teams can define their own artifact types via schema.yaml |
| Stores (beta) | Cross-repo features can share one planning home |
Tradeoffs (inference):
- Requires init, conventions, and occasional
openspec updateafter upgrades. - Spec quality still depends on model + templates — OpenSpec opens templates for editing, but someone has to maintain them.
Superpowers: specs as negotiated conversation → plan
Superpowers generates specs through skills, not a fixed directory schema:
brainstorming— Refines intent via questions; presents design in short sections for human approval.writing-plans— Converts approved design into a granular implementation plan (default save path:docs/superpowers/plans/).
As of Superpowers v6.x, brainstorming and writing-plans use inline self-review checklists during spec/plan creation rather than subagent review loops — faster, but still not a mergeable delta-spec model.
There is no built-in delta-spec merge, capability-oriented spec tree, or /opsx:sync equivalent. The plan becomes the implementation contract for that session/branch.
Advantages (source-backed + inference):
| Advantage | Why it matters |
|---|---|
| Zero repo ceremony | Install plugin; behavior changes immediately |
| Automatic activation | No need to remember slash commands — skills trigger from context |
| Human-readable design chunks | Launch post emphasizes digestible sections, not wall-of-markdown dumps |
| Pressure-tested skills | Author documents scenario-based evals for skill compliance |
Tradeoffs (inference):
- Less durable cross-session requirements unless you manually commit design/plan files.
- Harder for multi-team “source of truth” spec consumption without adding OpenSpec or similar.
- Skill behavior varies by harness (see platform notes below).
Spec generation comparison table
| Dimension | OpenSpec | Superpowers |
|---|---|---|
| Output location | openspec/changes/<name>/ | Default docs/superpowers/plans/YYYY-MM-DD-<topic>.md (overridable) |
| Requirement format | Structured scenarios + delta sections | Conversational design + task plan |
| Merge into canonical spec | /opsx:sync on archive | Not built-in |
| Multi-capability specs | specs/<capability>/spec.md per domain | Not built-in |
| Explore without committing | /opsx:explore | brainstorming (can stay conversational) |
| Customization | Templates, schemas, config rules | Fork/edit skills; limited upstream skill PRs |
Implementation: Where Discipline Comes From
OpenSpec /opsx:apply
From OpenSpec’s commands docs, /opsx:apply:
- Reads
tasks.mdand identifies incomplete items. - Implements tasks one by one — code, files, tests as needed.
- Checks off completed tasks.
- Can update artifacts when implementation reveals spec gaps (fluid workflow).
OpenSpec does not centrally enforce TDD, subagent dispatch, or two-stage review. Those depend on your agent rules, model, and any overlapping plugins.
Superpowers implementation stack
Superpowers treats implementation as a gated pipeline:
| Skill | Role |
|---|---|
using-git-worktrees | Isolated branch + clean test baseline before coding |
writing-plans | Micro-tasks with verification steps |
subagent-driven-development | Fresh subagent per task + two-stage review |
executing-plans | Single-agent execution on harnesses without subagent support (fallback) |
test-driven-development | Fail test first; delete code written before tests |
requesting-code-review | Severity-ranked issues; critical blocks progress |
finishing-a-development-branch | Tests green → merge/PR/discard |
The README claims multi-hour autonomous runs that stay on-plan — that is an author assertion, not a benchmark. Treat it as design intent, not a SLA.
Platform caveat: harness subagent support
Superpowers treats subagent orchestration as a harness capability, not something every plugin install gets equally.
From Superpowers v6.x release notes and the executing-plans skill (July 2026):
- Subagent-capable harnesses (explicitly listed): Claude Code, Codex CLI, Codex App, Copilot CLI.
subagent-driven-developmentis required on those harnesses after plan approval.executing-plansis reserved for harnesses without subagent capability and tells the user that Superpowers works better on subagent-capable platforms.
Cursor is supported as a plugin, but it is not listed among Superpowers’ subagent-capable harnesses as of v6.1.1. On Cursor, expect executing-plans (inline task execution with checkpoints) rather than the full subagent dispatch loop — unless Superpowers later adds Cursor to its subagent-capable list.
OpenSpec’s /opsx:apply is harness-agnostic — it is instructions plus task files, not subagent infrastructure.
| Harness | OpenSpec | Superpowers |
|---|---|---|
| Cursor | Full skills + /opsx:* | Plugin + session hook; executing-plans path (not subagent-capable per Superpowers docs) |
| Claude Code | Full skills + commands | Full skill stack + subagent-driven-development |
| Codex / Pi / others | Supported via openspec init --tools | Separate plugin install per harness; check subagent-capable list |
Extensibility and Customization
OpenSpec
openspec/config.yaml— project context + per-artifact rules.schema.yaml+ templates — custom artifact graphs (community schemas catalog exists).- Workflow profiles —
core(propose/explore/apply/sync/archive) vs expanded (new/continue/ff/verify/bulk-archive/onboard). - Stores (beta) — standalone planning repos shared across code repos.
OpenSpec’s OPSX docs explicitly frame customization as editing templates/schemas without waiting for package releases.
Superpowers
- Skills library — 14 documented skills spanning testing, debugging, collaboration, meta.
writing-skills— meta-skill for authoring and pressure-testing new skills.- Plugin updates — often automatic per harness.
- Contribution policy — README notes they do not generally accept new upstream skills; changes must work across all supported agents.
Superpowers optimizes for behavioral consistency. OpenSpec optimizes for artifact flexibility.
When to Use Which
| Situation | Prefer OpenSpec | Prefer Superpowers | Use both |
|---|---|---|---|
| Brownfield app with evolving requirements | ✓ delta specs + archive | ✓ common stack | |
| Solo hack, no spec history needed | ✓ low ceremony | ||
| Team needs readable spec source of truth | ✓ | ✓ add Superpowers for TDD/reviews | |
| Agent skips tests and reviews | ✓ mandatory TDD + review skills | ✓ | |
| Cross-repo feature planning | ✓ Stores (beta) | ||
| Cursor-only team | ✓ full command surface | partial (no full subagents) | ✓ |
| Regulated / audit trail for requirements | ✓ archived change folders | partial (plans only) | ✓ |
| Debugging production incidents | ✓ systematic-debugging skill |
Editorial judgment: If you must pick one, choose OpenSpec when spec traceability and brownfield deltas are the bottleneck; choose Superpowers when agent discipline (TDD, reviews, worktrees) is the bottleneck.
Same Feature, Two Routes
Feature: Add article audio summary playback to an Astro devlog.
Route A — OpenSpec
/opsx:explore → clarify delivery (inline player vs modal), scope caps
/opsx:propose article-audio-summary-pipeline
→ proposal.md, delta specs (ui, generation, delivery),
design.md, tasks.md
/opsx:apply → implement tasks; check off items
/opsx:archive → sync deltas into openspec/specs/; archive change
Artifacts remain readable for the next engineer — including requirements the agent never re-derives from chat.
Route B — Superpowers
"Help me add audio summaries to articles"
→ brainstorming: questions on UX, storage, generation API
→ design sections approved
→ using-git-worktrees: feat/article-audio branch
→ writing-plans: 2–5 min tasks with file paths + verification
→ executing-plans or subagent-driven-development
→ test-driven-development on each task
→ finishing-a-development-branch: PR or merge
You get strong implementation hygiene. Lasting requirements live wherever the skills wrote them — unless you adopt OpenSpec (or similar) for the spec layer.
Route C — Combined (inference)
OpenSpec: /opsx:propose + delta specs ← WHAT + traceability
Superpowers: TDD + review skills ← HOW with discipline
This is not an official integrated product — it is a practical stack many teams can assemble manually.
Stacking risks (inference): Both tools inject skills and behavioral rules. Without coordination, you may get duplicate planning phases (OpenSpec /opsx:propose plus Superpowers brainstorming) or conflicting git/worktree instructions. A practical pattern: use OpenSpec for artifact creation, then let Superpowers skills govern implementation hygiene only.
Advantages Summary
| OpenSpec | Superpowers | |
|---|---|---|
| Primary win | Durable, mergeable specs tied to changes | Mandatory SDLC skills that resist agent shortcuts |
| Repo footprint | openspec/ tree + generated skills/commands | Plugin-only; optional markdown outputs |
| Best for architects | Capability specs, deltas, archive audit trail | Worktree isolation, review gates, finish workflow |
| Best for implementers | Clear tasks.md checklist from specs | TDD skill, micro-plans, review between tasks |
| Weakest on | Agent behavior enforcement | Canonical long-lived spec management |
| License / cost | MIT, npm CLI | MIT, free plugin |
Sources
Primary sources consulted on July 14, 2026:
- OpenSpec README — philosophy, quick start, comparisons, MIT license
- OpenSpec OPSX workflow — fluid actions, artifacts, config, schemas
- OpenSpec workflows — core vs expanded profiles
- OpenSpec commands —
/opsx:*behavior including apply and archive - npm
@fission-ai/openspec— version 1.6.0 at time of writing - Superpowers README — skills library, workflow, installation, v6.1.1 release
- Superpowers RELEASE-NOTES — v6.x harness subagent behavior, Cursor plugin support
- Superpowers
writing-plansskill — plan format, default save path, execution handoff - Superpowers
executing-plansskill — subagent-capable platform list - Superpowers
subagent-driven-developmentskill — two-stage review model - Superpowers launch post — brainstorm → plan → implement origin, skills rationale (October 9, 2025)
- OpenSpec supported tools — tool IDs and generated skill names
Related reading in this devlog:
- OpenSpec vs GitHub Spec Kit — compares two spec artifact frameworks (use the Spec workflow picker in the article sidebar)
- Advanced OpenSpec: Expanded Workflows —
/opsx:verify, custom schemas, profiles - Replace Plan Mode with OpenSpec — when structured specs beat IDE plan mode