Gerenciamento de contexto

A maioria dos modelos usa janelas de contexto padrão de 200K:

• Claude 4.5 Sonnet — Equilibrado para tarefas complexas
• Claude 4.5 Haiku — Rápido e eficiente
• GPT-5 — Excelente para raciocínio (Beta)
• GPT-5-Codex — Otimizado para programação (Beta)

Capacidade:

• ~200,000 tokens de capacidade total de memória
• Suficiente para a maioria das tarefas de desenvolvimento e projetos de tamanho médio

O que está incluído:

• Todas as mensagens da conversa
• Conteúdos de arquivos carregados no contexto
• Saídas e respostas de ferramentas
• Prompts e instruções do sistema
• Definições de servidor MCP

Desempenho:

• Degrada significativamente ao se aproximar dos limites
• Fique atento aos sinais de sobrecarga de contexto (respostas mais lentas, saídas menos precisas)
• Reinicie o contexto com mais frequência para obter desempenho ideal

O Claude Sonnet 4.5 oferece contexto estendido (1M tokens) quando selecionado explicitamente ou quando a entrada excede 200K tokens.

Capacidade:

• 1,000,000 tokens de memória total
• 5x maior que os modelos padrão

Benefícios:

• Perfeito para carregar bases de código grandes inteiras sem fragmentação
• Elimina a maioria das preocupações com gerenciamento de contexto em projetos grandes
• Trabalhe por mais tempo antes de atingir os limites de contexto
• Menos reinícios de sessão necessários

Quando usar:

• Bases de código grandes com 1000+ arquivos
• Refatoração complexa de múltiplos arquivos em projetos inteiros
• Sessões longas de desenvolvimento abrangendo várias tarefas relacionadas
• Quando você deseja minimizar a sobrecarga de gerenciamento de contexto

Sinais:

• Respostas menos precisas ou incompletas
• Detalhes importantes do início da conversa estão faltando
• Dificuldade em manter a consistência ao longo de sessões longas
• Confusão sobre mudanças recentes ou contexto

Exemplos concretos:

• Sugere soluções que você já rejeitou anteriormente na sessão
• Ignora convenções de código que você estabeleceu 20 mensagens atrás
• Gera código que entra em conflito com mudanças feitas anteriormente na conversa
• Propõe implementações que não correspondem à arquitetura do seu projeto discutida anteriormente

Sinal principal: as respostas do Verdent ficam menos precisas ou inconsistentes

Sinais:

• Tempos de resposta visivelmente mais lentos
• Atrasos maiores no processamento antes do início das respostas
• Aumento da latência entre mensagens

Exemplos concretos:

• Respostas que normalmente levam 5-10 segundos agora levam 30+ segundos
• Atraso visível antes de o indicador de digitação aparecer depois de você enviar uma mensagem
• As respostas em streaming começam muito mais devagar que o habitual
• A execução de ferramentas (leitura de arquivos, buscas) leva visivelmente mais tempo

Sinal principal: as respostas levam significativamente mais tempo que o habitual

Sinais:

• Pedidos para esclarecer informações já fornecidas
• Esquecimento de padrões ou convenções estabelecidos anteriormente
• Incapacidade de referenciar arquivos ou código discutidos anteriormente
• Perguntas redundantes sobre a estrutura do projeto

Exemplos concretos:

• Pergunta "Qual framework você está usando?" quando você especificou React 30 mensagens atrás
• Solicita caminhos de arquivo que você já @-mentioned várias vezes
• Não lembra a convenção de nomenclatura que você estabeleceu no início da sessão
• Reexplica conceitos ou abordagens que você já rejeitou com justificativas

Sinal principal: o Verdent pergunta sobre coisas já discutidas

Sinais:

• Aproximação do último quinto do limite de 200K tokens (~160K+ tokens usados)
• Conversas longas com muitas leituras de arquivos e saídas de ferramentas
• Vários servidores MCP ativados com definições de ferramentas pesadas
• Arquivos grandes carregados no contexto repetidamente

Exemplos concretos:

• A sessão está em andamento há 2+ horas com 100+ mensagens
• Você carregou 20+ arquivos com @-mentions ao longo da conversa
• Vários arquivos grandes (>1000 linhas cada) estão no contexto
• Você tem 5+ servidores MCP ativados com definições de ferramentas extensas
• A conversa inclui muitos resultados de grep/busca e leituras de arquivos

Sinal principal: sessões muito longas com uso extenso de arquivos/ferramentas

• Tempos de resposta visivelmente mais lentos
• Respostas menos precisas ou inconsistentes
• O Verdent esquecendo contexto ou padrões anteriores
• Aproximação dos limites da janela de contexto (fique atento aos sinais de degradação)

Ação: inicie uma nova sessão quando a qualidade cair

• Alternância entre recursos ou módulos não relacionados
• Conclusão de uma tarefa e mudança para a próxima
• Após tarefas que exigem muita memória (grandes refatorações, trabalho arquitetural)
• Mudança da fase de pesquisa para a fase de implementação

Ação: nova sessão para cada nova tarefa importante

• Após enviar recursos concluídos ao controle de versão
• Entre pontos de verificação lógicos no fluxo de trabalho de desenvolvimento
• Após ciclos de teste-verificação-commit

Ação: commit → teste → nova sessão

• Antes de iniciar grandes recursos novos
• Quando o histórico da conversa fica muito longo
• Após concluir alterações em vários arquivos
• Entre diferentes tipos de trabalho (depuração → desenvolvimento de recursos)

Ação: inicie uma nova sessão proativamente antes que o contexto se degrade

Arquivos menores e focados:

