systematic-debugging

Implement a four-phase debugging workflow requiring root-cause investigation before fixes.

Updated Feb 11, 2016
One-click install
npx skills add https://github.com/Ehrax/dotfiles --skill systematic-debugging-ehrax
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/Ehrax/dotfiles/tree/main/configs/agents/skills/systematic-debugging
Command: npx skills add https://github.com/Ehrax/dotfiles --skill systematic-debugging-ehrax

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a disciplined, four-phase debugging framework to ensure root-cause investigation is completed before proposing fixes.

Core Features & Use Cases

  • Four-phase lifecycle: Phase 1 Root Cause Investigation, Phase 2 Pattern Analysis, Phase 3 Hypothesis and Testing, Phase 4 Implementation.
  • Phase-by-phase guardrails: never skip Phase 1, explicit failure modes, and anti-pattern identification.
  • Defensive practices: root-cause tracing, defense-in-depth validation, and guided testing to verify fixes.
  • Real-world applicability: debugging flaky tests, production incidents, and complex systems with multi-component interactions.

Quick Start

Read the skill and start with Phase 1 checklist before attempting any fix.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is a systematic debugging workflow for finding root causes?

A systematic debugging workflow enforces root-cause investigation through a four-phase lifecycle: root cause investigation, pattern analysis, hypothesis testing, and implementation. It prevents quick fixes by requiring data-flow tracing before applying any code changes.

How do I debug flaky tests and production incidents without quick fixes?

To debug flaky tests and production incidents, apply phase-by-phase guardrails starting with explicit root-cause investigation. Identify failure modes and anti-patterns, then validate fixes using defense-in-depth testing to ensure reliable outcomes.

What is the best way to trace unexpected behavior in complex systems?

The best way to trace unexpected behavior in complex systems is disciplined data-flow tracing. This process maps multi-component interactions to identify exact failure points, ensuring you analyze patterns and test hypotheses before implementation.

Can I use a defense-in-depth approach for software debugging?

Yes, you can use a defense-in-depth approach for software debugging by validating fixes through guided testing. It ensures measurable debugging outcomes by verifying that the root-cause fix holds against multi-component interactions and edge cases.

Why should I not skip root-cause investigation before proposing fixes?

Skipping root-cause investigation leads to anti-patterns and incomplete fixes. The debugging workflow imposes strict phase completion requirements, ensuring you identify the true failure mode and verify measurable outcomes before implementing changes.