systematic-debugging

Guides four-phase debugging to identify root causes through evidence gathering and single-hypothesis testing.

Updated Mar 5, 2026
One-click install
npx skills add https://github.com/Envy-7z/mobile-agent-skillpack --skill systematic-debugging-envy-7z
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/Envy-7z/mobile-agent-skillpack/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/Envy-7z/mobile-agent-skillpack --skill systematic-debugging-envy-7z

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

This Skill prevents wasted time and new bugs caused by quick fixes or symptom-based solutions, ensuring that the true root cause of any technical issue is identified and addressed systematically.

Core Features & Use Cases

  • Structured Investigation: Guides users through a mandatory four-phase process (Investigation, Pattern Analysis, Hypothesis, Implementation) to ensure thorough root cause analysis.
  • Pressure Resistance: Includes specific language and rules designed to prevent shortcuts and rationalizations, especially under time pressure or when a quick fix seems obvious.
  • Use Case: When a test fails or a bug appears in production, instead of guessing, use this Skill to follow a proven framework that guarantees finding the underlying issue, saving hours of debugging and preventing future regressions.

Quick Start

Use the systematic-debugging skill to investigate any bug or test failure before proposing fixes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is the best way to find the root cause of a bug instead of just fixing symptoms?

Systematic debugging uses a structured four-phase methodology—investigation, pattern analysis, hypothesis testing, and implementation—to identify root causes rather than treating symptoms. It mandates evidence gathering and single-hypothesis testing to ensure thorough bug fixing and prevent future regressions.

How do I systematically debug a failing test or production issue?

To systematically debug a failing test or production issue, follow a four-phase process: investigate the failure, analyze patterns, test a single hypothesis at a time, and implement the fix. This structured approach resists pressure and prevents rationalizations that lead to new bugs.

When should I use a systematic debugging process for troubleshooting?

Use a systematic debugging process when a test fails, a bug appears in production, or performance and build issues arise. It prevents wasted time and new bugs caused by quick fixes, ensuring the true root cause of any technical issue is addressed safely under time pressure.

Can I use this systematic debugging methodology for performance problems and build issues?

Yes, this systematic debugging methodology addresses bugs, test failures, performance problems, and build issues. It guides users through evidence gathering and single-hypothesis testing to guarantee finding the underlying issue across various technical domains without taking shortcuts.

How does systematic debugging prevent quick fixes and rationalizations under time pressure?

Systematic debugging includes specific language and rules designed to resist pressure and prevent shortcuts. By mandating a structured investigation and single-hypothesis testing, it stops developers from applying obvious quick fixes that mask symptoms and cause future regressions.