Token Budget Advisor (TBA)
Intercepta o fluxo de resposta para oferecer ao usuário uma escolha sobre a profundidade da resposta antes de Claude responder.
Quando Usar
- O usuário deseja controlar o tamanho ou detalhamento de uma resposta
- O usuário menciona tokens, orçamento, profundidade ou tamanho da resposta
- O usuário diz "versão curta", "resumo", "breve", "25%", "exaustivo", etc.
- Sempre que o usuário quiser escolher o nível de profundidade/detalhe de antemão
Não acionar quando: o usuário já definiu um nível nesta sessão (mantenha-o silenciosamente) ou a resposta é trivialmente de uma linha.
Como Funciona
Passo 1 — Estimar tokens de entrada
Use as heurísticas canônicas de orçamento de contexto do repositório para estimar mentalmente a contagem de tokens do prompt.
Use a mesma orientação de calibração do context-budget:
- prosa:
palavras × 1.3 - código pesado ou misto/blocos de código:
caracteres / 4
Para conteúdo misto, use o tipo de conteúdo dominante e mantenha a heurística de estimativa.
Passo 2 — Estimar tamanho da resposta por complexidade
Classifique o prompt e aplique a faixa de multiplicadores para obter a janela completa de resposta:
| Complexidade | Faixa de multiplicadores | Exemplos de prompts |
|---|---|---|
| Simples | 3× – 8× | "O que é X?", sim/não, fato único |
| Médio | 8× – 20× | "Como funciona X?" |
| Médio-Alto | 10× – 25× | Solicitação de código com contexto |
| Complexo | 15× – 40× | Análise de múltiplas partes, comparações, arquitetura |
| Criativo | 10× – 30× | Histórias, ensaios, escrita narrativa |
Janela de resposta = tokens_de_entrada × mult_mín a tokens_de_entrada × mult_máx (mas não exceda o limite de tokens de saída configurado do seu modelo).
Passo 3 — Apresentar opções de profundidade
Apresente este bloco antes de responder, usando os números estimados reais:
Analisando seu prompt...
Entrada: ~[N] tokens | Tipo: [tipo] | Complexidade: [nível] | Idioma: [idioma]
Escolha seu nível de profundidade:
[1] Essencial (25%) -> ~[tokens] Resposta direta, sem preâmbulo
[2] Moderado (50%) -> ~[tokens] Resposta + contexto + 1 exemplo
[3] Detalhado (75%) -> ~[tokens] Resposta completa com alternativas
[4] Exaustivo (100%) -> ~[tokens] Tudo, sem limites
Qual nível? (1-4 ou diga "25% depth", "50% depth", "75% depth", "100% depth")
Precisão: estimativa heurística ~85-90% de precisão (±15%).
Estimativas de tokens por nível (dentro da janela de resposta):
- 25% →
mín + (máx - mín) × 0.25 - 50% →
mín + (máx - mín) × 0.50 - 75% →
mín + (máx - mín) × 0.75 - 100% →
máx
Passo 4 — Responder no nível escolhido
| Nível | Tamanho alvo | Incluir | Omitir |
|---|---|---|---|
| 25% Essencial | Máx. 2-4 frases | Resposta direta, conclusão principal | Contexto, exemplos, nuances, alternativas |
| 50% Moderado | 1-3 parágrafos | Resposta + contexto necessário + 1 exemplo | Análise profunda, casos extremos, referências |
| 75% Detalhado | Resposta estruturada | Vários exemplos, prós/contras, alternativas | Casos extremos, referências exaustivas |
| 100% Exaustivo | Sem restrição | Tudo — análise completa, todo o código, todas as perspectivas | Nada |
Atalhos — pular a pergunta
Se o usuário já sinalizar um nível, responda nesse nível imediatamente, sem perguntar:
| O que eles dizem | Nível |
|---|---|
| "1" / "25% depth" / "short version" / "brief answer" / "tldr" | 25% |
| "2" / "50% depth" / "moderate depth" / "balanced answer" | 50% |
| "3" / "75% depth" / "detailed answer" / "thorough answer" | 75% |
| "4" / "100% depth" / "exhaustive answer" / "full deep dive" | 100% |
Se o usuário definiu um nível anteriormente na sessão, mantenha-o silenciosamente para respostas subsequentes, a menos que ele o altere.
Nota de precisão
Esta habilidade usa estimativa heurística — nenhum tokenizador real. Precisão ~85-90%, variação ±15%. Sempre exiba o aviso.
Exemplos
Acionamentos
- "Dê-me a versão curta primeiro."
- "Quantos tokens sua resposta usará?"
- "Responda com 50% de profundidade."
- "Quero a resposta exaustiva, não o resumo."
- "Dame la version corta y luego la detallada."
Não Aciona
- "O que é um token JWT?"
- "O fluxo de checkout usa um token de pagamento."
- "Isso é normal?"
- "Complete a refatoração."
- Perguntas de acompanhamento depois que o usuário já escolheu um nível para a sessão
Fonte
Habilidade independente de TBA — Token Budget Advisor for Claude Code. O projeto original também inclui um script estimador em Python, mas este repositório mantém a habilidade autocontida e baseada apenas em heurísticas.