ada-systematic-debugging

Diagnose root causes of test failures and bugs through a four-phase evidence-driven debugging workflow.

Updated Jul 23, 2026
One-click install
npx skills add https://github.com/wubing7755/Ada --skill ada-systematic-debugging-wubing7755
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ada-systematic-debugging
Source: https://github.com/wubing7755/Ada/tree/main/skills/software-development/ada-systematic-debugging
Command: npx skills add https://github.com/wubing7755/Ada --skill ada-systematic-debugging-wubing7755

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Debugging complex, flaky, or recurring bugs often devolves into guess-and-check patching that masks root causes and introduces regressions. This Skill enforces a disciplined four-phase methodology — root cause investigation, pattern analysis, hypothesis testing, and verified implementation — so fixes are based on evidence rather than speculation. ## Core Features & Use Cases - Tight Feedback Loops: Builds fast, deterministic reproduction commands (failing tests, curl scripts, bisection harnesses, fuzz loops) that go red on the exact symptom before any fix is attempted. - Ranked Hypothesis Testing: Forms 3-5 falsifiable hypotheses, tests one variable at a time, and stops after repeated failures to question the underlying architecture. - Multi-Component Evidence Gathering: Instruments component boundaries, traces data flow upstream, and supports delegated sub-agent investigation for distributed systems. - Use Case: A pytest case fails intermittently and two previous fixes did not stick. The agent raises the reproduction rate, isolates the root cause to a specific code path, writes a regression test, and verifies the fix against the full suite. ## Quick Start Ask the agent to debug a failing test or production error by finding the root cause first, reproducing it with a minimal command, and only then proposing a verified fix.

Frequently Asked Questions about ada-systematic-debugging

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

FAQPage Schema
How do I debug a flaky test that fails intermittently?

Raise the reproduction rate first by running the trigger repeatedly, parallelizing, adding stress, or narrowing timing windows until the failure is debuggable. Then investigate the root cause with evidence before proposing any fix, since a 50% flake is debuggable while a 1% flake usually is not.

What is the systematic debugging process for finding root causes?

The process has four phases: read errors and build a tight reproduction loop, analyze patterns by comparing working and broken code, form and test ranked falsifiable hypotheses one variable at a time, then implement a single fix with a regression test and verify the full suite passes.

When should I not use a systematic debugging workflow?

Skip it for known trivial bugs with an obvious one-line fix, such as a typo. Also check environment and configuration files first for configuration issues, and use efficiency analysis rather than debugging for performance tuning.

What should I do when multiple fix attempts keep failing?

Stop after two or three failed fixes and question the architecture instead of attempting another patch. Repeated failures where each fix reveals new problems elsewhere indicate an architectural issue that needs discussion before more changes.

How do I debug failures across multiple components like APIs and databases?

Add diagnostic instrumentation at each component boundary, logging what data enters and exits, then run once to see where the flow breaks. Investigate only the failing component, and optionally delegate investigation to a subagent that reports evidence without fixing.