systematic-debugging

Identify and correct root causes of bugs through a four-phase systematic debugging process.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Kinshuk699/sEYEght --skill systematic-debugging-kinshuk699
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/Kinshuk699/sEYEght/tree/main/.agents/skills/systematic-debugging
Command: npx skills add https://github.com/Kinshuk699/sEYEght --skill systematic-debugging-kinshuk699

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging provides a rigorous, four-phase workflow that ensures you discover and fix the root cause of bugs and flaky behavior, reducing time wasted on symptom patches and preventing regression.

Core Features & Use Cases

  • Four Phases: Phase 1 Root Cause Investigation, Phase 2 Pattern Analysis, Phase 3 Hypothesis & Testing, Phase 4 Implementation.
  • Defenses & Anti-patterns: Built-in guidance to resist shortcuts, including a strict no-fixes-before-root-cause rule and explicit failure modes.
  • Practical Validation: Includes defense-in-depth, root-cause tracing, and structured testing adapted to real-world debugging scenarios (CI failures, production incidents, complex systems).
  • Related Techniques: Root-cause tracing, defense-in-depth, condition-based waiting, and iterative verification workflows.

Quick Start

Begin by reading error messages, reproducing the issue, reviewing recent changes, and then follow the four-phase process to identify the root cause before applying 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 flaky behavior in a multi-service system instead of just patching symptoms?

To debug CI failures systematically, follow a four-phase process: investigate the root cause, analyze failure patterns, test hypotheses, and implement fixes with explicit fail-fast rules. This structured workflow prevents wasted time on symptom patches during production incidents.

What is the best way to debug production incidents without causing regressions?

The best way to debug production incidents is using a systematic debugging process that enforces a strict no-fixes-before-root-cause rule. You trace the root cause through evidence and constraints, then implement defense-in-depth patterns to prevent future regressions.

Can I use systematic debugging for complex multi-service systems and CI pipeline failures?

Yes, you can use systematic debugging for complex multi-service systems and CI pipeline failures. The four-phase workflow is explicitly adapted for real-world scenarios, applying root-cause tracing and iterative verification to resolve intricate multi-service dependencies.

Why do my code fixes keep introducing new bugs when I try to resolve traceback errors?

Your fixes introduce new bugs because quick symptom patches bypass root-cause investigation. By skipping pattern analysis and hypothesis testing, you fail to identify the actual error source, leading to incomplete fixes and regression in complex systems.

When should I not use a systematic debugging approach for my software development?

You should avoid shortcuts within the systematic debugging process itself, such as skipping the strict Phase 1 root-cause investigation. Built-in anti-pattern guidance resists these quick fixes, ensuring you never apply patches before fully tracing the error.