Systematic Debugging Process

Community

Debug with precision, fix once, prevent future bugs.

AuthorRomualdP
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill provides a systematic, 10-step debugging process to ensure bugs are fixed robustly, preventing quick, superficial patches and ensuring that the root cause is addressed, tested, and protected against future recurrence.

Core Features & Use Cases

  • Reproducible Bug Definition: Guides on precisely documenting the bug, reproduction steps, and expected vs. actual behavior, often by creating a failing test.
  • State Inspection & Binary Search: Teaches how to strategically add logs and use binary search techniques to pinpoint the exact line or function causing the issue.
  • Minimal Fix & Protection: Emphasizes applying the smallest possible fix, followed by running the full test suite, and adding long-term protections (more tests, guards, validations, documentation).
  • Use Case: After identifying a probable root cause for a bug, use this Skill to write a failing test, apply a minimal fix, verify that all tests pass, and then add comprehensive unit tests and documentation to prevent the bug from ever reappearing.

Quick Start

First, precisely define the bug and reproduce it locally. Then, formulate 2-3 probable root causes and prioritize them. Add strategic logs to inspect state changes, and use binary search to isolate the exact problem.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: Systematic Debugging Process
Download link: https://github.com/RomualdP/hoki/archive/main.zip#systematic-debugging-process

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository