reversa-archaeologist

Analyzes legacy code module by module to extract algorithms, data structures, and data dictionaries.

1|Updated Jul 10, 2026
One-click install
npx skills add https://github.com/tjsasakifln/extra-cli --skill reversa-archaeologist-tjsasakifln
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reversa-archaeologist
Source: https://github.com/tjsasakifln/extra-cli/tree/main/.agents/skills/reversa-archaeologist
Command: npx skills add https://github.com/tjsasakifln/extra-cli --skill reversa-archaeologist-tjsasakifln

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Reverse-engineering a legacy codebase requires deep, module-by-module analysis that is easy to lose track of across long sessions. This Skill performs the excavation phase of a reverse engineering workflow, systematically extracting control flows, algorithms, data structures, and business rules from legacy code into structured, reusable documentation. ## Core Features & Use Cases - Module-by-module deep analysis: Extracts functions, conditionals, loops, error handling, algorithms, validation logic, entities, DTOs, constants, and feature flags from each module in the analysis plan. - Tiered documentation output: Generates code-analysis.md, data-dictionary.md, and Mermaid flowcharts scaled to the configured doc_level (essencial, completo, detalhado). - Checkpointed sessions: Saves per-module checkpoints to .reversa/state.json and offers preventive pauses after intensive analysis so work can resume in a fresh session without quality loss. - Use Case: After running the reversa-scout on an unfamiliar legacy system, use this Skill to produce a structured modules.json (per the references schema) plus human-readable analysis that downstream agents (Detective, Architect, Writer) consume. ## Quick Start Analyze the legacy project modules listed in .reversa/plan.md and generate the code analysis, data dictionary, and flowcharts into the output folder defined in .reversa/state.json.

Frequently Asked Questions about reversa-archaeologist

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

FAQPage Schema
How do I reverse engineer a legacy codebase module by module?▼

Run the scouting phase first to build a module plan, then this Skill analyzes each module's functions, conditionals, loops, algorithms, entities, and business rules. Results are written to code-analysis.md, data-dictionary.md, and a structured modules.json file.

What artifacts does a legacy code analysis produce?▼

It produces a consolidated code-analysis.md, a structured modules.json following the references schema, and optionally a data-dictionary.md plus Mermaid flowcharts per module or per function, depending on the configured doc_level (essencial, completo, detalhado).

Does this Skill work with Claude Code, Cursor, and other AI agents?▼

Yes, the frontmatter declares compatibility with Claude Code, Codex, Cursor, Gemini CLI, and other agents supporting the Agent Skills format. It relies only on Markdown instructions and file-based state, with no platform-specific scripts.

How does the Skill handle long analysis sessions without losing progress?▼

It saves a checkpoint to .reversa/state.json after each module and, after three or more modules or an intensive read, offers the user a pause to clear context and resume in a fresh session. The checkpoint field tracks modules already analyzed.

What are the limitations of automated legacy code analysis?▼

Findings are tagged with a confidence scale: confirmed (extracted directly from code), inferred (pattern-based), or unknown (not determinable). Inferred and unknown items require human validation before being trusted in downstream architecture or rewrite decisions.