systematic-debugging

Diagnose root causes through a structured four-phase debugging process.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/raksok/netherica --skill systematic-debugging-raksok
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/raksok/netherica/tree/main/.agents/skills/systematic-debugging
Command: npx skills add https://github.com/raksok/netherica --skill systematic-debugging-raksok

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging provides a disciplined, four-phase process to identify root causes before proposing fixes, preventing symptom fixes and wasted time.

Core Features & Use Cases

  • Four-phase framework: Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, Implementation, with a strict rule to complete Phase 1 first.
  • Anti-patterns and defensive practices to resist time pressure and rationalization.
  • Validation and testing approaches (root-cause tracing, defense-in-depth, and structured experimentation) with real-world impact.

Quick Start

Read the four-phase framework and begin with Phase 1: Root Cause Investigation before proposing any fixes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is root-cause debugging and how does it prevent symptom fixes?

Root-cause debugging is a structured, four-phase process that identifies the actual source of a bug before applying fixes. It enforces deep tracing and pattern analysis to prevent superficial symptom patches and wasted time.

How do I systematically debug a test failure or unexpected system behavior?

To systematically debug a test failure, follow the four-phase framework: Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, and Implementation. You must complete Phase 1 tracing before attempting any code fixes.

Does systematic debugging work for any technical system or only specific platforms?

Systematic debugging applies to any bug, test failure, or unexpected behavior across technical systems. The phase-based framework is platform-agnostic and focuses on universal root-cause tracing and structured experimentation.

What is the best way to stop recurring bugs and prevent regressions during fixes?

The best way to prevent regressions is applying defense-in-depth validation during the Implementation phase. This practice ensures your root-cause fix is verified through structured experimentation and guarded against future failures.

Why should I complete root cause investigation before proposing code fixes?

You must complete root cause investigation before proposing fixes to resist time pressure and rationalization. Skipping this phase leads to anti-patterns, superficial symptom fixes, and wasted debugging time.