<omh-harness-claude />
Um harness transforma um modelo em um time.
O modelo é o motor. O harness é o que decide para onde ele vai: quem faz cada parte, com que regras, com que contexto — e o que nunca pode acontecer sem uma pessoa aprovar.
// Onde você está no harness
Esta página explica os recursos do Claude Code
agents, skills, rules, hooks, commands e MCPs: o que vive em .claude/ e configura o modelo.
o prompt do operador
como se trabalha aqui
arc42 · C4 · BDD · ADR
PRD · design · specs · tasks
o código que já está lá
lint e formatação
tipos e contratos
os *.test.js do tester
o pre-commit
a mensagem do commit
os workflows do GitHub
o modelo — prevê o próximo token a partir da janela
tudo em volta decide o que entra na janela e o que sai dela
11 ofícios, cada um na sua janela
52 procedimentos
47 defeitos proibidos
khaby-lame.sh, antes do Write
/craft /ship /audit /sync /extend
ferramentas externas
o código — onde a saída vira arquivo, com o teste ao lado
Fontes
o que ela lê antes de escrever
Claude Code
o modelo — prevê o próximo token a partir da janela
Recursos · .claude/
configuram o modelo
src/[contexto]/[container]/[componente]/
onde a saída vira arquivo, com o teste ao lado
Validadores
o veredito volta para o modelo
+90,2%
de desempenho de um sistema multiagente sobre o agente único, em pesquisa complexa.
Fonte: Anthropic Engineering, 2025
80%
da variação de desempenho explicada pelo uso de tokens — contexto bem gasto é o que decide.
Fonte: Anthropic Engineering, 2025
58%
das vezes o agente ignorou a ferramenta que tinha. O harness põe o caminho certo na frente dele.
Fonte: Paipuru, CodeCompass, 2026
Um agente × um time de agentes
Desempenho em pesquisa complexa, agente único = 100.
Agente único
100
Multiagente
190,2
Fonte: Anthropic Engineering, 2025
O custo do time
Consumo relativo de tokens, conversa = 1x. Por isso existe a rota Direto.
Conversa
1x
Agente
~4x
Multiagente
~15x
Fonte: Anthropic Engineering, 2025
// Quatro camadas
A regra exige, a habilidade executa, o ofício decide, o comando sequencia.
Cada camada tem uma responsabilidade. Quando uma faz o trabalho da outra, a mesma decisão aparece em dois lugares — e diverge até uma delas dar a resposta errada.
no instante certo
roteia o pedido
decide e faz
ensinam o como
valem em tudo
47 defeitos nomeados
| Camada | Responde | Quantidade |
|---|---|---|
| rules/ | O que é proibido | 47 defeitos nomeados |
| skills/ | Como se faz | 52 procedimentos e catálogos |
| agents/ | Quem faz, com que julgamento | 11 ofícios |
| commands/ | Em que ordem | 5 — e só um é a entrada |
| hooks/ | O que roda sozinho | 1, no instante certo |
// Onze ofícios
Separação de poderes, aplicada à IA
Quatro ofícios só leem — julgam e relatam. Sete escrevem, cada um no seu artefato. Nenhum conhece o outro: quem encadeia é a sessão, passando a entrega de um como escopo do seguinte.
Só leem · julgam e relatam
4architect
A forma antes de existir
investigator
Por que o código se comporta assim
reviewer
A qualidade dentro dos arquivos
surveyor
A organização entre os arquivos
Escrevem · cada um no seu artefato
7developer
O código em src/
tester
Os testes, ao lado do código
designer
O design system aplicado
writer
A prosa em specs/
builder
CI, lint e configs
releaser
O impacto e a nota de MR
curator
O próprio .claude/, a cada correção
// O operador não decora nada
Descreva o pedido. O roteamento escolhe quem entra.
O /craft classifica o pedido pela forma — pergunta, bug, feature, alteração, entrega — e aciona os ofícios na ordem certa. Pedido pequeno vai direto, sem cerimônia. Quem quiser dirigir pode: nomear um ofício vence a tabela.
linguagem natural
classifica
16 possíveis
na ordem da rota
| Você escreve | Rota | Quem entra |
|---|---|---|
| “Por que o cupom não aplica?” | Investigar | investigator → developer → tester |
| “Preciso de uma lista de desejos” | Criar | architect → designer → developer → tester |
| “Vale trocar a lib de datas?” | Decidir | architect → ADR |
| “Fecha isso pra MR” | Entregar | checks → reviewer → releaser → commit |
khaby-lame.sh: a pausa antes de complicar
No instante em que um pacote novo vai nascer, o hook entrega a escada já respondida: isso precisa existir? já existe? cabe no que há? Não bloqueia — economiza a rodada de ls e grep que o agente faria.
O que nunca acontece sozinho
git push sempre pede confirmação. Os quatro checks — lint, fronteira, tipos e teste — rodam antes de qualquer “está pronto”.
Fonte: Veracode 2025: 45% do código gerado falha em segurança
// A escada, desenhada
Rota Criar: cinco degraus antes de qualquer arquivo
É o planejamento do /craft e a rede do hook khaby-lame.sh. Pare no primeiro degrau que resolver — a resposta mais simples costuma estar ali.
O harness precisa de contexto
Ele é tão bom quanto o que lê. Veja como specs/ e changes/ dão ao agente o que nenhum prompt dá.