Usuário do Reddit compartilha abordagem baseada em especificações para reduzir alucinações do Claude Code

Um desenvolvedor na comunidade r/ClaudeAI do Reddit compartilhou um método prático para reduzir alucinações ao usar o Claude Code em sessões de desenvolvimento prolongadas. A abordagem se concentra em manter o contexto através de documentação estruturada.

O Problema: Perda de Contexto Durante as Compactações

O desenvolvedor descreveu um padrão em que o Claude Code começava bem em um projeto, mas se degradava após múltiplas compactações de contexto. Instruções específicas como "não diga concluído a menos que você tenha criado um teste e o teste tenha passado" eram esquecidas após as compactações, fazendo com que bugs antigos ressurgissem e a qualidade da saída piorasse.

A Solução: Desenvolvimento Orientado por Especificações

Inspirado pela forma como a Anthropic construiu seu recurso de Plugins, o desenvolvedor adotou uma abordagem de especificação primeiro:

• Comece pedindo ao Claude que faça perguntas esclarecedoras sobre o aplicativo, depois crie um REQUIREMENTS.md com requisitos detalhados e em tópicos
• Crie um IMPLEMENTATION_PLAN.md com tarefas para cada requisito, referenciando os tópicos do documento de requisitos
• Crie um plano de teste que corresponda 100% ao plano de implementação com casos de teste para cada tarefa
• Crie um CLAUDE.md com instruções para consultar o plano de implementação e executar as etapas

O CLAUDE.md especificamente instrui o Claude a:

consultar o plano de implementação e executar as etapas nele. Após cada tarefa ter concluído o desenvolvimento, você deve executar o item correspondente do plano de teste para a tarefa e somente após o teste passar, você "deve" marcá-lo como concluído. Para cada nova instrução que eu fornecer, você precisa atualizar o documento de requisitos, o plano de implementação e o plano de teste.

Resultados

O desenvolvedor relatou uma qualidade de execução muito melhor mesmo após várias compactações. O Claude não perde mais seu lugar após as compactações e sabe de onde executar. O desenvolvedor pode perguntar "O que falta?" e obter respostas úteis, com alucinação significativamente reduzida.

Uma limitação observada: o Claude ainda não executa testes todas as vezes, o que o desenvolvedor atribui às restrições do ambiente local (Mac antigo, dificuldade em executar XCode ou simuladores).

O Claude também criou um arquivo MEMORY.md durante o processo, embora o desenvolvedor tenha observado que não sabe como isso é útil.