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.
📖 Read the full source: r/ClaudeAI
👀 See Also
Anchormd: Uma Ferramenta para Gerenciar Contexto Entre Sessões do Claude AI
Anchormd é uma ferramenta de código aberto que resolve a perda de contexto em sessões do Claude AI, indexando planos curados em markdown em um grafo de conhecimento pesquisável. Ela permite que os agentes carreguem visões gerais do projeto no início da sessão e consultem detalhes específicos conforme necessário.
BotCost.dev: Analisador Gratuito para Ver Quanto os Bots de IA Custam ao Seu Site
BotCost.dev é uma ferramenta gratuita que analisa seus logs de servidor contra 18 impressões digitais conhecidas de bots de IA (GPTBot, ClaudeBot, Perplexity, etc.) e estima o custo mensal de largura de banda — sem necessidade de upload, executa no navegador.
blend-ai: Novo Serviço MCP do Blender para Claude Code
blend-ai é um novo serviço MCP do Blender que permite ao Claude Code gerar cenas 3D. Um usuário relatou que funcionou mais rápido e melhor que o blender-mcp, criando uma cena de lançamento de ônibus espacial a partir de imagens de referência em 5 minutos.
SpecLock: Motor de Restrições de Código Aberto para Agentes de IA de Programação
SpecLock é um servidor MCP que aplica ativamente restrições em agentes de codificação de IA, como o Claude Code. Ele bloqueia violações com avisos de conflito semântico usando expansão de sinônimos, detecção de negação e sinalização de ações destrutivas.