systematic-debugging

Enforce root-cause investigation before fixes across four debugging phases.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging helps engineers avoid symptom-based fixes by enforcing root-cause analysis before any changes.

Core Features & Use Cases

  • Four-phase workflow (root cause investigation, pattern analysis, hypothesis testing, implementation) that guides debugging across code defects, flaky tests, performance issues, and production incidents.
  • Defense-in-depth approach with layered validation and instrumentation to prevent regression.

Quick Start

Follow Phase 1: Root Cause Investigation before proposing 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 fixing the symptom?

Root cause investigation requires enforcing a systematic debugging workflow before applying fixes. This Skill guides engineers through four phases—root cause investigation, pattern analysis, hypothesis testing, and implementation—to ensure code defects are resolved at their source.

What is the best way to debug flaky tests and production incidents systematically?

Systematic debugging applies a four-phase workflow to flaky tests and production incidents, enforcing root cause investigation and pattern analysis before implementation. It uses defense-in-depth practices with layered validation to prevent future regressions.

Can I use a systematic debugging approach for performance issues?

Yes, systematic debugging applies to performance issues by guiding engineers through root cause investigation, pattern analysis, hypothesis testing, and implementation. It enforces thorough tracing and defense-in-depth instrumentation before applying fixes.

How do I start Phase 1 of root cause investigation for code defects?

Starting Phase 1 of root cause investigation means analyzing the code defect before proposing any fixes. You must complete this initial investigation phase, followed by pattern analysis, hypothesis testing, and implementation, to resolve the issue systematically.

When should I not use symptom-based fixes during software debugging?

Symptom-based fixes should be avoided whenever you face code defects, flaky tests, performance issues, or production incidents. Enforce root cause analysis and pattern analysis first to ensure the fix addresses the actual underlying problem.