What problem does it solve?
This skill provides a disciplined, evidence-driven framework for debugging complex software issues. It guides you to gather current-state evidence, formulate testable hypotheses, and verify fixes without premature code changes, improving confidence and reproducibility.
Core Features & Use Cases
- Evidence-gathering workflow: document the exact reproduction steps, gather logs and traces, and map the system state before acting.
- Hypothesis-driven reasoning: generate multiple testable explanations and design minimal experiments to prove or disprove them.
- Verification-first mindset: ensure any fix is minimal, reproducible, and thoroughly validated across environments, with clear rollback criteria.
- Read-only investigation discipline: avoid modifying code during debugging to preserve evidence and maintain traceability.
- Suitable for senior debugging on notoriously hard bugs, cross-team incidents, and platform/environment differences.
Quick Start
Document the current state of the issue, gather evidence, and outline hypotheses before making any changes.
