reversa-debugger-fix

Diagnoses and fixes registered bugs through gated reproduction, root-cause analysis, and regression tests.

Updated Jun 12, 2026
One-click install
npx skills add https://github.com/lacsousa/mediclaw-system --skill reversa-debugger-fix-lacsousa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reversa-debugger-fix
Source: https://github.com/lacsousa/mediclaw-system/tree/main/.agents/skills/reversa-debugger-fix
Command: npx skills add https://github.com/lacsousa/mediclaw-system --skill reversa-debugger-fix-lacsousa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Fixing bugs without a disciplined process leads to unverified patches, lost root-cause knowledge, and regressions that resurface later. This Skill takes a bug already registered in the Reversa bug registry and drives it through a controlled lifecycle: reproduction, root-cause diagnosis with epistemic states, risk assessment, approval-gated test and code changes, spec verdict, and policy-based closure. ## Core Features & Use Cases - Guided bug-fix lifecycle: Reproduces the bug with an evidence capsule, separates affected code from root cause (hypothesized/supported/confirmed), and optionally runs git bisect for regressions. - Two approval gates: Gate 1 covers reproduction and regression tests (demonstrated failing); Gate 2 covers the typed correction change set (demonstrated passing), with all diffs saved under fix/. - Spec verdict and closure policy: Compares the fix against the effective spec, generates versioned spec addenda when needed, and closes only when the project's closure policy (local-software, package, or production-service) is satisfied, locking the bug folder with DONE.md. - Use Case: A developer runs the skill on BUG-007, reviews the generated fix/plan.html, approves the failing regression test, approves the minimal patch, and closes the bug with full traceability. ## Quick Start Ask the agent to fix a registered bug by running /reversa-debugger-fix with the bug ID, for example: fix BUG-20260715-A7K3 using the reversa-debugger-fix skill.

Frequently Asked Questions about reversa-debugger-fix

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

FAQPage Schema
How do I fix a registered bug with an AI agent?▼

Invoke the skill with the bug ID, such as /reversa-debugger-fix BUG-007. The agent reproduces the bug, diagnoses the root cause, proposes a fix plan, and applies tests and code changes only after you approve two separate gates.

What is the difference between a reproduction test and a regression test?▼

A reproduction test proves the reported defect actually occurs, while a regression test protects behavior that must never break again. They may live in the same file but never share the same intent, and both must be shown failing before the fix is applied.

Can this skill modify files without my approval?▼

No. Every step that alters the project passes through an approval gate showing the full diff first. Outside the two gates, the skill only writes to the bug registry and spec addenda folders, and original specs are read-only forever.

What happens if a bug cannot be reproduced?▼

The skill never invents a cause. It offers to close the bug as instrumentation-required, where the change set adds logging, metrics, or tracing to capture the next occurrence, treating instrumentation as a valid resolution.

When should I use the optional multi-agent debate?▼

Use the debate when there are competing root-cause hypotheses, competing repair strategies with high change risk, or a divergence between code and spec. It never runs without explicit consent because it costs multiple extra model calls.