systematic-debugging

Diagnose root causes through evidence gathering and single-hypothesis testing before fixes.

28|1|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/bidah/react-native-hifi --skill systematic-debugging-bidah
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/bidah/react-native-hifi/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/bidah/react-native-hifi --skill systematic-debugging-bidah

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging stops the endless cycle of guesswork by forcing you to investigate errors, gather evidence, and trace the true root cause before proposing fixes, preventing new bugs and wasted time under pressure.

Core Features & Use Cases

  • Phase-driven workflow: Read errors, reproduce consistently, inspect recent changes, and only then move through pattern analysis, hypothesis testing, and disciplined implementation with failing tests.
  • Evidence and guardrails: Instrument multi-component systems, compare working examples, test single hypotheses, verify fixes, and never bundle changes or skip steps even when time pressure mounts.
  • Pressure-resistant guidance: Anti-pattern callouts, human partner signals, and architectural checkpoints keep teams honest when quick fixes seem tempting, while supporting techniques like root-cause tracing, defense-in-depth, and condition-based waiting provide practical tactics.

Quick Start

Ask the skill to walk you through the four phases of root cause investigation, pattern analysis, hypothesis testing, and implementation before changing any code.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is root cause debugging and how does it stop symptom patches?

Root cause debugging is the process of tracing errors to their true origin before applying fixes. It stops symptom patches by mandating evidence gathering, pattern analysis, and hypothesis testing to eliminate the guesswork cycle that introduces new bugs.

How do I debug a failing test using a systematic investigation process?

To debug a failing test systematically, first reproduce the error consistently and inspect recent changes. Then move through pattern analysis and single-hypothesis testing, write a failing test that confirms the root cause, and implement the fix only after verification.

What is the best way to investigate bugs in multi-component systems without skipping steps?

The best way to investigate bugs in multi-component systems is to instrument components for evidence gathering, compare working examples, and test single hypotheses sequentially. This disciplined approach prevents bundled changes and ensures accurate root cause tracing.

When should I do an architectural review during bug triage?

You should initiate an architectural review during bug triage after repeated failures to fix an issue. When pressure mounts and quick fixes repeatedly fail, architectural checkpoints help identify deeper systemic flaws rather than continuing patchwork symptom treatments.

Why does test-driven-development matter when fixing unexpected behavior?

Test-driven-development matters when fixing unexpected behavior because it requires writing a failing test before changing code. This verifies the root cause hypothesis and ensures the fix resolves the actual defect without introducing regressions.

Can I use systematic debugging for urgent bug fixes under time pressure?

Yes, systematic debugging is designed for urgent bug fixes under time pressure. It provides pressure-resistant guidance with anti-pattern callouts and guardrails to enforce disciplined investigation, preventing hasty symptom patches that cause future failures.