sandeco

    sandeco/reversa

    Transform legacy systems into executable specifications for AI coding agents

    web
    JavaScript
    MIT
    1.8K stars
    448 forks
    1.8K GitHub watchers
    Updated Oct 26, 2026
    View on GitHub

    Build with Backblaze B2

    SDKs, agent skills, IDE extensions, and reference pipelines from Backblaze Labs. All open source.

    Explore Backblaze Labs

    Loading star history...

    Where it stands

    Rank, growth pace and release cadence relative to everything GStars tracks.

    The project lists 1 contributor on GitHub.

    Use Cases & Benefits

    • Transforms legacy software into executable, traceable specifications for AI coding agents to safely analyze and evolve the system.
    • Enables safe AI-driven evolution of legacy code by generating operational contracts without modifying original project files.
    • Use for extracting implicit business rules and architecture from undocumented legacy systems to create formal specs.
    • Use for orchestrating AI agents to incrementally evolve legacy systems from specs to running code with traceability.
    • Use for generating self-contained HTML mini-sites documenting legacy system architecture and business logic for stakeholders.

    Should you depend on it?

    License terms, project hygiene and risks, from GitHub metadata and GStars' snapshots.

    License

    MIT

    Permissive: commercial use, modification and redistribution are allowed with attribution.

    Community files

    • README: present

    Watch-outs

    • Owned by an individual account with a single contributor on GitHub; plan for bus-factor risk.
    • No GitHub releases; pin a commit or tag instead of a release.

    General guidance from repository metadata, not legal advice. How we score

    From the README

    Turn legacy systems into executable specifications for AI agents.

    📄 Paper: Reversa: A Reverse Documentation Engineering Framework for Converting Legacy Software into Operational Specifications for AI Agents — Macedo & da Costa, May 2026.

    Reversa is a specification reverse-engineering framework. Install it inside a legacy project and it coordinates a team of specialized AI agents to analyze the existing code and generate complete, traceable specifications ready for use by any coding agent.

    Most production systems carry years of accumulated knowledge: implicit business rules, undocumented architectural decisions, critical logic buried in code nobody wants to touch. That knowledge exists, but it's trapped.

    AI agents are transformative for creating and evolving software, but they depend on specifications to operate safely. For new systems, you write the spec and the agent executes. For legacy systems — or those built with pure vibe coding — there is no spec: the agent has no way of knowing what it cannot break.

    Reversa is the bridge between the legacy system and AI agents.

    It analyzes the existing code, extracts accumulated knowledge (business rules, flows, module contracts, retroactive architectural decisions) and transforms everything into executable, traceable specifications ready for any coding agent.

    The result is not documentation for humans to read. These are operational contracts that allow an agent to evolve the system with fidelity to what already exists.

    Excerpt from the sandeco/reversa README on GitHub (MIT license). © its authors.Read the full README on GitHub

    Daily snapshots

    Stars gained per day, and how forks and open issues moved, from GStars' daily snapshots

    Sep 13: +2Sep 25: +2

    +355 stars over 84 days across 10 snapshot days; best day +2 on Sep 13.

    Forks

    448+72

    Open issues

    23+4

    Compared with peers in Web

    Fastest-growing repositories GStars tracks in this cohort for the week of Nov 1, by 7-day star growth

    sandeco/reversa compared with Web repositories by stars, 7-day star growth, health score and last release
    RepositoryStars+7dHealthLast release
    pingdotgg/t3code48.4K+16.6K40today
    pbakaus/impeccable104.0K+8.7K5410 days ago
    HunYiSage/dsh-purge19.2K+6.2K13today
    Renhuai123/ziwei-doushu16.2K+6.1K4421 days ago
    paperclipai/paperclip111.5K+2.8K5913 days ago
    sandeco/reversa1.8K—6—
    Category median48.4K+6.2K44—

    Discover Repositories

    Search across tracked repositories by name or description