Notas de leitura · O Fim da Engenharia de Harness (2026) Engenharia de Harness · Engenharia de Loop

O Fim da Engenharia de Harness

o loop escreve o harness, o humano escreve a prova

Resumo. Harness é o programa escrito ao redor de um modelo: ferramentas, instruções, fluxos e lógica de execução. Escrevê-lo à mão sempre foi a habilidade central de quem constrói agentes. O artigo argumenta que isso está acabando. Um harness escrito à mão é um palpite sobre uma tarefa, feito numa tarde; depois de publicado, ele roda por meses sem que ninguém leia ou dê nota. No loop que o artigo descreve, o harness é um arquivo que se avalia: um modelo pequeno de 4B lê o que falhou e propõe 8 edições, e só sobrevive a edição que tira a maior nota em perguntas held-out. Isso se repete a cada rodada. O modelo grande fica congelado; só o arquivo ao redor dele muda. O trabalho humano encolhe para um único artefato, o conjunto de avaliação, então frameworks viram descartáveis e a prova vira o trabalho.

Termos-chave: engenharia de harness, harness auto-aprimorável, avaliação held-out, modelo congelado, modelo editor pequeno, engenharia de loop


pessoa uma tarde harness v0 um palpite ✳ modelo grande congelado, nunca muda saídas por meses roda por meses ninguém lê nota sem nota nunca avaliado
(a) harness escrito à mão
vira a próxima versão próxima rodada falhaso que deu errado editor 4Blê as falhas 8 edições candidatas perguntasheld-out melhor edição mantida1 de 8 sobrevive 1 rodada nota held-out de cada edição roda a tarefasaídas ✳ modelo grande congeladoex.: Claude, nunca retreinado arquivo de harnessagora v0
(b) harness escrito pelo loop
 
1/8
Fig. 1. Duas formas de escrever um harness. (a) Uma pessoa escreve um arquivo para uma tarefa e publica; o modelo congelado roda por meses e nada nunca recebe nota. (b) A cada rodada um editor de 4B lê as falhas e propõe 8 edições; cada edição é avaliada em perguntas held-out e só a melhor vira o próximo arquivo de harness. O modelo grande é o mesmo modelo congelado nos dois casos. A animação mostra a execução real do laboratório (§5).

1Introdução

Engenharia de harness significou, até hoje, escrever à mão o programa ao redor do modelo. Uma pessoa estuda uma tarefa, escreve um arquivo e publica.1 Depois disso ninguém lê o arquivo e ninguém dá nota a ele, então um palpite errado continua rodando por meses. A resposta do artigo é parar de escrever esse arquivo à mão e deixar um loop escrevê-lo, sem tocar no modelo.

2O Loop

Cada rodada começa pelo que falhou. Um modelo pequeno de 4B2 lê as falhas e propõe 8 edições ao arquivo de harness. Cada edição é avaliada em perguntas held-out;3 a melhor é mantida como próxima versão e as outras sete são descartadas (Algoritmo 1). O modelo grande nunca é retreinado: fica congelado enquanto o arquivo ao redor dele muda.

Algoritmo 1  Uma rodada do loop
  1. Entrada: harness h_n, modelo congelado M, conjunto de avaliação Q
  2. 1F := falhas de M rodando h_n
  3. 2E := 8 edições propostas pelo editor 4B a partir de F
  4. 3para cada e em E: s(e) := nota de M em Q com h_n + e
  5. 4h_n+1 := h_n + o e com o maior s(e)
  6. 5n := n + 1, repita
Fig. 2. Nota held-out por rodada. A cada rodada o editor propõe 8 edições: as 7 rejeitadas ficam em cinza, a mantida em preto. O harness só muda quando uma edição vence, então a linha sobe a partir da base escrita à mão, uma edição por vez.
Fig. 4. Quem trabalha em cada rodada. O humano escreve o conjunto de avaliação uma vez, antes do loop começar; em toda rodada o editor 4B propõe edições e o modelo congelado roda para avaliá-las e para fazer a tarefa.
Tabela 1Quem escreve o quê no loop
ParteEscreveCom que frequência
Humanoo conjunto de avaliaçãouma vez, antes do loop
Loop: modelo 4Bedições do harness8 por rodada
✳ Modelo grandenada, congeladoroda em toda rodada

3O que muda

Três partes tocam o sistema e só uma delas é uma pessoa (Tabela 1). O humano escreve o conjunto de avaliação: as perguntas em que o harness recebe nota. O modelo 4B escreve toda edição do arquivo de harness. O modelo grande não escreve nada; é o mesmo modelo congelado em toda rodada, e só o arquivo ao redor dele muda (Tabela 2).

Tabela 2Harness escrito à mão vs. escrito pelo loop
à mãopelo loop
escrito poruma pessoaum modelo de 4B
frequênciauma vez, numa tardetoda rodada
candidatosum palpite8 edições por rodada
avaliado emnadaperguntas held-out
após publicarroda por meses, sem leiturafalhas lidas a cada rodada
modelo grandecongeladocongelado
arquivo de harness
↑ dá nota
conjunto de avaliação
escrito uma vez, por um humano, mantido em toda rodada
Fig. 3. O arquivo de harness é reescrito a cada rodada e o antigo vai fora; o conjunto de avaliação é o único artefato que fica.

4Conclusão

Quando um loop escreve o harness, frameworks viram descartáveis e a prova vira o trabalho. A ordem do trabalho se inverte: primeiro as perguntas em que o harness vai receber nota, depois o código. A vantagem competitiva deixa de ser quão bem escrevemos código para agentes e passa a ser quão bem medimos se eles realmente melhoraram.

Lição
escreva a prova antes do código

5Laboratório: escreva a prova

Aqui o loop roda de verdade, no seu navegador. A tarefa: classificar manchetes de notícias do gov.br em quatro temas. O modelo grande congelado é um classificador fixo que nunca muda: ele conta quantas palavras de cada tema do harness aparecem na manchete e escolhe o tema com mais acertos (empate ou zero conta como erro). O arquivo de harness é a lista de palavras por tema. O editor lê as manchetes que falharam e propõe 8 edições (incluir ou remover uma palavra); cada edição é avaliada nas perguntas held-out e só a melhor fica.4

Seu trabalho é só a prova. Edite as manchetes rotuladas abaixo e rode o loop: metade vira o conjunto de onde saem as falhas, a outra metade é held-out e serve só para dar nota. Uma prova fraca produz um harness fraco, e o loop não tem como perceber.

Temas válidos são as chaves do harness v0 ao lado. Linhas em branco e iniciadas por # são ignoradas.

    As palavras são comparadas pelos 6 primeiros caracteres, sem acento: "vacina" cobre "vacinação" e "vacinas".

    
            
    1. Um palpite sobre uma tarefa, feito numa tarde.
    2. 4B: um modelo com cerca de quatro bilhões de parâmetros, pequeno perto do modelo congelado que ele edita.
    3. Perguntas held-out ficam fora da etapa de edição e são usadas só para dar nota.
    4. No laboratório o editor é uma heurística determinística que imita o papel do modelo de 4B: as 5 edições que mais explicam as falhas e mais 3 ao acaso. Empates na nota held-out são decididos pela nota no conjunto de tarefas, e uma edição só entra se melhorar uma das duas.