Systematic Bug Debugger

Structured Root Cause Analysis

Ditch the "shotgun debugging" approach of trial-and-error changes. This skill implements a hypothesis-driven debugging framework designed to isolate and resolve complex software defects, from intermittent "Heisenbugs" to environment-specific failures.

What it does

The Systematic Bug Debugger guides you through a rigorous diagnostic process. Instead of jumping to a fix, it forces the identification of a minimal reproduction case, maps symptoms to specific architectural layers, and ranks potential causes based on evidence. It acts as a senior staff engineer looking over your shoulder to ensure no assumptions go untested.

Supported Workflows

• Reproduction First: Techniques to trigger bugs on demand with the smallest possible input.
• Hypothesis Ranking: Eliminates "noise" by prioritizing the most likely root causes based on stack traces and logs.
• Environment Drift: Diagnoses why code "works on my machine" but fails in production.
• Instrumentation Tactics: Specific advice on where to inject logging or breakpoints to validate a theory.

Why it's better than standard prompting

Most AI agents will try to fix code immediately, often leading to "hallucinated fixes" that treat symptoms rather than causes. This skill enforces a systematic methodology—bisection, instrumentation, and regression test design—ensuring that when a fix is finally applied, you have proof it actually works.