Regras para o CLAUDE.md
Regras que nasceram de um erro, prontas para o CLAUDE.md do seu agente
Cada regra está no CLAUDE.md da minha operação porque um erro aconteceu antes dela. Copie a que serve para o seu projeto.
- O sed do Mac e o \b: Seu agente roda um sed com \b, o terminal não reclama, e nada foi trocado. Esta regra impede que ele confie nesse comando.
- Uma árvore de dependência só: O agente instala com o gerenciador que lembrar. Esta regra fixa um só, para o projeto não ter duas versões da mesma biblioteca.
- Listar colisões antes de renomear: O agente troca um nome em cem arquivos, e o nome novo já existia com outro sentido. Esta regra o faz olhar antes.
- Frase mista depois de renomear: O agente passou os identificadores para inglês e um botão passou a dizer "Limpar search". Esta regra manda procurar isso depois.
- Teste verde não prova nada: O agente escreve o teste, o teste passa, e ninguém sabe se ele pegaria o erro. Esta regra o faz quebrar o código de propósito e ver.
- O mock.module do bun vaza: Na sua máquina tudo passa; no CI, um teste que não tem nada a ver quebra. Esta regra evita a causa mais comum disso no bun.
- Regra que não vira teste não existe: O CLAUDE.md cresce e o agente esquece metade. Esta regra obriga cada regra nova a virar uma checagem, ou a dizer que depende de memória.
- Se não está no log, não aconteceu: Ontem o agente fez alguma coisa, e hoje ninguém sabe o quê. Esta regra o faz registrar cada execução antes de dizer que terminou.
- Relatório de subagente não é verdade: O subagente diz "feito" e o agente principal repassa. Esta regra o faz conferir antes de repassar.
- Conferir o código HTTP do link: O agente entrega um material com sete links, e todos estão fora do ar. Esta regra o faz testar cada endereço antes.