Skip to content

Superpowers

A software development methodology built from composable skills for design, planning, testing, review, and delivery.

Analysis revision 44c9b2dGitHub snapshot Aug 12, 2026Metrics are a dated GitHub snapshot and are not used as a quality score.

Installing Superpowers means accepting a development method with hard gates. Design approval, isolation, TDD, separate reviews, and fresh verification are requirements, not optional tips.

Brainstorming and human design approval are hard gates before planning or code. Implementation then moves into an isolated worktree, executes narrow plan tasks with TDD, separates implementer self-review from specification and quality review, and accepts a completion claim only after a freshly run proving command.

The path a change must pass before completion

The sequence matters because each gate creates evidence consumed by the next one. Skipping ahead is treated as a process failure, even when the change looks small.

Brainstorm

Clarify intent and compare approaches.

Approve design

A human accepts the proposed behavior before planning.

Isolate

Use a worktree and establish a clean baseline.

Plan

Write narrow tasks with files and proof commands.

TDD

Implement through red, green, and refactor.

Review twice

Check specification first, then code quality.

Verify fresh

Rerun the proving command immediately before the claim.

EvidenceRepository overviewBrainstorming workflowVerification before completion

Why these gates are load-bearing

Design approval is a hard gate

Even small behavior changes resolve intent, alternatives, and a readable design before scaffolding, planning, or implementation begins.

Implementation and review are distinct roles

Each task is implemented, self-reviewed, checked for specification compliance, checked for code quality, and re-reviewed after fixes.

Verification is temporally fresh

A completion claim is invalid unless its proving command was rerun immediately and the complete output and exit status were read.

Trial the method on one real change

  1. Complete brainstorming and design approval before asking the agent to write an implementation plan.

  2. Reuse an existing isolated workspace when possible, then run setup and baseline tests before changing code.

  3. Follow red, green, refactor and rerun the command that directly proves completion before making the claim.

Adopting it changes how work is approved

Worth the overhead when

Feature development or bug fixes that benefit from a rigorous specification, isolated implementation, TDD, subagent collaboration, and review loop.

Process conflict

Its repository describes the workflows as mandatory rather than optional suggestions. Confirm that this degree of process ownership fits the project’s existing rules.

Sources reviewed

44c9b2d

Navigation

Type to search…

↑↓ navigate↵ selectEsc close