What problem does it solve?
Replaces improvisation during UI migration by converting legacy screen behavior and text into executable, mode-aware specifications that a codifier can implement without guessing layout, hierarchy, or messages.
Core Features & Use Cases
- Two-phase screen translation with mandatory human mode selection: enforces a deliberate choice between literal, modernized, or hybrid translation before generating specs.
- Executable target screen generation: produces
target_screens.md with adapter-specific spec formats and required state/event contracts.
- Parity support via golden files (when available): emits
golden/ outputs plus manifest.yaml for constructive parity tests using the legacy oracle output.
- Deviation tracking and gating: records divergences in
screen_deviation_log.md and blocks handoff to the Inspector until deviations are resolved.
- Strict read-only behavior for legacy content: limits writes to
_reversa_sdd/migration/, _reversa_sdd/screens/, and derived design tokens.
Quick Start
Run the command /reversa-screen-translator to translate the legacy screens into target_screens.md after you confirm the translation mode (literal, modernized, or hybrid).