reversa-debugger-fix

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

Updated Aug 14, 2026
One-click install
npx skills add https://github.com/Ruggery/OCR_Cartorio --skill reversa-debugger-fix-ruggery
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reversa-debugger-fix
Source: https://github.com/Ruggery/OCR_Cartorio/tree/main/.agents/skills/reversa-debugger-fix
Command: npx skills add https://github.com/Ruggery/OCR_Cartorio --skill reversa-debugger-fix-ruggery

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Fixing bugs without a disciplined process leads to untracked changes, unproven root causes, and regressions that resurface later. This Skill takes a bug already registered in the Reversa framework and drives it from triage to verified closure with causal evidence, approved change sets, and spec alignment. ## Core Features & Use Cases - Guided bug-fix lifecycle: reproduction capsule, root-cause analysis with epistemic states (hypothesized/supported/confirmed), optional git bisect for regressions, and risk assessment before any change. - Two-gate approval workflow: reproduction and regression tests are approved and shown failing first, then the typed correction change set (code, configuration, migration, data-repair, specification) is approved and shown passing. - Spec verdict and closure policy: compares the fix against the effective spec, generates versioned addenda when needed, and closes the bug per the project's closure policy (local-software, package, or production-service) with a DONE lock. - Use Case: A developer runs /reversa-debugger-fix BUG-007 to reproduce a reported defect, prove the root cause with evidence, apply a minimal approved patch with regression tests, and close 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 following the Reversa debugging workflow.

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 the Reversa debugger workflow?▼

Invoke /reversa-debugger-fix with a bug ID or display number. The skill locates the bug in the _reversa_bugs registry, reproduces it, diagnoses the root cause, and applies fixes only after two approval gates: failing tests first, then the correction change set.

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. Intermittent bugs are recorded with reproduction rate and suspected triggers.

Does the skill modify project files without approval?▼

No. Reading, reproduction, and diagnosis run freely, but every change to the project passes an approval gate with diffs shown. Outside the gates it only writes to the bug registry and spec addenda folders; original specs are read-only.

How does the skill handle bugs that contradict the specification?▼

It issues a mandatory spec verdict comparing the corrected behavior with the effective spec. The user decides between spec-correta, spec-desatualizada, or spec-gap, and any spec change is recorded as a versioned, immutable addendum alongside the code diff.

Can a closed bug be reopened or modified?▼

Closed bugs are locked by a DONE.md file making the folder read-only. Reopening requires the user to consciously remove the lock, or to register a new bug with a regression-of relation pointing to the closed one.