reversa-archaeologist

Reverse engineer legacy codebases module-by-module into technical artifacts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Este Skill ajuda a transformar um projeto legado pouco documentado em conhecimento técnico acionável, decompondo o código e seus fluxos por módulos para facilitar manutenção, migração e reengenharia.

Core Features & Use Cases

  • Análise módulo a módulo: identifica funções e métodos principais, condicionais, loops, tratamento de erros e pontos de lógica de negócio.
  • Extração de algoritmos e lógica: evidencia cálculos, transformações, validações e regras embutidas no código.
  • Construção de dicionário de dados: levanta entidades/estruturas e mapeia campos, tipos, obrigatoriedade e defaults, alinhado ao nível de documentação.
  • Saídas para descoberta e reuso: gera code-analysis.md e modules.json, e opcionalmente data-dictionary.md e fluxogramas quando doc_level for completo ou detalhado.

Quick Start

Use o skill reversa-archaeologist para analisar os módulos listados no .reversa/plan.md, usando output_folder e doc_level definidos em .reversa/state.json, e gerar os artefatos em <output_folder>/_reversa_sdd/.

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 to extract control flow and algorithms?

To reverse engineer legacy code, this Skill performs deep module-by-module analysis to extract control flow, algorithms, and data structures. It processes modules sequentially to support engineering comprehension and migration planning.

How do I generate a data dictionary from undocumented legacy code?

You can generate a data dictionary by running this Skill to survey entities and structures, mapping fields, types, required attributes, and defaults. The output is produced as `data-dictionary.md` when the documentation level is set to detailed or complete.

What is the best way to map modules and engineering documentation for a migration plan?

Mapping modules for migration is best handled by generating `code-analysis.md` and `modules.json` artifacts. This Skill consolidates technical details from each module, providing actionable knowledge for maintenance and reengineering.

Do I need specific configuration files to start analyzing legacy modules?

Yes, you need configuration files to start analyzing legacy modules. The workflow requires a scout context from `.reversa/context/surface.json`, a module plan from `.reversa/plan.md`, and state settings from `.reversa/state.json`.

Can I control the level of engineering documentation and output format generated?

Yes, you can control the documentation level and output format. The Skill honors the `output_folder` and `doc_level` parameters in `.reversa/state.json`, generating optional flowcharts and data dictionaries only when configured for detailed or complete output.