systematic-debugging

Enforce a four-phase workflow to identify root causes before fixes.

91|4|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/prime-radiant-inc/serf --skill systematic-debugging-prime-radiant-inc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/prime-radiant-inc/serf/tree/main/agent/skills/systematic-debugging
Command: npx skills add https://github.com/prime-radiant-inc/serf --skill systematic-debugging-prime-radiant-inc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging provides a structured, four-phase approach to identify the root cause of bugs, test failures, or unexpected behavior before proposing fixes, reducing wasted time on symptom patches.

Core Features & Use Cases

  • Phase-driven workflow: Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, and Implementation.
  • Mandatory Phase 1 before any fixes, with explicit kill-switches for shortcuts.
  • Anti-patterns, defense-in-depth, and real-world testing guidance to guard against rushed decisions.
  • Easy-to-follow references to related techniques and skills for deepening debugging rigor.
  • Use Cases: when debugging production issues, flaky tests, or long-running failures under pressure.

Quick Start

Load the skill and complete 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 a phase-based approach to root cause debugging?▼

It enforces a four-phase workflow—Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, and Implementation—to identify the true source of bugs before applying fixes, preventing wasted effort on symptom patches.

How do I debug flaky tests and production failures under pressure?▼

Apply a disciplined debugging workflow that mandates Root Cause Investigation before any fixes. Use pattern analysis and hypothesis testing to systematically isolate the failure source, reducing rushed decisions during high-pressure incidents.

What's the best way to stop patching symptoms and find the root cause of test failures?▼

The best way to find the root cause of test failures is to enforce a mandatory investigation phase before proposing any fixes, using defense-in-depth and structured pattern analysis to avoid premature symptom patching.

Can I skip the initial investigation phase if I already know the bug fix?▼

No, Phase 1 Root Cause Investigation is mandatory before any fixes to prevent rushed decisions. Explicit kill-switches exist for shortcuts, but the workflow emphasizes completing root cause analysis first to ensure correctness.

What are common anti-patterns when investigating unexpected software behavior?▼

Common anti-patterns include rushing to patch symptoms before completing root cause investigation and skipping structured pattern analysis. The workflow guards against these with defense-in-depth principles and mandatory hypothesis testing.

Does systematic debugging work for build failures and long-running production issues?▼

Yes, it solves root-cause debugging for production incidents, flaky tests, and build failures by enforcing a phase-based workflow with defense-in-depth guidance, applicable across diverse software development contexts.