What problem does it solve? Hard bugs and flaky failures resist casual code reading; without a reproducible signal, debugging devolves into guessing. This Skill enforces a disciplined diagnosis loop that builds a tight, red-capable feedback command before any hypothesis is tested. ## Core Features & Use Cases - Feedback Loop Construction: Builds a deterministic pass/fail signal via failing tests, curl scripts, CLI fixtures, headless browser runs, trace replays, fuzz loops, or git bisect harnesses. - Structured Six-Phase Process: Guides reproduction and minimization, ranked falsifiable hypotheses, single-variable instrumentation with tagged debug logs, regression-test-first fixes, and verified cleanup. - Human-in-the-Loop Fallback: Ships a bash template (scripts/hitl-loop.template.sh) that drives a human through manual reproduction steps and captures observations for the agent. - Use Case: A user reports that CSV export intermittently throws in production. The Skill builds a replay harness from a captured request, minimizes the failing input, tests ranked hypotheses one variable at a time, and lands a fix with a regression test. ## Quick Start Use the diagnosing-bugs skill to diagnose why the export endpoint intermittently returns a 500 error.