bug-investigator

What problem does it solve?

This Skill guides a systematic transition from vague symptom to verified fix by instructing on information gathering, reliable reproduction, focused root-cause analysis, and regression-safe remediation.

Core Features & Use Cases

• Symptom Analysis & Scoping: Determine what is failing, where it occurs, and which components or files are implicated.
• Reproduction & Test Automation: Create minimal reproducible cases and automate failing unit or integration tests to validate the issue.
• Root Cause Analysis & Verification: Use a checklist-driven 5-whys approach, trace data and state, review recent changes, apply minimal fixes, and verify by running targeted and full test suites.
• Prevention: Add guardrails such as assertions, type checks, and improved logging, and document the rationale for non-obvious fixes.
• Use Case: Ideal for intermittent crashes, regressions introduced by recent commits, failing CI tests, or unexpected runtime behavior across frontend and backend code.

Quick Start

Investigate the reported bug by reproducing the failure, creating a minimal failing test, running checklist-driven root-cause analysis, and proposing a minimal verified fix.