systematic-debugging

Identify root causes in technical issues before proposing fixes.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic Debugging addresses the issue of applying fixes to symptoms under time pressure by enforcing a structured four-phase workflow that reveals root causes before changes, reducing rework and brittle patches.

Core Features & Use Cases

  • Four Phases: Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, and Implementation.
  • Anti-patterns and safeguards: Never fix the symptom; STOP and re-analyze; use defense-in-depth instrumentation.
  • Defensive design: multi-layer validation and traceability techniques like root-cause tracing, defense-in-depth, and condition-based waiting.
  • Real-world impact: faster, more reliable fixes with higher first-time pass rates.

Quick Start

Begin with Phase 1 to uncover the root cause, then proceed through Phases 2–4 to implement a robust fix.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is the best way to find root causes in production bugs before applying fixes?

Root cause debugging requires a structured workflow that analyzes patterns and tests hypotheses before implementation. This prevents rushed, symptom-focused fixes by enforcing a four-phase process to uncover the true source of production bugs.

How do I stop fixing symptoms and start debugging root causes in test failures?

Stop fixing symptoms in test failures by following a phase-based workflow: investigate root causes, analyze patterns, test hypotheses, then implement. This discipline avoids brittle patches and resolves the underlying error.

Why does my debugging approach lead to recurring performance problems?

Recurring performance problems often result from symptom-focused fixes lacking defense-in-depth. Without root-cause tracing and multi-layer validation, initial patches fail to address the core issue.

Can I apply a systematic debugging workflow to any technical issue like performance problems?

Yes, systematic debugging applies to any technical issue including test failures, production bugs, and performance problems. The four-phase workflow uses systems-thinking to find root causes across various contexts.

What are the limitations of rushed debugging without pattern analysis?

Rushed debugging without pattern analysis leads to brittle patches and rework. It limits traceability and ignores anti-patterns, resulting in lower first-time pass rates and unresolved root causes.

How to use defense-in-depth instrumentation for root-cause tracing?

Use defense-in-depth instrumentation during the hypothesis and testing phase to add multi-layer validation. This provides traceability and ensures condition-based waiting reveals the true root cause.