systematic-debugging

Apply a four-phase framework to identify and resolve technical bugs.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/gaganpasupuleti/Resume-Matcher --skill systematic-debugging-gaganpasupuleti
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/gaganpasupuleti/Resume-Matcher/tree/main/.claude/skills/systematic-debugging
Command: npx skills add https://github.com/gaganpasupuleti/Resume-Matcher --skill systematic-debugging-gaganpasupuleti

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill prevents the common trap of wasting time on random, ineffective fixes that mask symptoms rather than solving the underlying issue.

Core Features & Use Cases

  • Four-Phase Framework: Guides you through investigation, pattern analysis, hypothesis testing, and implementation.
  • Anti-Pattern Detection: Explicitly identifies and stops you from using "quick fixes" or "shotgun debugging" under pressure.
  • Use Case: When a production API starts failing intermittently, use this skill to trace the data flow and identify the specific component boundary causing the timeout, rather than blindly adding retry logic.

Quick Start

Load the systematic debugging skill to begin a structured investigation of the current test failure or bug.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is a systematic approach to debugging complex software bugs?

Systematic debugging uses a rigorous, root-cause-first framework with four phases: investigation, pattern analysis, hypothesis testing, and implementation, applying strict evidence-gathering protocols to identify and resolve technical bugs rather than masking symptoms.

How do I find the root cause of intermittent production API failures?

To resolve intermittent production API failures, trace the data flow through system components to identify the specific boundary causing the timeout, applying hypothesis testing and architectural validation rather than blindly adding retry logic.

How do I stop shotgun debugging and quick fixes when troubleshooting test failures?

Stop shotgun debugging by applying anti-pattern detection to explicitly prevent random fixes under pressure, enforcing a structured investigation framework that requires evidence-gathering and hypothesis-testing before implementation.

Can I use a systematic debugging framework for resolving flaky tests?

Yes, the systematic debugging framework applies directly to flaky test resolution by guiding you through pattern analysis and architectural validation to isolate the root cause of test failures instead of applying temporary patches.

What is the best way to investigate a production incident response?

The best way to handle production incident response is following a four-phase framework that prioritizes evidence-gathering and hypothesis testing, ensuring you validate the root cause across component boundaries before implementing a fix.

When should I not use quick fixes during system troubleshooting?

You should never use quick fixes during system troubleshooting when dealing with complex bugs or flaky tests, as they mask symptoms; instead, apply strict architectural validation protocols to resolve the underlying root cause.