MÓDULO 2.3

🎛️ Níveis de Effort

low, medium, high, xhigh, max — o quadro periódico da calibração. Onde cada um brilha e onde atrapalha.

7
Tópicos
45
Minutos
Inter.
Nível
Calibr.
Tipo
QUADRO PERIÓDICO DOS 5 EFFORTS Lolowrápido Memediumrotina Hihighparalelo Xh ⭐xhighDEFAULT Mxmaxdifíceis
1

📉 low — rápido e barato

Modelo para cedo. Bom para lookups, diffs triviais, formatação. 4.7 respeita low mais estritamente que 4.6 — pode parar antes de concluir tarefa que exigia mais.

✓ Use em

  • • Rename em 1 arquivo
  • • Lookup de config
  • • Format de JSON
  • • "O que é X?" rápido

✗ Evite em

  • • Debug de bug não-óbvio
  • • Design de API
  • • Refactor > 2 arquivos
  • • Escolha de biblioteca
2

⚖️ medium — rotina sensível a custo

Tarefas com menos de 3 decisões, volume alto, pipeline automatizado.

Quando brilha

  • Scripts de triagem e classificação
  • Sumarização de PRs em lote
  • Etapa de "aplicação" no padrão desenho→aplicação
  • Code review de mudanças mecânicas
3

📊 high — concorrência e economia

Features de média complexidade em fan-out, quando muitas tarefas rodam em paralelo. Degrade gradual comparado a xhigh.

💡 Dica

Quando rodar 10+ subagentes em paralelo, use high em vez de xhigh. Qualidade quase igual, custo total bem menor.

4

⭐ xhigh — o default, 80% dos casos

Novo default do 4.7. Autonomia forte, consumo previsível. Não precisa configurar — já vem ligado se nunca setou effort.

Compare comxhigh
highMais raciocínio, +15–20% qualidade em ambiguidade
maxCusto 2–3x maior, ganho marginal em maioria dos casos
4.6 highxhigh do 4.7 ≈ max do 4.6 em complexidade, com menos tokens
5

🚀 max — problemas difíceis

Use pontualmente. Em tarefas simples, gera overthinking e custo inflado.

✓ Quando vale

  • • Debug de bug heisenberg
  • • Arquitetura em aberto
  • • Research de alternativas
  • • Spec ambígua com stakes altos

✗ Quando atrapalha

  • • Bug fix óbvio
  • • CRUD rotineiro
  • • Format/style
  • • Queries de lookup
6

🔍 4.7 respeita effort mais estritamente no low-end

Mudança silenciosa que confunde usuários do 4.6. Em low, o 4.7 pode parar onde o 4.6 continuaria.

⚠️ Armadilha

Você roda uma tarefa em low que no 4.6 funcionava e recebe output raso. Não é regressão — é o 4.7 respeitando o comando.

Solução: suba para medium ou xhigh.

7

🗺️ Matriz pessoal de decisão

Preencha com os seus próprios casos. Revise a cada 30 dias.

Tipo de tarefaEffortNota
Bug fix óbviolow/mediumSuba se parou cedo
Feature médiaxhighDefault
Refactor multi-arqxhighmax se arquitetura muda
Code review PRxhighmedium se mecânico
Debug difícilmaxApós 2 tentativas em xhigh
Script batchmediumEconomia real

📋 Resumo

xhigh é o default — 80% dos casos
low estrito no 4.7 — pode parar cedo
max pontualmente — não como default
Matriz pessoal — revisite em 30 dias

Próximo Módulo:

2.4 — Alternando Effort + Output Tokens