Systematic debugging

Reproduce, narrow, hypothesise, test one variable at a time — instead of changing four things and rerunning.

Installation

$ npx skills add obra/superpowers

The CLI's unit is the repository, so this installs everything in obra/superpowers, not systematic-debugging alone. It writes into whichever agent directories it finds — Claude Code, Codex, Cursor, Copilot, Windsurf, Zed.

Summary

Reproduce, narrow, hypothesise, test one variable at a time — instead of changing four things and rerunning.

  • Reach for it when the bug has survived two speculative fixes and is starting to cost a day.
  • Sits in Operate & maintain — production reality: debugging, performance, instrumentation, and writing down why the system is the way it is.
  • Stack-agnostic — nothing in it assumes a particular language or framework.
  • Published by Jesse Vincent. Well regarded, but not the vendor of the thing it covers.
  • Installing pulls the whole obra/superpowers repository: this catalogue lists 13 other entries from it, and the repo may hold more.

Where it sits in delivery

Operate & maintainProduction reality: debugging, performance, instrumentation, and writing down why the system is the way it is.Everything in Operate →

The skill itself

The full text lives with its publisher and changes when they change it. Read it there rather than here — a mirrored copy of somebody else's procedure goes stale silently, and this page would have no way of telling you.

Related

More in Operate & maintain