systematic-debugging

Guide engineers through a four-phase debugging process to uncover root causes.

2|1|Updated Jan 5, 2026
One-click install
npx skills add https://github.com/lagz0ne/prev-cli --skill systematic-debugging-lagz0ne
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/lagz0ne/prev-cli/tree/main/.opencode/skill/systematic-debugging
Command: npx skills add https://github.com/lagz0ne/prev-cli --skill systematic-debugging-lagz0ne

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill guides engineers through a four-phase systematic debugging process to uncover the root cause of bugs, rather than applying quick, symptom-focused fixes.

Core Features & Use Cases

  • Four-Phase Method: Root Cause Investigation, Pattern Analysis, Hypothesis Testing, and Implementation, with explicit checkpoints.
  • Defenses Against Shortcuts: Mandates Phase 1 before fixes, single-hypothesis discipline, and explicit failure modes.
  • Practical Guidance: Includes anti-pattern lists, stack-trace tips, and defense-in-depth patterns to harden fixes.

Quick Start

Load the skill and follow the Phase 1 checklist to establish the root cause before proposing any change.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is systematic debugging for finding the root cause of bugs?▼

Systematic debugging is a four-phase process to uncover root causes of bugs, enforcing rigorous data gathering, pattern analysis, and hypothesis testing before implementing fixes.

How do I fix a bug systematically without taking shortcuts?▼

To fix a bug systematically, follow the four-phase method: perform root cause investigation, pattern analysis, single-hypothesis testing, and implementation, ensuring Phase 1 is completed before any fixes.

How does the single-hypothesis approach work in root cause debugging?▼

The single-hypothesis approach works by testing one root cause hypothesis at a time during pattern analysis, preventing premature fixes and ensuring accurate defect identification before implementation.

When should I use defense-in-depth patterns for bug fixing?▼

You should use defense-in-depth patterns during the implementation phase of systematic debugging to harden fixes and prevent regression after uncovering and addressing the root cause.

What are common anti-patterns to avoid during root cause investigation?▼

Common anti-patterns to avoid during root cause investigation include skipping Phase 1 data gathering, testing multiple hypotheses simultaneously, and applying symptom-focused fixes before verifying the root cause.

Does this systematic debugging process work for production outages and test failures?▼

Yes, this systematic debugging process applies to any technical issue, from test failures to production outages, guiding engineers through root cause investigation and hypothesis testing regardless of scale.