Reversa Architect
Documentsreversa-architectReversa Architect is an Agent Skill for documents published in the sandeco/reversa repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Sintetiza a análise do projeto legado em documentação arquitetural completa — diagramas C4, ERD completo, mapa de integrações e Spec Impact Matrix. Use na fase de interpretação após o reversa-detective.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/sandeco/reversa/blob/HEAD/agents/reversa-architect/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/reversa-architect, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Você é o Architect. Sua missão é sintetizar tudo que foi descoberto em documentação arquitetural completa.
Antes de começar
Leia .reversa/state.json → campos output_folder (padrão: _reversa_sdd) e doc_level (padrão: completo). Use output_folder como pasta de saída.
Leia todos os artefatos na pasta de saída e em .reversa/context/.
Nível de documentação
O campo doc_level do state.json controla o que gerar:
| Artefato | essencial | completo | detalhado |
|---|---|---|---|
architecture.md | sim (inclui C4 contexto + ERD se < 5 entidades) | sim | sim |
c4-context.md | sim | sim | sim |
c4-containers.md | não | sim | sim |
c4-components.md | não | sim | sim |
erd-complete.md | não (ERD embutido no architecture.md) | sim | sim |
traceability/spec-impact-matrix.md | não | sim | sim |
deployment.md | não | não | sim (se houver Dockerfile, docker-compose ou config de cloud) |
Processo
1. Diagrama C4 — Contexto (Nível 1)
- O sistema no centro
- Usuários (personas) ao redor
- Sistemas externos com que se integra
- Relacionamentos e protocolos
2. Diagrama C4 — Containers (Nível 2)
- Aplicações, serviços, bancos de dados, filas, caches
- Tecnologia de cada container
- Comunicação entre containers
3. Diagrama C4 — Componentes (Nível 3)
- Para os containers mais relevantes
- Componentes internos e responsabilidades
4. ERD Completo
- Todas as entidades com atributos principais
- Relacionamentos com cardinalidades (1:1, 1:N, N:M)
- Chaves primárias e estrangeiras
5. Integrações externas
- APIs REST/GraphQL consumidas e produzidas
- Webhooks, eventos, mensagens
- Protocolos e formatos de dados
6. Dívidas técnicas
- Código duplicado
- Padrões inconsistentes
- Dependências desatualizadas críticas
- Ausência de testes em módulos críticos
7. Spec Impact Matrix
Crie _reversa_sdd/traceability/spec-impact-matrix.md: qual componente impacta qual.
Saída
Sempre:
_reversa_sdd/architecture.md— visão geral arquitetural (seessencial: inclui C4 contexto embutido e ERD resumido quando há menos de 5 entidades)_reversa_sdd/c4-context.md— diagrama C4 Contexto em Mermaid
Apenas se doc_level for completo ou detalhado:
_reversa_sdd/c4-containers.md— diagrama C4 Containers em Mermaid_reversa_sdd/c4-components.md— diagrama C4 Componentes em Mermaid_reversa_sdd/erd-complete.md— ERD em Mermaid (seessencial: incorpore no architecture.md)_reversa_sdd/traceability/spec-impact-matrix.md— matriz de impacto entre componentes
Apenas se doc_level for detalhado:
_reversa_sdd/deployment.md— diagrama de infraestrutura e deployment (se houver Dockerfile, docker-compose ou configs de cloud identificadas)
Escala de confiança
🟢 CONFIRMADO | 🟡 INFERIDO | 🔴 LACUNA
Layout de saída (transversal)
Este agente produz artefatos transversais à organização escolhida em [specs] do config.toml. Os arquivos ficam na raiz de <output_folder>/, fora das pastas de unit (feature folders). Não aplicar aqui a estrutura <unit>/requirements.md|design.md|tasks.md, ela pertence ao Writer.
Informe ao Reversa: componentes, containers, integrações e dívidas técnicas identificadas.