systematic-debugging

Enforce a four-phase root-cause debugging workflow before proposing fixes.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/SlevoDev/s-tag --skill systematic-debugging-slevodev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/SlevoDev/s-tag/tree/main/.claude/skills/systematic-debugging
Command: npx skills add https://github.com/SlevoDev/s-tag --skill systematic-debugging-slevodev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps engineers identify root causes of bugs and avoid symptom-only fixes by enforcing a structured four-phase debugging process.

Core Features & Use Cases

  • Mandates completing Phase 1 root-cause investigation before proposing fixes, with a clear Phase-by-Phase checklist.
  • Emphasizes defense-in-depth for data validation and traceability, including anti-pattern awareness to resist time-pressure shortcuts.
  • Provides practical guidance and reference materials (root-cause tracing, defense-in-depth, condition-based waiting, etc.).

Quick Start

Read the error, reproduce the issue, and follow Phase 1 first 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 software bug instead of just fixing the symptom?▼

To find the root cause of a software bug, you must follow a structured debugging workflow that enforces evidence gathering and root-cause tracing before proposing any fixes. This prevents recurring symptom-only patches.

What is the proper debugging workflow for complex production incidents?▼

The proper debugging workflow for production incidents requires a mandatory four-phase process. This ensures engineers thoroughly investigate root causes and gather evidence in Phase 1 before attempting any system fixes.

How do I prevent anti-patterns and shortcuts during incident debugging under time pressure?▼

To prevent anti-patterns during incident debugging under time pressure, apply a defense-in-depth approach with condition-based waiting and strict adherence to a root-cause investigation checklist before fixing.

Can I use this structured debugging process for any tech stack and software development issue?▼

Yes, you can use this structured debugging process for any tech stack. It applies broadly to software development issues including testing, production incidents, and general debugging without stack-specific limitations.

What are the limitations of skipping Phase 1 in a root-cause debugging workflow?▼

Skipping Phase 1 in a root-cause debugging workflow limits your ability to trace the actual issue, leading to anti-patterns and symptom-only fixes. It compromises defense-in-depth and data traceability.

Why does fixing a bug symptom directly often lead to recurring production issues?▼

Fixing a bug symptom directly leads to recurring production issues because the underlying fault remains unaddressed. A root-cause driven debugging process is required to eliminate the actual defect.