# Reversa

A framework that installs into a legacy project and coordinates a team of AI agents to analyze the existing code and produce traceable, executable specifications that coding agents can use to evolve the system safely.

Reversa is a specification reverse-engineering framework for legacy software. Installed into an existing project, it coordinates specialized AI agents that analyze the code and extract accumulated knowledge, such as implicit business rules, undocumented architectural decisions and module contracts, then turn that knowledge into complete, traceable specifications any coding agent can use.

The output is meant as an operational contract for an agent to follow, rather than documentation for a person to read, so the agent knows what it must not break in a system that was never specified in the first place. The installer only creates new files, such as `CLAUDE.md`, `AGENTS.md` and files under `.agents/skills/` and `.reversa/`, and never deletes or modifies existing project files; it installs with `npx reversa install` and requires Node.js 18 or later.

Website: https://github.com/sandeco/reversa
