Antes de começar
- Um projeto com Claude Code
- Acesso ao CLAUDE.md ou AGENTS.md do projeto
Peça uma auditoria das instruções atuais
Trabalhe em uma branch ou cópia. Peça ao agente para listar quais arquivos de instrução ele está lendo, onde entram no contexto e quais regras entram em conflito. Confira a lista nos arquivos: instrução repetida em dois lugares tende a ficar desatualizada em um deles.
Guarde os fatos que valem em toda tarefa
Mantenha os comandos reais de teste e build, o mapa curto das pastas e as convenções que a equipe precisa seguir. Confira os comandos no package.json ou equivalente antes de copiá-los. Evite registrar metas vagas como “faça código perfeito”: elas não dizem como avaliar uma mudança.
Mova procedimentos longos para skills
Um processo de publicar release ou gerar relatório só é necessário quando essa tarefa acontece. Transforme-o em uma skill com entrada, passos e resultado verificável. Regras que só valem para uma parte do código podem ir para arquivos de regras com escopo de caminho, conforme a documentação do Claude Code.
Use um modelo curto e adapte os comandos
O texto abaixo é um ponto de partida, não um arquivo para colar sem conferir. Substitua os caminhos e comandos pelos do seu projeto. Acrescente apenas regras que você consegue explicar com um exemplo de erro que elas evitam.
# Projeto
Aplicação de [finalidade].
## Verificação
- Teste: [comando existente]
- Build: [comando existente]
## Mapa
- [pasta]: [responsabilidade]
## Convenções
- Preserve contratos públicos ao corrigir um bug.
- Mudanças de banco precisam de migração e plano de retorno.
- Ao concluir, diga o que foi verificado e o que ficou pendente.Teste com uma correção pequena
Peça ao agente para corrigir um rótulo de formulário ou uma validação existente. Observe se ele encontra os arquivos certos e executa o comando correto. Se uma regra não foi seguida, confira primeiro se o arquivo foi carregado e se há instruções conflitantes; aumentar o texto pode piorar a confusão.
Revise junto com o código
Inclua o arquivo de instruções na revisão do projeto. Quando mudar o comando de build ou mover uma pasta, atualize a regra correspondente. Regras de texto orientam o agente; restrições de acesso a arquivos, rede e segredos precisam dos controles de permissão apropriados.
O que você terá ao final
Instruções curtas, conferidas no projeto e separadas dos procedimentos usados só em tarefas específicas.
Vale conferir
- Guia elaborado a partir da documentação. O fluxo completo não foi executado pela Agentspedia.