systematic-debugging

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes

Content Preview
---
name: systematic-debugging
description: Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes
---

# Systematic Debugging

## Overview

Random fixes waste time and create new bugs. Quick patches mask underlying issues.

**Core principle:** ALWAYS find root cause before attempting fixes. Symptom fixes are failure.

**Violating the letter of this process is violating the spirit of debugging.**

## The Iron Law

```
NO FIXES WITHOUT ROOT CAUSE INVESTIGATION
How to Use

Recommended: Install to project (local)

mkdir -p .claude/skills
curl -o .claude/skills/systematic-debugging.md \
  https://raw.githubusercontent.com/obra/superpowers/main/skills/systematic-debugging/SKILL.md

Skill is scoped to this project only. Add .claude/skills/ to your .gitignoreif you don't want to commit it.

Alternative: Clone full repo

git clone https://github.com/obra/superpowers

Then reference at skills/systematic-debugging/SKILL.md

Related Skills