systematic-debugging

Guide root-cause investigation before proposing fixes in a four-phase debugging workflow.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill prevents wasted time and new bugs by forcing systematic root-cause investigation before any code, config, or process fixes are proposed.

Core Features & Use Cases

  • Root-cause first rule: Enforces the iron law, ensuring fixes cannot be proposed until Phase 1 (investigation) is complete.
  • Four-phase workflow: Guides users through Investigation → Pattern Analysis → Hypothesis & Testing → Implementation with clear stop conditions.
  • Anti-shortcut guardrails: Includes explicit red flags and anti-patterns to resist time-pressure rationalizations like “quick fixes” or “multiple changes at once.”
  • Failure-aware behavior: Defines what to do when a hypothesis fails, including re-analyzing for a new hypothesis and escalating to architecture questions after repeated failures.
  • Deep debugging support: Provides techniques for tracing bugs backward through call stacks and for adding defense-in-depth validations across layers.

Quick Start

Use systematic-debugging when you hit a bug or failing test and you need a step-by-step process to identify the underlying root cause before attempting any 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 test failures instead of just patching symptoms?

To find the root cause of test failures, you must complete a systematic investigation phase before proposing any fixes. This approach enforces pattern analysis and single hypothesis testing to prevent wasted time and new bugs from superficial symptom patching.

What is the best way to debug flaky tests and unexpected production breakages?

The best way to debug flaky tests and unexpected production breakages is a four-phase workflow: Investigation, Pattern Analysis, Hypothesis Testing, and Implementation. It includes anti-shortcut guardrails to resist quick fixes under time pressure and mandates creating a failing test case before implementation.

What should I do when my debugging hypothesis fails to fix a code issue?

When your debugging hypothesis fails to fix a code issue, you should stop and re-analyze the problem to form a new single hypothesis. If repeated attempts fail, the process requires escalating to architecture questions to challenge underlying structural assumptions.

How do I trace bugs backward through call stacks for integration failures?

To trace bugs backward through call stacks for integration failures, apply deep debugging techniques that systematically track execution flow. This process ensures you validate a single hypothesis with minimal testing and add defense-in-depth validations across layers before applying final code fixes.

Can I apply systematic debugging to performance issues and build errors under time pressure?

Yes, you can apply systematic debugging to performance issues and build errors under time pressure. The workflow includes explicit red flags and anti-patterns to resist time-pressure rationalizations, ensuring you still complete root-cause investigation before attempting any quick fixes.