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.