systematic-debugging

Trace root causes with a four-phase debugging framework before fixing.

14|3|Updated Jan 23, 2026
One-click install
npx skills add https://github.com/lgbarn/devops-skills --skill systematic-debugging-lgbarn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/lgbarn/devops-skills/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/lgbarn/devops-skills --skill systematic-debugging-lgbarn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging provides a disciplined workflow to identify root causes before proposing fixes, preventing symptom-focused patches and reducing wasted effort.

Core Features & Use Cases

  • Four-phase framework (Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, Implementation) that must be completed before fixes
  • Anti-patterns and defense-in-depth guidance to resist shortcuts under pressure
  • Comprehensive techniques and references for tracing data flow, validating across layers, and documenting findings

Quick Start

Load the skill and follow Phase 1 through Phase 4 in order.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
How do I find the root cause of a bug before applying a fix?

Root-cause debugging requires completing a four-phase framework—Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, and Implementation—before proposing fixes. This enforces the rule of no fixes without root-cause investigation to prevent symptom-focused patches.

What is a systematic approach to debugging production incidents?

Systematic debugging applies a phase-based framework to diagnose production incidents by tracing data flow and validating across layers. It resists shortcuts under pressure using anti-patterns and defense-in-depth guidance to ensure accurate root-cause tracing.

How do I stop treating symptoms instead of tracing the root cause of test failures?

You stop treating symptoms by enforcing a strict workflow that requires completing Phase 1 Root Cause Investigation before any fixes. This disciplined approach prevents wasted effort on symptom-focused patches and ensures underlying issues are identified.

What's the best way to debug complex failures where symptoms mislead?

The best way to handle complex failures is using a systematic debugging framework that traces root causes through pattern analysis and hypothesis testing. This method provides comprehensive techniques for validating across layers and documenting findings.

Why does applying quick patches during bug hunts often lead to wasted effort?

Quick patches lead to wasted effort because they bypass root-cause investigation and treat misleading symptoms instead. Systematic debugging solves this by enforcing a four-phase framework that requires hypothesis testing before implementation.

When should I not use a systematic debugging approach for bug fixes?

You should not bypass systematic debugging when facing complex failures or production incidents, as skipping root-cause investigation risks applying symptom-focused patches. The framework is designed to resist shortcuts under pressure and prevent recurring issues.