Repolode
obra

obra/superpowers

A software development methodology and composable skills library that guides coding agents through brainstorming, planning, TDD, and subagent-driven implementation.

Stars
301,139
Forks
26,883
Open issues
377
Last commit
9 days ago

What is it?

Superpowers is a software development methodology for coding agents, built as a set of composable skills plus instructions that make the agent use them. When it detects that you are starting to build something, it pauses to clarify intent, presents the design in digestible sections, and then produces an implementation plan with exact file paths, code, and verification steps for each small task.

During implementation, the workflow emphasizes red/green test-driven development, YAGNI, and DRY. Work can be executed by dispatching a fresh subagent per task with review after each step, or inline in one session with a final review. Skills such as systematic debugging, code review requests, and branch completion are triggered automatically as the work progresses.

The project installs as a plugin for many coding harnesses, including Claude Code, Codex, Cursor, Gemini CLI, OpenCode, Pi, and others, each with its own install steps. It is MIT licensed.

Key features

  • 01Turns a rough idea into a design through guided questions before any code is written.
  • 02Produces step-by-step implementation plans with exact file paths and verification steps.
  • 03Enforces red/green TDD cycles during implementation.
  • 04Runs subagent-driven development with review between tasks, or inline execution with a final review.
  • 05Includes skills for systematic debugging, code review, git worktrees, and branch completion.
  • 06Installs as a plugin for multiple coding agents.

Use cases

  • Having a coding agent build a feature from a vague idea without skipping design and planning.
  • Running long autonomous implementation sessions that follow a written plan with review checkpoints.
  • Standardizing TDD and code review practices across a team using multiple coding agents.
  • Debugging a session where an agent ignored its plan or misused skills.

Topics

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects