systematic-debugging

Trace data flow and verify root causes before implementing software fixes.

Updated Dec 14, 2025
One-click install
npx skills add https://github.com/pproenca/dot-claude --skill systematic-debugging-pproenca
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/pproenca/dot-claude/tree/main/plugins/super/skills/systematic-debugging
Command: npx skills add https://github.com/pproenca/dot-claude --skill systematic-debugging-pproenca

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Random fixes and quick patches only address symptoms, leading to recurring bugs, wasted time in debugging, and a lack of true problem understanding.

Core Features & Use Cases

  • Four-Phase Framework: Guides through root cause investigation, pattern analysis, hypothesis testing, and implementation for thorough problem-solving.
  • Evidence-Based Debugging: Mandates gathering evidence and reproducing issues consistently before proposing fixes, preventing guesswork.
  • Anti-Rationalization: Explicitly counters common excuses for skipping thorough investigation, ensuring rigor even under pressure.
  • Use Case: When a critical production bug appears, this skill ensures you follow a rigorous process to find the true root cause, preventing quick fixes that mask deeper problems.

Quick Start

I've encountered an unexpected error in the build process. Use the systematic-debugging skill to guide my investigation.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
How do I systematically debug a production bug instead of applying quick fixes?

Systematic debugging follows a four-phase workflow: root cause investigation, pattern analysis, hypothesis testing, and implementation. This approach traces data flow across components, gathers reproducible evidence, and confirms the root cause before fixing—preventing symptom-masking patches that cause recurring bugs.

Why does my bug keep reoccurring after I fix it?

Recurring bugs stem from fixing symptoms rather than root causes. Systematic debugging enforces evidence-based verification and data-flow tracing across component boundaries to identify the true origin, ensuring fixes address the underlying problem, not just surface behavior.

How do I find the root cause in a multi-component system or CI pipeline?

Systematically investigate by adding diagnostic instrumentation at component boundaries, reproducing the issue with collected data, analyzing patterns across components, and testing hypotheses before implementation. This rigorous process isolates the true failure point in complex, interconnected systems.

What's the best way to troubleshoot failing tests or unexpected runtime anomalies?

Apply systematic debugging: reproduce the anomaly consistently, trace data flow to identify where behavior diverges from expectations, gather evidence at each component, form testable hypotheses, and verify the root cause before proposing a fix. This prevents guesswork and wasted debugging cycles.

Can I use this approach when I'm under pressure to ship a quick fix?

Yes. Systematic debugging includes anti-rationalization practices that counter pressure-driven excuses for skipping investigation. Following the four-phase framework under time constraints prevents costlier rework from incomplete fixes and builds lasting problem understanding.