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.