systematic-debugging

Enforce root-cause investigation before proposing fixes in debugging workflows.

Updated May 7, 2026
One-click install
npx skills add https://github.com/TumeloRamaphosa/StudEx-Valley-OS --skill systematic-debugging-tumeloramaphosa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/TumeloRamaphosa/StudEx-Valley-OS/tree/main/.claude/skills/superpowers/skills/systematic-debugging
Command: npx skills add https://github.com/TumeloRamaphosa/StudEx-Valley-OS --skill systematic-debugging-tumeloramaphosa

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

Prevents wasted time and new bugs by forcing a disciplined root-cause investigation before any proposed fixes.

Core Features & Use Cases

  • Four-phase workflow: Root Cause Investigation → Pattern Analysis → Hypothesis & Testing → Implementation.
  • Root-cause mandate: Enforces the “no fixes without root cause” rule, explicitly blocking symptom patching.
  • Pressure-resistant debugging: Adds anti-shortcut behavior for emergencies, repeated failures, and time pressure.
  • Failure handling: When a fix fails, it mandates re-analysis up to 2 failures and then requires architectural questioning.
  • Supporting techniques: Uses companion guidance like backward tracing, defense-in-depth validation, and condition-based waiting.

Quick Start

Ask your AI to apply systematic debugging to your failing test by reading errors, reproducing reliably, tracing data flow, and only then proposing a single root-cause fix with a minimal failing test.

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 flaky test failures instead of just patching symptoms?

To find the root cause of flaky test failures, you must complete a four-phase workflow: investigation, pattern analysis, single-hypothesis testing, and root-cause implementation. This enforces a strict mandate against symptom patching before verifying the actual issue.

What is the best way to debug production bugs and unexpected behavior under time pressure?

Debugging production bugs under time pressure requires a pressure-resistant approach that blocks shortcuts. You should trace data flow backward, test a single hypothesis, and mandate re-analysis or architectural review if repeated fixes fail to resolve the unexpected behavior.

How do I stop repeated fixes from failing when debugging build failures or integration problems?

To stop repeated fixes from failing on build failures or integration problems, enforce re-analysis after up to two failed attempts. If fixes still fail, you must escalate to an architectural review to question the foundational design.

When should I perform an architecture review during root cause investigation?

You should perform an architecture review during root cause investigation after repeated fixes fail. The systematic debugging process mandates architectural questioning when implementation attempts exceed two failures, ensuring deeper structural issues are addressed.

How does systematic hypothesis testing work for resolving performance issues?

Hypothesis testing for performance issues works by isolating a single proposed root cause and validating it with a minimal failing test. You trace data flow and apply defense-in-depth validation before implementing any actual code fixes.

Does backward tracing and condition-based waiting work for reproducing test failures?

Yes, backward tracing and condition-based waiting are companion techniques used to reliably reproduce test failures. They support the investigation phase by tracing data flow backwards and waiting for specific states before proposing a root-cause fix.