skills.rest
AlexandrePontesjr
AlexandrePontesjrCOMMUNITY
Explore all skills by this author →
GitHub

reversa-architect

Generate Mermaid C4/ERD architecture documentation from Reversa artifacts.

Updated May 5, 2026
Search Tags:#architecture#technical debt#c4 model#documentation automation#reverse engineering#erd#spec impact matrix
One-click install
npx skills add https://github.com/AlexandrePontesjr/calculadora-Juridica --skill reversa-architect-alexandrepontesjr
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reversa-architect
Source: https://github.com/AlexandrePontesjr/calculadora-Juridica/tree/main/.agents/skills/reversa-architect
Command: npx skills add https://github.com/AlexandrePontesjr/calculadora-Juridica --skill reversa-architect-alexandrepontesjr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It turns fragmented legacy-code findings into a coherent architectural picture, so teams can quickly understand the system and plan safe next steps.

Core Features & Use Cases

  • Produces complete architecture documentation: generates architecture overview with C4 Context and, when applicable, an embedded ERD summary.
  • Creates C4 diagrams and ERD artifacts: outputs Mermaid C4 Context, plus optional Containers and Components at higher doc levels, and a full ERD when entity count and settings require it.
  • Maps integrations and impacts: generates integration documentation and a Spec Impact Matrix to identify which components affect which specs.
  • Surfaces technical debt: documents duplicated code, inconsistent patterns, critical outdated dependencies, and missing tests in critical modules.
  • Use Case: After running a discovery/detection phase, you use this Skill to produce architecture docs for onboarding, refactoring planning, or delivery risk reduction.

Quick Start

Run the reversa-architect Skill after reversa-detective, ensuring state.json sets doc_level to completo and that the output folder contains the discovered artifacts.

Frequently Asked Questions about reversa-architect

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

FAQPage Schema
How do I generate C4 diagrams and ERDs from legacy code analysis?▼

To generate C4 diagrams and ERDs from legacy code, you need to synthesize discovery artifacts into architectural documentation. This process reads state files and context artifacts to produce Mermaid-based C4 Context, Containers, Components, and full ERD outputs.

What is a spec impact matrix and how does it map component dependencies?▼

A spec impact matrix maps system integrations by identifying which architectural components affect specific specifications. It traces dependencies across the codebase to highlight delivery risks and document impacts during refactoring planning.

How do I document technical debt from reverse engineering a legacy project?▼

Documenting technical debt from reverse engineering involves analyzing discovered artifacts to surface duplicated code, inconsistent patterns, critical outdated dependencies, and missing tests in critical modules for delivery risk reduction.

Can I use architecture documentation automation without prior discovery artifacts?▼

No, architecture documentation automation requires prior discovery artifacts to function correctly. It needs a state configuration file and context artifacts from a previous detection phase to synthesize a coherent architectural picture.

Does the generated architecture documentation support onboarding and refactoring planning?▼

Yes, generated architecture documentation supports onboarding and refactoring planning by turning fragmented legacy-code findings into a coherent system overview. It provides traceability and technical debt reporting for safe next steps.

What is the best way to structure legacy project interpretation for data modeling?▼

The best way to structure legacy project interpretation for data modeling is applying post-discovery workflows. This synthesizes context artifacts into embedded ERD summaries and entity relationship diagrams based on configured output levels.

Related Skills

Explore More Software Engineering Skills→
cliffthelincliffthelin

reversa-architect

Generate C4 diagrams, ERD, and impact matrix from reverse-engineered artifacts.

Community
Intermediate
Pabloprogramador23Pabloprogramador23

reversa-architect

Generate C4 diagrams, ERDs, and integration maps from legacy code.

Community
Advanced
brainbrewlabsbrainbrewlabs
7

synthesis

Synthesize multiple research documents into integrated narratives with ranked themes and recommendations.

Official
Intermediate
mylukinmylukin
247

project-analyze

Generate ARCHITECTURE.md documentation from codebase analysis.

Community
Intermediate