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.