systematic-debugging

Identify and fix root causes using a four-phase debugging workflow.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/lightxue/dotfiles --skill systematic-debugging-lightxue
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/lightxue/dotfiles/tree/main/agent/skills/systematic-debugging
Command: npx skills add https://github.com/lightxue/dotfiles --skill systematic-debugging-lightxue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps engineers reliably identify and fix root causes of bugs and failures by following a disciplined, four-phase debugging process.

Core Features & Use Cases

  • Four-phase framework (Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, Implementation) to systematically uncover root causes.
  • Anti-patterns, defense-in-depth guidance, and stack-trace oriented diagnostics to resist time pressure and avoid symptom fixes.
  • Practical playbooks and references (root-cause-tracing, defense-in-depth, condition-based waiting) to strengthen debugging across teams.

Quick Start

Load the Systematic Debugging skill and complete Phase 1 before proposing 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 of bugs?

Systematic debugging is a structured, four-phase process—root cause investigation, pattern analysis, hypothesis testing, and implementation—that reliably uncovers and fixes the true root causes of bugs instead of just treating symptoms.

How do I debug production issues and test failures without applying symptom fixes?

Debug production issues and test failures by following a disciplined workflow that enforces stack-trace oriented diagnostics, pattern analysis, and hypothesis testing before implementation, resisting time pressure to ensure durable, verifiable fixes.

When should I use a structured debugging process for software failures and performance quirks?

Use a structured debugging process when facing complex software failures, performance quirks, or integration problems where time pressure might push you toward symptom fixes, ensuring you verify root causes through defense-in-depth checks.

Can I apply this debugging workflow to integration problems across different software systems?

Yes, this debugging workflow applies to integration problems across software systems, using pattern analysis and condition-based waiting playbooks to systematically trace failures and implement verifiable, durable fixes.

What's the best way to stop recurring bugs and prevent symptom fixes in my codebase?

The best way to stop recurring bugs is to enforce anti-patterns and defense-in-depth guidance during implementation, ensuring every fix passes through root-cause investigation and hypothesis testing to verify the source of the failure.