One-click install
npx skills add https://github.com/DaFum/github-repository-vi --skill systematic-debugging-dafum
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/DaFum/github-repository-vi/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/DaFum/github-repository-vi --skill systematic-debugging-dafum

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging helps engineers identify root causes before applying fixes, reducing wasted time and rework across bug investigations, test failures, and production incidents.

Core Features & Use Cases

  • Phase-driven process: a four-phase workflow (Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, Implementation) to structure debugging.
  • Anti-patterns and defenses: explicit guidance to avoid symptom fixes and to apply defense-in-depth across layers.
  • Reference techniques: includes root-cause tracing, condition-based waiting, and defense-in-depth patterns for robust problem solving.
  • Use Case: ideal for complex software issues, flaky tests, and production incidents where tracing to the source is essential.

Quick Start

Read the skill overview, then follow 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
How do I find the root cause of a bug instead of just fixing symptoms?

To find a root cause, start with Root Cause Investigation to gather data before proposing fixes. This systematic debugging method enforces a four-phase workflow to trace failures to their source, preventing wasted time on symptom patches.

What is the best way to debug flaky test failures?

The best way to debug flaky test failures is applying pattern analysis and condition-based waiting. Systematic debugging uses data-driven tracing and hypothesis testing to isolate intermittent test failures before applying implementation fixes.

How do I structure debugging for production incidents?

Structure production incident debugging using a phased workflow: Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, and Implementation. This data-driven approach ensures you identify failure sources across layers before applying defense-in-depth fixes.

Why does applying quick fixes make debugging take longer?

Applying quick fixes prolongs debugging because it addresses symptoms rather than the actual root cause. Without systematic pattern analysis and data-driven tracing, the underlying issue persists, causing rework and recurring failures across your software.

Can I use systematic debugging for complex software issues across multiple layers?

Yes, systematic debugging is ideal for complex software issues across multiple layers. It applies defense-in-depth practices during the Implementation phase, ensuring robust problem solving and preventing symptom fixes across your application stack.

What are the phases of systematic debugging?

The phases of systematic debugging are Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, and Implementation. This four-phase workflow enforces data-driven tracing and decision making to resolve bugs, test failures, and production incidents.