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.