systematic-debugging

Guide users through a four-phase root cause analysis process for technical issues.

134|27|Updated Nov 16, 2025
One-click install
npx skills add https://github.com/projectbluefin/dakota --skill systematic-debugging-projectbluefin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/projectbluefin/dakota/tree/main/.opencode/skills/systematic-debugging
Command: npx skills add https://github.com/projectbluefin/dakota --skill systematic-debugging-projectbluefin

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a robust framework to systematically identify the root cause of any technical issue, preventing the common pitfalls of quick fixes and symptom-based solutions that lead to wasted time and recurring bugs.

Core Features & Use Cases

  • Structured Four-Phase Process: Guides users through Investigation, Pattern Analysis, Hypothesis, and Implementation.
  • Root Cause Mandate: Emphasizes finding the fundamental issue, not just patching symptoms.
  • Pressure Resistance: Includes rules and language designed to prevent shortcuts under time pressure or rationalization.
  • Use Case: When a critical API is failing in production, instead of immediately trying a known "quick fix" like adding a retry, this Skill ensures you first investigate why the failure is occurring to implement a permanent solution.

Quick Start

Use the systematic debugging skill when encountering any bug 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
What is systematic debugging and when do I need it?

Systematic debugging is a structured investigation method used to identify the fundamental cause of technical issues rather than just patching symptoms. You need it for bugs, test failures, and performance problems before proposing fixes.

How do I find the root cause of a bug instead of just fixing symptoms?

To find the root cause, follow a four-phase process: Investigation, Pattern Analysis, Hypothesis, and Implementation. This framework mandates investigating why a failure occurs before attempting any code changes to ensure a permanent solution.

What is the best way to troubleshoot recurring production bugs?

The best way to troubleshoot recurring bugs is to resist time pressure and rationalization by enforcing pattern identification and hypothesis testing. This ensures you validate the fundamental issue rather than relying on quick fixes like adding retries.

Can I use this systematic troubleshooting process for performance issues and test failures?

Yes, you can use this systematic troubleshooting process for performance issues and test failures. The framework is applicable to all technical problems, providing structured steps for root cause analysis and validated implementation across any scenario.

How do I stop taking shortcuts when debugging under time pressure?

To stop taking shortcuts under time pressure, apply specific rules and language designed to resist rationalization during the investigation and hypothesis phases. This enforces a complete pattern analysis before moving to validated implementation.

What are the limitations of systematic debugging?

The main limitation of systematic debugging is the strict mandate against immediate quick fixes, which requires dedicating time to investigation and pattern analysis upfront. This structured process may initially slow down symptom patching during critical incidents.