systematic-debugging

Guide four-phase root cause analysis for technical issues.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

This Skill prevents wasted time and new bugs caused by random fixes, quick patches, or addressing only the symptoms of a problem, ensuring that the true root cause of any technical issue is identified and resolved.

Core Features & Use Cases

  • Structured Debugging Process: Guides users through a mandatory four-phase process (Investigation, Pattern Analysis, Hypothesis, Implementation) to systematically uncover the root cause of bugs, test failures, or unexpected behavior.
  • Pressure Resistance: Includes specific language and structural defenses designed to prevent shortcuts and rationalizations, especially under time pressure or when a quick fix seems obvious.
  • Use Case: When a critical test fails in CI, instead of guessing or applying a quick timeout, use this Skill to methodically trace the error, identify the faulty logic, and implement a robust fix that prevents recurrence.

Quick Start

Use the systematic debugging skill when encountering any bug or test failure.

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 symptoms?

Finding the root cause requires a systematic debugging process of investigation, pattern analysis, hypothesis testing, and implementation. This structured approach prevents wasted time on quick patches that only address symptoms.

What is the best way to troubleshoot unexpected behavior in a multi-component system?

Troubleshooting unexpected behavior in a multi-component system requires methodical investigation and pattern analysis to trace errors across components. A structured approach identifies the faulty logic and implements a robust fix that prevents recurrence.

How do I systematically debug a critical test failure in CI without guessing?

Systematically debug a critical test failure by tracing the error methodically through a four-phase process: investigation, pattern analysis, hypothesis, and implementation. This identifies the faulty logic and implements a robust fix instead of applying a quick timeout or guess.

How can I prevent taking debugging shortcuts when under time pressure to fix a bug?

To prevent debugging shortcuts under time pressure, use a process with structural defenses and specific language designed to resist rationalizations. This enforces a methodical investigation and root cause implementation over quick fixes.

When should I use a systematic debugging process for error handling?

You should use a systematic debugging process for error handling whenever you encounter any bug, test failure, or unexpected behavior. It is specifically designed to uncover the true root cause of technical issues and prevent new bugs caused by random fixes.