Gerenciamento Automatizado do Estado da Sessão para o Claude Code Handoff

Preservação Automática de Contexto para Sessões do Claude

Um usuário do Reddit compartilhou uma solução para gerenciar a degradação de contexto nas conversas com Claude, abordando especificamente problemas com autocompactação e perda de contexto no meio da conversa conforme as janelas de conversa ficam muito grandes. O sistema mantém automaticamente um arquivo de estado ativo ao longo das sessões sem intervenção manual.

Como Funciona

A solução expande os comandos manuais de handoff incorporando hooks adicionais:

• Um hook UserPromptSubmit é acionado a cada mensagem enviada, injetando uma diretiva no contexto do sistema do Claude que diz "verifique se algo importante aconteceu e, se sim, atualize o session-state.md"
• Um hook PostToolUse rastreia quais arquivos o Claude edita
• Quando session-state.md fica muito longo, a diretiva muda automaticamente para "modo de reescrita" dizendo ao Claude para manter apenas informações críticas
• Antes da autocompactação, um hook PreCompact força um dump completo do estado para que nada seja perdido
• No início da sessão, o estado da sessão anterior é carregado novamente

Detalhes de Implementação

O sistema automatizado consiste em aproximadamente 4 scripts shell sem dependências além de bash e jq. As opções de instalação incluem:

• Instalar como um submódulo git
• Copiar os hooks para o diretório .claude/hooks/

O sistema mantém um arquivo de estado ativo em .claude/session-state.md ao longo da sessão. Também inclui um comando manual /handoff para checkpoints deliberados, útil para rastreamento de tarefas, investigações de bugs e recuperação de contexto degradado.

Esse tipo de ferramenta é útil para desenvolvedores que trabalham em projetos complexos e multissessão com Claude, onde manter o contexto entre conversas é crítico para continuidade e para evitar repetições.