<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.

Validadores
o que confere a saída
Fontes
o que ela lê antes de escrever
Claude Code
o modelo e o que o configura
pedido
o prompt do operador
CLAUDE.md
como se trabalha aqui
specs/
arc42 · C4 · BDD · ADR
changes/
PRD · design · specs · tasks
src/ existente
o código que já está lá
Biome
lint e formatação
check
tipos e contratos
bun test
os *.test.js do tester
husky + lint-staged
o pre-commit
commitlint
a mensagem do commit
CI
os workflows do GitHub
Claude Code
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
Recursos do Claude Code · em .claude/
agents
11 ofícios, cada um na sua janela
skills
52 procedimentos
rules
47 defeitos proibidos
hooks
khaby-lame.sh, antes do Write
commands
/craft /ship /audit /sync /extend
MCPs
ferramentas externas
src/[contexto]/[container]/[componente]/
o código — onde a saída vira arquivo, com o teste ao lado
lê
veredito
escreve
configuram
confere

Fontes

o que ela lê antes de escrever

pedidoCLAUDE.mdspecs/changes/src/ existente
↓ lê

Claude Code

o modelo — prevê o próximo token a partir da janela

Recursos · .claude/

configuram o modelo

agents · 11skills · 52rules · 47hookscommands · 5MCPs
↓ escreve

src/[contexto]/[container]/[componente]/

onde a saída vira arquivo, com o teste ao lado

↓ confere

Validadores

o veredito volta para o modelo

Biomecheckbun testhusky + lint-stagedcommitlintCI

+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.

hook
no instante certo
/craft
roteia o pedido
agent
decide e faz
skills
ensinam o como
rules/
valem em tudo
47 defeitos nomeados
CamadaRespondeQuantidade
rules/O que é proibido47 defeitos nomeados
skills/Como se faz52 procedimentos e catálogos
agents/Quem faz, com que julgamento11 ofícios
commands/Em que ordem5 — e só um é a entrada
hooks/O que roda sozinho1, 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

4

architect

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

7

developer

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

Por que isolar
Cada ofício roda na sua própria janela e devolve só a entrega. É o mesmo princípio que a Anthropic descreve: subagentes com contexto limpo, retornando um resumo destilado.

// 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.

Pedido
linguagem natural
/craft
classifica
Rota
16 possíveis
Ofícios
na ordem da rota
Você escreveRotaQuem entra
“Por que o cupom não aplica?”Investigarinvestigator → developer → tester
“Preciso de uma lista de desejos”Criararchitect → designer → developer → tester
“Vale trocar a lib de datas?”Decidirarchitect → ADR
“Fecha isso pra MR”Entregarchecks → reviewer → releaser → commit
O hook

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.

Guardrails

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.

Workflow · rota Criar
A escada antes de qualquer arquivo. Pare no primeiro degrau que resolver.
Feature, tela ou pacote novo
Precisa existir agora?
Para aqui
necessidade especulativa fica para depois
Já existe no workspace?
Reaproveita
o que existe vem antes de escrever
Cabe numa fatia existente?
Implementa na fatia
contexto, container e componente certos
O catálogo resolve?
Usa a dependência
dependência nova é decisão do architect, com ADR
Cabe em menos?
Reduz o escopo
um componente que faz uma coisa
Nasce o componente
pasta, index.ts, checks verdes com o pacote vazio
designer → developer → tester
A mesma escada, em dois lugares
No /craft ela é o planejamento. No hook khaby-lame.sh ela é a rede, para quem começou a escrever sem passar pela rota.
não
sim
sim
não
sim
não
sim
não
sim
não

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á.

Ver specs/