systematic-debugging

Diagnose and fix bugs using a four-phase root cause framework.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/dylan-conlin/orch-go --skill systematic-debugging-dylan-conlin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/dylan-conlin/orch-go/tree/main/skills/src/worker/systematic-debugging
Command: npx skills add https://github.com/dylan-conlin/orch-go --skill systematic-debugging-dylan-conlin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires worker-base.

What problem does it solve?

It helps engineers systematically diagnose and fix bugs by guiding root-cause investigation, pattern analysis, hypothesis testing, and implementation.

Core Features & Use Cases

  • Four-phase framework (Root Cause Investigation → Pattern Analysis → Hypothesis Testing → Implementation) to ensure understanding before fixes.
  • Defense-in-depth mindset: trace data flow, validate at boundaries, and document findings for reproducibility.
  • Applicable to any technical issue (test failures, production bugs, unexpected behavior) across multi-component systems.
  • Smoke-test and evidence-based completion with structured phase reports.

Quick Start

Start by describing the bug you’re facing and run the skill to begin Phase 1: Root Cause Investigation

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is a systematic approach to find the root cause of software bugs?

Systematic debugging uses a four-phase framework—Root Cause Investigation, Pattern Analysis, Hypothesis Testing, and Implementation—to uncover root causes before proposing fixes. It traces data flow and validates boundaries to ensure robust understanding across multi-component systems.

How do I debug test failures across multiple components?

To debug test failures across multi-component systems, apply a phased framework starting with Root Cause Investigation to trace data flow, followed by Pattern Analysis and Hypothesis Testing to validate assumptions before writing a minimal fix.

Can I use this four-phase debugging method for production bugs?

Yes, the four-phase debugging method is applicable to any technical issue, including production bugs, test failures, and unexpected behavior. It requires documenting the root cause and validating fixes with smoke tests and evidence before completion.

What's the best way to ensure a bug fix actually resolves the underlying issue?

The best way to ensure a bug fix resolves the underlying issue is to apply a defense-in-depth mindset: document the root cause, perform phased analysis, write a minimal fix, and validate completion with smoke tests and structured evidence reports.

Do I need the worker-base dependency to run systematic debugging?

Yes, systematic debugging requires the worker-base dependency to function. This prerequisite provides the foundational environment needed to execute the four-phase debugging framework and generate structured phase reports.