Brooks-Lint — Auditoria de Arquitetura

Quando Usar

Use esta habilidade quando precisar de uma auditoria de arquitetura que mapeie dependências de módulos, verifique a integridade de camadas e sinalize o decaimento estrutural em uma base de código, baseando-se em doze livros clássicos de engenharia. Dispara quando: o usuário pede para auditar a arquitetura, revisar a estrutura de pastas/módulos, verificar importações circulares, entender...

Configuração

1. Leia ../_shared/common.md para as regras da Lei de Ferro, Configuração do Projeto, Modelo de Relatório e Pontuação de Saúde
2. Leia ../_shared/source-coverage.md para cobertura em nível de livro, exceções e compensações
3. Leia ../_shared/decay-risks.md para definições de sintomas e atribuições de origem
4. Leia architecture-guide.md neste diretório para o framework de auditoria

Processo

Modo de integração: Se o usuário pedir um relatório de integração, tour pela base de código ou "explique esta base de código para um novo desenvolvedor", leia onboarding-guide.md deste diretório e siga-o em vez de architecture-guide.md. Este modo explica em vez de diagnosticar — sem Pontuação de Saúde, sem descobertas da Lei de Ferro.

Se o usuário não especificou arquivos ou um diretório para auditar: aplique a Detecção Automática de Escopo de ../_shared/common.md para determinar o escopo da auditoria antes de prosseguir.

1. Colete o contexto da base de código e desenhe o grafo de dependência de módulos como Mermaid (Passos 0–1 do guia)
2. Verifique cada risco de decaimento na ordem especificada (Passos 2–4 do guia)
3. Atribua cores aos nós no diagrama Mermaid com base nas descobertas (vermelho/amarelo/verde) — após o Passo 4
4. Execute a Avaliação de Ponto de Testabilidade (Passo 5 do guia)
5. Execute a verificação da Lei de Conway (Passo 6 do guia)
6. Saída usando o Modelo de Relatório de common.md — grafo Mermaid PRIMEIRO, depois Descobertas

Linha de modo no relatório: Architecture Audit

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente à sua fonte upstream e ao contexto local do projeto.
• Verifique comandos, código gerado, dependências, credenciais e comportamento de serviços externos antes de aplicar alterações.
• Não trate exemplos como substitutos para testes específicos do ambiente, revisão de segurança ou aprovação do usuário para ações destrutivas ou custosas.