reversa-archaeologist

Extracts algorithms, control flows, and data structures from legacy code modules.

Updated Jun 26, 2026
One-click install
npx skills add https://github.com/RLuf/fzagent --skill reversa-archaeologist-rluf
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reversa-archaeologist
Source: https://github.com/RLuf/fzagent/tree/main/.agents/skills/reversa-archaeologist
Command: npx skills add https://github.com/RLuf/fzagent --skill reversa-archaeologist-rluf

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Reverse-engineering a legacy codebase module by module is slow and error-prone: undocumented business rules, hidden data structures, and complex control flows get lost. This Skill performs deep, structured excavation of each module and produces consistent technical documentation artifacts. ## Core Features & Use Cases - Module-by-module deep analysis: Extracts functions, conditionals, loops, error handling, algorithms, data transformations, and validation logic from each module listed in the reverse-engineering plan. - Structured data dictionary and flowcharts: Generates code-analysis.md, data-dictionary.md, Mermaid flowcharts per module (and per function at the detailed level), plus a machine-readable modules.json following a defined schema. - Confidence labeling and checkpoints: Tags every finding as confirmed, inferred, or gap, and saves per-module checkpoints in .reversa/state.json so long sessions can pause and resume safely. - Use Case: During the excavation phase of a legacy system reverse-engineering project, run this after the scout phase to turn each module's source code into documented algorithms, entities, and business rules for the architect and writer phases. ## Quick Start Analyze the 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 document a legacy codebase module by module?▼

Run this Skill after the scout phase: it reads the module plan in .reversa/plan.md and analyzes each module's functions, conditionals, loops, algorithms, and data structures. Results are written to code-analysis.md, data-dictionary.md, and Mermaid flowcharts.

What artifacts does reverse engineering code analysis produce?▼

It always produces code-analysis.md and a structured modules.json. At completo or detalhado doc levels it also generates data-dictionary.md and per-module Mermaid flowcharts; detalhado adds per-function flowcharts for non-trivial logic.

How are uncertain findings marked during code analysis?▼

Every finding uses a three-level confidence scale: confirmed (extracted directly from code), inferred (based on patterns), or gap (not determinable). The same confirmed/inferred/unknown values appear in the modules.json schema.

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

Yes. After each module a checkpoint is saved to .reversa/state.json under checkpoints.archaeologist.modules_analyzed. After three or more modules the Skill offers a pause so you can resume in a fresh session without losing progress.

What inputs are required before running the excavation phase?▼

The Skill expects .reversa/state.json with output_folder and doc_level fields, .reversa/plan.md listing modules to analyze, and .reversa/context/surface.json from the prior scout phase. Without these it cannot determine scope or output location.