systematic-debugging

Enforce root-cause investigation before applying bug fixes across development, testing, and production.

1|1|Updated Dec 15, 2024
One-click install
npx skills add https://github.com/Alejocabeza/dotfiles --skill systematic-debugging-alejocabeza
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/Alejocabeza/dotfiles/tree/main/opencode/skills/systematic-debugging
Command: npx skills add https://github.com/Alejocabeza/dotfiles --skill systematic-debugging-alejocabeza

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps engineers stop guessing and ensures root-cause investigation precedes fixes, reducing wasted effort and rework during debugging.

Core Features & Use Cases

  • Phase-driven workflow (4 phases) with explicit rules to prevent shortcuts
  • Defense-in-depth: layered validations and diagnostic instrumentation
  • Root-cause tracing and anti-patterns to avoid symptom-focused fixes
  • Real-world testing scenarios and decision-making under pressure

Quick Start

Load the skill, review the four phases, and begin Phase 1 to systematically investigate issues.

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 how does it prevent symptom-focused fixes?

Systematic debugging enforces root-cause investigation before applying fixes, using a four-phase framework to trace data flow and validate solutions. This structured approach prevents patching symptoms and reduces wasted effort.

How do I find a root cause instead of just patching symptoms during testing?

You find a root cause by following a structured workflow that enforces tracing data flow and analyzing patterns before implementation. This method requires validating hypotheses and applying defense-in-depth to ensure the actual issue is resolved.

Does a phase-based debugging workflow work for production environments?

Yes, a phase-based debugging workflow applies across development, testing, and production environments. It uses layered validations and diagnostic instrumentation to trace issues and enforces stopping rules if problems remain unresolved.

What is the best way to structure a debugging workflow under pressure?

The best way is to apply a four-phase framework with explicit guardrails and anti-patterns. This enforces root-cause tracing and hypothesis testing before implementation, ensuring structured decision-making even under pressure.

When should I stop a root-cause investigation if a bug remains unresolved?

You should stop a root-cause investigation when explicit stopping rules are triggered. The framework enforces these rules during the hypothesis and testing phase to prevent endless cycles if the issue remains unresolved.