Regras CLAUDE.md para Claude Code que podem ser verificadas
Um CLAUDE.md breve e verificável com limites, comandos e tratamento seguro de segredos.
Conteúdo
Regras CLAUDE.md para Claude Code que podem ser verificadas
Uma lista extensa de preferências não torna o agente previsível. Uma regra diz o que é permitido, proibido e verificável. Se o workflow usar API, abra o guia BetterToken Claude Code atual, configure sua própria chave e faça um teste curto: o Dashboard deve mostrar modelo, status e tokens esperados. Mantenha a chave no ambiente, nunca no CLAUDE.md.
Comece com contrato curto
## Goal
- Keep changes limited to the requested feature.
## Checks
- Run `npm test` after code changes.
## Forbidden
- Do not read, print, or commit `.env`.“Código de qualidade” não é observável; comando e exit code são.
Escopo e hierarquia
A documentação atual de Memory explica como o Claude Code descobre instruções de escopos diferentes. Neste exemplo, “a regra local pode substituir uma regra raiz comum, mas não a segurança raiz” é um contrato escrito pelo projeto, não uma exceção universal incorporada. Revise as regras visíveis e remova duplicatas.
Tipos de regras
| Tipo | Exemplo | Evidência |
|---|---|---|
| Objetivo | ler perfil | só módulo alvo mudou |
| Limite | sem migration | não aparece no diff |
| Check | npm test | exit 0 |
| Estilo | nomes existentes | sem refactor extra |
Explicações longas ficam em docs/ com link.
Conflitos e exemplo
Antes de editar, leia package.json, os arquivos da tarefa e regras locais. Não invente comandos. Duas regras com checks divergentes devem virar uma regra local verificável.
Teste reversível
Renomeie uma variável local em teste e rode:
git diff --check
git diff --stat
npm testRejeite se outro arquivo mudou ou se o check não foi executado.
Segredos e manutenção
Nunca coloque API keys, tokens CI, dados pessoais ou .env no CLAUDE.md; use API_KEY=your_api_key_here. Segredos reais passam por ambiente ou secret store. Revise o contrato ao mudar testes, pacotes ou diretórios.
