Taxa de Violação Arquitetural

A Taxa de Violação Arquitetural rastreia com que frequência o código gerado por agentes tenta violar limites de domínio, regras de dependência ou restrições estruturais definidas pelo Principal Systems Architect. É calculada como:

Falhas em testes de arquitetura / Total de PRs de agentes submetidos

Testes de arquitetura verificam propriedades estruturais: direção de dependência entre módulos, conformidade com limites de camadas, adesão a convenções de nomenclatura e conformidade com contratos de API. Estes testes são executados como parte do Eval Harness antes que a saída do agente chegue à revisão humana, capturando violações precocemente no pipeline.

A taxa divide-se em três faixas interpretativas:

1. Abaixo de 0,05 — as restrições estão bem definidas e os agentes estão produzindo consistentemente código estruturalmente sólido. Os Golden Samples e a documentação arquitetural no Context Index estão orientando o comportamento dos agentes de forma eficaz.
2. 0,05 a 0,15 — taxa de violação moderada, indicando que algumas restrições não estão claras ou que falta algum contexto. Causas comuns incluem regras arquiteturais recém-introduzidas que ainda não foram refletidas nos Golden Samples ou limites de domínio ambíguos na documentação. Atualize os samples relevantes e as definições de restrição.
3. Acima de 0,15 — problema sistêmico. Os agentes estão produzindo regularmente código que viola regras estruturais, indicando que as restrições arquiteturais não estão chegando aos agentes por meio de Context Packets ou que as próprias restrições são inconsistentes com a estrutura real da base de código. Isso exige um Boundary Audit focado para realinhar as regras com a realidade.

A Taxa de Violação Arquitetural complementa o Pattern Consistency Score: a taxa de violação mede falhas em restrições rígidas (código que quebra regras), enquanto a pontuação de consistência mede a adesão flexível (código que segue padrões). Uma taxa de violação baixa com uma pontuação de consistência baixa indica que os agentes estão respeitando os limites, mas não seguindo as convenções estilísticas — um problema de qualidade dos Golden Samples, e não um problema de regras arquiteturais.

Esta métrica é revisada durante o Boundary Audit mensal e monitorada no AgentOps Dashboard.