systematic-debugging

Diagnose software bugs through a four-phase root cause investigation workflow.

38|6|Updated Aug 14, 2026
One-click install
npx skills add https://github.com/7757/Fan-Browser-Agent --skill systematic-debugging-7757
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/7757/Fan-Browser-Agent/tree/main/skills/software-development/systematic-debugging
Command: npx skills add https://github.com/7757/Fan-Browser-Agent --skill systematic-debugging-7757

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Random fixes and guess-and-check patches waste hours and introduce new bugs. This Skill enforces a disciplined four-phase debugging process that finds the root cause before any fix is attempted, preventing symptom-only patches and repeated failed fix attempts. ## Core Features & Use Cases - Four-Phase Process: Root cause investigation, pattern analysis, hypothesis testing, and implementation, each with explicit completion criteria. - Tight Feedback Loops: Builds fast, deterministic reproduction commands or tests that go red on the exact symptom and green when fixed. - Escalation Rules: The Rule of Three stops thrashing after three failed fixes and triggers an architectural review instead of a fourth guess. - Use Case: A failing pytest suite in production gets traced through error messages, git history, and data flow analysis to isolate the broken component, then a regression test is written before the single root-cause fix is applied. ## Quick Start Debug this failing test using the systematic-debugging process: find the root cause first, then write a regression test before fixing it.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
How do I debug a failing test systematically?▼

Start by reading the full error message and stack trace, then build a tight reproduction command that fails on the exact symptom. Check recent git changes, trace the data flow to the source, and only then form a hypothesis and fix the root cause with a regression test.

What is root cause analysis in debugging?▼

Root cause analysis identifies why a bug occurs rather than patching its symptoms. It involves reading errors completely, reproducing the issue deterministically, gathering evidence at component boundaries, and tracing bad values upstream to their origin.

When should I stop trying fixes and question the architecture?▼

Stop after three failed fix attempts. If each fix reveals new problems in different places or requires massive refactoring, the pattern indicates an architectural problem that needs discussion rather than a fourth fix attempt.

Why does my quick fix keep breaking other things?▼

Quick fixes typically address symptoms instead of root causes, so the underlying issue resurfaces elsewhere. Bundling multiple changes at once also makes it impossible to isolate what worked, often introducing new bugs.

How do I reproduce a flaky or intermittent bug?▼

Increase the reproduction rate with repetition, stress runs, fixed random seeds, or captured input replay. Pin time and randomness, isolate filesystem and network dependencies, and assert the exact symptom rather than a generic crash check.