systematic-debugging

Guide engineers through a four-phase debugging workflow for root-cause investigation.

1|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/danilonovaisv/PROMPT-APP --skill systematic-debugging-danilonovaisv
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/danilonovaisv/PROMPT-APP/tree/main/.agent/skills/systematic-debugging
Command: npx skills add https://github.com/danilonovaisv/PROMPT-APP --skill systematic-debugging-danilonovaisv

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides engineers to consistently identify root causes of bugs and failures before attempting fixes, reducing wasted effort and rework.

Core Features & Use Cases

  • Phase-driven approach: Phase 1 Root Cause Investigation, Phase 2 Pattern Analysis, Phase 3 Hypothesis and Testing, Phase 4 Implementation.
  • Root-cause tracing: Trace issues back to their source rather than patching symptoms.
  • Defense-in-depth: Encourages validation at multiple layers to prevent regression.
  • Applicable to debugging across UI, tests, CI/CD, and production incidents.

Quick Start

Load the systematic-debugging skill and begin with Phase 1 to ensure root-cause investigation before fixes.

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 a bug instead of just patching symptoms?

Root cause debugging requires tracing issues back to their source through a structured four-phase workflow: investigation, pattern analysis, hypothesis testing, and implementation. This methodical approach prevents premature fixes and reduces rework by ensuring the actual origin is identified and resolved.

What is the best way to systematically debug failures in CI/CD pipelines?

Systematic debugging applies a phase-driven approach to CI/CD failures by tracing data through root cause investigation, analyzing failure patterns, testing hypotheses, and implementing defensive practices. This ensures pipeline issues are fixed at their source rather than masked by temporary patches.

How do I prevent bug regression after implementing a fix in production?

Preventing regression involves adding defense-in-depth during the implementation phase. This technique encourages validation at multiple layers of the system, making the bug structurally impossible to reoccur and ensuring the fix holds against future edge cases.

Does systematic debugging work for production incidents and UI failures?

Yes, systematic debugging is applicable across UI, tests, CI/CD, and production incidents. The four-phase workflow of root cause investigation, pattern analysis, hypothesis testing, and defensive implementation guides engineers through any failure context to ensure accurate resolution.

Why do my software fixes keep causing new issues or failing to resolve the original problem?

Fixes often cause new issues when engineers apply premature patches to symptoms instead of identifying the root cause. A methodical debugging workflow forces hypothesis testing and data tracing before implementation, ensuring the actual fault is addressed and preventing cascading failures.