What problem does it solves?
Bugs often manifest far from their origin, leading to symptom-fixing that doesn't solve the underlying problem and causes recurring issues and wasted effort.
Core Features & Use Cases
- Backward Call Stack Tracing: Systematically traces bugs backward through the call chain to find the original trigger.
- Diagnostic Instrumentation: Adds
console.error with stack traces and context to pinpoint where invalid data originates.
- Polluter Identification: Utilizes a bisection script (
find-polluter.sh) to identify which specific test or code introduces unwanted state.
- Use Case: You encounter a 'git init failed' error deep within a test suite, but the immediate cause is unclear. Use this Skill to trace backward through the call chain, identify where an empty directory path originated, and fix the bug at its true source.
Quick Start
Use the root-cause-tracing skill to investigate an error where a file is created in the wrong directory, starting by identifying the immediate code causing the file creation.