systematic-debugging

Guide four-phase debugging from investigation to verified implementation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill prevents wasted time and new bugs caused by quick fixes and symptom-based solutions, ensuring that the true root cause of any issue is identified and resolved.

Core Features & Use Cases

  • Structured Debugging: Guides users through a mandatory four-phase process (Investigation, Pattern Analysis, Hypothesis, Implementation).
  • Root Cause Mandate: Emphasizes finding the fundamental issue before any fixes are attempted.
  • Pressure Resistance: Includes specific language and rules to prevent shortcuts under time pressure or when a quick fix seems obvious.
  • Use Case: When a test fails or a bug appears in production, load this skill to systematically trace the problem to its origin, rather than applying a temporary patch that might break something else.

Quick Start

Use the systematic-debugging skill to investigate any bug or unexpected behavior you encounter.

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 of a bug requires a structured debugging methodology that enforces investigation, pattern analysis, and hypothesis formation before implementation, preventing superficial symptom patching.

What is the best way to systematically troubleshoot unexpected software behavior?

Systematically troubleshooting unexpected software behavior involves a four-phase process: investigation, pattern analysis, hypothesis formation, and verified implementation to reliably trace issues to their origin.

How do I debug software failures under tight time pressure without causing new bugs?

Debugging under time pressure without introducing new bugs requires a pressure-resistant process that mandates root cause identification and resists shortcuts, ensuring reliable software maintenance over quick temporary patches.

When should I use a structured debugging process for bug fixing?

Use a structured debugging process for bug fixing whenever a test fails or unexpected behavior appears in production, ensuring the fundamental issue is resolved rather than applying a temporary patch that might break other components.

What are the steps to investigate a software bug before attempting a fix?

Investigating a software bug before fixing involves four mandatory steps: gathering information during investigation, analyzing patterns, forming a hypothesis about the root cause, and implementing a verified fix.