reversa-architect

Synthesize legacy system analysis into C4 diagrams, ERD models, and impact matrices.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It converts scattered reverse-engineering findings into a coherent, decision-ready architectural package that teams can use to rebuild the system with clarity.

Core Features & Use Cases

  • C4 Diagrams Coverage: Produces C4 Context (Level 1) and, when enabled, C4 Containers (Level 2) and Components (Level 3).
  • Complete Data Modeling: Generates a full ERD (as Mermaid) and includes ERD coverage in the architecture overview when applicable.
  • Integration & Impact Traceability: Documents external integrations and creates a Spec Impact Matrix to show which parts of the architecture are affected by which specs.
  • Technical Debt Highlights: Identifies likely technical debt areas such as inconsistencies and missing coverage signals.

Quick Start

Run the reversa-architect skill in the interpretacao phase to generate the architecture.md and c4-context.md inside the output_folder defined by .reversa/state.json.

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 ERD models from legacy system analysis?

You generate C4 diagrams and ERD models by synthesizing scattered reverse-engineering findings into traceable architectural documentation. This process consolidates artifacts from your output folder into structured markdown covering C4 Context, Containers, Components, and full ERD modeling.

What is a spec impact matrix and how does it map external integrations?

A spec impact matrix documents external integrations and maps which architectural components are affected by specific specifications. It provides traceability across legacy systems, showing the direct impact of requirements on the synthesized architecture overview.

Can I identify technical debt areas during architecture synthesis?

Yes, you can identify technical debt during architecture synthesis by detecting inconsistencies and missing coverage signals in the reverse-engineering artifacts. It highlights likely technical debt areas to ensure the rebuilt architecture avoids existing structural flaws.

How do I consolidate reverse-detection findings into architecture markdown?

You consolidate reverse-detection findings by reading the doc level from your state configuration and writing specified markdown outputs to the configured output folder. This synthesizes context artifacts into an architecture overview ready for decision-making.

Does the generated architecture documentation include ERD coverage in Mermaid format?

Yes, the architecture documentation includes ERD coverage by generating a full Entity Relationship Diagram in Mermaid format. This complete data modeling is also summarized within the architecture overview when applicable to the legacy system.

What are the limitations of synthesizing legacy findings into C4 documentation?

A limitation is that producing C4 Container and Component diagrams requires enabling higher generation levels, as only C4 Context is generated by default. Additionally, the synthesis depends entirely on the completeness of prior reverse-detection artifacts in your context folder.