Orçamento de Contexto

Use o medidor nativo do provedor para uso de sessão ao vivo. Mantenha a auditoria de instalação estimada, separada, por trás de uma opção explícita.

Padrão: Contexto ao Vivo

Trate uma invocação sem solicitação de auditoria como uma solicitação de contexto ao vivo. Isso inclui solicitações para a janela atual, capacidade restante, margem, uso de tokens ou um detalhamento de contexto.

Para este caminho padrão:

• Não chame ou use ferramentas.
• Não escaneie ou leia arquivos.
• Não execute comandos de shell, CLIs do provedor, logs de depuração ou descoberta de MCP.
• Responda apenas com o comando nativo e uma explicação curta.

Roteie pelo harness ativo:

Esses comandos são documentados na Referência de comandos do Codex e na Referência de comandos do Claude Code.

Uma habilidade não pode invocar um comando de barra TUI em nome do usuário. Nunca substitua o comando nativo por uma varredura estimada e nunca infira uma solicitação de auditoria de frases como "o contexto está pesado" ou "quanto resta".

Auditoria Estática Explícita

Execute uma auditoria de instalação/configuração apenas quando o usuário disser explicitamente --audit, "auditar componentes instalados" ou redação inequívoca equivalente. --verbose altera os detalhes do relatório; não opta por uma auditoria por si só.

Se o escopo da auditoria for ambíguo, pergunte pelo harness e pela raiz de instalação antes de ler qualquer coisa. Mantenha cada auditoria limitada e somente leitura:

1. Inspecione apenas o plugin nomeado/raiz de instalação e os arquivos de configuração conhecidos do harness nomeado.
2. Nunca enumere recursivamente a raiz do workspace, o diretório home, o cache do provedor, as transcrições, os logs de depuração ou os worktrees não relacionados.
3. Nunca inicie uma CLI do provedor, servidor MCP ou sessão de depuração para contar ferramentas.
4. Limite a saída do inventário a 50 entradas por classe de componente. Resuma o restante.
5. Não escreva logs temporários nem copie o conteúdo da configuração para o relatório.

Audite apenas os metadados do componente relevantes para a descoberta antecipada:

• descrições de agente e habilidade;
• descrições de comando quando o harness as descobre antecipadamente;
• arquivos de instrução sempre carregados no escopo explicitamente nomeado;
• esquemas de ferramentas MCP configurados quando um manifesto limitado existente os expõe.

Corpos completos de habilidades, agentes, comandos e regras são geralmente conteúdo sob demanda. Relate o tamanho do disco separadamente do overhead de descoberta antecipada estimado, em vez de adicionar cada corpo à linha de base da sessão.

Saída da Auditoria

Retorne um relatório compacto contendo:

• harness e caminhos exatos inspecionados;
• overhead estimado de descoberta/antecipado por classe de componente;
• contagens instaladas e as entradas de metadados mais pesadas;
• suposições, medições indisponíveis e até três otimizações.

Todo número de token calculado é uma estimativa do overhead de configuração estática, não do contexto da sessão ao vivo. Não afirme que uma estimativa é relatada pelo provedor, atual, exata ou evidência de economia realizada. Direcione o usuário de volta ao comando nativo de contexto ao vivo para uso atual.

Diagnóstico Opcional de Registro Selecionado

Inspecione um registro persistido apenas quando o usuário selecionar explicitamente esse arquivo para este diagnóstico. Isso é separado da solicitação de contexto ao vivo padrão e da auditoria de instalação.

Para um diagnóstico de arquivo local, selecione explicitamente um arquivo JSONL estável e regular ou um snapshot que você pretende inspecionar. Substitua o caminho de exemplo abaixo; isso não encontra nem reconecta uma sessão. O trecho imprime apenas contagens de bytes agregadas. Ele lê uma linha por vez, portanto, o uso de memória depende do maior registro; evite registros muito grandes e arquivos em crescimento ativo.

python3 - "/path/to/selected-session.jsonl" <<'EOF'
import json
import sys

total = attachment = other = unclassified = 0
try:
    with open(sys.argv[1], "rb") as source:
        for raw in source:
            size = len(raw)
            total += size
            try:
                record = json.loads(raw.decode("utf-8"))
            except (UnicodeDecodeError, json.JSONDecodeError):

…