systematic-debugging

Trace software bug root causes through a structured four-phase investigation process.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps engineering teams systematically diagnose bugs and unexpected failures, ensuring root causes are identified before proposing fixes.

Core Features & Use Cases

  • Four-phase framework for root-cause investigation, pattern analysis, hypothesis testing, and implementation.
  • Defense-in-depth guidance to add validations and instrumentation across multiple layers.
  • Root-cause tracing techniques to backtrack errors to their origin and prevent symptom fixes.
  • Real-world impact: reduces debugging time and prevents regression by focusing on the source.

Quick Start

Begin with Phase 1: Root Cause Investigation and gather diagnostic evidence before attempting any fix.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
How do I trace the root cause of a production bug before fixing it?

Trace the root cause of a bug by backtracking errors to their origin through a structured four-phase framework requiring explicit evidence gathering and hypothesis testing before any implementation. This disciplined approach prevents symptom fixes and reduces regression risks.

What is the best way to debug flaky tests systematically?

Debug flaky tests systematically using a four-phase framework that enforces root-cause investigation, pattern analysis, and disciplined implementation constraints. This structured method ensures fixes address the actual integration failure rather than temporary symptoms.

How do I stop applying symptom fixes during software debugging?

Stop applying symptom fixes by separating root-cause investigation from implementation using a structured four-phase process. Phase 1 requires explicit evidence gathering and error backtracking to guarantee the proposed fix addresses the true source of the failure.

Can I use a systematic debugging approach for CI integration problems?

You can use this systematic debugging approach for CI integration problems, production bugs, and flaky tests across codebases. It guides engineers through structured root-cause tracing, pattern analysis, and disciplined implementation constraints regardless of the software layer.

How to add defense-in-depth validations when fixing unexpected failures?

Add defense-in-depth validations during the implementation phase of the debugging framework by instrumenting multiple system layers. This structured approach ensures fixes address the root cause while adding necessary validations to prevent unexpected failures from recurring.