systematic-debugging

Debug bugs via four-phase root-cause investigation, hypothesis testing, and implementation.

Updated May 4, 2026
One-click install
npx skills add https://github.com/xaionaro/.config-codex --skill systematic-debugging-xaionaro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/xaionaro/.config-codex/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/xaionaro/.config-codex --skill systematic-debugging-xaionaro

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The skill provides a structured, repeatable approach to debugging that emphasizes root-cause analysis over symptom fixes.

Core Features & Use Cases

  • Four-phase workflow: Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, and Implementation.
  • Anti-patterns and defense-in-depth guidance to resist time pressure and rationalization.
  • Step-by-step guidance for each phase, with explicit success criteria and checks.
  • Practical templates and references to ensure robust, scalable debugging practices.

Quick Start

Start Phase 1: Root Cause Investigation before attempting any fixes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is systematic debugging and how does it help find root causes?

Systematic debugging is a structured, repeatable approach to finding root causes rather than applying symptom fixes. It guides engineers through a four-phase process to investigate failures and avoid quick fixes.

How do I debug software failures systematically step by step?

To debug software failures systematically, follow a four-phase process: Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, and Implementation. Phase 1 is mandatory and cannot be skipped before attempting fixes.

Can I use systematic debugging for production incidents and testing environments?

Yes, systematic debugging applies to development, testing, and production incidents. It guides engineers through root-cause investigation, pattern analysis, hypothesis testing, and safe implementation across all environments.

What is the best way to resist quick fixes during root cause analysis?

The best way to resist quick fixes during root cause analysis is to apply anti-pattern awareness and defense-in-depth guidance. This enforces non-skippable Phase 1 work to resist time pressure and rationalization.

Why does my debugging process fail to prevent recurring bugs?

Your debugging process likely fails to prevent recurring bugs because it lacks defense-in-depth and anti-pattern awareness. Skipping root-cause investigation in favor of quick symptom fixes leads to repeated failures.

How do I verify hypotheses during software debugging?

You verify hypotheses during software debugging in the third phase of the systematic process, which involves explicit hypothesis testing. This phase follows root-cause investigation and pattern analysis before safe implementation.