Original em inglês: https://argusic.com/subject/learn-harness-engineering

learn-harness-engineering

Tutorial de engenharia de harness para iniciantes, do 0 ao 1

Executa com mocksfonte: GitHubpágina do projetoTypeScriptMITcommit 77e7a3e21469

TypeScript, licença MIT. O projeto se descreve como: agent, agentic, agentic ai, ai, ai agent, ai agents, dsh e dsh plugin.

learn-harness-engineering executa, com substitutos para os serviços de que depende. Em uma máquina limpa sem GPU, um agent da Argusic o instalou em 30 minutos e encontrou 2 erros, corrigindo todos sem ajuda, e a sessão inteira foi gravada.

Root npm install succeeded, VitePress docs dev server serves all pages with 200, all 15 project Electron apps build successfully, and project-01 starter Electron app launches and stays running in the container.

O que o agent conseguiu em uma máquina limpa, nas palavras dele. Como isto é medido

Medido pela Argusic em uma máquina nova, todas as vezes. Cada número tem link para as suas evidências. Pontuação Argusic 86 de 100 (a média das pontuações das execuções deste projeto).

Visão geral

veredito
Executa com mocks
Pontuação Argusic
86 / 100
custo da execução de verificação
US$ 0,08 (medido)
execuções registradas
2
último teste
estrelas
23.146
forks
2.647
issues abertas
21
observadores
112
tamanho
29 MB
criado em
último push

Dados do projeto de GitHub, com link no topo desta página, atualizado em . Dados de teste da Argusic (CC BY 4.0); cada número tem link para uma página de execução com o log completo, a gravação e os hashes sha256 deles.

O que foi medido

Da execução que decidiu este veredito. Cada linha é um valor registrado, não uma estimativa.

Tempo perdido em cada falha durante o teste de learn-harness-engineering, extraído da execução registrada
Cada barra é uma falha que o agent registrou, com o tempo que ela custou. Extraído desta execução, e de nenhum outro lugar.

O que deu errado, nas palavras do agent

As palavras do próprio agent, das piores para as menores, nunca reescritas como conselho.

  • VitePress static build (npm run docs:build) exhausts heap on 512MB machine with 15 locales; OOM on node v18.19.1 even with --max-old-space-size=4008 minutos
  • Electron startup errors: dbus connection failures, GPU process exit — expected in headless container3 minutos
Tempo de instalação
30 minutos
Da máquina limpa até o fim
15 minutos
Erros encontrados e corrigidos
2 encontrados, 2 corrigidos sem ajuda humana
Como o resultado foi comprovado
curl http://localhost:5174/learn-harness-engineering/en/ returned 200; curl http://localhost:5174/learn-harness-engineering/en/lectures/lecture-01-why-capable-agents-still-fail/ returned 200; npx electron . --no-sandbox --disable-gpu ran for 10s timeout then exited 124 (killed, not crash); npm run build exited 0 in all 15 project directories
Tokens de modelo usados
603.618
Commit exato testado
77e7a3e21469
Imagem do container
sha256:cdd920bce783

O que não foi medido

A outra metade, para você ver exatamente até onde estas evidências vão. Uma lacuna é mostrada como lacuna e nunca é preenchida.

Pico de memória da GPU
esta execução foi em uma máquina com CPU, então não havia GPU para medir
Comportamento em uma execução longa
cada tentativa usa as menores configurações documentadas e um orçamento de tempo fixo, então isto mede se ele executa, não como ele se comporta sob carga
Comportamento com serviços reais
esta execução foi verificada apenas com serviços substitutos

Assista à sessão

A execução inteira, a partir de uma máquina limpa, na velocidade em que realmente aconteceu. Nada é cortado e nada é acelerado.

Uma gravação da tentativa 1, executada em , a tentativa que decidiu o veredito acima. A gravação do terminal da qual ele foi feito é a evidência, guardada com uma impressão digital sha256; o vídeo é uma renderização dela. Nada é carregado do serviço de vídeo até você apertar o play.

O fim da gravação

As últimas linhas da sessão de terminal que decidiu este veredito, exatamente como foram gravadas.

