systematic-debugging

Investigate technical issues through a structured 4-phase root cause process.

Updated Apr 18, 2026
One-click install
npx skills add https://github.com/sammy9322/ventura-dental-facturacion --skill systematic-debugging-sammy9322
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/sammy9322/ventura-dental-facturacion/tree/main/.agents/skills/systematic-debugging
Command: npx skills add https://github.com/sammy9322/ventura-dental-facturacion --skill systematic-debugging-sammy9322

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates wasted time and recurring bugs caused by quick symptom fixes and unvalidated guesswork, ensuring you resolve technical issues permanently even under tight deadlines or after multiple failed quick attempts.

Core Features & Use Cases

  • 4-Phase Systematic Process: Structured workflow covering root cause investigation, pattern analysis, hypothesis testing, and implementation to eliminate guesswork.
  • Pressure-Resistant Guardrails: Explicit rules and anti-pattern guidance to prevent shortcuts when under time pressure, exhaustion, or social pressure from senior team members.
  • Supporting Techniques: Includes ready-to-use methods for backward root cause tracing, defense-in-depth validation, and fixing flaky tests caused by arbitrary timeouts.
  • Use Case: For a recurring failing payment processing test, use this skill to trace the root cause of the status update delay instead of adding arbitrary timeouts that mask the underlying issue.

Quick Start

Use the systematic-debugging skill to investigate the root cause of the failing production API error before proposing any 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 flaky test failure instead of just masking it?

To fix a recurring bug permanently, apply a structured 4-phase process: root cause investigation, pattern analysis, hypothesis testing, and implementation. This enforces backward trace analysis to eliminate guesswork and stop recurring symptoms.

What is the best way to debug production bugs under tight deadline pressure?

The best way to debug under pressure is applying pressure-resistant guardrails and anti-pattern guidance. These rules prevent shortcuts and unvalidated guesswork during root cause analysis, ensuring permanent bug resolution even under tight deadlines.

How do I stop recurring software bugs caused by random symptom fixes?

To stop recurring software bugs, replace random symptom fixes with a systematic 4-phase root cause investigation. This eliminates wasted debugging time by validating hypotheses and tracing backward to the actual origin of the technical issue.

How does backward root cause tracing work for performance degradation?

Backward root cause tracing for performance degradation works by systematically investigating from the observed symptom backward through pattern analysis and hypothesis testing. It enforces defense-in-depth validation to ensure the issue is permanently resolved.

Does this debugging approach work for integration errors and test failures?

Yes, this debugging approach works for integration errors and test failures. The structured root cause investigation process applies to all technical issues, including production bugs and performance degradation, ensuring comprehensive bug fixing.

When should I not use quick fixes for a failing payment processing test?

You should not use quick fixes for a failing payment processing test when the issue stems from a status update delay. Adding arbitrary timeouts masks the underlying issue; instead, trace the root cause to prevent recurring bugs.