systematic-debugging

Enforce root-cause investigation before applying fixes in a four-phase debugging workflow.

15|2|Updated Jun 21, 2026
One-click install
npx skills add https://github.com/Liuchun-oss/codelf-agent --skill systematic-debugging-liuchun-oss
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/Liuchun-oss/codelf-agent/tree/main/resources/skills/systematic-debugging
Command: npx skills add https://github.com/Liuchun-oss/codelf-agent --skill systematic-debugging-liuchun-oss

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Random debugging wastes time and creates unnecessary fixes; this skill enforces a disciplined, four-phase approach to uncover root causes before proposing changes.

Core Features & Use Cases

  • Four-Phase Process: Phase 1 Root Cause Investigation, Phase 2 Pattern Analysis, Phase 3 Hypothesis and Testing, Phase 4 Implementation.
  • Defensive Practices: anti-symptom fixes, data-flow tracing, and defense-in-depth to prevent regressions.
  • Use Cases: debugging production issues, flaky tests, and complex systems where timing or data flow causes failures.

Quick Start

Follow the four-phased root-cause debugging workflow to identify the true trigger before implementing fixes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is the best way to trace root causes before fixing production bugs?

Systematic debugging enforces root-cause tracing to uncover the true trigger of production bugs before proposing any code changes. This approach prevents random debugging and eliminates unnecessary symptom fixes by applying a deterministic four-phase workflow.

How do I debug flaky tests and complex data-flow failures systematically?

Debugging flaky tests requires data-flow tracing and pattern analysis to identify hidden timing or data dependencies. You apply a four-phase workflow to investigate the root cause, form hypotheses, and verify fixes with reproducible checks.

Why does applying quick fixes to unexpected behavior lead to code regressions?

Applying quick fixes to unexpected behavior often masks the underlying root cause and introduces code regressions. A defense-in-depth approach with post-fix verification ensures the true trigger is eliminated and prevents future failures.

What are the four phases of a deterministic root-cause debugging workflow?

The four phases are Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, and Implementation. This workflow guides engineers from initial investigation through data-flow tracing to applying verified fixes.

How do I stop treating symptoms and start eliminating bugs in existing codebases?

To stop treating symptoms and eliminate bugs, enforce anti-symptom fixes by tracing data-flow back to the root cause. Implement defense-in-depth practices and reproducible checks to ensure fixes target the actual failure trigger.

When should I use a phase-based debugging approach instead of ad-hoc troubleshooting?

Use a phase-based debugging approach for complex systems, production issues, and flaky tests where timing or data flow causes failures. It provides robust debugging with multiple defense layers that ad-hoc troubleshooting lacks.