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.