How Superpowers Turns AI Agents into Professional Developers with TDD Workflows

Introduction

Superpowers (https://github.com/obra/superpowers) is a software‑development workflow system for AI coding agents such as Claude Code, Codex, OpenCode, Gemini and Cursor. It encodes best‑practice skills and initial instructions so the AI behaves like an experienced engineer, following test‑driven development, systematic debugging, and other engineering conventions.

Core Design Philosophy

Test‑Driven Development (TDD): always write failing tests first.

Systematic over ad‑hoc: replace guesswork with explicit decision‑flow diagrams defined in DOT/GraphViz.

Complexity reduction: prioritize simplicity, enforce YAGNI, and delete unnecessary features.

Evidence instead of assertions: verify task completion by passing tests and running code.

Skill Library

Testing skills

test‑driven‑development – enforces the RED‑GREEN‑REFACTOR cycle with anti‑pattern references.

Debugging skills

systematic-debugging – four‑stage root‑cause analysis integrating root‑cause‑tracing, defense‑in‑depth, and condition‑based‑waiting.

verification‑before‑completion – ensures issues are truly fixed before moving on.

Collaboration skills

brainstorming – Socratic design questioning.

writing‑plans – detailed implementation plans.

executing‑plans – batch execution with checkpoints.

dispatching‑parallel‑agents – parallel sub‑agent workflows.

requesting-code-review / receiving-code-review – code‑review request and response.

using‑git‑worktrees – parallel branch development.

finishing‑a‑development‑branch – merge/PR decision workflow.

subagent‑driven‑development – two‑stage rapid iteration.

Meta‑skills

using‑superpowers – getting started with the skill system.

writing‑skills – how to create new skills with testing methodology.

Installation

Supported agents: Claude Code, Cursor, Codex, OpenCode, Gemini CLI.

Find and install the plugin via /plugin (or the appropriate UI).

Activate with /reload-plugins.

Verify installation using /help or /superpowers:help.

Common commands: /superpowers:brainstorm – start brainstorming. /superpowers:write-plan – generate an implementation plan. /superpowers:execute-plan – execute the plan. /superpowers:test-driven-development – run the TDD workflow. /superpowers:verification-before-completion – verify fixes before finishing. /superpowers:requesting-code-review – request a code review.

Typical Workflow

Feature development chain:

writing-plans → test-driven-development → implementation → verification-before-completion → requesting-code-review

Debugging chain:

systematic-debugging → root‑cause identification → fix → verification

Parallel tasks can be handled with dispatching-parallel-agents, and branch finalisation uses finishing-a-development-branch.

Step‑by‑Step Usage Example

Start brainstorming: /superpowers:brainstorm (e.g., “I want an employee leave‑approval feature”).

Answer clarification questions about purpose, constraints, and success criteria.

Select a design proposal, confirm it, and receive a full design document.

Generate a task list: /superpowers:write-plan.

Implement using TDD: /superpowers:test-driven-development.

Finish with verification: /superpowers:verification-before-completion and optionally request a review with /superpowers:requesting-code-review.

Key Value

Standardises “how to do” steps, automatically fills missing stages (testing, verification, review), and reduces repetitive rework on medium‑to‑large tasks.