systematic-debugging

Guide systematic debugging through four phases from root cause to implementation.

125|16|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/aaddrick/claude-pipeline --skill systematic-debugging-aaddrick
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/aaddrick/claude-pipeline/tree/main/.claude/skills/systematic-debugging
Command: npx skills add https://github.com/aaddrick/claude-pipeline --skill systematic-debugging-aaddrick

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging eliminates guesswork by enforcing a structured process to identify root causes before implementing fixes.

Core Features & Use Cases

  • Phase-driven, four-phase workflow (Root Cause Investigation → Pattern Analysis → Hypothesis & Testing → Implementation)
  • Defense-in-depth: validate data and behaviors across multiple layers to prevent regressions
  • Root-cause tracing: trace issues from symptoms back to original trigger
  • Use cases: debugging flaky tests, production outages, and complex integrations across various tech stacks

Quick Start

Load this skill and follow its four-phase process to guide debugging sessions, starting with Phase 1 (Root Cause Investigation) before proposing any fixes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
How do I find the root cause of a production outage instead of just patching symptoms?

Root cause debugging enforces a structured, four-phase process to trace issues from symptoms back to original triggers before proposing fixes. It eliminates guesswork by requiring thorough root cause investigation and pattern analysis first.

What is the best way to debug flaky tests across different tech stacks?

Systematic debugging handles flaky tests by applying a phase-driven workflow: Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, and Implementation. This approach standardizes root-cause tracing across diverse tech stacks.

How does defense-in-depth apply to fixing complex integration issues?

Defense-in-depth debugging validates data and behaviors across multiple layers to prevent regressions. It ensures that fixing a complex integration issue does not introduce new vulnerabilities in interconnected systems.

Can I use a systematic debugging process for any programming language or framework?

Yes, this systematic debugging process applies to test failures, production outages, and complex integrations across diverse tech stacks. It focuses on universal root-cause tracing techniques rather than language-specific tooling.

Why should I follow a phase-driven workflow instead of immediately applying code fixes?

A phase-driven workflow prevents premature patching by enforcing hypothesis testing and pattern analysis before implementation. This structured approach ensures you resolve the actual root cause rather than masking the symptom.

When should I not use a root-cause tracing approach for debugging?

Root-cause tracing may be excessive for trivial syntax errors or immediate hotfixes where the trigger is obvious. It is designed for complex production outages, flaky tests, and integration issues where the root cause is unclear.