systematic-debugging

Guide debugging cycles through reproduce, isolate, hypothesize, verify, and fix.

3|Updated Feb 9, 2026
One-click install
npx skills add https://github.com/marcus-friction/agents --skill systematic-debugging-marcus-friction
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/marcus-friction/agents/tree/main/.agent/skills/systematic-debugging
Command: npx skills add https://github.com/marcus-friction/agents --skill systematic-debugging-marcus-friction

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured debugging framework that guides teams through reproducibility, isolation, hypothesis, verification, and focused fixes to reduce cycle time.

Core Features & Use Cases

  • Reproduce: Create reliable reproductions with exact steps and minimal state.
  • Isolate & Hypothesize: Systematically narrow the root cause using binary search, boundary checks, and data inspection.
  • Verify & Fix: Validate hypotheses with targeted checks before implementing a precise fix.
  • Use Case: When debugging a flaky API, ensure consistent reproduction, isolate the failing layer, and apply a minimal change with tests.

Quick Start

Reproduce the bug, isolate the root cause, hypothesize a fix, verify with tests, and implement a minimal solution.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
How do I debug hard-to-reproduce issues across a large codebase?

Systematic debugging reduces cycle time by guiding teams through reproduce, isolate, hypothesize, verify, and fix cycles. It establishes repeatable guardrails to systematically narrow the root cause using boundary checks and data inspection.

What is the best way to systematically isolate a root cause in software?

The best way to isolate a root cause is using binary search, boundary checks, and data inspection to systematically narrow down the failing layer. This ensures hypotheses are validated with targeted checks before a fix is applied.

How do I create reliable reproductions for flaky API bugs?

To create reliable reproductions for flaky API bugs, establish exact reproduction steps with minimal state. Consistent reproduction allows you to isolate the failing layer and apply a minimal change with tests to verify the fix.

Can I integrate a structured debugging process into existing CI/CD pipelines?

Yes, structured debugging can be integrated into existing CI/CD pipelines and code-review processes. It establishes repeatable guardrails that guide teams through reproducibility, isolation, hypothesis, verification, and focused fixes.

What are the limitations of systematic debugging for intermittent software failures?

Systematic debugging relies on creating reliable reproductions with minimal state. If an intermittent failure cannot be consistently reproduced to establish exact steps, isolating the root cause and verifying the fix becomes significantly harder.