# Superpowers Workflow

> Superpowers Workflow

- Skill: `phoroth/superpowers-workflow` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add phoroth/superpowers-workflow`
- Raw SKILL.md: https://api.skillmd.com/api/skills/phoroth/superpowers-workflow/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: phoroth (https://skillmd.com/u/phoroth)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/phoroth/superpowers-workflow

---


# Superpowers Workflow

This skill defines the default operating procedure for software and automation tasks.

## When to use this skill
Use whenever the user asks to:
- build or modify code
- debug an error or failing tests
- refactor or improve quality
- design an automation workflow (e.g., API integrations, ETL, pipelines)
- add tests, reliability, or safety checks

## Activation marker (required)
Immediately after reading this skill (before any other output), run:

python .agent/skills/superpowers-workflow/scripts/record_activation.py --skill superpowers-workflow


## Default workflow (mandatory unless explicitly unnecessary)
1. **Brainstorm (short)**: clarify goal, constraints, risks, and acceptance criteria.
2. **Write a plan**: small steps (2–10 minutes each) with files + verification.
3. **Implement**: make the smallest correct change; prefer tests-first when feasible.
4. **Review pass**: correctness, edge cases, security, style, maintainability.
5. **Finish**: run verification commands, summarize changes + next steps.

## Decision tree: how much process is needed?
- **Tiny change (1 file, obvious)**:
  - Do a mini-brainstorm (3 bullets), then mini-plan (3–5 steps), then implement + verify.
- **Non-trivial change**:
  - Full brainstorm + plan before editing.
- **High-risk change** (auth, money, prod data, security, migrations):
  - Add explicit risk controls: rollback plan, dry-run, extra tests, logging, safe defaults.

## Output rules (how you communicate)
- Always state **assumptions** if anything is ambiguous.
- Always include **verification** (commands, tests, or observable checks).
- If you must ask questions, ask **at most 3**; then proceed with best assumptions.

## Stop conditions
Pause implementation and switch to planning if:
- requirements conflict
- critical unknowns block correctness
- the change could cause data loss or security issues without safeguards