debug-investigate

What problem does it solve?

debug-investigate helps prevent premature changes by guiding you to reproduce, narrow scope, test hypotheses, and identify the true root cause of a bug or inconsistency.

Core Features & Use Cases

• Reproduction-first debugging: verifies whether the symptom is consistently reproducible or intermittent before making any assumptions.
• Hypothesis-driven narrowing: generates 3–5 targeted hypotheses and runs exactly one focused test per hypothesis to quickly confirm or eliminate causes.
• Guardrails for safe fixes: enforces “no fixes without investigation,” stops after 3 failed hypothesis tests, and then recommends or applies only the smallest patch once the cause is confirmed.

Use case: A production issue appears sporadically after a release; use this skill to reproduce the behavior, isolate the affected component or state, test race vs. logic vs. environment hypotheses, and only then implement a minimal corrective patch with verification.

Quick Start

Use the debug-investigate skill to investigate the reported production bug by reproducing it, generating hypotheses, testing them one at a time, stopping after three ruled-out hypotheses, and then applying the smallest fix only after the root cause is confirmed.