reversa-architect

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It eliminates the hard work of manually translating reverse-engineering findings into coherent, audit-ready system architecture documentation.

Core Features & Use Cases

  • Architectural synthesis: Produces complete architectural documentation from discovered artifacts, including C4 Context and an integration map for the interpretation phase.
  • Data modeling output: Generates a complete ERD (with relationships and keys) to make domain structure explicit and reviewable.
  • Traceability for impact: Creates a Spec Impact Matrix to map which components affect which spec elements, improving change governance and drift analysis.

Quick Start

Use the reversa-architect skill to generate full architecture documentation in the output folder specified 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 architecture documentation from reverse-engineered legacy artifacts?

Generate architecture documentation by synthesizing reverse-engineered legacy artifacts into C4 diagrams, an ERD, and an integration map. This process translates raw discovery findings into coherent, audit-ready system architecture outputs for downstream design.

What is a Spec Impact Matrix and when do I need it for legacy system governance?

A Spec Impact Matrix maps which components affect which spec elements to improve change governance and drift analysis. You need it when interpreting legacy systems to ensure traceability between architectural components and specification requirements.

Can I create C4 context and container diagrams from existing codebase discoveries?

Yes, you can create C4 context and container diagrams from existing codebase discoveries. The synthesis process generates these diagrams based on doc_level, producing Mermaid documentation files that capture the system's structural and contextual architecture.

How do I map external integrations for a reverse-engineered legacy system?

Map external integrations by synthesizing discovered artifacts during the interpretation phase. The process generates an external integration map that explicitly defines connections between the legacy system and external dependencies for architectural review.

What output formats are produced when turning legacy discoveries into full architecture?

The process produces Mermaid documentation files stored in the _reversa_sdd directory by default. These files include C4 context, containers/components diagrams, an ERD with relationships and keys, an integration map, and a Spec Impact Matrix.

Do I need a specific state file to generate architectural documentation from legacy artifacts?

Yes, generation is driven by reading .reversa/state.json and artifacts in the output and .reversa/context/ directories. This state file specifies the output folder and provides the necessary context for synthesizing the architectural documentation.