systematic-debugging

Guide software defect debugging through a four-phase root cause analysis process.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill prevents time wasted on ineffective "quick fixes" by enforcing a structured, root-cause-focused debugging process, ensuring long-term stability and reducing future issues.

Core Features & Use Cases

  • Systematic Four-Phase Process: Guides users through Investigation, Pattern Analysis, Hypothesis, and Implementation.
  • Root Cause Mandate: Prioritizes identifying the fundamental issue over addressing immediate symptoms.
  • Pressure Resistance: Includes specific language and rules to counteract rationalizations made under time pressure.
  • Use Case: When a critical API endpoint starts returning errors, instead of immediately trying to restart the service or add a quick patch, use this Skill to systematically trace the error back to its origin, preventing recurring outages.

Quick Start

Use the systematic-debugging skill when encountering any bug or unexpected behavior before proposing fixes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is a systematic debugging process for finding root causes of software defects?

A systematic debugging process enforces a structured four-phase approach—Investigation, Pattern Analysis, Hypothesis, and Implementation—to trace software defects back to their fundamental root cause rather than applying quick symptom fixes.

How do I stop fixing symptoms and find the actual root cause of a bug?

To find the actual root cause of a bug, follow a structured debugging process that prioritizes investigation and pattern analysis over immediate patches, using specific rules to resist time pressure and rationalizations that lead to recurring outages.

How do I troubleshoot a production bug or critical API endpoint returning errors?

Troubleshoot a production bug by systematically tracing the error back to its origin through hypothesis formation and controlled implementation, preventing recurring outages by avoiding immediate service restarts or quick patches.

Can I use a systematic debugging approach for test failures and performance problems?

Yes, a systematic debugging approach supports investigating various technical issues including test failures, production bugs, and performance problems by enforcing pattern analysis and hypothesis formation before implementing fixes.

What is the best way to fix bugs under time pressure without causing recurring issues?

The best way to fix bugs under time pressure is to apply pressure-resistance rules that enforce a root cause mandate, ensuring you complete investigation and hypothesis phases before implementing controlled fixes to ensure long-term stability.

When should I avoid quick patches during error resolution?

You should avoid quick patches during error resolution whenever you face critical API failures or unexpected behavior, as symptom-fixing wastes time and increases future issues compared to identifying the fundamental defect.