debug-protocol

Require a written root-cause and falsification test before code changes.

1|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/hbvg234/jnmt.vn --skill debug-protocol-hbvg234
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-protocol
Source: https://github.com/hbvg234/jnmt.vn/tree/main/Claude-code/.claude/skills/debug-protocol
Command: npx skills add https://github.com/hbvg234/jnmt.vn --skill debug-protocol-hbvg234

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Solves the problem of rushing fixes by requiring a written root-cause and falsification test before any code changes.

Core Features & Use Cases

  • Four-phase structured debugging workflow: reproduce and locate, form hypothesis, test hypothesis, fix and verify.
  • Auto-triggered guidance before touching code, ensuring disciplined investigation and traceability.
  • Useful in any software debugging scenario to reduce regression risk and improve debugging quality.

Quick Start

Activate the lightweight auto-trigger when an error occurs and follow the four phases to investigate root cause before proposing any fix.

Frequently Asked Questions about debug-protocol

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce root-cause analysis before applying software fixes?

Falsification testing validates debugging hypotheses by attempting to disprove them before fixing code. You form a hypothesis about an error, test conditions that should falsify it, and only proceed with a fix if the hypothesis survives, ensuring accurate root-cause identification.

What are the four phases of structured software debugging?

The four phases of structured software debugging are reproducing and locating the error, forming a hypothesis, testing the hypothesis through falsification, and finally fixing and verifying the solution. This workflow reduces regression risk and improves overall debugging quality.

How do I stop developers from rushing code fixes during failing tests?

To stop developers from rushing code fixes during failing tests, implement an auto-triggered guidance system requiring written root-cause documentation before code changes. This enforces a four-phase investigation process to ensure disciplined problem-solving and reduce regression risk.

Does structured debugging work for unexpected software behavior without explicit errors?

Yes, structured debugging works for unexpected software behavior without explicit errors. The investigation workflow is applicable during any abnormal behavior, requiring you to reproduce the issue, form hypotheses, and validate fixes before committing changes, ensuring thorough quality assurance.

What is the best way to reduce regression risk when fixing bugs?

The best way to reduce regression risk when fixing bugs is to follow a four-phase investigation process requiring written root-cause analysis and falsification tests before modifying code. This structured approach ensures fixes are validated against the actual problem.