systematic-debugging

Guide users through four-phase systematic debugging to identify and fix root causes of technical issues.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/marcusfelix/barney --skill systematic-debugging-marcusfelix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/marcusfelix/barney/tree/main/src/prompts/skills/systematic-debugging
Command: npx skills add https://github.com/marcusfelix/barney --skill systematic-debugging-marcusfelix

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 symptom-based solutions, ensuring that the true root cause of any technical issue is identified and addressed systematically.

Core Features & Use Cases

  • Structured Debugging Process: Guides users through four distinct phases: Investigation, Pattern Analysis, Hypothesis, and Implementation.
  • Root Cause Mandate: Emphasizes finding the fundamental cause before applying any fix.
  • Pressure Resistance: Includes specific language and rules to counteract rationalizations made under time pressure or urgency.
  • Use Case: When a critical API endpoint starts failing intermittently, this Skill ensures the engineer doesn't just add a quick retry, but systematically investigates why the endpoint is failing in the first place, preventing future occurrences.

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
What is a systematic debugging process for finding the root cause of a bug?

A systematic debugging process guides you through four phases: Investigation, Pattern Analysis, Hypothesis, and Implementation. It mandates thorough evidence gathering and data flow tracing to identify the fundamental cause before applying any fix.

How do I fix intermittent API failures without introducing new bugs?

To fix intermittent API failures safely, conduct a systematic error investigation to trace data flows and gather evidence. This prevents quick patches like adding retries, ensuring the true root cause is identified and addressed without new bugs.

What is the best way to troubleshoot complex system errors under time pressure?

The best way to troubleshoot complex system errors under time pressure is following a structured debugging process with built-in anti-patterns and red flags. This counters rationalizations and ensures thorough root cause analysis before implementation.

How do I stop random fixes from causing new bugs during bug fixing?

To stop random fixes from causing new bugs, mandate a root cause investigation before implementation. A structured debugging process enforces hypothesis testing and pattern analysis, preventing symptom-based solutions that lead to wasted time.

When should I use a systematic troubleshooting process instead of a quick patch?

Use systematic troubleshooting instead of a quick patch whenever you face critical or intermittent technical issues. It prevents symptom-based solutions by ensuring thorough investigation, hypothesis testing, and root cause identification before any code changes.

Does root cause analysis work for complex systems with intermittent technical issues?

Yes, root cause analysis works for complex systems by detailing evidence gathering and data flow tracing. A systematic debugging process guides you through pattern analysis and hypothesis testing to identify and fix the fundamental cause of intermittent issues.