• Muitos arquivos pequenos consomem o contexto de forma mais eficiente do que poucos arquivos grandes
• É mais fácil carregar apenas os módulos relevantes
• Melhor controle granular sobre o que está no contexto
• Reduz a necessidade de carregar arquivos grandes inteiros

Estrutura de diretórios clara:

• A organização lógica ajuda o Verdent a localizar arquivos relacionados
• A organização baseada em recursos ou módulos melhora o direcionamento do contexto
• Reduz a necessidade de carregar código não relacionado

Documentation in AGENTS.md:

• A documentação do projeto substitui a necessidade de carregar muitos arquivos de exemplo
• Padrões arquiteturais descritos uma vez e referenciados repetidamente
• Padrões de código documentados de forma centralizada
• Reduz a sobrecarga de contexto causada por leituras exploratórias de arquivos

Benefícios:

• Trabalhe em módulos isolados sem carregar toda a base de código
• Limites claros permitem sessões focadas
• A divisão do trabalho se torna natural ao longo dos limites dos módulos

Problemas:

• Arquivos monolíticos forçam o carregamento de contextos grandes inteiros
• Uma estrutura pouco clara exige carregar muitos arquivos para entender a arquitetura
• Preocupações misturadas nos mesmos arquivos desperdiçam contexto com código irrelevante

Impacto:

• Problemas frequentes de limite de contexto
• Tokens desperdiçados com código irrelevante
• Dificuldade em isolar o trabalho em módulos específicos
• Necessidade mais frequente de reiniciar sessões

Antipadrões comuns:

• Arquivos únicos de 5000+ linhas com várias preocupações
• Estrutura de diretórios plana com 100+ arquivos na raiz
• Nenhuma separação clara entre recursos/módulos
• Falta de documentação centralizada

Abordagens de refatoração:

• Divida arquivos grandes em módulos menores e focados
• Organize por recurso ou domínio (não por tipo de arquivo)
• Crie uma hierarquia de diretórios clara
• Extraia código compartilhado para módulos separados

Documentação:

• Crie AGENTS.md com padrões arquiteturais
• Documente os padrões de código de forma centralizada
• Mantenha arquivos README por módulo
• Mantenha as decisões de design documentadas

Impacto no contexto: para contextos padrão de 200K tokens, espaços de trabalho organizados fazem a diferença entre atingir os limites com frequência ou raramente. Para contextos de 1M tokens, a organização importa menos, mas ainda melhora a eficiência.

Fique atento aos sinais de desempenho:

• Monitore a qualidade e a velocidade das respostas ao longo das sessões
• Note quando as respostas ficam mais lentas ou menos precisas
• Acompanhe manualmente o tamanho da conversa e a quantidade de arquivos
• Seja proativo ao iniciar novas sessões

O que monitorar:

• Precisão e consistência das respostas
• Tempo até a primeira resposta (atraso do indicador de digitação)
• Tempo total de conclusão da resposta
• Memória de detalhes anteriores da conversa

Gerenciamento de subagentes:

• Desative subagentes personalizados não utilizados quando não forem necessários
• Cada subagente ativado adiciona definições à sobrecarga do sistema
• Mantenha ativados apenas os subagentes em uso ativo
• Reative-os conforme necessário para tarefas específicas

Limite de ação: quando você notar 2-3 sinais de degradação, é hora de iniciar uma nova sessão.

Abordagem de divisão:

• Divida tarefas grandes em partes menores
• Conclua trabalhos relacionados em sessões focadas
• Evite misturar diferentes tipos de tarefa em conversas longas
• Evite o último quinto da janela de contexto em trabalhos que exigem muita memória

Gerenciamento de sessões:

• Inicie novas sessões entre tarefas importantes
• Limpe o contexto após commits: teste → verifique → commit → nova sessão
• Use tarefas para o planejamento de várias etapas
• Trabalhe nos itens de tarefa em sessões focadas separadas

Padrão de boa prática:

1. Planeje a tarefa no Plan Mode
2. Execute a implementação focada em uma nova sessão
3. Teste e verifique as alterações
4. Faça commit no controle de versão
5. Inicie uma nova sessão para a próxima tarefa

Isolamento de tarefas: mantenha a depuração separada do desenvolvimento de recursos e a pesquisa separada da implementação.

Inclusão estratégica:

• Use @-mentions para inclusão explícita de arquivos apenas quando necessário
• Aproveite a documentação AGENTS.md em vez de carregar muitos arquivos
• Trabalhe em um módulo de cada vez em projetos grandes
• Divida arquivos grandes em componentes menores e focados

Princípios de seleção de arquivos:

• Inclua apenas arquivos que precisam de modificação ou referência direta
• Prefira a documentação ao carregamento de arquivos de exemplo
• Remova arquivos do contexto quando não forem mais necessários
• Carregue arquivos sob demanda, e não preventivamente

Tratamento de arquivos grandes:

• Considere dividir arquivos com mais de 500 linhas
• Extraia utilitários e auxiliares para arquivos separados
• Use limites de módulo claros
• Documente as relações entre arquivos em AGENTS.md

Fluxo de trabalho de otimização:

Monitore o desempenho → identifique o inchaço da sessão → desative subagentes não utilizados → inicie novas sessões proativamente → concentre-se na qualidade da tarefa

Prática diária:

• Inicie cada recurso importante com um contexto novo
• Faça commits com frequência e reinicie entre os commits
• Mantenha as sessões focadas em objetivos únicos
• Revise o uso do contexto em pontos de pausa naturais

For Extended Context (1M tokens): Com a janela de contexto maior do Claude Sonnet 4.5, a otimização se torna menos crítica — concentre-se na qualidade da tarefa em vez do gerenciamento agressivo de contexto. Ainda assim, boas práticas continuam melhorando a eficiência e a organização.