systematic-debugging

Debug software issues through four phases of root-cause investigation and testing.

Updated May 4, 2026
One-click install
npx skills add https://github.com/Ab0umar/SRV100_Acc --skill systematic-debugging-ab0umar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/Ab0umar/SRV100_Acc/tree/main/.codex/plugins/cache/openai-curated/superpowers/dc902811/skills/systematic-debugging
Command: npx skills add https://github.com/Ab0umar/SRV100_Acc --skill systematic-debugging-ab0umar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Root-cause debugging for software issues is solved by a four-phase, systematic process that ensures you investigate core causes before applying fixes.

Core Features & Use Cases

  • Phase 1: Root Cause Investigation
  • Phase 2: Pattern Analysis
  • Phase 3: Hypothesis and Testing
  • Phase 4: Implementation
  • Defensive patterns: defense-in-depth, root-cause tracing, and stacking validations

Quick Start

Follow Phase 1 to begin root-cause investigation, reproduce the issue, and gather evidence 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 root-cause debugging and when should I use it?

Systematic root-cause debugging follows four phases: gather evidence, analyze patterns, formulate hypotheses, and test those hypotheses before implementing fixes. This sequencing ensures you verify the root cause through evidence rather than applying immediate symptom patches.

How do I start a root-cause investigation for a flaky test failure?

Start root-cause investigation by reproducing the issue and gathering evidence before proposing fixes. Phase 1 requires explicit sequencing where you collect observable data and trace the root cause, ensuring you avoid jumping straight to symptom resolution.

What is the best way to debug production incidents without fixing symptoms?

The best way to debug production incidents is applying a four-phase process with defense-in-depth guardrails. This approach enforces explicit Phase 1–4 sequencing, ensuring you investigate core causes and stack validations for durable resolutions.

Does hypothesis testing work for fixing software regressions?

Yes, hypothesis testing works for fixing software regressions by formulating and testing hypotheses in Phase 3 before implementing fixes. This systematic process ensures you verify the exact root cause through evidence rather than applying speculative patches.

When should I not use systematic debugging for an issue?

You should not use systematic debugging when a rapid, temporary symptom fix is urgently required to restore service. The four-phase process enforces explicit sequencing and defense-in-depth practices, which prioritize durable root-cause resolution over immediate patching.