systematic-debugging

Guide root-cause debugging through four phases with decision gates.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured, phase-based approach to debugging, ensuring root-cause analysis before any fixes to prevent symptom-driven work.

Core Features & Use Cases

  • Phase-driven workflow with four phases: Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, and Implementation.
  • Defense-in-depth mindset that adds layered checks to catch edge cases and bypass shortcuts.
  • Applicable to bugs, test failures, performance issues, and integration problems across projects and teams.

Quick Start

Load the skill and follow Phase 1 (Root Cause Investigation) before attempting any fixes. Use the other phases as guidance when the root cause remains unclear.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
How do I fix recurring software bugs instead of just patching symptoms?▼

To fix recurring software bugs instead of patching symptoms, use a phase-based root-cause investigation workflow that enforces analysis before implementation. This approach adds defense-in-depth validation to catch edge cases and ensure the actual flaw is resolved.

What is the best way to debug flaky tests and production outages?▼

The best way to debug flaky tests and production outages is applying a systematic debugging process with explicit decision gates. This structured workflow ensures you stop and re-evaluate hypotheses when root causes remain unclear across complex integration issues.

How do you carry out root-cause tracing for complex integration issues?▼

Root-cause tracing for complex integration issues requires a four-phase process: Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, and Implementation. You must complete the initial investigation phase before attempting any code fixes.

When should I stop and re-evaluate during the debugging process?▼

You should stop and re-evaluate during the debugging process when reaching explicit decision gates and the root cause remains unclear. This phase-based methodology prevents symptom-focused work and ensures rigorous analysis before proceeding to implementation.

Does a systematic debugging workflow work for small codebases and large teams?▼

Yes, a systematic debugging workflow applies to software engineering challenges across codebases of varying sizes. It provides a structured phase-based process and defense-in-depth validation suitable for both small projects and large teams.

Why does symptom-focused debugging fail to permanently fix software issues?▼

Symptom-focused debugging fails because it bypasses root-cause investigation and applies immediate fixes without pattern analysis. A rigorous phase-based workflow with layered checks is required to catch edge cases and prevent recurring failures.