reversa-archaeologist

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

Updated Aug 14, 2026
One-click install
npx skills add https://github.com/Ruggery/OCR_Cartorio --skill reversa-archaeologist-ruggery
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reversa-archaeologist
Source: https://github.com/Ruggery/OCR_Cartorio/tree/main/.agents/skills/reversa-archaeologist
Command: npx skills add https://github.com/Ruggery/OCR_Cartorio --skill reversa-archaeologist-ruggery

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Reverse-engineering a legacy codebase requires deep, structured analysis that is hard to do consistently by hand. This Skill performs the excavation phase of a reverse-engineering workflow, reading each module of a legacy project and producing consolidated technical documentation with confidence levels for every finding. ## Core Features & Use Cases - Module-by-module analysis: Extracts control flow, non-trivial algorithms, data structures, entities, business rules, and configuration metadata from each module listed 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). - Structured machine-readable output: Produces modules.json following a defined schema with confidence levels (confirmed, inferred, unknown) consumed by downstream reverse-engineering agents. - Checkpointing and session pacing: Saves per-module checkpoints to state.json and offers preventive pauses after intensive analysis to preserve quality across sessions. - Use Case: After running the reversa-scout surface scan on an undocumented legacy system, invoke this Skill to excavate each module and produce a data dictionary and flowcharts before writing the new specification. ## Quick Start Ask the agent to run the reversa-archaeologist excavation on the modules listed in .reversa/plan.md and generate the code analysis and data dictionary.

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 excavation phase after a surface scan: the skill reads the module plan in .reversa/plan.md, analyzes each module's control flow, algorithms, and data structures, and writes consolidated documentation plus a structured modules.json with confidence levels.

What artifacts does a reverse engineering code analysis produce?▼

It produces code-analysis.md with consolidated technical findings, data-dictionary.md with field types and constraints, Mermaid flowcharts per module, and modules.json following a defined schema. Output volume scales with the doc_level setting: essencial, completo, or detalhado.

How are uncertain findings marked during legacy code analysis?▼

Every finding carries a confidence level: confirmed (extracted directly from code), inferred (based on patterns), or unknown (not determinable). These map to green, yellow, and red markers in the documentation and to enum values in modules.json.

Can I pause a long legacy code analysis and resume later?▼

Yes. The skill saves a checkpoint to .reversa/state.json after each module and, after three or more modules or an intensive read, offers a pause so you can clear the session and resume with /reversa without losing progress.

What inputs does the reverse engineering excavation phase require?▼

It requires .reversa/state.json for output folder and doc_level, .reversa/plan.md listing the modules to analyze, and .reversa/context/surface.json from the prior scout phase. Without these, the excavation cannot start.