Quando um arquivo de anotações basta
Muitos desenvolvedores dizem que um simples arquivo de anotações é toda a memória de que uma IA precisa, e para algumas tarefas eles têm razão. Um arquivo é grátis, você consegue ler cada palavra dele, ele fica no projeto junto com o código e nada acontece com ele que você não tenha escrito.
Um arquivo é a ferramenta certa quando:
- Você usa um app de IA, quase sempre em um projeto.
- O que ele precisa saber é sobre o projeto: como compilar, como testar, o que evitar.
- Você mesmo o mantém curto e atualizado.
O Claude Code lê o CLAUDE.md, o Cursor lê as regras dele, e os três, Claude Code, Cursor e Codex, conseguem ler um AGENTS.md. Para regras do projeto, um AGENTS.md versionado junto com o código é difícil de superar.
Onde um arquivo não dá conta
- Cada app lê um arquivo diferente, ou nenhum. Os apps de conversa do ChatGPT e do Claude não leem os arquivos de anotações das suas ferramentas de programação; a memória deles fica na conta de cada empresa.
- Fatos sobre você não pertencem a um projeto só. Como você gosta das respostas, as ferramentas que prefere, no que está trabalhando este mês: coloque isso no arquivo de um repositório e o próximo projeto não terá nada disso.
- Alguém precisa escrever. Um arquivo só sabe o que você, ou o app, lembrou de adicionar, e manter os arquivos de três apps sincronizados é uma tarefa que acaba ficando para trás.
- Só uma parte é lida no início. A Anthropic sugere manter cada CLAUDE.md abaixo de 200 linhas e carrega só as primeiras 200 linhas ou 25KB do índice de memória do Claude Code quando uma sessão começa (documentação da Anthropic). Além disso, um arquivo mais longo custa mais e é menos seguido.
Nossos próprios arquivos, depois de cinco meses
Construímos o Zaaheen com o Claude Code e mantemos os dois tipos de anotação, então contamos as nossas:
| Opção | Linhas |
|---|---|
| Nosso CLAUDE.md | 147 linhas |
| Nosso índice de memória | 155 linhas |
| Orientação da Anthropic | 200 linhas |
Os dois estão perto do limite, e só ficam abaixo dele porque os enxugamos: uma linha por memória, detalhes movidos para arquivos separados, entradas antigas fundidas ou removidas. Um arquivo de anotações funciona, mas dá trabalho de manutenção.
Use os dois, para coisas diferentes
A questão não é bem arquivo ou ferramenta. Mantenha as regras do projeto em um arquivo junto com o código. Mantenha o que é verdade sobre você em uma memória que todos os apps de IA alcançam, para que isso fique fora dos arquivos do projeto e você nunca precise escrever três vezes.
O Zaaheen é uma memória desse tipo, para Windows e Mac: seus apps de IA salvam o que aprendem sobre você enquanto trabalham e encontram de novo quando importa, e suas memórias ficam criptografadas no seu próprio computador. Você vê cada memória no app e pode esquecer qualquer uma.