debug-phase

What problem does it solve?

This Skill eliminates inefficient, trial-and-error debugging, which often leads to recurring bugs, wasted development time, and user frustration.

Core Features & Use Cases

• Root Cause Analysis (5 Whys): Guides you through asking "why" five times to uncover the true underlying cause of an error, not just its symptoms.
• Systematic Debugging: Provides a structured workflow for reproducing, classifying, isolating, and fixing bugs with precision.
• Error Documentation & Prevention: Ensures bugs are documented in a standardized error-log.md and prevented from recurring with new tests and defensive code.
• Use Case: When a dashboard timeout error is reported, use this Skill to reproduce it, classify it as an "Integration" error, apply the "5 Whys" to discover a missing pagination parameter, implement a fix with a regression test, and document the entire process for future reference.

Quick Start

Example of 5 Whys Root Cause Analysis

1. Why did the dashboard fail to load? → API call to external service timed out

2. Why did the API call timeout? → Request took >30 seconds (timeout limit)

3. Why did the request take >30 seconds? → External service response time was 45 seconds

4. Why was external service so slow? → Requesting too much data (1000 records instead of 10)

5. Why requesting 1000 records? → Missing pagination parameter in API call

Root cause: Missing pagination parameter causes over-fetching