superpowers-workflow
- Repo stars 774
- Author repo gemini-superpowers-antigravity
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)
- Brainstorm (short): clarify goal, constraints, risks, and acceptance criteria.
- Write a plan: small steps (2–10 minutes each) with files + verification.
- Implement: make the smallest correct change; prefer tests-first when feasible.
- Review pass: correctness, edge cases, security, style, maintainability.
- 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
- Fluxly category
- AI
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Author / version / license
- @anthonylee991 · no license declared
- Fluxly token estimate
- Lean
- Fluxly setup estimate
- Plug-and-play
- External API key
- No requirement detected
- Detected OS requirements
- Unspecified
- Runtime requirements
- Python
- Detected file/system behavior
-
- Read-only
- Write / modify
- Detected network behavior
- Local-only
- Install commands
- None (reference only)
Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.
Heads up: 未限定 allowed-tools,默认拥有全部工具权限。
The current SKILL.md does not define a fixed output example. Brainstorm (short): clarify goal, constraints, risks, and acceptance criteria. Write a plan: small steps (2–10 minutes each) with files + verification. Implement: make the smallest correct change; prefer tests-first when feasible.
Tiny change (1 file, obvious): Do a mini-brainstorm (3 bullets), then mini-plan (3–5 steps), then implement + verify. Non-trivial change:
# 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
… Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.
sections -> When to use this skill → Activation marker (required) → Default workflow (mandatory unless explicitly unnecessary) → Decision tree: how much process is needed? → Output rules (how you communicate) → Stop conditions
terms -> Brainstorm (short) · Write a plan · Implement · Review pass · Finish · Tiny change (1 file, obvious) · Non-trivial change · High-risk change
files/cmd -> .agent/skills/superpowers-workflow/scripts/recordactivation.py
body sha256 -> 09738058cb81
Decide Fit First
Design Intent
How To Use It
Boundaries And Review