Instruções globais
Regras que o Claude Code segue em todos os meus projetos. Para usar, salve como
~/.claude/CLAUDE.md (vale para todos os projetos) ou como CLAUDE.md na raiz de um projeto, e
ajuste idioma e regras ao seu caso.
Como o agente trabalha
- Responde sempre em português (pt-BR).
- Ação com efeito fora do código só com permissão explícita: commitar, publicar, abrir navegador, rodar comando contra produção.
- Nunca pula o hook de pré-commit. Se ele falhar, corrige a causa.
- Nunca diz que algo está pronto sem verificar. O que não foi verificado é dito com essas palavras.
Documentação
- Todo projeto tem uma pasta
docs/com estes arquivos, criados no início e mantidos em dia:roadmap.md: o que o produto precisa ser, em checklists por fase.produto.md: glossário, regras de negócio e registro datado das decisões de produto.concorrentes.md: análise dos concorrentes e do posicionamento.design.md: decisões de interface, atualizado na mesma alteração do código.migrations.md: registro de cada migration, com o que muda no schema e o SQL manual.deploys.md: registro de cada deploy, com resultado e duração.gotchas.md: armadilhas confirmadas, que economizariam tempo no futuro.
Interfaces
Tabelas não têm rolagem horizontal, só em raríssimas exceções. Para caber: dado secundário vira subtítulo da coluna principal, colunas secundárias somem nas larguras menores e o que não ajuda a decidir nada sai da lista.
Formulários devem exigir o mínimo de preenchimento: sempre que possível, já trazer os campos preenchidos com padrões sensatos (ex.: responsável = usuário logado, prioridade baixa, prazo em 7 dias, projeto/contexto mais provável). O usuário só ajusta o que for diferente.
- Exceção: ações destrutivas ou críticas (excluir, pagar, assinar, enviar para cliente) não ganham escolha pré-preenchida que leve ao erro; exigem confirmação explícita.
Migrations
- Nome dos arquivos de migration no padrão que uso em todos os projetos:
NNNN-AAAA-MM-DD-descricao-em-kebab-case.sql.NNNN: número sequencial com 4 dígitos (zero à esquerda), continuando do último existente.AAAA-MM-DD: data de criação da migration.- Descrição curta em inglês, kebab-case, começando pela ação (
create-,add-,drop-,split-...). - Exemplo:
0060-2026-10-09-add-status-to-leads.sql.
Usuário administrador
- Em todo projeto com login, o administrador inicial vem de variáveis de ambiente (
MASTER_EMAIL,MASTER_PASSWORD), nunca de um valor fixo no código.- No
.env.examplea senha fica vazia: cada ambiente define a sua. - Em produção, o sistema se recusa a subir com senha fraca.
- No
Seeds
- Seeds são completos e deixam o sistema utilizável e demonstrável: dados realistas em todas as entidades principais e seus relacionamentos.
- Conforme a necessidade do projeto, incluem também arquivos e mídias (imagens, avatares, anexos, logos etc.), não só registros no banco.
- Uma variável de ambiente liga e desliga os seeds (ex.:
SEED_ENABLED=true|false), documentada no.env.example.- Desligados por padrão em produção.
Variáveis de ambiente
.enve.env.exampledevem ter sempre a mesma estrutura: mesmas variáveis, na mesma ordem e nos mesmos grupos. Só os valores mudam.- Ao adicionar, remover ou renomear uma variável em um, atualizar o outro junto.
- Os arquivos devem ser enxutos, organizados e objetivos: variáveis agrupadas por assunto, comentários curtos só onde ajudam, nada de variável sem uso.
- O
README.mdde todo projeto tem a seção "Onde fica cada chave": para cada chave, se está no.envlocal, no servidor, no CI (variables e secrets do GitHub) e em qual painel externo ela nasce, incluindo chaves que não são variáveis do app (chave SSH do deploy, token de DNS). Conferida só pelos nomes, nunca pelos valores, e atualizada na mesma alteração que cria, move ou troca uma chave.
Skills
Skills que uso, instaladas em ~/.claude/skills. As regras acima funcionam sem elas:
impeccable: desenhar, revisar, polir e auditar interfaces de front-end.frontend-design: direção visual e tipografia com identidade própria.emil-design-eng: acabamento de UI, componentes e animações.copywriting: textos de marketing (landing, home, preços, produto).humanizer: deixar textos com cara de escritos por uma pessoa.graphify: perguntas sobre a arquitetura do código viagraphify-out/.