O que colocar no CLAUDE.md e o que anexar a uma tarefa específica
O Claude Code lê o CLAUDE.md do repositório ao iniciar. O Codex e muitos outros agentes têm um arquivo equivalente, o AGENTS.md. É um bom lugar para reunir tudo o que o agente precisa saber sobre o projeto: como rodar os testes, onde fica cada coisa, quais são as regras do código.
Com o tempo o arquivo cresce, e aparecem nele instruções que não são necessárias em toda tarefa.
Exemplo: revisores depois do desenvolvimento
Uma técnica útil para tarefas de código são os revisores independentes. Depois do desenvolvimento, o agente inicia subagentes separados, que não viram como o código foi escrito. Eles leem as mudanças e as comparam com a tarefa e com as regras do projeto. Um verifica se foi feito o que se pediu. Outro olha o estilo e o código desnecessário. O agente corrige o que for encontrado antes de dizer “pronto”.
Essa instrução ocupa umas quinze linhas. Se ela for para o CLAUDE.md, o agente a recebe em toda sessão: tanto na tarefa de texto para a landing page quanto na análise de logs, em que não há código para revisar. É contexto a mais e, às vezes, trabalho a mais.
Escrevê-la à mão em cada tarefa também não é prático. É fácil esquecer, e, ao copiar de uma tarefa antiga, é fácil levar uma versão desatualizada.
Uma instrução para um tipo de tarefa
No Tascue, essa instrução vira um trecho (include), por exemplo “Revisores independentes”. Ele é marcado nas tarefas em que o código muda e, ao copiar, entra no fim do prompt. Nas tarefas de texto e de pesquisa, ele simplesmente não está.
Se o trecho surgir quando o backlog já tem muitas tarefas, é possível adicioná-lo a todas de uma vez: “Aplicar a todas as tarefas do backlog”. As tarefas em andamento e as concluídas não mudam.
O que vai onde
| Instrução | Onde manter |
|---|---|
| Necessária em qualquer tarefa deste repositório: como rodar os testes, como o projeto é organizado | CLAUDE.md |
| Necessária em tarefas de um tipo: revisão de código, verificação no navegador, regras de texto | Trecho do projeto |
| Necessária em todos os projetos: “não faça commits” | Trecho comum, incluído por padrão nas novas tarefas |
| Necessária em uma só tarefa | Texto da tarefa |
Um teste simples para uma nova instrução: ela é necessária em toda tarefa? Se não, o lugar dela é um trecho, e o CLAUDE.md continua curto, lido em um minuto.
O prompt da tarefa é montado sozinho: intro, campos, texto, trechos. No Claude Code, dá para colá-lo depois de “Copiar” ou entregá-lo por MCP, e o agente recebe a mesma tarefa completa.