claude-pi-superpowers

Pi + Superpowers: Diverse Agentic Workflows

Overview

Pi provides a heterogeneous agent fleet — Gemini, GPT-4, Claude, and others — running outside your context window. Superpowers workflows have natural read-only roles where Pi adds model diversity and breadth without consuming tokens.

REQUIRED: Load claude-pi:orchestrate for Pi tool signatures, model tiers, and the parallel pattern.

Role Routing

Role	Tool	Tier
Spec compliance reviewer	Pi	balanced
Code quality reviewer	Pi	balanced
Security reviewer	Pi	frontier
Parallel investigation agent	Pi	balanced
Parallel research agent	Pi	fast
Implementer subagent	Agent tool	— needs Bash/Edit/Write
Brainstorming dialogue	neither	— no subagent dispatch

Per-Workflow Patterns

subagent-driven-development

Reviewer roles receive the full diff + spec context in the prompt — no local file access needed.

Per task:
  Implementer            → Agent tool          (needs Edit/Bash)
  Spec reviewer          → pi_spawn_agent       balanced
  Code quality reviewer  → pi_spawn_agent       balanced
  Security-sensitive     → pi_spawn_agent       frontier

Use pi_run_task for sequential reviews. For the final cross-task review, spawn once and pi_get_result.

Use followUp: true on pi_spawn_agent when you want to queue a review without interrupting the implementer.

dispatching-parallel-agents / systematic-debugging

Independent investigations are Pi's strongest use case — each agent gets a self-contained prompt.

1. pi_spawn_agent × N  — focused investigation prompt per agent
2. pi_poll_agent loop  — steer if off-track
3. pi_get_result × N   — collect findings
4. synthesize          — combine in this session

Prefer balanced for code/log analysis; fast for pure text retrieval.

requesting-code-review

The reviewer receives git SHAs and a full diff — entirely read-only and ideal for Pi.

pi_run_task(
  model: 'google/gemini-2.5-pro',  // frontier when review gates a merge to main
  task: <full requesting-code-review prompt with git diff>
)

Use balanced for draft or in-progress reviews; frontier when gating main.

What Pi Cannot Do

Pi agents have no access to your local filesystem. Never delegate roles that require:

• Editing or writing files
• Running tests or shell commands
• Reading project files not provided in the prompt

When a role needs local access, use the Agent tool.