reversa-archaeologist

Reverse-engineer legacy source code into module-level operational specifications.

1.5k|383|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/sandeco/reversa --skill reversa-archaeologist-sandeco
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reversa-archaeologist
Source: https://github.com/sandeco/reversa/tree/main/agents/reversa-archaeologist
Command: npx skills add https://github.com/sandeco/reversa --skill reversa-archaeologist-sandeco

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It turns undocumented legacy code into reliable, module-by-module operational specifications that AI agents can use without breaking behavior.

Core Features & Use Cases

  • Deep code excavation: analyzes each module to extract control flow, algorithms, data structures, and validation logic.
  • Data dictionary generation: produces a structured data model (fields, types, requirements, defaults) when the selected doc level supports it.
  • Traceable outputs for agents: writes consolidated artifacts for downstream agents, including analysis summaries and a structured modules.json, and saves checkpoints per module.

Quick Start

Use the reversa-archaeologist agent to analyze the legacy project modules listed in the current Reversa plan and generate code-analysis and module data dictionary outputs in the configured output folder.

Frequently Asked Questions about reversa-archaeologist

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate operational specifications from legacy code for AI agents?▼

To generate operational specifications from legacy code, this Skill reverse-engineers modules to extract control flow, algorithms, and data structures, producing traceable artifacts and a structured modules.json for downstream AI agents.

Can I automatically build a data dictionary from undocumented source modules?▼

Yes, you can build a data dictionary from undocumented source modules. It analyzes legacy code to produce a structured data model containing fields, types, requirements, and defaults when the selected documentation level supports it.

What is the best way to extract control flow and algorithms from legacy projects?▼

The best way to extract control flow and algorithms from legacy projects is through deep code excavation, which analyzes each module individually to capture validation logic and operational truths for deterministic specification generation.

How does module analysis handle checkpoints during reverse engineering?▼

During reverse engineering, module analysis handles checkpoints by reading Reversa state and plan files, then updating checkpoints after each module is processed to ensure traceable and resolvable spec generation.

Do I need Reversa state and plan files before starting module analysis?▼

Yes, you need Reversa state and plan files before starting module analysis. The Skill targets legacy projects during the excavation phase by reading these files to identify which modules require analysis and documentation generation.

Are there limitations when generating specifications for very large legacy codebases?▼

When generating specifications for large legacy codebases, processing operates module-by-module and saves checkpoints after each one, so limitations depend on configuring the appropriate documentation level and managing the output folder structure.