# sandeco/reversa

Transform legacy systems into executable specifications for AI coding agents

Repository: https://github.com/sandeco/reversa
Canonical: https://ross.abutalabs.com/products/reversa
Language: JavaScript
License: MIT
License Family: permissive
Last push: 2026-08-23T22:51:07+00:00

## Health v2 (maintenance only)
Score: 59/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 35, longevity 9
- inputs: {"age_days": 129, "days_push": 10, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, young
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1526, forks 395 (observed 2026-08-28T04:04:58.090378+00:00)

## What it is
Reversa is a specification reverse-engineering framework that installs into legacy codebases and coordinates specialized AI agents to analyze existing code. It extracts business rules, flows, and architectural decisions into executable, traceable specifications that AI coding agents can use to safely evolve the system.

## Use cases
- generate specifications from a legacy codebase for AI coding agents
- document undocumented business rules in old systems
- make a legacy project safe for AI-assisted refactoring
- reverse-engineer specs from vibe-coded projects
- create operational contracts from existing code
- prepare an old codebase for Claude Code or Cursor
- extract module contracts and architecture from legacy software

## When to choose
- you have a legacy system with no documentation and want AI agents to work on it safely
- you need traceable, executable specifications rather than human-readable docs
- you use Claude Code, Codex, Cursor, or similar AI coding engines

## When to avoid
- you are starting a greenfield project where you can write specs directly
- you only need human-readable documentation rather than agent-consumable contracts
- your project is not JavaScript/Node.js based

## Facets
- artifact type: framework
- maturity: active
- function: reverse-engineering, documentation, agent-framework, developer-tools
- domain: developer-tools, documentation, artificial-intelligence, reverse-engineering
- platform: cli, cross-platform
- tags: legacy-code, executable-specifications, ai-coding-agents, specification-generation, claude-code, cursor, ai-agents, nodejs

## Member repositories
- sandeco/reversa (main) score 59

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:58.090378+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:31:37.875338+00:00, confidence not recorded.
  - readme: https://github.com/sandeco/reversa (fetched 2026-08-28T04:04:58.090378+00:00, sha b559cc07f14b)
  - registry_npm: https://registry.npmjs.org/reversa (fetched 2026-08-29T11:34:29.002627+00:00, sha 7d77990128c8)
- Data as of 2026-08-30T08:39:29.467469+00:00.