What problem does it solve?
Debugging often turns into guessing and repeated trial-and-error; this skill instead guides you through systematic root-cause investigation so the eventual fix addresses the underlying reason the bug happened.
Core Features & Use Cases
- Root-cause-first workflow: Collect symptoms, inspect the relevant code path, check what changed recently, and verify the behavior you’re seeing before proposing any fix.
- Pattern-based narrowing: Matches symptoms to common failure patterns (like race conditions, null propagation, integration failures, config drift, or stale cache) to focus where to look next.
- Freeze-safe scope locking: When available, restricts edits to the narrowest affected module to prevent scope creep during debugging.
- Evidence and verification discipline: Requires confirming the hypothesis before implementing and finishing with a verification/report step.
- Manual-trigger debugging: Intended to be invoked only when the user explicitly asks (e.g., “/investigate”), minimizing accidental interference.
Use Case Example: When you see an unexpected runtime error or behavior change after a deployment, use this skill to trace the error back to the exact failing path, identify what changed, and then implement a fix tied to the root cause rather than the symptom.
Quick Start
Use the /investigate command when you need to debug why something broke so you can trace the issue to its root cause and apply a verified fix.