systematic-debugging

Guide developers through a four-phase root-cause debugging process.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Hanseooo/hanseo-opencode-workflows --skill systematic-debugging-hanseooo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/Hanseooo/hanseo-opencode-workflows/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/Hanseooo/hanseo-opencode-workflows --skill systematic-debugging-hanseooo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debugging is often reactive and chaotic; this skill enforces a structured approach to uncover root causes rather than masking symptoms.

Core Features & Use Cases

  • Phase-driven investigation: Root Cause Investigation, Pattern Analysis, Hypothesis testing, and Implementation.
  • Anti-pattern awareness: STOP and re-analyze; Never fix symptoms.
  • Defense-in-depth: Add checks across multiple data-flow layers to prevent regression.

Quick Start

Follow the four-phase process to uncover root causes before proposing fixes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
How do I systematically debug a software issue to find the root cause?

To systematically debug a software issue, follow a structured four-phase process: Root Cause Investigation, Pattern Analysis, Hypothesis testing, and Implementation. This enforces uncovering actual root causes rather than just masking symptoms before proposing fixes.

What is the best way to stop fixing bug symptoms and prevent regression?

The best way to stop fixing symptoms is applying anti-pattern awareness to STOP and re-analyze, combined with defense-in-depth validation. This adds checks across multiple data-flow layers to prevent regression while addressing the core issue.

Can I use this systematic debugging process for production incidents and test failures?

Yes, you can use this phase-based systematic debugging process for production incidents, test failures, and integration problems. It is applicable across varying software projects to diagnose and fix bugs methodically.

How does the hypothesis testing phase work during root-cause analysis?

The hypothesis testing phase works by validating educated guesses against actual system behavior after completing initial root cause investigation and pattern analysis. It serves as an explicit constraint to ensure fixes target verified root causes rather than assumptions.

When should I not use a structured debugging approach for my code?

You should not use a structured debugging approach when addressing simple, isolated syntax errors or trivial configuration changes that require immediate, direct fixes rather than multi-phase root-cause analysis and defense-in-depth validation.