Pular para o conteúdo
LabS Atlas
Agentic AI
Entrar

Harness Engineering

Ir para notas que citam esta
atualizado há 25 diasEntre para perguntar ao Labinho sobre esta notaO Labinho é o assistente que responde com as notas e as sessões do LabS e mostra de onde tirou cada resposta.

Harness Engineering é tratar tudo o que cerca o modelo (contexto, ferramentas, planejamento, verificação, memória e sandbox) como o centro do desenvolvimento com IA.

A palavra inglesa harness quer dizer cabresto ou arreio: o que guia o cavalo sem ser o cavalo. O modelo de linguagem é probabilístico, e a mesma pergunta repetida pode gerar respostas diferentes. Como o modelo não é determinístico e não está sob controle de quem desenvolve, a engenharia atua no que está: o ambiente ao redor dele. O objetivo é deixar de depender só de um prompt melhor e impedir de fato que o agente saia do caminho.

A fórmula que resume a ideia é agente = modelo + harness. Sozinho, o modelo recebe texto e devolve texto, sem ler arquivos, pesquisar ou executar nada. É o harness que lhe dá braços. Na analogia do carro, o modelo é o motor e o harness é o resto do veículo: um motor forte parado não anda, e um harness bem construído em volta de um modelo mais fraco pode render mais do que simplesmente escolher o melhor modelo.

As seis frentes do harness

  • Contexto: prompts e arquivos estruturados que descrevem o projeto, como os Arquivos de Contexto de Agentes de Código (o que o projeto é, o que não é, stack, convenções). As specs do SDD entram aqui, como contexto melhorado.
  • Ferramentas: ler, criar e editar arquivos, pesquisar, integrar sistemas externos.
  • Planejamento: como o agente organiza o trabalho antes de agir, idealmente com uma especificação feita antes.
  • Verificação: o agente revisar o que escreveu e corrigir, ou ser barrado antes de agir, com hooks.
  • Memória: registro de aprendizados para usos futuros.
  • Sandbox: ambiente isolado, como um contêiner Docker, onde o agente testa sem risco.

Por cima disso, ferramentas agênticas compartilham convenções quase universais: skills, comandos de barra, subagentes, um arquivo de configuração próprio e plugins. Cada ferramenta nomeia suas pastas de um jeito, mas o conceito é o mesmo.

Sugestão versus barreira

Um arquivo markdown de diretrizes é uma sugestão: o agente pode ignorá-lo. Um hook é código executado, e o agente não consegue contorná-lo. Um experimento com dois projetos mostra a diferença. No projeto com harness, o pedido de editar diretamente uma migration de banco já aplicada foi bloqueado por um hook, e o agente propôs e gerou uma migration nova. No projeto sem esses hooks, o mesmo pedido foi obedecido: a migration existente foi alterada e a tabela de usuários foi apagada.

Por que o harness existe

Modelos são treinados para obedecer e agradar quem pede. O harness está ali justamente para barrar esse comportamento quando obedecer é o erro.

Harness e modelo na prática

No Claude Code, o modelo raciocina e a ferramenta é o harness: é ela que lê os arquivos do projeto, envia ao modelo, recebe a resposta e grava de volta. Não existe programar nele sem harness: o mínimo já vem embutido, e o trabalho de engenharia é acrescentar contexto, skills e hooks. Compare o mesmo modelo como chat e dentro de um harness: no chat, colar uma função e perguntar por que um IF falha só resolve se o defeito estiver no trecho colado. Dentro do harness, o agente navega pelo código, segue a implementação de um DTO até outra camada e encontra a causa real.

Há uma tendência de acoplamento entre modelo e harness da mesma empresa: modelos da Anthropic cada vez mais treinados para o Claude Code, modelos da OpenAI para o Codex. Isso tende a dificultar usar um harness com modelos de outros fornecedores.

Quando o investimento compensa

Se as specs são o mapa (o quê e por quê), o harness é o que garante que o agente siga esse mapa até a implementação. Ele compensa quando o projeto é construído com agentes e precisa escalar e gerar código pronto para produção. Entre as abordagens de programação com IA, é a mais madura e a única já vista como pronta para produção. Para uma tarefa única e rápida, não vale o custo: um harness bem feito exige preparar contexto, specs e verificações antes de escrever a primeira linha.