systematic-debugging

Traces symptoms to identify and fix the underlying root cause of failures.

1|Updated Jan 7, 2026
One-click install
npx skills add https://github.com/adamatdevops/forge-works --skill systematic-debugging-adamatdevops
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/adamatdevops/forge-works/tree/main/.skills/obra/systematic-debugging
Command: npx skills add https://github.com/adamatdevops/forge-works --skill systematic-debugging-adamatdevops

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

It prevents wasted time and recurring bugs by forcing you to locate the true root cause instead of applying symptom-based fixes.

Core Features & Use Cases

  • Four-phase debugging workflow (Root Cause Investigation → Pattern Analysis → Hypothesis & Testing → Implementation) with explicit rules that block premature fixing.
  • Pressure-resistant decision making, including “STOP and re-analyze” guidance when fixes fail or you feel tempted to ship quickly.
  • Evidence-driven debugging for multi-component systems, adding instrumentation and tracing data flow across boundaries before proposing fixes.
  • Use cases: test failures, production bugs, unexpected behavior, performance problems, build failures, and integration issues—especially under time pressure or after previous fixes didn’t work.

Quick Start

Ask an AI to help you apply the four phases to your error by first reading the exact error messages, then reproducing consistently, then tracing back to the triggering cause, and only afterward proposing a single minimal root-cause fix.

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 test failures instead of just patching symptoms?

Finding the root cause of test failures requires tracing symptoms back to the original trigger by consistently reproducing the error, analyzing data flow across component boundaries, and fixing at the source. This prevents recurring bugs from symptom-based fixes.

What is the best way to debug production incidents under time pressure?

Debugging production incidents under time pressure requires a pressure-resistant, four-phase workflow: root cause investigation, pattern analysis, single-hypothesis minimal testing, and root-cause-only implementation. It enforces strict stop conditions to re-analyze when repeated fixes fail.

How do I trace data flow across multi-component systems to resolve integration problems?

To trace data flow across multi-component systems for integration problems, add instrumentation to trace evidence across boundaries before proposing fixes. This evidence-driven debugging approach ensures you identify the true triggering cause rather than guessing at symptoms.

Why does my fix keep failing and how do I stop applying patches that don't work?

Fixes keep failing when you patch symptoms instead of locating the true root cause. You stop recurring bugs by enforcing a strict stop condition after repeated failures, forcing you to re-analyze the problem and trace back to the original trigger before implementing any new fix.

Can I use systematic debugging for build failures and performance issues?

Yes, you can use systematic debugging for build failures and performance issues. The four-phase workflow applies to any technical failure including unexpected behavior and integration problems, requiring you to complete root-cause investigation before progressing to hypothesis testing and implementation.