reversa-inspector

Generate paradigm-adapted parity specifications and Gherkin scenarios for Reversa migrations.

Updated May 13, 2026
One-click install
npx skills add https://github.com/cliffthelin/AXiomEngine --skill reversa-inspector-cliffthelin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reversa-inspector
Source: https://github.com/cliffthelin/AXiomEngine/tree/main/skills/reversa/reversa-inspector
Command: npx skills add https://github.com/cliffthelin/AXiomEngine --skill reversa-inspector-cliffthelin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Reversa-inspector eliminates uncertainty during migration by defining rigorous, paradigm-aware criteria to demonstrate that the new system matches the legacy system’s behavior where it matters.

Core Features & Use Cases

  • Parity strategy definition: Selects applicable validation modes (e.g., shadowing, characterization, contract checks, data parity) and sets measurable “acceptable parity” criteria.
  • Migration-ready parity artifacts: Produces migration outputs including parity_specs.md and Gherkin-based parity_tests/*.feature files for critical flows.
  • Paradigm-adapted equivalence: Adds required extra parity dimensions when the target paradigm shifts (e.g., event-driven ordering/idempotency, OO invariants, functional immutability, actor supervision).
  • Screen parity planning (optional): Generates visual parity scenarios in literal mode (using golden manifests), or contract-style screen scenarios in modernized/hybrid modes, while respecting deviation logs.

Quick Start

Instruct your coding agent to run /reversa-inspector after /reversa-migrate so it reads the migration SDD prerequisites and writes parity_specs.md plus the required parity_tests/*.feature files.

Frequently Asked Questions about reversa-inspector

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

FAQPage Schema
How do I prove migration parity when moving legacy systems to a new architecture?

To prove migration parity, you generate paradigm-adapted parity specifications and Gherkin scenarios that validate functional equivalence between legacy and new systems. This involves defining acceptable parity criteria and producing testable artifacts like `parity_specs.md` and `.feature` files.

How do I write Gherkin scenarios for behavioral equivalence testing during a migration?

You write Gherkin scenarios for behavioral equivalence by defining paradigm-adapted parity tests that validate critical flows. The process generates `parity_tests/*.feature` files based on migration SDD inputs, ensuring explicit traceability without executing the tests.

What validation modes are needed to establish audit defensibility for a system migration?

Audit defensibility requires selecting applicable validation modes such as shadowing, characterization, contract checks, and data parity. These modes establish measurable acceptable parity criteria and generate traceable artifacts proving functional equivalence.

Does this approach handle paradigm shifts like moving to event-driven or functional architectures?

Yes, paradigm-adapted equivalence adds specific parity dimensions for target paradigm shifts. It covers event-driven ordering and idempotency, OO invariants, functional immutability, and actor supervision, ensuring the new paradigm's specific guarantees are validated.

Can I validate UI screen parity as part of a legacy system migration?

You can validate UI screen parity by generating visual parity scenarios using golden manifests in literal mode, or contract-style screen scenarios in modernized or hybrid modes. This process respects deviation logs to account for approved UI changes.

What inputs are required to generate parity specifications for a migration?

Generating parity specifications requires reading migration SDD inputs to understand the legacy-to-new transformation. It produces `_reversa_sdd/migration/parity_specs.md` and required Gherkin `.feature` files while maintaining explicit traceability throughout the validation process.