reversa-inspector

Generates parity specs and Gherkin feature files proving legacy-to-new system behavioral equivalence.

Updated Mar 23, 2026
One-click install
npx skills add https://github.com/Helcio-Nogueira/Painel_Inteligente_Hackaton_2026 --skill reversa-inspector-helcio-nogueira
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reversa-inspector
Source: https://github.com/Helcio-Nogueira/Painel_Inteligente_Hackaton_2026/tree/main/.agents/skills/reversa-inspector
Command: npx skills add https://github.com/Helcio-Nogueira/Painel_Inteligente_Hackaton_2026 --skill reversa-inspector-helcio-nogueira

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? When migrating a legacy system to a new architecture or paradigm, teams struggle to prove the new system behaves equivalently to the old one. This Skill defines the validation strategy and produces parity specifications adapted to the chosen paradigm transition. ## Core Features & Use Cases - Parity Strategy Definition: Selects validation modes (shadow mode, characterization tests, contract tests, data parity) and defines acceptance criteria such as divergence thresholds and observation windows. - Paradigm-Adapted Coverage: Adjusts required test dimensions based on the paradigm transition (e.g., synchronous to event-driven requires idempotency, ordering, and queue-failure scenarios). - Gherkin Spec Generation: Produces one .feature file per critical flow with traceability to process flows, target architecture, and business rules, including screen parity scenarios when a UI exists. - Use Case: After migrating a monolithic OO system to an event-driven architecture, invoke this Skill to generate parity specs requiring idempotency and message-ordering scenarios for every critical flow before cutover. ## Quick Start Run /reversa-inspector after the migration strategy and target architecture are approved to generate parity_specs.md and Gherkin parity tests for all critical flows.

Frequently Asked Questions about reversa-inspector

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

FAQPage Schema
How do I prove a migrated system is equivalent to the legacy system?▼

Define parity specs that select validation modes such as shadow mode, characterization tests, contract tests, and data parity, then set an acceptance metric like functional divergence below a threshold over an observation window. Generate Gherkin scenarios per critical flow covering positive cases, edge cases, and paradigm-specific dimensions.

What extra tests are needed when migrating from synchronous to event-driven architecture?▼

Event-driven targets require scenarios for message ordering, idempotency, eventual consistency, and queue failure behavior such as retries and dead letter queues. Each critical flow should produce at least parity, idempotency, and ordering scenarios.

Are the generated .feature files executable tests?▼

No, the .feature files are specifications, not executable tests. They contain no framework calls; a separate coding agent translates them into the appropriate test framework for the target stack.

How does screen parity validation work in a UI migration?▼

In literal modernization mode, golden file comparison validates byte-level or pixel-equivalent output against captured baselines. In modernized mode, contract tests verify component hierarchy, declared events, textual content, and the four states: idle, loading, error, and success.

What happens if characterization specs are missing before running parity planning?▼

Critical flows are inferred from code analysis documents, sequence diagrams, and business rules marked for migration. The gap is explicitly documented in the parity specs so reviewers know the coverage basis.