Harness engineering: como construir um agente de IA confiável
Artigos: 8
Harness engineering (engenharia de harness) é a disciplina que cuida de montar, em volta de um modelo de linguagem, um ambiente em que um agente de IA realiza trabalho real de forma confiável. A fórmula é Agente = Modelo + Harness. O mesmo modelo pode atuar como um desenvolvedor experiente em um projeto e, em outro, perder o contexto e declarar «pronta» uma funcionalidade que não funciona. Na maioria das vezes, a diferença está no harness, e não no modelo.
Este guia é um mapa do tema. Ele reúne os conceitos principais e a ordem sugerida para estudá-los. Cada tema é detalhado em um artigo próprio.
Os cinco subsistemas do harness
- Instruções——os arquivos CLAUDE.md e AGENTS.md, documentos temáticos e skills: o que o agente sabe sobre o projeto.
- Ferramentas——shell, edição de arquivos, navegador, servidores MCP: como o agente age.
- Ambiente——sandbox, contêiner, cópia de trabalho isolada: onde o agente executa comandos.
- Estado——arquivos de plano e de progresso, histórico do git: a memória entre sessões.
- Feedback——testes, linters, hooks, verificadores independentes: como o agente percebe os próprios erros.
Esses subsistemas formam um circuito fechado. Se você remover qualquer um, o circuito se rompe: sem verificações o agente não vê erros; sem estado, cada sessão começa do zero.
Por onde começar
Se o tema é novo para você, comece pelo artigo que explica o que é harness engineering e em que ele se diferencia da engenharia de prompt e de contexto. Uma definição curta e um exemplo do harness do agente estão no artigo sobre o conceito de harness.
Depois, passe para a prática. O primeiro arquivo com que todo mundo se depara é o de instruções do projeto: o que escrever no CLAUDE.md e no AGENTS.md, o que deixar de fora e por que o agente ignora uma regra escrita explicitamente no arquivo.
Quando o agente já trabalha no projeto, surge a questão da confiabilidade. O plano em etapas parte do diário de falhas e das métricas MTBF e MTTR, passa por reversão barata, laços de feedback e memória em arquivos, e chega a um ciclo autônomo em que o agente trabalha por horas sem supervisão.
Princípios centrais
- O agente não está quebrado: quebrado está o ambiente. Procure a falha no harness antes de trocar de modelo.
- Comece pelo feedback: um comando de verificação vale mais do que uma página de instruções.
- Instruções são mapa, não livro-texto: um arquivo de entrada curto e os detalhes sob demanda.
- O que importa vive em arquivos, não na janela de contexto.
- Meça: diário de falhas no lugar de achismos.
Todos os subsistemas e a montagem completa do harness são explicados na prática no curso de harness engineering.