How sandeco/reversa works
Reversa is an AI-agent framework and installer that turns knowledge in legacy software into traceable, operational specifications. The main workflow starts when a user invokes the installed Reversa skill in an AI coding environment: its orchestrator coordinates reconnaissance, code excavation, interpretation, specification generation, and review. The resulting specifications support separate migration, forward-development, and HTML-documentation workflows; the framework also provides a greenfield path. The graph combines README-documented capabilities with sampled CLI and installer behavior; agent internals were not sampled, so orchestration links reflect documented workflow rather than inspected calls.
Main entry points: reversa Discovery orchestrator · install.js Install command · reversa.js Reversa CLI · writer.js Installer writer
Components 23
Installation
- Reversa CLI
bin/reversa.js - Install command
lib/commands/install.js - Engine detection
lib/installer/detector.js - Setup prompts
lib/installer/prompts.js - Installer writer
lib/installer/writer.js - AI engine setup
Legacy Discovery
- Discovery orchestrator
agents/reversa - Reconnaissance
agents/reversa-scout - Code excavation
agents/reversa-archaeologist - Rule interpretation
agents/reversa-detective - Architecture analysis
agents/reversa-architect - Spec generation
agents/reversa-writer - Spec review
agents/reversa-reviewer
Specification Use
- Executable specifications
- Forward development
agents/reversa-forward - Legacy migration
agents/reversa-migrate - HTML mini-site
agents/reversa-docs
Additional Workflows
- Greenfield specs
agents/reversa-new - Defect traceability
agents/reversa-debugger - Effort and pricing
agents/reversa-pricing-estimate
Other components
- Project user
- Legacy project
- AI coding agent
Connections 26
- Project user → Reversa CLI: runs command
- Reversa CLI → Install command: dispatches install
- Install command → Engine detection: detects engines
- Install command → Setup prompts: collects setup
- Install command → Installer writer: installs files
- Installer writer → AI engine setup: writes skills
- AI engine setup → AI coding agent: enables invocation
- Project user → AI coding agent: invokes skill
- AI coding agent → Discovery orchestrator: runs
- Discovery orchestrator → Reconnaissance: coordinates
- Discovery orchestrator → Code excavation: coordinates
- Discovery orchestrator → Rule interpretation: coordinates
- Discovery orchestrator → Architecture analysis: coordinates
- Discovery orchestrator → Spec generation: coordinates
- Discovery orchestrator → Spec review: coordinates
- Reconnaissance → Legacy project: inspects
- Code excavation → Legacy project: analyzes
- Spec generation → Executable specifications: generates
- Spec review → Executable specifications: reviews
- Executable specifications → Forward development: guides evolution
- Executable specifications → Legacy migration: guides rebuild
- Executable specifications → HTML mini-site: renders
- Project user → Greenfield specs: starts idea
- Greenfield specs → Executable specifications: generates
- Project user → Defect traceability: invokes
- Executable specifications → Effort and pricing: supports estimate