01Arquivo

preferencias.md

Como trabalhar com agentes de código

Conversa, ritmo, o que nunca fazer sem permissão, produção e documentação: como trabalhar com um agente de código.

Voltar para skills

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 humanizer antes 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 em docs/design.md, armadilha em docs/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.