Um Sistema para o Claude Code Aprender Seu Projeto ao Longo do Tempo

Um desenvolvedor no r/ClaudeAI compartilhou um sistema para resolver a falta de contexto persistente do Claude Code entre sessões. Em vez de começar do zero a cada vez, essa configuração ajuda o Claude a aprender as convenções, arquitetura e erros passados do seu projeto.

O Problema e a Solução

Ao usar o Claude Code, cada nova sessão perde todo o contexto anterior. O Claude relê arquivos que já havia entendido, repete erros corrigidos e ignora padrões estabelecidos, exigindo reexplicação constante.

A solução envolve adicionar alguns arquivos a qualquer repositório:

• CLAUDE.md - Um conjunto curto de regras dizendo ao Claude como se comportar. Exemplos incluem "pergunte antes de prosseguir se algo não estiver claro" e "não execute testes você mesmo, diga-me o que executar" (o que economiza dinheiro evitando desperdício de tokens na busca por erros).
• Pasta docs/ - Contém arquivos curtos (5-10 linhas cada) capturando convenções, padrões e arquitetura do projeto, organizados em subpastas. Um arquivo de índice (docs/README.md) ajuda o Claude a encontrar rapidamente o documento certo em vez de adivinhar.

Três Prompts Principais

• bootstrap - Colado uma vez ao adotar uma base de código existente. O Claude lê seu código e escreve a documentação inicial.
• refine - Colado no final de uma sessão. O Claude reflete sobre o que aconteceu e atualiza a documentação com novos aprendizados.
• factory - Colado quando o Claude faz algo que você deseja repetir. Ele captura o padrão como um prompt reutilizável.

O Ciclo de Trabalho

O processo cria um ciclo de aprendizado contínuo: Você programa com o Claude → a sessão termina → você cola o prompt refine → o Claude atualiza a documentação → você faz commit → a próxima sessão começa mais inteligente. Como a documentação está no git, todos da sua equipe se beneficiam dela, e funciona com qualquer stack de tecnologia.

Dicas Práticas da Implementação

• Diga explicitamente ao Claude para não executar comandos de build/teste para evitar queimar tokens perseguindo erros. Em vez disso, peça para ele dizer quais comandos executar.
• Use números específicos nas regras (ex: "pause se alterar 3+ arquivos") em vez de termos vagos como "pause para tarefas complexas", pois o Claude perde tempo interpretando ambiguidades.
• Um arquivo de índice para sua pasta docs compensa imediatamente, impedindo que o Claude abra arquivos aleatórios na esperança de encontrar informações relevantes.

O sistema é gratuito e de código aberto, disponível em saas-vibe.