systematic-debugging

Enforce root-cause investigation before fixes across four debugging phases.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/ilderaj/superpowering-with-files --skill systematic-debugging-ilderaj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/ilderaj/superpowering-with-files/tree/main/harness/upstream/superpowers/skills/systematic-debugging
Command: npx skills add https://github.com/ilderaj/superpowering-with-files --skill systematic-debugging-ilderaj

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging enforces a disciplined, four-phase workflow to ensure root-cause analysis before any code changes, preventing symptom-focused fixes.

Core Features & Use Cases

  • Phase-driven approach: Root Cause Investigation, Pattern Analysis, Hypothesis Testing, and Implementation with explicit stop rules.
  • Defense-in-depth mindset: validate data across entry, business, environment, and debugging context.
  • Real-world applicability: handles common software bugs, test failures, and production incidents with auditable traces.

Quick Start

Load the skill and begin with Phase 1: Root Cause Investigation, completing all four phases 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 systematic debugging and when do I need it for production incidents?

Systematic debugging is a disciplined, four-phase workflow enforcing root-cause investigation before any code changes. You need it for production incidents, test failures, and performance issues to prevent symptom-level fixes and ensure auditable traces.

How do I find the root cause of a bug before applying a fix?

To find the root cause of a bug, begin with Phase 1: Root Cause Investigation, then proceed through Pattern Analysis, Hypothesis Testing, and Implementation. You must complete all four phases in order before proposing fixes to ensure true root-cause resolution.

Does systematic debugging work for both software bugs and test failures?

Yes, systematic debugging works for software bugs, test failures, production incidents, and performance issues. It applies a defense-in-depth mindset to validate data across entry, business, environment, and debugging contexts for comprehensive issue resolution.

What's the best way to stop applying symptom-level fixes to software bugs?

The best way to stop symptom-level fixes is to enforce a root-cause investigation workflow with explicit stop rules. Systematic debugging mandates completing Phase 1 before any fixes, ensuring you trace the actual problem origin before modifying code.

Can I skip the root cause investigation phase if I already know the bug fix?

No, you cannot skip the root cause investigation phase. The systematic debugging workflow requires completing all four phases in order, with Phase 1 mandatory before fixes, to maintain a defense-in-depth validation approach and prevent incomplete resolutions.