Auditoria de Fronteira
A cerimônia mensal onde o Principal Systems Architect revisa as fronteiras de domínio quanto à integridade, capturando o desvio arquitetônico antes que ele se agrave.
Definição
A Auditoria de Fronteira é a cerimônia mensal onde o Principal Systems Architect revisa as fronteiras de domínio quanto à integridade estrutural, capturando o desvio arquitetônico antes que se transforme em problemas sistêmicos.
À medida que os agentes geram código em escala, o desvio arquitetônico se acumula de formas difíceis de detectar no nível de PR individual. Módulos desenvolvem dependências indesejadas, contextos delimitados vazam através das fronteiras de domínio, convenções de nomenclatura se degradam e padrões estruturais divergem dos Golden Samples. Cada violação individual pode ser pequena, mas ao longo de semanas o efeito cumulativo mina a modularidade do sistema e aumenta o custo de manutenção.
A Auditoria de Fronteira aborda isso por meio de três atividades estruturadas:
- Executar testes automatizados de restrição de arquitetura — execute a suíte completa de testes estruturais contra a base de código atual, não apenas contra novos PRs. Isso captura violações que passaram despercebidas em verificações incrementais ou que surgiram da interação de múltiplas mudanças individualmente conformes. Os resultados alimentam diretamente a Architectural Violation Rate.
- Sinalizar novas violações desde a última auditoria — compare os resultados atuais com a linha de base do mês anterior para identificar novos cruzamentos de fronteiras, violações de direção de dependência ou desvios de convenção de nomenclatura. Novas violações são categorizadas como regressões (padrões que anteriormente estavam em conformidade) ou expansões (novas áreas de código que nunca foram cobertas por restrições).
- Atualizar Golden Samples se os padrões evoluíram — quando a base de código evoluiu legitimamente e os Golden Samples existentes não representam mais as melhores práticas atuais, atualize-os. Este é um passo crítico: amostras obsoletas fazem com que os agentes gerem código em um estilo que conflita com a abordagem atual da equipe, reduzindo o Pattern Consistency Score.
A Auditoria de Fronteira normalmente dura de duas a três horas e produz três saídas: um relatório de violações atualizado, uma lista de mudanças nas regras de restrição e quaisquer Golden Samples revisados. Essas saídas alimentam o próximo ciclo de execução do agente, fechando o ciclo de feedback entre a governança arquitetônica e o comportamento do agente.
A cerimônia faz parte da cadência mensal, juntamente com a Context Hygiene e a FinOps Review.