reversa-inspector

Generates migration parity specs and Gherkin test scenarios for legacy-to-target systems.

1.5k|383|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/sandeco/reversa --skill reversa-inspector-sandeco
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reversa-inspector
Source: https://github.com/sandeco/reversa/tree/main/agents/reversa-inspector
Command: npx skills add https://github.com/sandeco/reversa --skill reversa-inspector-sandeco

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It defines how to prove that a migrated system behaves equivalently to the legacy system where it matters, even when the migration changes the execution paradigm.

Core Features & Use Cases

  • Parity specs for migration handoff: produces parity_specs.md describing acceptance criteria and validation modes aligned to the confirmed paradigm.
  • Gherkin parity scenarios per critical flow: generates parity_tests/*.feature (one file per critical flow) as executable specifications for a downstream coding agent to map into the right test framework.
  • UI parity handling across modernization modes: creates visual golden-file comparison scenarios in literal mode, contract-oriented UI parity scenarios in modernized mode, or skips UI parity when configured as skipped.
  • Paradigm-aware coverage: expands coverage with required additional dimensions (idempotency, message/order semantics, invariants, immutability, supervision, etc.) when the paradigm changes.

Quick Start

Use the reversa-inspector agent to generate parity specs and Gherkin parity test scenarios for the confirmed migration target by running the /reversa-inspector activation within your migration pipeline.

Frequently Asked Questions about reversa-inspector

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

FAQPage Schema
How do I prove behavioral parity between a legacy system and a migrated target?

To prove behavioral parity, you need to establish equivalence criteria and generate executable Gherkin specifications for critical legacy flows. This approach validates that the migrated system behaves equivalently where it matters, even when the execution paradigm changes.

How do I generate Gherkin specs for migration acceptance testing?

You generate Gherkin specs for migration acceptance testing by creating parity scenarios for each critical flow, outputting them as .feature files. These executable specifications allow a downstream coding agent to map them into the correct test framework.

What is the best way to handle UI parity validation during screen modernization?

Handling UI parity validation during screen modernization depends on the configured mode: use visual golden-file comparison for literal parity, contract-oriented scenarios for modernized parity, or skip UI parity validation entirely when not applicable.

Does migration parity testing require additional coverage when changing execution paradigms?

Migration parity testing does require additional coverage when changing execution paradigms. You must expand validation to include paradigm-specific dimensions like idempotency, message-order semantics, invariants, immutability, and supervision to ensure true behavioral equivalence.

What prerequisites do I need before generating parity specifications for a legacy system migration?

Before generating parity specifications for a legacy system migration, you need to read the migration SDD prerequisites, select validation modes, and define primary acceptance metrics. These inputs drive the generation of the parity specs and test scenarios.

Can I execute runtime parity tests directly from the generated Gherkin feature files?

You cannot execute runtime parity tests directly from the generated Gherkin feature files. They serve as executable specifications that define acceptance criteria, requiring a downstream coding agent to map them into the appropriate runtime test framework.