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.

Siga o Tascue no LinkedIn