systematic-debugging

Identify root causes before proposing fixes in software debugging.

2|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/ingbyr/lzcode --skill systematic-debugging-ingbyr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/ingbyr/lzcode/tree/main/packages/desktop/src-tauri/lz-assets/skills/systematic-debugging
Command: npx skills add https://github.com/ingbyr/lzcode --skill systematic-debugging-ingbyr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic Debugging helps teams avoid rushing to fixes by enforcing root-cause investigations before proposing changes, reducing wasted time and preventing symptom-focused patches.

Core Features & Use Cases

  • Phase-based workflow (Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, Implementation) to structure debugging efforts.
  • Mandatory Phase 1 before any fixes, with explicit checks to prevent skipping steps.
  • Practical defenses like anti-patterns, data-flow tracing, and defense-in-depth to ensure robust fixes.
  • Real-world scenarios include debugging flaky tests, production incidents, and complex system behavior.

Quick Start

Read the four phases overview and begin with Phase 1: perform 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 with production incidents?

Systematic debugging enforces root-cause investigation before proposing fixes, preventing symptom-focused patches during production incidents. It mandates a four-phase workflow to reduce wasted time and ensure robust resolutions.

How do I debug flaky tests without rushing to apply fixes?

Debug flaky tests by following a phase-based workflow starting with root-cause investigation, then pattern analysis, hypothesis testing, and implementation. This structured method ensures you understand the underlying issue before changing code.

Can I use a phase-based debugging workflow for regression bugs?

Yes, a phase-based debugging workflow applies to regression bugs across development, test, and production environments. It requires completing root-cause investigation and pattern analysis before moving to hypothesis testing and implementation.

What is the best way to trace data flow when troubleshooting complex system behavior?

The best way to troubleshoot complex system behavior is using data-flow tracing combined with defense-in-depth practices. This approach is part of a structured debugging workflow that identifies root causes through pattern analysis before applying fixes.

Why should I not skip root-cause investigation when fixing bugs?

Skipping root-cause investigation often results in symptom-focused patches that fail to resolve the actual issue. A systematic debugging workflow includes explicit checks to prevent skipping this critical phase before implementation.

Does systematic debugging work for identifying anti-patterns in software engineering?

Yes, systematic debugging works for identifying anti-patterns by enforcing pattern analysis during the root-cause investigation phase. This structured approach helps teams avoid wasted time and ensures fixes address the true origin of software defects.