systematic-debugging

Enforce a four-phase root-cause workflow to debug production outages and flaky tests.

Updated Mar 8, 2026
One-click install
npx skills add https://github.com/Phife726/ds_agent --skill systematic-debugging-phife726
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/Phife726/ds_agent/tree/main/systematic-debugging
Command: npx skills add https://github.com/Phife726/ds_agent --skill systematic-debugging-phife726

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When debugging complex bugs, you need a repeatable process that prioritizes root cause over quick fixes and reduces wasted time.

Core Features & Use Cases

  • Phase-based approach: Phase 1 Root Cause Investigation, Phase 2 Pattern Analysis, Phase 3 Hypothesis & Testing, Phase 4 Implementation.
  • Anti-patterns and defenses to resist hurried fixes, with explicit stop-and-reanalyze guidance.
  • Real-world use cases: debugging production outages, flaky tests, and multi-component systems.

Quick Start

Run the four-phase framework on the current issue, starting with root-cause investigation before proposing any fix, and consult the defense-in-depth guidelines when data flows across components.

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 root-cause debugging for production outages?▼

Systematic debugging enforces a four-phase root-cause workflow—investigation, pattern analysis, hypothesis testing, and implementation—before proposing any fix. It applies defense-in-depth validation to prevent hurried patches and resolves complex multi-component outages.

How do I debug flaky tests across multi-component systems?▼

Debug flaky tests by applying a phased root-cause workflow that reproduces the behavior issue, analyzes patterns across components, and tests hypotheses. Defense-in-depth guidelines validate data flow to ensure the fix targets the actual root cause.

How to stop fixing symptoms and find the root cause of behavior issues?▼

Stop fixing symptoms by enforcing strict anti-pattern checks that halt the process for reanalysis. The framework requires completing Phase 1 root-cause investigation and Phase 2 pattern analysis before allowing any hypothesis or implementation.

Can I use this systematic debugging method for multi-component data flow issues?▼

Yes, this method explicitly supports multi-component systems. It provides defense-in-depth guidelines specifically designed to validate and trace data as it flows across components during the root-cause investigation and hypothesis testing phases.

What's the best way to structure a debugging workflow for complex software bugs?▼

The best way to structure debugging is using a four-phase workflow: reproduce and investigate the root cause, analyze patterns, test hypotheses, and implement the fix. This traceable process reduces wasted time and resists hurried solution proposals.

When should I reanalyze during the root-cause debugging process?▼

You should reanalyze when encountering identified anti-patterns that trigger explicit stop-and-reanalyze guidance. This defense mechanism prevents jumping to premature solutions and ensures you complete the investigation and pattern analysis phases before proceeding.