systematic-debugging

Diagnose software bug root causes through structured evidence gathering and hypothesis testing.

1|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/OMIXEC/Mobile-dev-skills --skill systematic-debugging-omixec
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/OMIXEC/Mobile-dev-skills/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/OMIXEC/Mobile-dev-skills --skill systematic-debugging-omixec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic Debugging prevents wasted time and recurring regressions by replacing guesswork and quick symptom fixes with a disciplined, evidence-driven process that locates and fixes the true root cause of bugs, test failures, and unexpected behavior.

Core Features & Use Cases

  • Four-phase workflow: explicit phases for investigation, pattern analysis, hypothesis testing, and implementation to ensure you never propose fixes before understanding the problem.
  • Instrumentation and tracing: guidance on layered logging, stack trace capture, and cross-component data flow tracing to find where failures originate.
  • Defenses and validation: defense-in-depth patterns and test-first verification to make bugs structurally impossible and prevent regressions.
  • Practical tools and examples: includes scripts and patterns for finding polluting tests, condition-based waiting, and concrete test-case creation scenarios for CI and local debugging.

Quick Start

Use the systematic-debugging skill to reproduce the failure, gather layered evidence, form a single testable hypothesis, and run the smallest change to verify the root cause before implementing a 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 flaky test failures instead of just patching symptoms?▼

To find the root cause of flaky test failures, you need a systematic debugging process that reproduces the issue reliably, gathers layered instrumentation across component boundaries, and tests a single hypothesis at a time before implementing any fix. This prevents recurring regressions.

What is the best way to debug intermittent CI build failures and multi-component integration errors?▼

The best way to debug intermittent CI build failures is to use structured diagnostics and evidence gathering, which involves reproducing the failure, capturing stack traces, and tracing cross-component data flow to pinpoint exactly where the integration error originates.

How do I systematically reproduce a software bug before attempting a code fix?▼

You systematically reproduce a software bug by setting up condition-based waiting and layered logging to capture the exact runtime state, ensuring the failure triggers consistently before you form a hypothesis or run the smallest change to verify the root cause.

Why do my software bugs keep coming back after I apply quick fixes?▼

Software bugs keep returning after quick fixes because guesswork only masks the symptom. A disciplined, evidence-driven workflow locates the true root cause and uses test-first verification with defense-in-depth patterns to make the bug structurally impossible.

How do I trace cross-component data flow to locate where a runtime failure originates?▼

You trace cross-component data flow by adding layered instrumentation and stack trace capture across component boundaries, which provides the evidence needed to form a single testable hypothesis about the exact origin of the runtime failure.

Can I use test-driven verification to prevent future regressions when fixing unit test failures?▼

Yes, test-driven verification prevents future regressions by requiring a failing test that proves the root cause before implementing the fix, ensuring the defense-in-depth patterns make the bug structurally impossible to reoccur.