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.