systematic-debugging

Trace bugs through data flow to identify root causes before proposing fixes.

1|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/TruCol270/salty-pickle --skill systematic-debugging-trucol270
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/TruCol270/salty-pickle/tree/main/.claude-skills/systematic-debugging
Command: npx skills add https://github.com/TruCol270/salty-pickle --skill systematic-debugging-trucol270

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging helps teams avoid patchwork fixes by enforcing root-cause investigation before any changes. It provides a disciplined, phase-driven workflow that reduces time spent on unverified fixes and rework.

Core Features & Use Cases

  • Four-phase process (Root Cause Investigation → Pattern Analysis → Hypothesis & Testing → Implementation) to guide debugging.
  • Defense-in-depth approach: validate data and behavior at multiple layers to prevent regression.
  • Clear stop rules: require completion of Phase 1 before proposing fixes and use explicit evidence gathering.

Quick Start

Follow the four-phase root-cause debugging process to identify the root cause 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 symptoms?

To find the root cause of a bug, trace data flow through a systematic debugging process that enforces evidence gathering and pattern analysis before proposing fixes. This prevents patchwork solutions and reduces rework.

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

The best way to debug production bugs under time pressure is using a four-phase root cause investigation workflow with explicit stop rules. This enforces completion of evidence gathering before any implementation fixes are applied.

How do I stop recurring test failures caused by unverified fixes?

To stop recurring test failures from unverified fixes, apply a defense-in-depth debugging approach that validates data and behavior at multiple layers. Complete root cause investigation and pattern analysis before implementing changes.

Does systematic debugging work for performance problems and integration issues?

Systematic debugging works for performance problems and integration issues by applying a phase-driven workflow. It traces bugs through data flow to identify the root cause, ensuring fixes target the actual fault rather than symptoms.

What are the stop rules for a phase-driven debugging workflow?

The stop rules for a phase-driven debugging workflow require completing Phase 1, the root cause investigation, before proposing any fixes. This enforces explicit evidence gathering across the four phases of pattern analysis and hypothesis testing.

How do I trace faults through data flow to prevent regression?

To trace faults through data flow and prevent regression, use a defense-in-depth approach that validates behavior at multiple layers. This systematic debugging method requires explicit evidence gathering before moving to the implementation phase.