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.