reversa-archaeologist

Analyze legacy codebase modules to extract control flow, algorithms, and data structures.

Updated May 16, 2026
One-click install
npx skills add https://github.com/ricardops34/rcg-crm --skill reversa-archaeologist
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reversa-archaeologist
Source: https://github.com/ricardops34/rcg-crm/tree/main/.agents/skills/reversa-archaeologist
Command: npx skills add https://github.com/ricardops34/rcg-crm --skill reversa-archaeologist

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps teams understand and document a legacy codebase by extracting module-by-module algorithms, control flow, data structures, and a data dictionary from the actual implementation.

Core Features & Use Cases

  • Module-by-module code analysis: Identify key functions/methods, branching logic, loops, error handling, and the real business logic embedded in code.
  • Data dictionary extraction: Produce field-level documentation for entities/DTOs, including types and constraints when doc_level is set to generate it.
  • Structured outputs for downstream agents: Generate consolidated artifacts such as _reversa_sdd/code-analysis.md and .reversa/context/modules.json, with optional flowcharts and deeper details when configured.

Quick Start

Run the reversa-archaeologist skill to analyze the modules defined in .reversa/plan.md and write the results to the output_folder specified 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 legacy code to extract control flow and data structures?

Reverse engineering legacy code involves analyzing modules to extract control flow, algorithms, and data structures. This process produces structured artifacts like code-analysis markdown files and module JSON contexts for clear specification documentation.

How do I generate a data dictionary from an undocumented legacy codebase?

Generating a data dictionary from legacy code requires analyzing entities and DTOs module by module. By configuring the documentation level, you can extract field-level types and constraints to output a comprehensive domain-oriented data dictionary.

What is the best way to document legacy code algorithms for downstream agents?

Documenting legacy code algorithms for downstream agents requires extracting business logic into structured formats. Module analysis produces deterministic artifacts like modules.json and code-analysis markdown, providing clear execution contexts for automated consumption.

Does architecture discovery from legacy code require a prior module plan?

Architecture discovery requires a defined plan of modules and execution context before analysis. A prior scout pass must define the module structure in a plan file and surface JSON to guide the deterministic excavation of the codebase.

Can I generate flowcharts when reverse engineering a legacy codebase?

You can generate flowcharts when reverse engineering a legacy codebase by setting the appropriate documentation level. The analysis process optionally produces Mermaid flowcharts alongside structured artifacts to visualize control flow and module logic.

What are the limitations of module-by-module code analysis for spec documentation?

Module-by-module code analysis limitations depend on the defined documentation level and prior scout pass accuracy. The process strictly follows the defined module plan and surface context, meaning unlisted modules or undefined execution contexts will not be excavated.