What problem does it solve? Legacy codebases accumulate technical debt, but teams struggle to decide where refactoring effort pays off. This Skill acts as an orchestrator that scans working legacy code, inventories improvement opportunities, ranks them by real return on investment (hotpath impact, coupling, change frequency) rather than aesthetics, and routes each one to the right specialist agent. It never modifies code itself. ## Core Features & Use Cases - Opportunity Inventory: Detects code smells and classifies each by specialist verb: restructure, modularize, decouple, optimize, simplify, standardize, or prune. - ROI-Based Prioritization: Ranks opportunities by impact, cost, and risk, with confidence levels (green/yellow/red) tied to test coverage and behavior proof. - Context-Organized Registry: Stores opportunities and transformations per feature or module under _reversa_refactor/<context>/ using a YAML-frontmatter schema, with full traceability to specs and business rules. - Use Case: A developer says "the freight calculation module is a monster." The Skill resolves the context, reads the code, registers prioritized opportunities like "restructure nested conditionals in freight calculator (hotpath, low cost)", and routes the chosen one to /reversa-restructure with a gate before any change is applied. ## Quick Start Ask the agent to analyze the legacy code in a specific module and list which refactorings are worth doing first, ordered by return on investment.
