systematic-debugging

Identify and resolve technical issues through a four-phase debugging framework.

Updated Nov 3, 2016
One-click install
npx skills add https://github.com/xleliberty/mydotfiles --skill systematic-debugging-xleliberty
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/xleliberty/mydotfiles/tree/main/.config/.claude/plugins/cache/claude-plugins-official/superpowers/5.0.7/skills/systematic-debugging
Command: npx skills add https://github.com/xleliberty/mydotfiles --skill systematic-debugging-xleliberty

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This skill eliminates the cycle of random, ineffective patches and symptom-masking fixes that lead to technical debt and recurring bugs.

Core Features & Use Cases

  • Four-Phase Framework: Enforces a rigorous process of investigation, pattern analysis, hypothesis testing, and implementation.
  • Anti-Shortcut Guardrails: Explicitly identifies and prevents common rationalizations like "I'll just add one quick fix" or "I'm in a hurry."
  • Use Case: When a production API fails or a test suite becomes flaky, use this skill to trace the error back to its original trigger rather than applying superficial workarounds.

Quick Start

Load the systematic debugging skill to begin a structured investigation of the current bug or test failure.

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 software troubleshooting?

Systematic debugging is a rigorous four-phase framework for resolving technical issues. You need it when facing software debugging, test failure analysis, or system performance troubleshooting to identify root causes rather than applying superficial symptom-based patching.

How do I trace a test failure back to its original trigger without guessing?

To trace a test failure, apply the four-phase framework of investigation, pattern analysis, hypothesis testing, and implementation. This enforces evidence-based hypothesis testing and architectural validation to find the original trigger instead of using random patches.

What's the best way to stop recurring bugs and technical debt from quick fixes?

The best way to stop recurring bugs is using anti-shortcut guardrails that prevent rationalizations like adding quick fixes. This enforces evidence-based hypothesis testing and architectural validation to eliminate symptom-masking fixes and technical debt.

Can I use this systematic troubleshooting framework for production API failures?

Yes, you can use this framework for production API failures. It applies to software debugging, test failure analysis, and system performance troubleshooting, tracing errors back to their original trigger rather than applying superficial workarounds.

How do I prevent symptom-based patching when I am in a hurry to fix a bug?

To prevent symptom-based patching when in a hurry, the framework explicitly identifies and blocks common rationalizations like being in a hurry. It requires adherence to systematic investigation and evidence-based hypothesis testing to ensure proper root cause resolution.