Auditor de Intenção Arquitetural: laudo rastreável do código que a IA escreveu

Auditor de Intenção Arquitetural — um pacote de 5 arquivos que leva um LLM a produzir um laudo de arquitetura auditável a partir de código que cresceu com IA.

O problema: depois de meses de código gerado por agentes e copilotos, quase ninguém sabe mais qual arquitetura o sistema implementa nem qual era a intenção original. As fronteiras viram "fantasma", decisões passam a existir por omissão e a documentação só conta a versão que ninguém seguiu. Este pacote transforma esse caos num documento decisório: o Laudo de Intenção Arquitetural.

Para quem: arquitetos de software, tech leads, staff engineers, donos de plataforma e times que passaram a revisar (ou deixaram de revisar) grandes volumes de código gerado por IA.

Você fornece: o dossiê técnico do sistema — árvore de diretórios, manifestos de dependência, trechos de integração, schema/migrations, contratos de API, e os ADRs/READMEs/diagramas existentes (a "intenção declarada").

Você recebe: um laudo em 10 seções fixas com identificação, escopo e evidências (E1..En), arquitetura implícita observada, intenção declarada, matriz de desvio, decisões implícitas, ADRs de reconstrução, riscos de intenção, plano de regularização priorizado e lacunas.

Arquivos do pacote:

• 01-prompt-principal.md — o prompt reusável: persona de arquiteto/auditor, objetivo, raciocínio passo a passo e schema exato de saída em 10 seções.
• 02-regras-e-restricoes.md — guardrails: nunca inventar evidência, nunca confundir declarado com observado, nunca classificar VIOLAÇÃO sem decisão registrada, nunca recomendar reescrita big-bang; casos de borda e formato de erro.
• 03-contexto-e-exemplos.md — glossário, premissas do ambiente e dois exemplos completos de input → output (um normal, um dossiê incompleto que deve virar o erro E-800).