systematic-debugging

Enforce a four-phase process for root-cause debugging before proposing fixes.

20|1|Updated Dec 10, 2025
One-click install
npx skills add https://github.com/galangryandana/superpowers-for-my-own-workflow --skill systematic-debugging-galangryandana
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/galangryandana/superpowers-for-my-own-workflow/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/galangryandana/superpowers-for-my-own-workflow --skill systematic-debugging-galangryandana

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Random fixes waste time and create new bugs. This Skill enforces a four-phase process to identify and fix root causes rather than symptoms.

Core Features & Use Cases

  • Four-phase debugging workflow: Phase 1 (Root Cause Investigation), Phase 2 (Pattern Analysis), Phase 3 (Hypothesis & Testing), Phase 4 (Implementation) with mandatory completion before fixes.
  • Anti-patterns and defenses: stop guidance against rushing to solutions and promote defense-in-depth across layers.
  • Practical use: for bugs, test failures, performance issues, and integration problems.

Quick Start

Load the skill, read the overview, and follow Phase 1 checklists. Do not skip steps; refer to the defense-in-depth and root-cause-tracing references when needed. Then progress through Phases 1–4 and verify outcomes before claiming resolution.

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 fixing symptoms?

Root-cause debugging stops random fixes by enforcing a four-phase workflow: Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, and Implementation. You must complete each phase sequentially, gathering evidence before proposing any code fixes.

Why do my random bug fixes keep creating new problems?

Random fixes waste time and create new bugs because they bypass root-cause analysis. Applying a structured four-phase debugging process prevents rushing to solutions, ensuring you gather evidence and verify hypotheses before implementation to avoid regressions.

What is the best way to debug test failures and performance issues systematically?

Systematically debug test failures and performance issues by following a four-phase workflow: investigate root causes, analyze patterns, test hypotheses, and implement fixes. This structured approach ensures you verify evidence before applying solutions.

Can I skip the investigation phase and jump straight to fixing a bug?

No, you cannot skip the investigation phase. The debugging workflow mandates completing Phase 1, Root Cause Investigation, before proposing any fixes. Skipping this evidence-gathering step leads to patching symptoms rather than resolving the true source of the issue.

How does the hypothesis testing phase work in technical problem solving?

The hypothesis testing phase works by enforcing evidence-based verification before implementation. In technical problem solving, you formulate a hypothesis about the root cause, test it against gathered evidence, and only proceed to implementation fixes after confirming the hypothesis.