Individual skill

systematic-debugging

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

eval/local/skills/benchmarks/dependency/superpowers/systematic-debugging/SKILL.md

Read pinned source

Source commit 1fb0f070582714f8dd36cd01b7681a8aa0310942

What was checked

Matches the observed repository HEAD: Yes
Scanner rules are current: Yes
Repository scan complete: No
Skill scan complete: No
Observed behavior: Network or broad shell
Last checked: Nov 6, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings): 3,280
Repository last updated: Nov 6, 2026
License: MIT

Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

ai Repository topic
harness-engineering Repository topic
sdd Repository topic
skills Repository topic
spec Repository topic
eval Repository topic
skill-creator Repository topic
phase-guarded Repository topic
loop-engineering Repository topic
testing Derived category

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files

CREATION-LOG.mddoc · 4,257 bytes
SKILL.mdcore · 9,885 bytes
SKILL.mdcore · 9,885 bytes
condition-based-waiting-example.tsruns · 5,054 bytes
condition-based-waiting.mddoc · 3,516 bytes
defense-in-depth.mddoc · 3,650 bytes
find-polluter.shruns · 1,528 bytes
root-cause-tracing.mddoc · 5,316 bytes
test-academic.mddoc · 653 bytes
test-pressure-1.mddoc · 1,900 bytes
test-pressure-2.mddoc · 2,283 bytes
test-pressure-3.mddoc · 2,692 bytes

Read excerpt


# 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 FIRST