**Minutes elapsed:** ~30 minutes
**Install summary:**
- Root `npm install` succeeded (272 packages)
- All 15 project directories installed and built successfully (project-01 through project-06, each …
**Errors encountered:**
1. **VitePress static build OOM** — `npm run docs:build` exhausts heap on 512MB machine even with `…
2. **Electron sandbox / dbus / GPU errors** — Expected in a container environment. `--no-sandbox --…
3. **Type-check errors in project-01 starter/solution** — Pre-existing issues in the course code (u…
**Verification:**
- VitePress dev server: `curl http://localhost:5174/learn-harness-engineering/en/` returns 200; lec…
- Project-01 starter: `npm run build` succeeds, `npx electron . --no-sandbox --disable-gpu` stays u…
- Project builds across all 15 project directories succeed with no errors

Reproduzir a sessão inteira, cada comando desde a máquina limpa até este ponto.

Como foi testado

Um agent, um container, nenhuma ajuda humana. Ele instala o projeto do jeito que a própria documentação do projeto manda, executa o projeto e corrige o que quebra. Tudo abaixo é registrado como aconteceu: a sessão de terminal, o log e o commit exato. A metodologia completa.

Pontos fortes e limites

Fatos medidos, não opiniões. Como este conteúdo é escrito.

O que deu certo

  • Recuperou-se de todos os 2 erros sem que uma pessoa interviesse, o que indica que as falhas estão documentadas o suficiente para serem resolvidas.
  • Licença MIT, segundo a plataforma onde o projeto está hospedado.
  • Medido 2 vezes, então o resultado não é um caso isolado.

O que não deu certo, ou não se sabe

  • Só chegou a um estado de execução com serviços substitutos, então nada aqui prova que ele funciona com os serviços reais.
  • Levou 30 minutos para instalar, mais devagar que a mediana dos 134 projetos comparáveis que a Argusic mediu.

Dos 135 projetos de agent que a Argusic instalou e cronometrou, learn-harness-engineering foi o 122º mais rápido a chegar a um estado de execução, e 87 de 135 chegaram a esse estado.

Também testados, na mesma área

Cada um destes foi instalado e executado pela Argusic em uma máquina limpa. Nada aparece aqui sem ter sido testado.

Histórico de execuções

testado portentativaresultadopontuaçãocusto USDquando
Argusic Runner2/3Não verificado80,000,16
Argusic Runner1/3Executa com mocks92,000,08

Tópicos (de GitHub)

agentagenticagentic-aiaiai-agentai-agentsdshdsh-pluginharnessharness-engineeringharness-frameworkllm

Incorporar o selo

Markdown para o README do projeto. Ele tem link de volta para esta página; os termos estão na página de termos.

[![Tested by Argusic](https://argusic.com/badge/learn-harness-engineering.svg)](https://argusic.com/subject/learn-harness-engineering)

Perguntas

learn-harness-engineering executa?
learn-harness-engineering executa, com mocks no lugar de serviços externos. A Argusic o instalou e iniciou em uma máquina limpa em 30 minutos, encontrando 2 erros no caminho, e gravou a sessão.
Como a Argusic testou learn-harness-engineering?
Em uma máquina nova e descartável, com cada comando gravado e o repositório fixado no commit 77e7a3e21469. Há 2 tentativas registradas, e a metodologia completa está na página da metodologia.
Quanto custou testar learn-harness-engineering?
A execução que produziu este veredito custou US$ 0,08: custo real de computação e de modelo, não um preço de tabela por milhão de tokens. Esse valor está registrado na página da execução.
Quanto tempo leva para instalar learn-harness-engineering?
30 minutos na execução que decidiu este veredito, de uma máquina limpa até um estado de execução. É uma tentativa medida, não uma média.
learn-harness-engineering precisa de GPU?
Não para iniciar. A Argusic chegou a um estado de execução em uma máquina sem GPU.
O que dá errado ao instalar learn-harness-engineering?
2 coisas quebraram na execução registrada, e 2 foram corrigidas sem ajuda humana. Cada uma, com o tempo que custou, está listada nesta página.
Como learn-harness-engineering se compara às alternativas?
Dos 135 projetos de agent que a Argusic instalou e cronometrou, learn-harness-engineering foi o 122º mais rápido a chegar a um estado de execução, e 87 de 135 chegaram a esse estado.
Onde estão as evidências de learn-harness-engineering?
Todas as 2 execuções registradas estão nesta página, cada uma com link para o seu log completo e a sua gravação do terminal, guardados com uma impressão digital sha256 para que não possam ser alterados discretamente.

Discussion