skills.rest
sandeco
sandecoCOMMUNITY
Explore all skills by this author →
Website𝕏@sandecoGitHub

reversa-docs-mapper

Generate interactive 2D and 3D architecture HTML pages from legacy modules and dependencies.

1.5k|383|Updated Apr 26, 2026
Search Tags:#documentation generation#three.js#dependency graph#legacy modernization#architecture mapping#d3 force-directed#code city
One-click install
npx skills add https://github.com/sandeco/reversa --skill reversa-docs-mapper-sandeco
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reversa-docs-mapper
Source: https://github.com/sandeco/reversa/tree/main/agents/reversa-docs-mapper
Command: npx skills add https://github.com/sandeco/reversa --skill reversa-docs-mapper-sandeco

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Transforma conhecimento disperso em código legado (módulos, dependências e topologia) em visualizações navegáveis que ajudam agentes e equipes a entender rapidamente como o sistema está organizado.

Core Features & Use Cases

  • Arquitetura 3D (Code City via Three.js): gera uma página que representa a estrutura física e conceitual do sistema para leitura rápida e orientação de navegação.
  • Mapa de módulos 2D (force-directed via D3): cria um diagrama 2D dos módulos e suas dependências com destaque para ciclos e filtros interativos.
  • Topologia side-by-side (legado vs moderno vs híbrido): opcionalmente renderiza a evolução/topologia quando detectada em architecture.md.
  • Reuso de cache com fallback: reutiliza assets/data/modules.json e deps.json quando válidos, ou regenera via scripts.
  • Operação segura e não destrutiva: escreve apenas em .reversa/documentation/ e cria backups ao sobrescrever páginas.

Quick Start

Use o orquestrador para executar /reversa-docs-mapper e gerar .reversa/documentation/arquitetura.html e .reversa/documentation/modulos.html (e topologia.html quando existir topologia detectada).

Frequently Asked Questions about reversa-docs-mapper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate 3D architecture maps from legacy source code?▼

You generate 3D architecture maps from legacy source by running the /reversa-docs-mapper command, which extracts modules and dependencies into interactive Three.js Code City HTML pages for rapid system navigation.

What is a force-directed dependency graph for legacy modernization?▼

A force-directed dependency graph for legacy modernization is a 2D D3 diagram mapping modules and dependencies, highlighting cycles and offering interactive filters to visualize structural issues before refactoring.

Does the architecture mapping pipeline support cached JSON intermediates?▼

The architecture mapping pipeline supports cached JSON intermediates by reusing valid modules.json and deps.json files, automatically regenerating them through fallback scripts only when the cache is stale.

Can I visualize legacy and modern topology side-by-side in HTML?▼

You can visualize legacy and modern topology side-by-side in HTML when the pipeline detects topology data in architecture.md, rendering an interactive comparison page for hybrid evolution tracking.

Are there limitations when rendering interactive HTML documentation without local fetch?▼

Rendering interactive HTML documentation without local fetch requires a viewer.html chassis that embeds all data directly, avoiding browser CORS restrictions when opening architecture pages locally.

Related Skills

Explore More Design & Creative Skills→
Markson22Markson22

reversa-docs-mapper

Generate architecture, module, and topology HTML documentation from codebase dependency data.

Community
Advanced
fanguyunfanguyun

legacy-modernizer

Design incremental migration strategies and generate API facade designs for legacy systems.

Community
Advanced
afsjrafsjr

reversa-docs

Generate a self-contained offline HTML mini-site from Reversa core knowledge.

Community
Advanced
stribusstribus
1

reversa-especialista-d3

Generate standalone HTML visualizations from D3.js data models.

Community
Advanced