systematic-debugging

Identify root causes in software bugs using a four-phase investigation framework.

21|2|Updated Oct 26, 2025
One-click install
npx skills add https://github.com/amrhas82/agentic-toolkit --skill systematic-debugging-amrhas82
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/amrhas82/agentic-toolkit/tree/main/ai/subagents/claude/skills/systematic-debugging
Command: npx skills add https://github.com/amrhas82/agentic-toolkit --skill systematic-debugging-amrhas82

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents wasted time and new bugs caused by random fixes and quick patches. It provides a structured, four-phase framework to ensure you always find the root cause of any technical issue before attempting solutions, saving hours of "thrashing" and ensuring lasting fixes.

Core Features & Use Cases

  • Four-Phase Framework: Guides you through Root Cause Investigation, Pattern Analysis, Hypothesis Testing, and Implementation, ensuring a thorough and efficient approach to problem-solving.
  • Anti-Rationalization Defenses: Explicitly counters common excuses for skipping steps, keeping you on track even under intense time pressure or when a "quick fix" seems obvious.
  • Use Case: When a critical production bug occurs, use this skill to systematically diagnose the issue, gather evidence across multiple components, and implement a verified fix, rather than guessing and potentially introducing new problems.

Quick Start

I've encountered an unexpected error in the 'payment-gateway' service. Use the systematic-debugging skill to help me find the root cause.

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 patching symptoms?

Root cause analysis requires a structured investigation framework. Systematic debugging applies a four-phase approach—Root Cause Investigation, Pattern Analysis, Hypothesis Testing, and Implementation—to identify the actual problem before attempting fixes, preventing wasted effort on symptoms and ensuring lasting solutions.

What's the best way to debug a production failure systematically?

Follow a disciplined debugging process: gather complete evidence during investigation, document reproducible steps, instrument diagnostics across components, test hypotheses against facts, and verify the fix resolves the actual issue. This prevents guessing and introducing new bugs under time pressure.

Why do quick bug fixes often create new problems?

Random patches target visible symptoms rather than underlying causes. Systematic debugging enforces evidence-based problem-solving through a complete investigation phase before proposing changes, reducing rework and secondary failures caused by incomplete fixes.

How do I avoid wasting time thrashing on the wrong solution?

Anti-rationalization defenses in systematic debugging counter common excuses for skipping investigation steps. The framework keeps you on track by requiring reproducible steps, diagnostic instrumentation, and validated verification—eliminating guesswork even under deadline pressure.

Can I use this debugging approach for unexpected failures across multiple services?

Yes. Systematic debugging gathers evidence across multiple components to identify where failure originates. The four-phase framework handles complex interactions by enforcing thorough pattern analysis and hypothesis testing before implementing fixes.

Related Skills