be-debug

Diagnoses and fixes backend errors using a bounded 4-phase hypothesis-testing methodology.

1|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/ohmyhotelco/hare-cc-plugins --skill be-debug-ohmyhotelco
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: be-debug
Source: https://github.com/ohmyhotelco/hare-cc-plugins/tree/main/backend-webflux-plugin/skills/be-debug
Command: npx skills add https://github.com/ohmyhotelco/hare-cc-plugins --skill be-debug-ohmyhotelco

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Runtime errors, test failures, and build issues in a Spring WebFlux backend pipeline often get fixed through unbounded trial-and-error that leaves partial fixes stacked on top of each other. This Skill enforces a structured debugging session that reproduces the problem, tests at most three hypotheses with full reverts between attempts, and records an auditable trail. ## Core Features & Use Cases - Bounded hypothesis testing: A debugger agent tests a maximum of 3 hypotheses, fully reverting each failed attempt before trying the next, and never modifies tests or adds suppressions to silence failures. - Pipeline state integration: Acquires a lock on the feature's progress file, records classification, root cause, and modified files, then suggests the correct pipeline re-entry point (re-verify, re-review, or resume implementation). - Evidence-backed reporting: Produces a debug report where every hypothesis carries observed evidence and a file:line location, with an escalation path when all hypotheses fail. - Use Case: A NullPointerException appears in EmployeeHandler.createEmployee. Invoke the skill with the error message; it reproduces the failure with a WebTestClient case, applies a null-check fix in the validator, runs the full regression suite, and reports 47/47 tests passing. ## Quick Start Ask the AI to debug the pasted error message or failing test, for example by running be-debug with "NullPointerException in EmployeeHandler.createEmployee at line 42".

Frequently Asked Questions about be-debug

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

FAQPage Schema
How do I debug a Spring WebFlux runtime error systematically?▼

Pass the error message or stack trace to the be-debug skill, which launches a debugger agent that reproduces the failure, tests up to three hypotheses with evidence, and applies a verified fix. It then runs the full regression suite and reports the root cause with file and line locations.

How to fix a failing test without modifying the test itself?▼

The debugger is constrained to change production code only — it never edits tests to make them pass and never adds @SuppressWarnings or @Disabled. Each hypothesis is verified against the full regression suite, not just the single failing test.

What happens when all debugging hypotheses fail?▼

The session escalates with a report listing each failed hypothesis, the evidence observed, and the implicated file:line locations. It also provides suggested manual investigation steps based on the strongest evidence gathered.

Does the debugger work without the plugin configuration file?▼

It can diagnose and propose fixes without .claude/backend-webflux-plugin.json, but cannot run build or test verification since that config supplies the buildCommand and testCommand. Running be-init first enables full verification capability.

Why does the debugging session use a lock file?▼

The lock prevents concurrent be-verify, be-fix, or be-debug runs from interleaving writes to the same feature's progress file, which would corrupt pipeline state. Stale locks older than 30 minutes are removed automatically.