systematic-debugging

Identify root causes of software bugs through a four-phase debugging process.

6|2|Updated Aug 14, 2025
One-click install
npx skills add https://github.com/Im5tu/claude --skill systematic-debugging-im5tu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/Im5tu/claude/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/Im5tu/claude --skill systematic-debugging-im5tu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging guides engineers to root-cause bugs before implementing fixes, preventing symptom fixes and reducing rework.

Core Features & Use Cases

  • Four-phase process: Phase 1 Root Cause Investigation, Phase 2 Pattern Analysis, Phase 3 Hypothesis & Testing, Phase 4 Implementation.
  • Anti-shortcut rules: STOP and re-analyze, NEVER fix the symptom, document evidence.
  • Defense-in-depth: adding validations at multiple layers to prevent regression.
  • Use cases: debugging test failures, production outages, flaky tests, and complex integrations.

Quick Start

  1. Read error messages and reproduce the issue.
  2. Trace data flow and identify the root cause.
  3. Complete Phase 1 before proposing changes.
  4. Proceed through Phases 2–4 and apply defensive checks.

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 or flaky test?

Systematic debugging prevents symptom fixes by enforcing a four-phase progression: Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, and Implementation. You must gather evidence and complete each phase before moving forward.

What is the best way to debug complex multi-component software issues?

Systematic debugging handles multi-component issues by enforcing strict phase progression: investigate root causes, analyze patterns, test hypotheses, and implement fixes. It adds defense-in-depth validations across multiple layers to prevent future regressions.

How do I stop fixing symptoms and start tracing root causes during debugging?

To stop fixing symptoms, follow anti-shortcut rules during debugging: STOP and re-analyze if jumping to conclusions, NEVER fix the symptom directly, and document all evidence. Complete root cause investigation before proposing any fixes.

Does systematic debugging work for test failures and unexpected behavior in complex integrations?

Yes, systematic debugging applies to test failures, production outages, flaky tests, and complex integrations across multi-component systems. It enforces evidence gathering and hypothesis testing to ensure accurate root cause identification before fixing.

How do I apply defense-in-depth validations when fixing bugs?

Apply defense-in-depth validations by adding checks at multiple layers during the Implementation phase. This systematic debugging practice prevents regression after you fix the identified root cause of the software issue.