systematic-debugging

Trace root causes of bugs and test failures before proposing fixes.

1|Updated Apr 27, 2026
One-click install
npx skills add https://github.com/darkmatter/skills --skill systematic-debugging-darkmatter
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/darkmatter/skills/tree/main/docs/00-inbox/skills/systematic-debugging
Command: npx skills add https://github.com/darkmatter/skills --skill systematic-debugging-darkmatter

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents guess-and-check debugging by forcing a root-cause-first approach for bugs, test failures, performance issues, and unexpected behavior.

Core Features & Use Cases

  • Root Cause Investigation: Read errors carefully, reproduce issues reliably, review recent changes, and trace data flow back to the original trigger.
  • Pattern Analysis and Hypothesis Testing: Compare against working examples, form a single specific hypothesis, and test the smallest possible change.
  • Safe Implementation: Create a failing test, apply one fix at a time, verify the result, and escalate to architectural review after repeated failures.
  • Use Case: When a flaky test or production incident tempts you toward a quick patch, this Skill keeps you from masking symptoms and helps you fix the real source.

Quick Start

Use the systematic-debugging skill to investigate this issue from root cause to verified fix before suggesting any solution.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
How do I find the root cause of flaky test failures instead of guessing?▼

To find the root cause of flaky test failures, you must establish consistent reproduction, trace data flow backwards to the original trigger, and form a single specific hypothesis before changing code.

What is the best way to debug production incidents in multi-component systems?▼

The best way to debug production incidents in multi-component systems is gathering evidence, analyzing patterns against working examples, and tracing data flow back to the original trigger before proposing any fix.

Why should I create a failing test before applying a bug fix?▼

You should create a failing test before applying a bug fix to validate the root cause hypothesis and confirm that your single-variable change resolves the exact issue durably.

How do I troubleshoot build failures and integration issues systematically?▼

To troubleshoot build failures and integration issues systematically, review recent changes, compare against working examples, and apply one minimal fix at a time while escalating to architectural review after repeated failures.

When should I escalate debugging to an architectural review?▼

You should escalate debugging to an architectural review after repeated single-variable fixes fail to resolve the issue, indicating a deeper structural problem rather than a simple bug.

Does systematic debugging work for performance issues and unexpected behavior?▼

Yes, systematic debugging works for performance issues and unexpected behavior by applying layered validation, pattern analysis, and hypothesis testing to trace the root cause before any solution is implemented.