Repo brief: obra/superpowers

Generated by RepoPilot · document generated 2026-09-16 · concise human review Evidence snapshot · analyzed 2026-09-16T14:36:29.176Z · commit f2cbfbefebbf

Verdict

Mixed — Mixed signals — read the receipts

• Last commit today
• 10 active contributors
• MIT licensed
• Tests present

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests

What it is

Superpowers is a multi-agent coding framework that installs as a plugin into AI coding assistants (Claude Code, Codex CLI/App, Gemini CLI, Cursor, OpenCode) and injects a structured software development methodology — spec-first design, TDD-enforced implementation planning, and subagent-driven-development — directly into the agent's behavior via AGENTS.md/CLAUDE.md/GEMINI.md instruction files and platform-specific plugin manifests. It solves the problem of LLM coding agents jumping straight to code without planning, by forcing a spec → plan → subagent execution loop with review checkpoints. See architecture tab.

Start here

Open these first:

• CLAUDE.md — Primary agent instruction file that bootstraps the entire Superpowers methodology for Claude Code — defines how the agent…
• skills/using-superpowers/SKILL.md — Meta-skill that teaches the agent how to discover and load all other skills — the entry point for the skills framework…
• .opencode/plugins/superpowers.js — The OpenCode plugin entry point (also the npm package main) — the only runtime JavaScript in the repo, used to inject…
• hooks/hooks.json — Defines lifecycle hooks (e.g. session-start) that wire Superpowers into agent tool calls across supported platforms.
• skills/subagent-driven-development/SKILL.md — Core development methodology skill — describes the parallel subagent TDD workflow that is the heart of the Superpowers…

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/obra/superpowers.git && cd superpowers

No npm install needed — no node_modules dependencies

To install into Claude Code:

/plugin install superpowers@claude-plugins-official

Or to use directly from clone, point your agent harness at the local plugin manifest

Daily commands:

There is no dev server. The 'runtime' is the AI agent itself. To test changes locally, point your agent harness at the local plugin path. For OpenCode specifically, the entry point is .opencode/plugins/superpowers.js. F…

…shortened for this brief.

Key cautions & unknowns

• Concentrated ownership — top contributor handles 63% of recent commits
• No CI workflows detected
• The hooks/run-hook.cmd file indicates Windows support exists but is handled separately — Windows users must use the batch runner, not the shell scripts directly (see docs/windows/polyglot-hooks.md). The package.json…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.