systematic-debugging

Guide engineers through four structured debugging phases before implementing fixes.

Updated Mar 3, 2026
One-click install
npx skills add https://github.com/jacexh/skills --skill systematic-debugging-jacexh
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/jacexh/skills/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/jacexh/skills --skill systematic-debugging-jacexh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging helps teams resist time-pressure shortcuts by enforcing root-cause investigation and structured phases.

Core Features & Use Cases

  • Phase-based workflow: Phase 1 Root Cause Investigation, Phase 2 Pattern Analysis, Phase 3 Hypothesis and Testing, Phase 4 Implementation.
  • Bulletproofing with anti-patterns, defense-in-depth, and data-flow tracing to prevent regression.
  • Applicable to production outages, flaky tests, and complex bug scenarios across multi-component systems.

Quick Start

Follow the four-phase process (investigate root cause, analyze patterns, test hypotheses, implement robust fixes) and verify results before declaring success.

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 flaky test before applying a fix?▼

Root-cause debugging prevents fixes that merely mask symptoms by enforcing a structured four-phase workflow: investigating the root cause, analyzing patterns, testing hypotheses, and implementing robust fixes to reduce regression risk.

What is the best way to debug production incidents without introducing regressions?▼

Debugging production incidents systematically uses defense-in-depth and data-flow tracing to validate hypotheses, ensuring you identify the actual issue and implement robust fixes rather than taking time-pressure shortcuts that cause regressions.

Can I use a phased debugging approach for complex multi-component code paths?▼

Yes, systematic debugging applies directly to complex multi-component systems by using data-flow tracing and pattern analysis to navigate intricate code paths and pinpoint the underlying failure across components.

Why does systematic debugging require completing all four phases before proposing fixes?▼

Systematic debugging requires completing all four phases—root cause investigation, pattern analysis, hypothesis testing, and implementation—to ensure trace-based validation confirms the true issue and prevents premature, superficial patches.

How do I stop engineers from taking debugging shortcuts during time-sensitive outages?▼

Systematic debugging enforces a strict phase-based workflow that resists time-pressure shortcuts, requiring thorough root-cause investigation and trace-based validation before any implementation to ensure the real issue is fixed.

What is defense-in-depth debugging and when should I apply it?▼

Defense-in-depth debugging bulletproofs your fixes by using anti-patterns and data-flow tracing to prevent regression. Apply it across complex bug scenarios, flaky tests, and production outages to validate fixes robustly.