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.