One-click install
npx skills add https://github.com/gqf2008/hermez-ai --skill systematic-debugging-gqf2008
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/gqf2008/hermez-ai/tree/main/skills/software-development/systematic-debugging
Command: npx skills add https://github.com/gqf2008/hermez-ai --skill systematic-debugging-gqf2008

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a disciplined, mentally-modelled approach to debugging, ensuring root-cause investigation before attempting fixes to reduce rework and fragility.

Core Features & Use Cases

  • Phase-driven debugging framework for any software issue (errors, failures, unexpected behavior)
  • Systematic steps: read errors, reproduce, trace data flow, compare changes, form hypotheses, test minimally, implement root-cause fixes
  • Supports multi-component systems and integration with existing tests and tooling

Quick Start

Start the root-cause investigation by carefully reading the first error message and reproducing the bug with deterministic steps.

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 software bug instead of just patching symptoms?

To find the root cause of a software bug, systematically read errors, reproduce the issue deterministically, trace data flow, form hypotheses, and test minimally before implementing root-cause fixes to reduce rework.

What is the best way to debug production incidents and build failures systematically?

Debugging production incidents and build failures systematically requires enforcing a four-phase process: reading errors, reproducing the failure, tracing data flow, and testing minimal hypotheses to implement durable root-cause fixes.

How do I trace data flow to troubleshoot unexpected behavior across multi-component systems?

Trace data flow to troubleshoot multi-component systems by carefully reading the first error message, reproducing the bug deterministically, comparing recent changes, and formulating minimal hypotheses to test across the integrated components.

Can I integrate a systematic debugging process with my existing test suites and tooling?

Yes, a systematic debugging process integrates directly with existing test suites and tooling, utilizing deterministic reproduction steps and minimal hypothesis testing to validate root-cause fixes across your current environment.

Why does fixing software errors directly often lead to fragile code and rework?

Fixing software errors directly without systematic root-cause analysis leads to fragile code and rework because underlying data flow issues remain unresolved, causing unexpected behavior to persist or reappear in multi-component systems.