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.