One-click install
npx skills add https://github.com/AlexandrePontesjr/calculadora-Juridica --skill reversa-archaeologist-alexandrepontesjr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reversa-archaeologist
Source: https://github.com/AlexandrePontesjr/calculadora-Juridica/tree/main/.agents/skills/reversa-archaeologist
Command: npx skills add https://github.com/AlexandrePontesjr/calculadora-Juridica --skill reversa-archaeologist-alexandrepontesjr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It converts a legacy codebase into clear, module-by-module engineering documentation by extracting control flow, business logic, data structures, and a data dictionary directly from the source.

Core Features & Use Cases

  • Module-by-module engineering reverse: analyzes each planned module to produce control flow, algorithms, error handling, and validation logic.
  • Domain data extraction: derives a data dictionary (when configured) and documents entities/DTOs, including field types, defaults, and relationships.
  • Checkpointed excavation: updates progress in .reversa/state.json after each module, enabling resumable high-effort analysis.
  • Config-driven documentation depth: uses doc_level (essencial, completo, detalhado) to decide which artifacts to generate (e.g., data-dictionary.md, module flowcharts, function flowcharts).

Quick Start

Run the reversa archaeologist workflow using your existing .reversa/state.json, .reversa/plan.md, and .reversa/context/surface.json so it writes the consolidated outputs into your 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 document legacy code algorithms and control flow without existing comments?

To document undocumented legacy code, this Skill performs module-by-module reverse engineering to extract algorithms, control flow, and business logic directly from the source. It transforms the codebase into structured engineering artifacts like flowcharts and data dictionaries for downstream teams.

What is the best way to extract a data dictionary from an undocumented codebase?

Extracting a data dictionary from an undocumented codebase involves analyzing domain data to derive entities and DTOs. This process documents field types, defaults, and relationships, outputting a structured data-dictionary.md file when configured to run at a detailed documentation level.

How do I generate module flowcharts from existing source code?

Generating module flowcharts from source code is achieved through deep reverse engineering analysis. By evaluating each planned module's control flow and validation logic, the system produces visual flowcharts based on your chosen documentation depth level.

Can I resume reverse engineering a large legacy codebase if the process is interrupted?

Yes, you can resume reverse engineering a large legacy codebase because the process uses checkpointed excavation. It updates progress in a state.json file after each module, enabling resumable high-effort analysis without losing prior work.

Do I need a scout analysis before running a deep code excavation?

Yes, a scout analysis is required before deep code excavation. The archaeologist workflow applies during the excavation phase after a scout, requiring existing state.json, plan.md, and context surface files to read and process the planned modules effectively.