ORG-0007 — Agentes de IA e controle humano

Agentes de IA escrevem boa parte do código e da documentação. O risco não está em escrever, e sim em publicar: um commit, um deploy ou uma chamada administrativa a um sistema real feitos sem revisão. As regras do agente também precisam valer para qualquer ferramenta, não só para uma.

1. AGENTS.md é a fonte das regras para qualquer agente; CLAUDE.md (e equivalentes) só apontam para ele, de preferência importando-o (no CLAUDE.md, a linha @AGENTS.md), para as regras entrarem no contexto de toda sessão.
2. São só do mantenedor: Git de escrita, recursos no GitHub, deploy, acesso a infraestrutura real (Keycloak, bancos, observabilidade, VPS) e qualquer valor de segredo. Onde dá, um hook garante (ex.: block-git-writes.py, block-infra.py).
3. O agente nunca lê, exibe nem escreve valores de segredos: só placeholders (<VALOR>).
4. Protocolo de entrega de toda change: build, testes, verificador e regressão E2E verdes, com os números; o ambiente local no ar, com dados; um resumo por aplicação e por tela do que mudou e do que conferir; o que ficou pendente; as instruções de commit, com a mensagem sugerida; e as de deploy, se houver.
5. O que vale para todas as stacks não fica na memória do agente: vira pedido à arquitetura.

• O mantenedor revisa tudo antes de publicar e valida cada change olhando o sistema no ar.
• Os hooks bloqueiam por engano, não só por intenção; um bloqueio indevido é corrigido no hook.

O detalhe está na documentação da arquitetura.