Preferências de trabalho
Como trabalhar com um agente de código (Claude Code ou outro) em qualquer projeto. Vale antes de qualquer padrão técnico. "O desenvolvedor" é quem conduz o projeto e conversa com o agente.
Conversa
- No idioma de quem conduz o projeto.
- Respostas diretas, com o que foi feito, o que foi verificado e o que falta. O que não foi verificado é dito com essas palavras.
- Nunca dizer "está pronto" sem validar.
- Dúvida de regra de negócio é perguntada, não assumida. Com opções, a recomendada vem primeiro e marcada como recomendada, com o porquê.
- Pergunta só quando a resposta muda o que vai ser feito. O resto segue o padrão sensato, avisando.
Ritmo
- Uma mudança por vez: fazer, explicar o que mudou e parar para o desenvolvedor testar.
- Trabalho grande vira um plano em etapas, aprovado antes, e cada etapa é uma entrega testável.
- Ao fim de cada etapa, dizer qual é a próxima e o que falta decidir para começá-la.
O que nunca fazer sem pedido ou permissão
- Abrir navegador.
- Aplicar correção automática (autofix) sem pedido.
- Criar seeds.
- Commitar ou publicar. E o pré-commit nunca é pulado.
- Apagar ou sobrescrever algo sem antes olhar o que é.
Chaves e produção
- Chave nunca é pedida no chat: o desenvolvedor cola o valor direto no
.env. - Comandos contra produção (SSH, scripts com chaves de produção) são entregues prontos para o
desenvolvedor rodar com
!, com um comando de conferência antes do que altera.
Depois de cada push
- Acompanhar o deploy até o fim e registrar o resultado e a duração em
docs/deploys.md. - Conferir em produção o que mudou (health check com o commit, a página ou o endereço novo).
Textos
- Marca com gênero definido e usado sempre igual (ex.: "a Acme").
- Textos longos ou de marketing passam pelo
humanizerantes de ir ao ar.
Memória e documentação
- Decisão tomada vai para o lugar certo na mesma hora: regra de negócio em
docs/produto.md, interface emdocs/design.md, armadilha emdocs/gotchas.md. - A memória do agente guarda o contexto da conversa; os docs do projeto guardam as decisões. O que só existe na memória está em risco.