superpowers guru

why

  • a distilled catalog keeps fourteen process skills findable from one page: trigger, procedure, failure prevented, hard rules — no re-reading the source repo.
  • discipline must be discoverable, not remembered: an agent under pressure locates the applicable skill instead of rationalizing a skip.
  • superpowers is a discipline system for agent-assisted development: process skills that gate creative work behind design approval, implementation behind tests and plans, and completion claims behind fresh evidence.
  • distillation lets local corpus owners supersede upstream guidance (worktrees, testing) in one visible place.

the system in one pass

the through-line

every skill attacks the same enemy: rationalized skipping under pressure. forms vary — iron laws, rationalization tables, red-flag lists, approval gates, ledgers — but each makes a discipline visible at the moment it's about to be abandoned.

local resolutions in this corpus

where this distillation meets an owner decision, curly standards hold the local rule:

good and bad

bad

agent guidance: remember the testing discipline and the design approval gate
result under pressure: skips test when features "seem simple," skips approval
when "the change is obviously right," skips review when "code is clean"
each skip feels justified in isolation; together they compound.
outcome: untested feature breaks a related system; unreviewed design
conflicts with the architecture; unreviewable change introduces a bug
recovery: investigation and fixes; re-testing and re-review at double cost

implicit discipline disappears under pressure: no triggers, no observable boundary, no recorded exceptions — every skip looks like judgment while compounding into untested, unreviewed work. recovery costs multiples of the original effort.

good

skill catalog: explicit trigger ("before editing code"), procedure ("read the
heading, stop if do-not-edit"), failure modes named ("rationalization: 'I'll
fix it later'"), verification ("are we still following the gate?")
result under pressure: the written trigger remains visible; exceptions become
explicit decisions, not rationalized skips; the ledger records each one
outcome: discipline survives pressure because it's discoverable, not remembered

explicit skills are discoverable, repeatable, auditable — they survive time pressure; implicit rules are the first casualty.

search pages

go to any page