systematic-debugging

Apply a four-phase framework to identify and resolve technical bug root causes.

1|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/smrik/ai-fund --skill systematic-debugging-smrik
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/smrik/ai-fund/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/smrik/ai-fund --skill systematic-debugging-smrik

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This skill solves the common issue of wasting time on symptom-based patches and "guess-and-check" debugging, which often leads to new bugs and architectural debt.

Core Features & Use Cases

  • Root Cause Mandate: Enforces a strict four-phase process (Investigation, Pattern Analysis, Hypothesis, Implementation) to ensure the underlying issue is resolved.
  • Defense-in-Depth: Provides patterns for adding validation at multiple layers to make bugs structurally impossible.
  • Use Case: When a production API returns intermittent timeouts, use this skill to trace the data flow back to the source rather than simply adding a retry loop that masks the real problem.

Quick Start

Activate the systematic debugging skill to begin a structured investigation of the current test failure or production bug.

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

Systematic debugging resolves flaky tests by enforcing a rigorous four-phase framework: Investigation, Pattern Analysis, Hypothesis, and Implementation. This evidence-based process traces intermittent failures to their source, preventing symptom-based patches that mask the real problem.

What is the best way to debug intermittent production API timeouts?

The best way to debug intermittent production API timeouts is using a root-cause-first debugging framework to trace data flow back to the source. This structured investigation prevents masking the real problem with quick fixes like adding a retry loop.

How does a systematic debugging framework handle complex system troubleshooting?

A systematic debugging framework handles complex system troubleshooting through minimal hypothesis testing and pattern analysis. It mandates a strict process of evidence-based investigation before implementation, ensuring the underlying issue is resolved without architectural debt.

Can I use systematic debugging to stop recurring architectural debt from guess-and-check fixes?

Yes, systematic debugging stops architectural debt from guess-and-check fixes by mandating root cause identification through a four-phase process. It provides defense-in-depth patterns that add validation at multiple layers to make bugs structurally impossible.

What are the limitations of using a root cause mandate for troubleshooting test failures?

The limitation of a strict root cause mandate for troubleshooting test failures is that it requires rigorous adherence to evidence-based investigation and multi-layer validation strategies, which demands more time upfront compared to applying quick symptom-based patches.