reversa-inspector

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

Updated Jun 26, 2026
One-click install
npx skills add https://github.com/RLuf/fzagent --skill reversa-inspector-rluf
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reversa-inspector
Source: https://github.com/RLuf/fzagent/tree/main/.agents/skills/reversa-inspector
Command: npx skills add https://github.com/RLuf/fzagent --skill reversa-inspector-rluf

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, so cutover decisions rest on explicit criteria rather than guesswork. ## Core Features & Use Cases - Parity strategy definition: Produces parity_specs.md selecting validation modes such as shadow mode, characterization tests, contract tests, and data parity, with measurable acceptance criteria and cutover blocking rules. - 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; OO to functional requires immutability and composition checks). - Gherkin spec generation: Writes one .feature file per critical flow with traceability to process flows, target architecture, and business rules, including screen parity scenarios (golden file comparison or component contract tests) when the legacy system has a UI. - Use Case: After a migration team decides to move a monolithic synchronous system to an event-driven architecture, invoke this Skill to generate parity specs requiring idempotency and message-ordering scenarios for every critical flow, plus a divergence metric that blocks cutover if exceeded. ## Quick Start Run /reversa-inspector after the migration strategy and target architecture are approved to generate parity_specs.md and Gherkin parity test files under _reversa_sdd/migration/.

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 behaves the same as the legacy system?▼

Define parity specs that select validation modes such as shadow mode traffic comparison, characterization tests, contract tests, and data parity checksums. Set a primary divergence metric, an observation window, and a cutover blocking criterion, then cover each critical flow with Gherkin scenarios.

What extra testing is needed when migrating from synchronous to event-driven architecture?▼

Event-driven targets require scenarios for message ordering per key, idempotency under reprocessing, eventual consistency windows, and queue failure behavior including retry and dead letter queues. Functional equivalence alone is insufficient for this paradigm transition.

How do I validate UI parity when modernizing legacy screens?▼

For literal modernization, compare implementation output byte-for-byte against golden files using the normalization rules in the manifest. For modernized screens, use contract tests verifying component hierarchy, declared events, textual content, and the four states: idle, loading, error, success.

Can the generated Gherkin feature files be executed directly as tests?▼

No. The .feature files are specifications, not executable tests, and must not contain framework calls. A coding agent translates them into the appropriate test framework for the target stack.

What happens if characterization specs from the discovery phase are missing?▼

Critical flows are derived from code analysis documents, sequence diagrams, and business rules marked as critical. The gap is explicitly documented in parity_specs.md so reviewers know the coverage basis.