Pular para conteúdo

Réguas de modelo & effort

O que é

A política única que responde "qual modelo Claude e quanto esforço (effort) usar" em cada agente, skill, rotina e tarefa do monorepo. É a 4ª régua da casa, ao lado de priorize (ordem), estimate (tamanho) e criticidade (risco).

Os modelos (sem Fable)

Modelo Papel Onde
Opus 4.8 O padrão — juiz, coding pesado, decisão. pr-guardian, deep-search, attention-gate, tech-debt-scout; skills de julgamento (co-create, review, to-project…)
Sonnet 5 Degrau-abaixo consciente — feature típica/bugfix, escala. backlog-scout, test-writer, prod-guardian
Haiku 4.5 Varredor barato — lê→resume→reporta, alto volume, errar é barato. ci-scout, ux-scout, release-scout
~~Fable 5~~ Fora do uso (consome metade do limite, lento).

Como se decide (o quarteto de réguas)

  1. criticidade — o freio de mão: fluxo crítico nunca roda no Haiku (piso Sonnet + verificação).
  2. estimate — a base: XS/S → Haiku/Sonnet · M → Sonnet · L/XL → Opus.
  3. priorize — o ajuste: P0/P1 sobe um degrau.

Algoritmo: crítico + (L/XL ou P0/P1) → Opus/xhigh; crítico pequeno → Sonnet/high + verificação; não-crítico → estimate manda, P0/P1 sobe um degrau.

Auto-delegação — "deixa o Claude decidir"

Pra trabalho ad-hoc (humano codando à mão, sem agente nomeado), o CLAUDE.md raiz tem instrução sempre-ligada: comece pelo Opus e delegue pra baixo o trabalho menor num subagente — Haiku pro mecânico, Sonnet pra feature típica/bugfix, Opus pra arquitetura/decisão/revisão.

Diferença: agente nomeado = modelo fixo no frontmatter; tarefa ad-hoc = auto-delega.

Effort & adaptive thinking

Coding → xhigh · julgamento → high · rotina → medium · lookup → low. Adaptive thinking (o modelo escolhe o effort sozinho) existe em Opus/Sonnet; Haiku não tem — por isso os scouts Haiku ficam com effort à mão fixo. Preferência da casa: manter o esforço alto e trocar o modelo, em vez de micro-ajustar effort.

Rotinas & OpenCode

  • Rotinas (claude.ai): só aceitam model (ID completo). O model da rotina governa a condução; o agente invocado carrega o próprio tier.
  • OpenCode (.opencode/): modelo é provider/model-id; sem campo padrão de effort.

Como impacta o ciclo de desenvolvimento

O caro (Opus) fica no julgamento (gate, review, caça-bug) e no coding pesado; a construção pequena roda Sonnet; o monitoramento diário roda Haiku. pr-guardian (Opus/xhigh) é o teto de rigor; to-build (inherit) sobe pra Opus sozinho em L/XL e crítico via as réguas. Ninguém "acha" o modelo — as réguas que o board já preenche decidem.

Relacionado

comite-de-agentes · skills · engenharia-regenerativa · loop-engineering · visao-geral