systematic-debugging

Enforce a reproducible debugging workflow that isolates root causes before fixes.

124|22|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/tmdgusya/engineering-discipline --skill systematic-debugging-tmdgusya
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/tmdgusya/engineering-discipline/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/tmdgusya/engineering-discipline --skill systematic-debugging-tmdgusya

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic Debugging enforces a disciplined debugging workflow that prevents guessing by requiring reproduction-first, root-cause-first, and failing-test-first steps before applying fixes.

Core Features & Use Cases

  • Seven-phase process: Define the Problem, Reproduce, Gather Evidence, Isolate Root Cause, Lock the Failure, Implement a Single Fix, and Verify.
  • Comprehensive documentation and evidence capture at every phase to improve traceability and collaboration.
  • Suitable for bugs, flaky tests, and unexpected behavior across development, testing, and CI pipelines.

Quick Start

Define the problem, reproduce it using the defined steps, capture evidence, formulate a single root-cause hypothesis, lock the failure with a guard, implement a minimal fix, and verify across the path.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is a reproducible debugging workflow for isolating root causes?

A reproducible debugging workflow enforces problem definition, reproduction, and evidence gathering to isolate root causes before applying fixes. It stops guesswork by requiring a failing-guard and automated verification.

How do I fix flaky tests using root-cause isolation?

To fix flaky tests using root-cause isolation, define the problem, reproduce the failure, gather evidence, and formulate a single root-cause hypothesis. Lock the failure with a guard, implement a minimal fix, and verify with automated tests.

What is the best way to stop guesswork when fixing unexpected behavior in CI?

The best way to stop guesswork when fixing unexpected behavior in CI is enforcing a systematic debugging workflow. This requires documenting a problem statement, a single root-cause hypothesis, a failing-guard, a minimal fix, and post-fix verification.

Can I use systematic debugging for any bug across development and CI pipelines?

Yes, you can use systematic debugging for any bug, flaky test, or unexpected behavior across development and CI pipelines. It guides teams through a seven-phase process from problem definition to post-fix verification without dependencies.

Why do I need a failing-guard before applying a minimal fix to a bug?

You need a failing-guard before applying a minimal fix to lock the failure and ensure your root-cause hypothesis is correct. This locked failure verifies that your automated test catches the bug before you implement the actual fix.

How to document evidence during software debugging to improve traceability?

To document evidence during software debugging, capture comprehensive data at every phase of the workflow including problem definition, reproduction, and root-cause isolation. This evidence capture improves traceability and team collaboration.