sandeco

reversa

AI🌱 NEW PROJECT BOOST#AI Agents#Legacy Code#Reverse Engineering#Software Architecture#Documentation

// summary

Reversa is a framework that coordinates specialized AI agents to analyze legacy codebases and generate comprehensive, traceable technical specifications. It functions as a bridge between existing systems and modern coding agents by creating operational contracts that ensure safe and informed development. The tool operates with a strict immutability guarantee, ensuring that no existing project files are ever modified or deleted during the analysis process.

// technical analysis

Reversa is a specification reverse-engineering framework designed to transform legacy codebases into structured, executable specifications for AI agents. By orchestrating a team of specialized agents through a five-phase pipeline, it extracts implicit business rules, architectural decisions, and technical contracts that are otherwise trapped in undocumented code. This approach solves the 'vibe coding' problem by providing AI agents with the necessary operational context to evolve legacy systems safely without the risk of breaking existing logic.

// key highlights

Orchestrates a multi-agent pipeline including roles like Scout, Archaeologist, and Architect to perform comprehensive code analysis.

Generates a wide array of technical documentation, including C4 diagrams, ERDs, state machines, and API specifications.

Ensures project immutability by strictly restricting all AI-generated output to dedicated folders, leaving the original legacy source code untouched.

Implements a confidence scale (Confirmed, Inferred, Gap) to help users distinguish between verified code logic and areas requiring human validation.

Supports a broad range of AI engines and coding assistants, including Claude Code, Cursor, Aider, and GitHub Copilot, without requiring external API keys.

Provides persistent state management, allowing analysis sessions to be interrupted and resumed without losing progress.

// use cases

Reverse-engineering legacy code into executable specifications for AI agents

Automated extraction of business rules, architectural decisions, and data structures

Generating traceable documentation including C4 diagrams, ERDs, and API contracts

// getting started

To begin, run 'npx reversa install' in the root of your legacy project to detect your AI environment and set up the necessary agent skills. Once installed, open the project in your preferred AI agent and trigger the analysis by typing '/reversa' or 'reversa'. The framework will then create an exploration plan and begin generating documentation in the '_reversa_sdd/' directory.