What problem does it solve? Hard bugs and performance regressions resist casual debugging: staring at code rarely finds the cause. This Skill enforces a disciplined six-phase diagnostic loop that builds a tight, deterministic pass/fail signal first, then reproduces, minimizes, hypothesizes, instruments, fixes, and cleans up. ## Core Features & Use Cases - Feedback Loop Construction: Builds a red-capable, deterministic, fast reproduction command using failing tests, curl scripts, CLI fixtures, headless browsers, trace replay, fuzz loops, or bisection harnesses. - Structured Hypothesis Testing: Generates 3-5 ranked, falsifiable hypotheses and instruments one variable at a time with tagged debug logs for easy cleanup. - Regression Lockdown: Writes a regression test at a correct seam before the fix, verifies the original scenario, and removes all debug instrumentation. - Use Case: A user reports that an export endpoint intermittently returns corrupted data. The Skill guides building a replay harness from a captured request, minimizing the failing input, testing ranked hypotheses, and landing a fix with a regression test. ## Quick Start Use the diagnosing-bugs skill to diagnose why the export endpoint intermittently returns corrupted data and build a reproduction loop for it.
