01Arquivo

claude-md.md

Instruções globais do Claude

O que o Claude Code segue em todos os meus projetos: permissões do agente, documentação, interfaces, migrations, seeds e variáveis de ambiente.

Voltar para skills

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.example a senha fica vazia: cada ambiente define a sua.
    • Em produção, o sistema se recusa a subir com senha fraca.

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

  • .env e .env.example devem 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.md de todo projeto tem a seção "Onde fica cada chave": para cada chave, se está no .env local, 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 via graphify-out/.