Um ficheiro de regras não muda nada. Medido.

Mesmo agente, os mesmos trinta tickets: 2,28 regras violadas por ticket sem ficheiro, 2,27 com um mantido à mão.

Instalar o VibeDefend Ler o estudo

O que cada configuração violou.

Regras violadas por ticket, o mesmo agente, as mesmas tarefas.

Sem ferramenta2,28
Um ficheiro de regras, mantido à mão2,27
Um ficheiro de regras perfeito, palavra por palavra0,95
VibeDefend0,28

Estudo controlado, 24 de agosto de 2026. Ler o estudo

No ficheiro. Violada na mesma.

Um ficheiro é lido quando a sessão começa. Uma regra conta numa linha, muitos turnos depois.

Na linha
Antes de cada edição, as regras do ficheiro alterado.
A partir do teu código
Propostas a partir do teu código, aprovadas uma vez. Nenhum ficheiro para manter.
Em cada agente
As mesmas regras nos cinco agentes de código.

Mesmo perfeito, o ficheiro fica nos 64 %.

Coladas palavra por palavra, as regras foram aplicadas exatamente 7 vezes em 11. Servidas na linha: 11 em 11.

64%

das regras aplicadas exatamente, ficheiro perfeito

100%

com o VibeDefend, as mesmas tarefas

Servida não quer dizer respeitada.

Uma vez, uma regra servida treze vezes foi mesmo assim desfeita. Por isso cada alteração também é verificada antes do commit.

O que é verificado

Em detalhe

Perguntas sobre ficheiros de regras.

Devo apagar o meu CLAUDE.md ou o meu AGENTS.md?

Não. Mantém o que ajuda o agente a trabalhar, como os comandos de build e as convenções. As regras que têm de se cumprir são mais bem servidas na linha: no estudo, o ficheiro sozinho não mudou nada mensurável.

Quanto custa servir as regras em tokens?

Cerca de 18 % mais tokens por ticket no estudo. Face a um ficheiro de regras perfeito, o custo foi o mesmo, com 11 regras aplicadas em 11 em vez de 7.

Como foi feito o estudo?

Um mesmo agente (Claude Opus 5) tratou os mesmos trinta tickets sem ferramenta, com um ficheiro de regras e com o VibeDefend; auditores às cegas avaliaram cada diff. O protocolo, as transcrições e as auditorias são públicos.

Com que agentes funciona?

O instalador configura o Claude Code, Cursor, Windsurf, GitHub Copilot e OpenAI Codex. As regras chegam aos cinco; os guardrails funcionam no Claude Code, Cursor e Codex.