---
slug: "harrypan-12138-pi-superpower"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/PanCodeInventory/pi-superpower@main/README.md"
repo: "https://github.com/PanCodeInventory/pi-superpower"
source_file: "README.md"
branch: "main"
---
# pi-superpower

Superpower workflow extension for [pi coding agent](https://pi.dev) — a Scout→Think→Plan→Implement→Review→Debug pipeline with 8 specialized subagent tools and 15 methodology skills.

## Features

### 8 Specialized Subagent Tools

| Tool | Agent | Purpose |
|------|-------|---------|
| `super_scout` | scout | Explore codebase structure, find relevant files and dependencies |
| `super_librarian` | librarian | Research external docs, APIs, libraries via Context7 + Web Reader |
| `super_think` | thinker | Brainstorm approaches, evaluate architecture decisions |
| `super_plan` | planner | Create step-by-step implementation plans from scout findings |
| `super_implement` | worker | Execute plans — write code, run tests, self-review |
| `super_review` | reviewer | Code quality + security analysis after implementation |
| `super_debug` | debugger | Systematic debugging — reproduce, trace root cause, fix, verify |
| `super_parallel` | parallel | Dispatch multiple agents concurrently for independent tasks |

### 15 Methodology Skills

Covers the complete development lifecycle: brainstorming, plan-writing, plan-execution, TDD, systematic debugging, code review (request + receive), git worktrees, parallel dispatch, and verification.

### `/super` Toggle

Enable/disable Super mode with `/super`. When on, enforces the full superpowers methodology and activates all subagent tools.

## Install

```bash
pi install npm:@harrypan-12138/pi-superpower
```

## Usage

```
/super                    # Toggle Super mode on/off
```

When Super mode is active, the agent follows a rigorous workflow:

1. **Scout** — Explore codebase before any changes
2. **Think** — Evaluate approaches for design decisions
3. **Plan** — Create concrete implementation plan
4. **Implement** — Dispatch worker to execute the plan
5. **Review** — Validate code quality after every implementation
6. **Debug** — Systematic root-cause tracing for bugs

## Requirements

- pi coding agent (bundles `@earendil-works/pi-ai`, `@earendil-works/pi-coding-agent`, `@earendil-works/pi-tui`)

## License

MIT