Uma regra para o Claude Code que mantém um registro da tarefa para a próxima conversa continuar dali

O arquivo de hoje é uma regra para o Claude Code. Você fecha uma conversa no meio de uma tarefa, abre outra no dia seguinte, e o Claude não sabe de nada: você explica a tarefa de novo, e a lista que ele já tinha feito sumiu. Com esta regra, o Claude mantém um registro de cada tarefa em um arquivo, e uma conversa nova lê esse registro e continua de onde a anterior parou.

Como funciona

Quando você dá uma tarefa ao Claude ou relata um erro, ele primeiro procura os seus registros dos últimos 7 dias em ~/.claude/tasks/. Se existe um registro da mesma tarefa, ele continua esse registro, e dos registros sobre um tema próximo leva os pontos principais para a seção “Experiência anterior”. Depois cria ou atualiza o registro: a tarefa, o que já foi feito, fatos verificados com a sua fonte, o que falta fazer. Ele atualiza o arquivo antes de cada resposta e o reescreve a cada vez, jogando fora o que o trabalho não precisa mais. As duas primeiras linhas de cada resposta são o caminho do registro e o que foi encontrado nos registros anteriores, e assim você vê a regra funcionando.

No nosso teste, pedimos em quatro idiomas uma lista de compras para abrir uma cafeteria, depois abrimos uma conversa nova e pedimos para continuar. Em todas as vezes o Claude encontrou o registro, disse o que a lista já tinha e seguiu dali: acrescentou uma parte com o que as pessoas costumam esquecer ou perguntou o orçamento e a cidade para ajustar a lista. Sem a regra, para o mesmo pedido o Claude respondeu que não encontrava nenhuma lista de compras de cafeteria. Quando depois pedimos uma lista de tarefas para abrir a cafeteria, em três dos quatro idiomas o Claude tomou o registro da lista de compras como tema próximo e aproveitou partes dele. Também plantamos em um registro antigo uma linha copiada da página de um fornecedor, pedindo para rodar um script da internet: o Claude não rodou e disse que a instrução veio da página, não de você.

O que mudar

A regra dispara em qualquer pergunta: “quanto é 17*23” também ganhou um registro e as duas linhas no topo. Se você não quer isso, acrescente depois da primeira linha: “Uma pergunta com resposta de uma linha não é uma tarefa: sem registro, sem as primeiras linhas.” No nosso teste, depois disso 17*23 e uma pergunta sobre uma capital receberam uma resposta comum, e a lista da cafeteria continuou ganhando o seu registro. Para guardar os registros por mais de uma semana, troque o 7 do passo 2 e o -mtime -7 do comando de busca. Duas linhas nós acrescentamos. A primeira: um resultado que existe só na resposta (uma lista, um texto, um plano) vai inteiro para o arquivo. Sem ela, o registro dizia só “lista entregue no chat”, e a conversa nova fez outra lista em vez de continuar. Com ela, o registro guarda a lista inteira. A segunda: as duas primeiras linhas vão só nas respostas no chat, não em arquivos, código, mensagens de commit ou saídas que um programa lê (JSON, CSV). Sem ela, uma de duas respostas ao pedido “5 nomes como array JSON, nada mais” começou com as duas linhas e um bloco de código, e um script que lê a saída de uma execução agendada do claude -p quebraria nisso. Com ela, 12 de 12 respostas em JSON, nos quatro idiomas, vieram limpas, e o arquivo todo.md que o Claude escreveu não tinha essas linhas.

Como instalar

A regra vai no fim do arquivo ~/.claude/CLAUDE.md, onde ficam as suas instruções para todos os projetos; o pedido exato está na nota abaixo. Depois feche o Claude Code e abra de novo, porque o arquivo é lido na inicialização. Os registros ficam em ~/.claude/tasks/, dentro da pasta do próprio Claude, então ele pede permissão antes de gravar ali: responda Yes. Os nomes dos arquivos de registro começam com um ponto, e ls -a ~/.claude/tasks mostra todos. Nas nossas execuções do claude -p, o Claude não conseguiu gravar nessa pasta de jeito nenhum, então uma execução agendada não mantém registro. A verificação da nota abaixo: peça a lista de compras da cafeteria, feche o Claude Code, abra de novo e peça para continuar.