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.