Sua Política de Codificação de IA Precisa de um Recibo, Não Apenas de um AGENTS.md
Um arquivo AGENTS.md pode explicar uma regra. Ele não pode provar que um agente viu a regra, que uma ação proposta foi avaliada ou que uma mudança rejeitada deixou um rastro de recuperação utilizável. Essa é a questão útil por trás do coding-ethos.
coding-ethos divide o problema em política, agentes, hooks e inteligência de código. coding_ethos.yml descreve a mecânica; ETHOS.md e os padrões de coding-ethos carregam os valores; AGENTS.md e CLAUDE.md descrevem contratos de agentes. O executor de hooks recebe eventos de ciclo de vida, os roteia para o avaliador relevante ou ferramenta MCP, e normaliza o resultado.
A linha v0.3.0 é interessante por três razões concretas: as costuras de extensão de política permitem que regras posteriores se conectem sem reescrever o compilador; o roteamento é centralizado em vez de duplicado em cada hook; e a evidência de remediação é persistida no armazenamento de inteligência de código. Uma ação negada deve ser testável como um veredicto estruturado mais um payload de remediação, não apenas uma linha de log vermelha.
Meu check de primeiro uso é deliberadamente pequeno: execute uvx coding-ethos contra um repositório descartável, exerça uma ação permitida e uma ação negada, leia o id da regra e o payload de evidência, tente novamente após a remediação, então remova a configuração temporária e verifique o rollback. Uma lista de ferramentas MCP visíveis não é prova de aplicação, e um caminho legado que contorna hooks/runner pode silenciosamente descartar evidências.
O pacote Doramagic também registra relatórios da comunidade sobre provisionamento de Bubblewrap, política de git amend, cobertura de stdio MCP e trabalho de agente-proxy. Essas são verificações baseadas em fonte para revisitar, não alegações de que o Doramagic reproduziu todos os problemas. Notas do projeto: https://doramagic.ai/en/projects/coding-ethos/manual/
Divulgação: este é um pacote de capacidade independente do Doramagic, não um lançamento ou endosse oficial do coding-ethos.
O artigo discute a importância de documentar e validar ações de agentes de IA, o que pode impactar a conformidade e a transparência em projetos de IA. Empresas brasileiras devem considerar a implementação de políticas robustas para garantir a responsabilidade dos agentes.
