Session Guard

Visão Geral

Sessões longas corrompem silenciosamente. A compactação de contexto descarta instruções sem aviso. Hooks não resolvem isso (confirmado por vários desenvolvedores em issues do GitHub #19471, #9796, #64171). Esta habilidade previne ambos através da auto-aplicação comportamental: monitorar a saúde, ancorar regras críticas através da compactação, dividir antes que o dano ocorra. Sem pacotes, sem bancos de dados - pura aplicação comportamental que funciona em qualquer ambiente.

Quando Usar

• Sessão excede 40 chamadas de ferramenta
• Agente contradiz decisões anteriores
• Convenções de estilo/nomeação começam a desviar
• Após qualquer evento de compactação de contexto
• Escopo da tarefa crescendo sem limites

Sinais de Saúde

Protocolo

Zona Verde (0-40 chamadas de ferramenta)

Operação normal. Nenhuma intervenção necessária.

Zona Amarela (40-60 chamadas de ferramenta)

1. CHECKPOINT - resumir o progresso em um parágrafo
2. RECITAR - declarar as 3-5 regras ativas mais críticas em voz alta: "Regras ativas: [convenção de nomeação], [estrutura de arquivos], [padrão de tratamento de erros], [requisito de teste]"
3. AVALIAR - quase terminando? Continue. Não terminou? Prepare a divisão.
4. REDUZIR - sem leituras exploratórias. Apenas operações direcionadas.

Zona Vermelha (60+ chamadas de ferramenta OU sinal de desvio)

1. PARAR - não fazer mais chamadas de ferramenta
2. VERIFICAR - reler as regras do projeto (não confiar na memória)
3. CHECKPOINT - escrever o estado em um documento de passagem
4. DIVIDIR - criar passagem, sugerir nova sessão

Ancoragem de Contexto (anti-compactação)

Quando a compactação ocorreu (perda súbita de contexto anterior, ou após /compact):

1. RELER o arquivo de regras do projeto imediatamente
2. RECITAR as 3-5 regras críticas em voz alta em sua resposta
3. VERIFICAR se sua próxima ação planejada corresponde a essas regras antes de executar
4. Se incerto sobre QUALQUER decisão anterior, RELER o arquivo fonte - não adivinhe

O que sobrevive à compactação:

• Mensagens mais recentes do usuário (alta prioridade)
• Corpo da habilidade atualmente invocado (limitado a 5K tokens, o mais antigo é descartado primeiro)
• Status do Git e estrutura do projeto
• Conteúdo de arquivos lidos APÓS a compactação

O que é PERDIDO na compactação:

• Decisões tomadas no início da conversa
• Regras arquiteturais declaradas apenas verbalmente (não em arquivos)
• Contexto de saídas de ferramentas (leituras de arquivos, saídas de comandos)

Padrão Seguro contra Compactação

Mantenha instruções críticas em ARQUIVOS (CLAUDE.md, CONTEXT.md), NÃO na conversa. Se uma regra importa, ela deve residir em um arquivo que o agente possa reler - não em algo acordado anteriormente.

Erros Comuns

• Confiar que você se lembra das regras após 50+ chamadas de ferramenta (você não se lembra - releia)
• Relendo TUDO para ter certeza (desperdiça chamadas de ferramenta - seja direcionado)
• Sentir-se bem, portanto, assumir que o contexto está bem (a compactação é SILENCIOSA)
• Dividir APÓS notar problemas (divida ANTES - prevenção, não recuperação)

Por Que Isso Importa

A compactação de contexto é o principal problema não resolvido da plataforma em 2026. Hooks não resolvem isso (confirmado: o agente ignora injeções pós-compactação porque o resumo da compactação cria um impulso narrativo). Esta habilidade é a contramedida comportamental leve: sem infraestrutura, sem pacotes - auto-monitoramento disciplinado que funciona em qualquer ambiente.