systematic-debugging

Guide root-cause investigation through four debugging phases before fixes.

1|Updated May 15, 2025
One-click install
npx skills add https://github.com/badaniya/.stowed --skill systematic-debugging-badaniya
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/badaniya/.stowed/tree/main/agents/.agents/skills/systematic-debugging
Command: npx skills add https://github.com/badaniya/.stowed --skill systematic-debugging-badaniya

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables teams to systematically diagnose bugs by enforcing root-cause investigation before any fixes, reducing wasted time and recurring issues.

Core Features & Use Cases

  • Phase-based debugging framework (Root Cause Investigation, Pattern Analysis, Hypothesis Testing, Implementation).
  • Anti-shortcut guidance and explicit failure modes to resist rush fixes under pressure.
  • Use cases include diagnosing production outages, flaky tests, and deep stack-trace bugs.

Quick Start

Load the systematic-debugging skill from skills/debugging/systematic-debugging and start with Phase 1: Root Cause Investigation, following the four-phase process before proposing any changes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is systematic debugging and when should I use a root cause investigation process?

Systematic debugging is a structured four-phase process that enforces root cause investigation before applying fixes. You use it when diagnosing production outages, flaky tests, and unexpected software failures to prevent recurring issues.

How do I debug flaky tests and production outages without rushing to a fix?

To debug flaky tests and outages without rushing, follow a four-phase process: Root Cause Investigation, Pattern Analysis, Hypothesis Testing, and Implementation. This framework provides anti-shortcut guidance to resist premature fixes under pressure.

What are the four phases of systematic debugging for diagnosing software failures?

The four phases of systematic debugging are Root Cause Investigation, Pattern Analysis, Hypothesis Testing, and Implementation. These phases mandate evidence gathering and provide structured checks to guide you from tracing failures to implementing a verified fix.

How to trace a deep stack-trace bug by finding its root cause first?

To trace a deep stack-trace bug, start with Phase 1: Root Cause Investigation to gather evidence and analyze patterns before testing hypotheses. This structured approach ensures you identify the actual failure mode instead of patching symptoms.

Does systematic debugging work for diagnosing unexpected software failures in production?

Yes, systematic debugging is designed for diagnosing unexpected software failures in production. It applies a phase-based framework with explicit failure modes and defense-in-depth checks to guide root cause analysis under pressure.

Why do my bug fixes keep failing and how does root cause analysis prevent recurring issues?

Bug fixes keep failing when you apply premature patches instead of investigating root causes. Systematic debugging solves this by mandating evidence gathering through four phases, reducing wasted time and preventing recurring issues.