Código Aberto CLAUDE.md Mantém Agentes Claude Code Produtivos por Horas, Sem Loop

Se você já executou sessões autônomas do Claude Code, conhece o problema: o agente começa afiado, mas após 2 horas começa a divagar em narrações, entra em loop na mesma correção por volta da 3ª hora e morre sem entregar nada. Um desenvolvedor que queimou centenas de sessões descobriu que o culpado não era uma ferramenta ou framework — era a falta de um arquivo CLAUDE.md na raiz do projeto.

O que o Arquivo Operacional Faz

O arquivo tem 70 linhas, licença MIT, e fica em ./CLAUDE.md. O Claude Code o lê na inicialização e o comportamento muda imediatamente. As diretrizes principais:

• Força ação em vez de narração. Se o agente se pegar escrevendo "vou agora" em vez de chamar uma ferramenta, ele para e executa a ferramenta.
• Exige evidências antes de declarar concluído. Nada de "deve estar corrigido" sem saída de teste.
• Elimina linguagem de planejamento. As únicas saídas válidas são ações concluídas, perguntas ou resumos.
• Faz auto-auditoria sob pressão de contexto em vez de degradar silenciosamente.

Impacto nas Sessões

Com o arquivo no lugar, as sessões passaram de loops de narração de 3 horas para ciclos produtivos completos. O agente entrega código, verifica se foi implantado e continua até que a pressão do contexto atinja o limite. Então salva o estado e a próxima sessão retoma limpa.

Como Usar

Copie o arquivo do repositório GitHub para a raiz do seu projeto. Sem configuração, sem dependências. O Claude Code o lê automaticamente. O repositório contém o CLAUDE.md exato — pegue e coloque.