systematic-debugging

Enforce root-cause investigation across four debugging phases.

3|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/idiaz01/enterprise-superpowers --skill systematic-debugging-idiaz01
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/idiaz01/enterprise-superpowers/tree/main/content/skills/systematic-debugging
Command: npx skills add https://github.com/idiaz01/enterprise-superpowers --skill systematic-debugging-idiaz01

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Random fixes waste time and create new bugs. Quick patches mask underlying issues. Core principle: ALWAYS find root cause before attempting fixes. Violating the letter of this process is violating the spirit of debugging.

Core Features & Use Cases

The skill enforces a four-phase process (Phase 1: Root Cause Investigation; Phase 2: Pattern Analysis; Phase 3: Hypothesis and Testing; Phase 4: Implementation) and includes explicit anti-patterns to prevent shortcuts. It guides you through collecting evidence, tracing data flow, validating across multiple layers, and documenting failures to ensure robust fixes.

Quick Start

Run the skill by loading skills/debugging/systematic-debugging and follow Phase 1 through Phase 4 before applying any changes.

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 bug instead of just patching symptoms?

To find the root cause of a bug, you must enforce a systematic investigation process across four phases: evidence collection, pattern analysis, hypothesis testing, and implementation. This prevents quick patches from masking underlying issues.

What is the best way to debug production failures under time pressure?

The best way to debug production failures under pressure is following a structured four-phase methodology that enforces root-cause investigation before attempting fixes, applying defense-in-depth guidance to ensure robust resolutions without introducing new errors.

How do I systematically trace data flow to resolve technical issues?

You systematically trace data flow during the pattern analysis phase by collecting evidence across multiple layers, validating hypotheses, and documenting failures to ensure your technical issue resolution addresses the actual fault.

What are common debugging anti-patterns that create new bugs?

Common debugging anti-patterns include applying random fixes and quick patches without finding the root cause. These shortcuts waste time, mask underlying issues, and often create new bugs by violating the systematic debugging process.

When should I not use a systematic debugging approach?

You should not bypass systematic debugging when facing any technical issue across development, testing, or production. Violating the root-cause investigation process, even under extreme time pressure, risks masking underlying issues with ineffective quick patches.