Harness do agente: o que é e do que é feito

Definição

O harness do agente (agent harness) é a camada de software que envolve o modelo de linguagem: tudo o que não é o modelo em si, mas influencia a forma como o agente trabalha. A fórmula é Agente = Modelo + Harness. O modelo sabe raciocinar e escrever código; o harness decide o que ele enxerga, com quais ferramentas age, onde os comandos são executados, o que é guardado entre sessões e como o agente descobre que errou.

Os cinco componentes do harness

• Instruções——o prompt de sistema e arquivos do projeto como CLAUDE.md e AGENTS.md, documentos temáticos e skills.
• Ferramentas——execução de comandos no shell, edição de arquivos, navegador e serviços conectados via MCP.
• Ambiente——um sandbox ou contêiner onde o código roda sem risco para a produção.
• Estado——arquivos de plano e de progresso e o histórico do git: a memória que sobrevive ao fim da sessão.
• Feedback——testes, linters, checagem de tipos e hooks, que devolvem ao agente o sinal de erro.

O harness não é um único arquivo de prompt. Se o agente não tem acesso aos testes, ou se o ambiente não sobe, nenhum AGENTS.md, por maior que seja, resolve. A confiabilidade é determinada pela mais fraca das cinco partes.

Exemplo

O agente tenta corrigir o mesmo bug por três sessões seguidas e, a cada reinício, não lembra o que já testou. Parece um problema do modelo, mas o que está quebrado é o subsistema de estado. A solução é um arquivo PROGRESS.md no qual o agente registra, ao final de cada sessão, as hipóteses que não funcionaram e o próximo passo:

## Bug: cobrança duplicada em reenvio de requisição
Verificado e descartado:
- timeout do cliente HTTP — sem efeito
- race condition no handler do webhook — não reproduzido
Próximo passo: checar a chave de idempotência em payments/service.py

A nova sessão lê o arquivo e continua exatamente do ponto certo. O modelo não mudou; mudou o harness.

Conclusão

O harness do agente é o conjunto de instruções, ferramentas, ambiente, estado e feedback em torno do modelo. É ele que define se o mesmo agente trabalha de forma confiável ou quebra com frequência. Como montar cada parte é explicado na prática no curso de harness engineering.