systematic-debugging

Guide four-phase debugging to identify root causes before fixes.

Updated Jan 1, 2026
One-click install
npx skills add https://github.com/Palomig/PALOMATIKA --skill systematic-debugging-palomig
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/Palomig/PALOMATIKA/tree/main/.claude/skills/systematic-debugging
Command: npx skills add https://github.com/Palomig/PALOMATIKA --skill systematic-debugging-palomig

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the common issue of inefficient and ineffective debugging practices that lead to wasted time, recurring bugs, and architectural debt. It enforces a structured, root-cause-focused approach to problem-solving.

Core Features & Use Cases

  • Root Cause Analysis: Guides users through a rigorous process to identify the fundamental reason for a bug, not just its symptoms.
  • Phased Approach: Breaks down debugging into four distinct phases: Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, and Implementation.
  • Use Case: When a critical test fails in a CI/CD pipeline, instead of making quick, unverified changes, this Skill ensures the engineer systematically investigates error messages, reproduces the issue, checks recent changes, and gathers evidence before proposing any fixes.

Quick Start

Use the systematic-debugging skill to investigate any bug, test failure, or unexpected behavior 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 symptoms?

Root cause analysis requires a systematic debugging process that enforces error reproduction, recent change verification, and evidence gathering before implementing fixes. This approach prevents recurring bugs by investigating the fundamental reason for the issue rather than applying quick patches.

What is the best way to debug a failing test in a CI/CD pipeline?

Debugging a failing test in a CI/CD pipeline requires a structured approach: analyze error messages, reproduce the issue, check recent code changes, and gather evidence before proposing any fixes. This prevents unverified changes from introducing new issues into the pipeline.

How do I troubleshoot performance problems across multi-component systems?

Troubleshooting performance problems across multi-component systems requires systematic pattern analysis and hypothesis testing. By gathering evidence and identifying patterns across components, you can isolate the root cause and implement minimal targeted fixes rather than broad architectural changes.

When should I use a systematic debugging process instead of making quick fixes?

A systematic debugging process should be used whenever you face bugs, test failures, performance problems, or build issues. It prevents architectural debt and wasted time by enforcing a four-phase approach: root cause investigation, pattern analysis, hypothesis testing, and minimal implementation.

How do I verify a hypothesis when debugging software issues?

Hypothesis verification during debugging requires testing your assumptions against gathered evidence and reproduced errors. The systematic process enforces hypothesis testing before implementation, ensuring fixes address the verified root cause rather than unconfirmed theories.

Does systematic debugging work for build issues and test failures?

Systematic debugging works for build issues, test failures, performance problems, and unexpected behavior across multi-component systems. The four-phase process of error analysis, reproduction, evidence gathering, and minimal implementation applies universally to technical issue resolution.