Orçamento de Contexto
Analise a sobrecarga de tokens em cada componente carregado em uma sessão do Claude Code e sugira otimizações acionáveis para recuperar espaço de contexto.
Quando Usar
- A performance da sessão parece lenta ou a qualidade da saída está degradando
- Você adicionou recentemente muitas skills, agentes ou servidores MCP
- Você quer saber quanta margem de contexto realmente tem
- Planejando adicionar mais componentes e precisa saber se há espaço
- Executando o comando
/context-budget(esta skill dá suporte a ele)
Como Funciona
Fase 1: Inventário
Examine todos os diretórios de componentes e estime o consumo de tokens:
Agentes (agents/*.md)
- Conte linhas e tokens por arquivo (palavras × 1.3)
- Extraia o comprimento do frontmatter
description - Sinalize: arquivos >200 linhas (pesados), descrição >30 palavras (frontmatter inchado)
Skills (skills/*/SKILL.md)
- Conte tokens por SKILL.md
- Sinalize: arquivos >400 linhas
- Verifique cópias duplicadas em
.agents/skills/— ignore cópias idênticas para evitar contagem dupla
Regras (rules/**/*.md)
- Conte tokens por arquivo
- Sinalize: arquivos >100 linhas
- Detecte sobreposição de conteúdo entre arquivos de regras no mesmo módulo de idioma
Servidores MCP (.mcp.json ou configuração MCP ativa)
- Conte servidores configurados e número total de ferramentas
- Estime sobrecarga de esquema em ~500 tokens por ferramenta
- Sinalize: servidores com >20 ferramentas, servidores que envolvem comandos CLI simples (
gh,git,npm,supabase,vercel)
CLAUDE.md (nível de projeto + usuário)
- Conte tokens por arquivo na cadeia CLAUDE.md
- Sinalize: total combinado >300 linhas
Fase 2: Classificar
Classifique cada componente em um balde:
| Balde | Critério | Ação |
|---|---|---|
| Sempre necessário | Referenciado em CLAUDE.md, suporta um comando ativo ou corresponde ao tipo de projeto atual | Manter |
| Às vezes necessário | Específico de domínio (ex: padrões de linguagem), não referenciado em CLAUDE.md | Considerar ativação sob demanda |
| Raramente necessário | Nenhuma referência de comando, conteúdo sobreposto ou nenhuma correspondência óbvia com o projeto | Remover ou carregar sob demanda |
Fase 3: Detectar Problemas
Identifique os seguintes padrões problemáticos:
- Descrições de agentes inchadas — descrição >30 palavras no frontmatter é carregada em toda invocação da ferramenta Task
- Agentes pesados — arquivos >200 linhas inflam o contexto da ferramenta Task a cada inicialização
- Componentes redundantes — skills que duplicam lógica de agente, regras que duplicam CLAUDE.md
- Assinatura excessiva de MCP — >10 servidores, ou servidores que envolvem ferramentas CLI disponíveis gratuitamente
- Inchaço do CLAUDE.md — explicações verbosas, seções desatualizadas, instruções que deveriam ser regras
Fase 4: Relatar
Produza o relatório de orçamento de contexto:
Relatório de Orçamento de Contexto
═══════════════════════════════════════
Sobrecarga total estimada: ~XX.XXX tokens
Modelo de contexto: Claude Sonnet (janela de 200K)
Contexto disponível efetivo: ~XXX.XXX tokens (XX%)
Detalhamento de Componentes:
┌─────────────────┬────────┬───────────┐
│ Componente │ Cont. │ Tokens │
├─────────────────┼────────┼───────────┤
│ Agentes │ N │ ~X.XXX │
│ Skills │ N │ ~X.XXX │
│ Regras │ N │ ~X.XXX │
│ Ferramentas MCP │ N │ ~XX.XXX │
│ CLAUDE.md │ N │ ~X.XXX │
└─────────────────┴────────┴───────────┘
AVISO: Problemas Encontrados (N):
[classificados por economia de tokens]
Top 3 Otimizações:
1. [ação] → economizar ~X.XXX tokens
2. [ação] → economizar ~X.XXX tokens
3. [ação] → economizar ~X.XXX tokens
Economia potencial: ~XX.XXX tokens (XX% da sobrecarga atual)
No modo verboso, adicionalmente gere contagens de tokens por arquivo, detalhamento linha por linha dos arquivos mais pesados, linhas redundantes específicas entre componentes sobrepostos e lista de ferramentas MCP com estimativas de tamanho de esquema por ferramenta.
Exemplos
Auditoria básica
Usuário: /context-budget
Skill: Examina configuração → 16 agentes (12.400 tokens), 28 skills (6.200), 87 ferramentas MCP (43.500), 2 CLAUDE.md (1.200)
Sinaliza: 3 agentes pesados, 14 servidores MCP (3 substituíveis por CLI)
Maior economia: remover 3 servidores MCP → -27.500 tokens (47% de redução de sobrecarga)
Modo verboso
Usuário: /context-budget --verbose
Skill: Relatório completo + detalhamento por arquivo mostrando planner.md (213 linhas, 1.840 tokens),
Lista de ferramentas MCP com tamanhos por ferramenta, linhas de regras duplicadas lado a lado
Verificação pré-expansão
Usuário: Quero adicionar mais 5 servidores MCP, tenho espaço?
Skill: Sobrecarga atual 33% → adicionar 5 servidores (~50 ferramentas) adicionaria ~25.000 tokens → empurra para 45% de sobrecarga
Recomendação: remova 2 servidores substituíveis por CLI primeiro para ficar abaixo de 40%
Melhores Práticas
- Estimativa de tokens: use
palavras × 1.3para prosa,chars / 4para arquivos com muito código - MCP é a maior alavanca: cada esquema de ferramenta custa ~500 tokens; um servidor com 30 ferramentas custa mais que todas as suas skills combinadas
- Descrições de agentes são sempre carregadas: mesmo que o agente nunca seja invocado, seu campo de descrição está presente em todo contexto da ferramenta Task
- Modo verboso para depuração: use quando precisar identificar os arquivos exatos que estão gerando sobrecarga, não para auditorias regulares
- Auditar após mudanças: execute após adicionar qualquer agente, skill ou servidor MCP para detectar aumento cedo