> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/obra/superpowers/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> An agentic skills framework that gives your coding agents superpowers

<img className="block dark:hidden" src="https://media.brand.dev/3b16fb27-22e9-4daa-a368-88b404b0d37e.svg" alt="Superpowers" />

<img className="hidden dark:block" src="https://media.brand.dev/3b16fb27-22e9-4daa-a368-88b404b0d37e.svg" alt="Superpowers" />

# Welcome to Superpowers

Superpowers is a complete software development workflow for your coding agents, built on composable "skills" that enforce best practices automatically.

## What is Superpowers?

Instead of jumping straight into code, Superpowers guides your agent through a systematic workflow:

1. **Design first** — Refine ideas through conversation and get approval before implementation
2. **Plan thoroughly** — Break work into bite-sized tasks with clear verification steps
3. **Test-driven development** — Write failing tests first, then minimal code to pass
4. **Systematic debugging** — Four-phase root cause analysis instead of guess-and-check
5. **Code review** — Two-stage review process (spec compliance, then code quality)
6. **Clean completion** — Verify everything works before declaring success

Because skills trigger automatically based on context, your agent just has Superpowers. No special commands needed.

## Key Features

<CardGroup cols={2}>
  <Card title="Test-Driven Development" icon="flask" href="/skills/test-driven-development">
    Enforce RED-GREEN-REFACTOR cycle with hard gates
  </Card>

  <Card title="Systematic Debugging" icon="bug" href="/skills/systematic-debugging">
    Root-cause tracing and defense-in-depth techniques
  </Card>

  <Card title="Design-First Brainstorming" icon="lightbulb" href="/skills/brainstorming">
    Socratic refinement before writing any code
  </Card>

  <Card title="Subagent-Driven Development" icon="users" href="/skills/subagent-driven-development">
    Parallel task execution with independent agents
  </Card>

  <Card title="Git Worktrees" icon="code-branch" href="/skills/using-git-worktrees">
    Isolated development branches for clean workflows
  </Card>

  <Card title="Code Review" icon="check" href="/skills/requesting-code-review">
    Two-stage review: spec compliance + code quality
  </Card>
</CardGroup>

## Philosophy

<Note>
  **Systematic over ad-hoc** — Process beats guessing every time
</Note>

Superpowers is built on four core principles:

* **Test-Driven Development** — Write tests first, always
* **Systematic over ad-hoc** — Process over guessing
* **Complexity reduction** — Simplicity as primary goal
* **Evidence over claims** — Verify before declaring success

## Supported Platforms

Superpowers works with multiple coding agent platforms:

<CardGroup cols={2}>
  <Card title="Claude Code" icon="claude" href="/installation/claude-code">
    Install via plugin marketplace
  </Card>

  <Card title="Cursor" icon="cursor" href="/installation/cursor">
    Install via plugin marketplace
  </Card>

  <Card title="Codex" icon="code" href="/installation/codex">
    Manual installation
  </Card>

  <Card title="OpenCode" icon="terminal" href="/installation/opencode">
    Manual installation
  </Card>
</CardGroup>

## Get Started

<Card title="Quickstart Guide" icon="rocket" href="/quickstart" horizontal>
  Install Superpowers and run your first workflow in 5 minutes
</Card>

## Open Source

Superpowers is MIT licensed and developed in the open. Contributions are welcome!

<Card title="View on GitHub" icon="github" href="https://github.com/obra/superpowers" horizontal>
  Star the repository and contribute new skills
</Card>