systematic-debugging

Apply a four-phase framework to identify and resolve root causes of technical issues.

7|1|Updated Mar 15, 2017
One-click install
npx skills add https://github.com/Henquewl/Hunter-X-Hunter-Greed-Island-MUD --skill systematic-debugging-henquewl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/Henquewl/Hunter-X-Hunter-Greed-Island-MUD/tree/main/.opencode/skills/superpowers/skills/systematic-debugging
Command: npx skills add https://github.com/Henquewl/Hunter-X-Hunter-Greed-Island-MUD --skill systematic-debugging-henquewl

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 patches and symptom-masking fixes by enforcing a disciplined, four-phase investigation process that ensures the actual root cause is identified and resolved.

Core Features & Use Cases

  • Four-Phase Framework: Guides you through Root Cause Investigation, Pattern Analysis, Hypothesis Testing, and Implementation.
  • Anti-Shortcut Mandates: Explicitly identifies and blocks common rationalizations like "quick fix for now" or "just one more try."
  • Use Case: When a production API returns intermittent timeouts, use this skill to trace the data flow and identify the architectural bottleneck rather than simply adding a retry loop that masks the underlying issue.

Quick Start

Load the systematic-debugging skill and follow the Phase 1 checklist to begin a rigorous investigation of the current bug.

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 intermittent test failures instead of just masking the symptoms?

To find the root cause of test failures, you need a systematic debugging framework that enforces a four-phase investigation: Root Cause Investigation, Pattern Analysis, Hypothesis Testing, and Implementation. This structured approach prevents guess-and-check methods and symptom-masking fixes.

What is the best way to debug software engineering issues when random patches are not working?

The best way to debug software engineering issues when random patches fail is to use an evidence-based root-cause-first framework. This method applies strict investigation protocols and architectural validation to identify the actual bottleneck, blocking common rationalizations like quick fixes.

How do I systematically troubleshoot a production API returning intermittent timeouts?

To systematically troubleshoot production API timeouts, apply a structured debugging framework to trace the data flow and identify architectural bottlenecks. This prevents simply adding a retry loop that masks the underlying issue, ensuring the actual root cause is resolved.

Can I use a systematic debugging method to stop developers from using quick fixes for now?

Yes, you can use a systematic debugging method that includes anti-shortcut mandates to explicitly block quick fixes. It enforces a disciplined investigation process requiring evidence-based hypothesis testing and architectural validation before implementation.

When should I use a root cause investigation framework for software troubleshooting?

You should use a root cause investigation framework for software troubleshooting when guess-and-check methods are ineffective. It is specifically designed for resolving software development bugs, test failures, and system performance problems where identifying the actual root cause is critical.

Does systematic debugging work for resolving system performance problems and architectural bottlenecks?

Yes, systematic debugging works for resolving system performance problems and architectural bottlenecks. It guides you through pattern analysis and architectural validation to ensure the actual root cause of technical issues is identified and resolved.