systematic-debugging

Enforce root-cause investigation before implementing fixes for software issues.

Updated Apr 18, 2026
One-click install
npx skills add https://github.com/sachio222/based-stack --skill systematic-debugging-sachio222
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/sachio222/based-stack/tree/main/systematic-debugging
Command: npx skills add https://github.com/sachio222/based-stack --skill systematic-debugging-sachio222

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging helps teams avoid wasted time by enforcing root-cause investigation before proposing fixes, reducing rework and time-to-resolution.

Core Features & Use Cases

  • Four-phase framework with explicit rules to prevent shortcut fixes.
  • Guidance on root-cause tracing, pattern analysis, hypothesis testing, and controlled implementation.
  • Integrated defense-in-depth practices and anti-patterns to resist time-pressure rationalization.

Quick Start

Begin with Phase 1: Root Cause Investigation before proposing any fix.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is root-cause debugging and how does it fix underlying software issues?

Root-cause debugging enforces identifying underlying issues before applying fixes, preventing recurring symptoms. It requires completing investigation, pattern analysis, hypothesis testing, and implementation phases.

How do I systematically debug production incidents and test failures?

Systematically debug production incidents and test failures by following four phases: root cause investigation, pattern analysis, hypothesis testing, and controlled implementation, ensuring no fixes occur without prior investigation.

Why do my bug fixes keep failing under time pressure during integration issues?

Bug fixes fail under time pressure when shortcut fixes bypass root-cause investigation. Defense-in-depth practices and anti-patterns resist this rationalization, enforcing proper hypothesis testing before implementation.

What's the best way to trace the root cause of performance issues across software systems?

The best way to trace root causes of performance issues is following a structured framework mandating pattern analysis and hypothesis testing before implementation, preventing superficial symptom patches.

Can I apply systematic debugging to performance and integration issues across any software system?

Yes, systematic debugging applies to bugs, test failures, production incidents, and performance or integration issues across software systems, requiring root cause investigation before any fixes.

When should I avoid shortcut fixes during software incident investigation?

Avoid shortcut fixes whenever time pressure tempts immediate patches without investigation. The mandatory rule requires no fixes without root cause investigation first, preventing wasted time and rework.