systematic-debugging

Investigate root causes through a structured 4-phase debugging workflow.

1|Updated Apr 22, 2026
One-click install
npx skills add https://github.com/Herxinsasa/Skills-Collector --skill systematic-debugging-herxinsasa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/Herxinsasa/Skills-Collector/tree/main/superpowers/skills/systematic-debugging
Command: npx skills add https://github.com/Herxinsasa/Skills-Collector --skill systematic-debugging-herxinsasa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the wasted time and recurring defects caused by random, symptom-focused bug fixes that ignore underlying root causes, which often lead to hours of thrashing and new issues introduced by patchwork solutions.

Core Features & Use Cases

  • 4-Phase Systematic Workflow: Enforces a structured process of root cause investigation, pattern analysis, hypothesis testing, and controlled implementation to ensure bugs are fixed at the source.
  • Pressure-Resistant Guardrails: Includes explicit anti-shortcut language, red flag checks, and rationalization countermeasures to prevent cutting corners during emergencies or when quick fixes seem obvious.
  • Supporting Techniques: Provides actionable guidance for root cause tracing, defense-in-depth validation, and condition-based waiting to address common debugging challenges.
  • Use Cases: Ideal for test failure diagnosis, production incident response, performance issue troubleshooting, and any scenario where random fixes risk creating new bugs.

Quick Start

Use the systematic-debugging skill to investigate the root cause of the failing payment-processing test before proposing any fixes.

Frequently Asked Questions about systematic-debugging

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix recurring bugs caused by symptom-focused patches?

To fix recurring bugs, you must perform root cause analysis instead of applying symptom-focused patches. This involves a structured 4-phase workflow of evidence gathering, single-hypothesis testing, and multi-layer validation to eliminate the underlying defect for good.

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

The best way to debug production incidents under time pressure is to use pressure-resistant guardrails that enforce structured root cause investigation. This prevents rationalization and shortcutting, ensuring you resolve the actual issue without introducing new patchwork defects.

How do I debug failing tests without introducing new issues?

Debug failing tests by applying a systematic 4-phase workflow: trace the root cause, analyze patterns, test a single hypothesis, and implement controlled changes. This method uses defense-in-depth validation to ensure your bug fix does not create new integration errors.

When should I use systematic debugging for performance degradation?

You should use systematic debugging for performance degradation when obvious quick fixes tempt shortcutting or when random fixes risk creating new bugs. It enforces mandatory evidence gathering and condition-based waiting to identify the true source of the issue.

Does hypothesis testing work for complex integration errors?

Yes, single-hypothesis testing works for complex integration errors by isolating variables and validating each assumption with concrete evidence. This structured approach prevents the thrashing and wasted time commonly caused by random, untested bug fixes.