What problem does it solve?
Provides a structured, hypothesis-driven workflow to investigate software bugs and runtime errors, helping teams distinguish direct causes from deeper root causes and avoid guesswork when applying fixes.
Core Features & Use Cases
- Guided information collection: Ask for the minimal necessary inputs such as error messages, stack traces, reproduction steps, recent changes, and relevant logs.
- Systematic isolation & verification: Recommend divide-and-conquer tactics (code, time, input spaces), git bisect, and focused tests to narrow failure scope.
- Hypothesis loop & evidence tracking: Emphasize refutation-first tests, 5 Whys tracing with evidence, and clear decision rules for immediate fixes, escalation, or long-term redesign.
- Operational artifacts: Ship a reproducible debug report using the provided template and reference patterns for log analysis and tool strategies.
Quick Start
Invoke the troubleshooting skill with an error message, stack trace, or log path, for example: /troubleshooting TypeError: Cannot read property 'x' of undefined