Problema
Tenho vários projetos andando ao mesmo tempo, cada um parado num ponto diferente. Sem método, cada sessão nova começa com meia hora de “onde a gente estava mesmo?”, e decisão da semana passada volta para a mesa como se fosse nova.
O que fiz
Uma convenção com uma premissa só: o modelo esquece, o repositório não.
- Documento por porte. Experimento leva dois arquivos; produto leva o kit completo. Cada documento responde uma pergunta só.
- Toda decisão guarda as alternativas que perderam. Sem elas, a discussão volta.
- Regras que se verificam sozinhas. Um script confere o mecânico (documento faltando, link quebrado) e falha se algo estiver fora.
Este site passou por isso: a direção visual saiu da segunda rodada de opções de tela.
O modelo esquece. O repositório não.
O custo de lembrar demais
O outro lado do problema apareceu quando medi o consumo de setembro: 1,93 bilhão de tokens de entrada no mês, e 94% deles era contexto reenviado, não pergunta nova. Sessão longa é cara porque cada mensagem carrega tudo o que veio antes.
Não dava para depender de eu lembrar. Pus dois avisos automáticos no Claude Code:
- A cada mensagem, um hook mede o tamanho da sessão. Passou de 5 MB, o próprio agente me avisa que é hora de fechar a tarefa e abrir sessão nova. Passou de 15 MB, avisa de novo, mais firme. Cada aviso aparece uma vez só.
- Quando o Claude Code compacta a conversa sozinho, por ter batido o limite, outro hook avisa na hora. É o sinal mais forte que existe.
Nenhum dos dois bloqueia nada. Eles só fazem o agente dizer, em uma frase, o que eu deveria ter notado. Como os documentos guardam onde paramos, abrir uma sessão nova não custa nada.