/compact na Verboo Code: como compactar o contexto sem perder o que importa

Sessão longa, o agente começa a esquecer o que combinou uma hora atrás e, de repente, aparece o aviso de que o contexto está acabando. A saída não é reiniciar do zero e perder tudo: é compactar. O /compact troca o histórico da conversa por um resumo, e você decide o que esse resumo precisa preservar. Este guia mostra os comandos, quando a Verboo Code compacta sozinha e o que fazer quando a compactação falha.

O que o /compact faz na Verboo Code?

Ele apaga o histórico da conversa e deixa no contexto um resumo do que aconteceu. A sessão continua, com o mesmo projeto e o mesmo agente, só que ocupando muito menos tokens da janela de contexto.

A descrição do comando no código é literal: "Clear conversation history but keep a summary in context. Optional: /compact [instructions for summarization]". Ele funciona também em modo não interativo, e o resumo completo abre com Ctrl+O.

Como ver quanto do contexto já foi usado?

Rode /context. Em sessão interativa ele mostra o uso atual como uma grade colorida; em modo não interativo, mostra o uso em texto.

/context

Vale olhar antes de compactar. Compactar com 20% de uso só gasta uma chamada de modelo para resumir pouca coisa.

Como compactar dizendo o que preservar?

Escreva as instruções depois do comando. Elas entram no pedido de resumo, então o resumo guarda o que você citou em vez de decidir sozinho.

/compact preserve a lista de arquivos alterados, o schema novo da tabela orders e a decisão de não usar Redis

Sem instruções, a Verboo Code tenta primeiro a compactação por memória de sessão, que não aceita instruções personalizadas. Se ela não se aplica, cai na compactação tradicional, que gera o resumo por chamada ao modelo. Com instruções, vai direto para a tradicional. Na prática: use instruções sempre que houver uma decisão ou um nome de arquivo que você não pode perder.

Quando a Verboo Code compacta sozinha?

Quando o contexto chega perto do limite e o Auto-compact está ligado. O gatilho é a janela efetiva do modelo menos 13.000 tokens de folga. A janela efetiva já desconta o espaço reservado para o resumo, de até 20.000 tokens.

Para ligar ou desligar, abra /config e alterne a opção Auto-compact. Também dá para controlar por variável de ambiente:

export DISABLE_AUTO_COMPACT=1

Dá para rodar algo antes da compactação?

Dá. A Verboo Code dispara os hooks PreCompact e PostCompact, e o de antes informa se a compactação é manual ou auto. Um hook de PreCompact também pode devolver instruções extras, que são anexadas depois das suas. Para montar hooks, veja o guia de hooks da Verboo Code.

O que fazer quando o /compact dá erro?

Três mensagens aparecem no código, cada uma com um caminho diferente:

A compactação automática para de tentar depois de 3 falhas seguidas, para não gastar chamadas à toa numa sessão que já estourou o limite. Se chegou nesse ponto, compacte manualmente com /compact ou comece do zero com /clear.

Quando usar /clear em vez de /compact?

Quando a próxima tarefa não depende da anterior. O /compact mantém um resumo no contexto, e esse resumo ainda custa tokens e pode puxar o agente para o assunto velho. O /clear começa limpo.