Systematic Debugging

Guides root cause investigation through a four-phase debugging framework before attempting fixes.

Updated Dec 4, 2025
One-click install
npx skills add https://github.com/dallascrilley/dowser --skill systematic-debugging-dallascrilley
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Systematic Debugging
Source: https://github.com/dallascrilley/dowser/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/dallascrilley/dowser --skill systematic-debugging-dallascrilley

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Debugging under pressure often devolves into guess-and-check fixes that mask symptoms, waste hours, and introduce new bugs. This Skill enforces a disciplined process that finds the actual root cause before any fix is attempted. ## Core Features & Use Cases - Four-Phase Framework: Structured progression through Root Cause Investigation, Pattern Analysis, Hypothesis Testing, and Implementation, with explicit gates between phases. - Anti-Rationalization Defenses: Red flags, common rationalizations table, and anti-patterns that catch shortcut behavior like "quick fix for now" or stacking multiple changes at once. - Escalation Rules: After three failed fixes, the process mandates stopping to question the architecture rather than attempting a fourth patch. - Use Case: A test fails intermittently in CI. Instead of adding sleep calls, you follow Phase 1 to reproduce consistently, gather evidence across component boundaries, trace the data flow, and fix the actual source of the race condition. ## Quick Start Ask the AI to apply the systematic debugging process to investigate a failing test or bug before proposing any fix.

Frequently Asked Questions about Systematic Debugging

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug a bug systematically instead of guessing?▼

Follow the four phases: investigate the root cause by reading errors and reproducing the issue, analyze patterns against working examples, form and test a single hypothesis, then implement one verified fix. Never propose fixes before completing the investigation phase.

What should I do when my first fix doesn't work?▼

Stop and return to Phase 1 to re-analyze with the new information rather than stacking more fixes. If three or more fixes have failed, stop entirely and question whether the underlying architecture is the real problem.

Should I skip the debugging process for simple bugs or emergencies?▼

No. The skill explicitly states simple bugs have root causes too, and systematic debugging is faster than guess-and-check thrashing even under time pressure. Skipping the process guarantees rework.

How do I debug failures in multi-component systems like CI pipelines?▼

Add diagnostic instrumentation at each component boundary: log data entering and exiting each layer, verify environment propagation, and run once to identify which layer fails. Then investigate that specific component rather than guessing.

When is it acceptable to conclude a bug has no root cause?▼

Only after completing the full investigation. If the issue is truly environmental or timing-dependent, document the investigation and add appropriate handling like retries or monitoring. The skill notes 95% of "no root cause" cases are incomplete investigation.