The latest articles on DEV Community by José Roberto dos Santos (@jroberto1). https://dev.to/jroberto1 https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F3957120%2F39bcfe40-757b-414f-a4e8-076c0ccf8db1.jpeg https://dev.to/jroberto1 en José Roberto dos Santos Thu, 28 May 2026 17:57:20 +0000 https://dev.to/jroberto1/harness-engineering-como-fazer-agentes-de-ia-funcionarem-em-producao-4gn2 https://dev.to/jroberto1/harness-engineering-como-fazer-agentes-de-ia-funcionarem-em-producao-4gn2 <p>Você já teve uma sessão perfeita com um agente de IA — ele entendeu<br> tudo, fez exatamente o que você pediu — e na sessão seguinte ele<br> esqueceu tudo e voltou a cometer os mesmos erros?</p> <p>Isso não é um problema do modelo. É um problema de harness.</p> <h2> Prompt Engineering vs Context Engineering vs Harness Engineering </h2> <p>A maioria das pessoas fica no <strong>prompt engineering</strong> — como formular<br> a pergunta certa. Alguns chegam ao <strong>context engineering</strong> — como<br> estruturar o contexto para consistência.</p> <p>Mas existe uma terceira camada:<br> Prompt Engineering → você funciona<br> Context Engineering → você é consistente<br> Harness Engineering → você é confiável em produção</p> <p><strong>Harness Engineering</strong> é o conjunto de arquivos, regras e automações<br> que envolvem o agente e definem como ele deve se comportar — não só<br> o que fazer, mas o que nunca fazer, como verificar o próprio trabalho,<br> e como aprender com erros.</p> <h2> O experimento que mudou minha perspectiva </h2> <p>A Anthropic publicou um resultado interessante: o mesmo modelo (Claude),<br> a mesma tarefa, duas condições:</p> <ul> <li> <strong>Sem harness</strong>: $9, 20 minutos, não funcionou</li> <li> <strong>Com harness</strong>: $200, 6 horas, entregou um jogo jogável</li> </ul> <p>Não é o modelo que faz a diferença. É o ambiente em que ele opera.</p> <h2> O que um harness resolve na prática </h2> <p>Sem harness, um agente tende a:</p> <ul> <li>Pular etapas de verificação</li> <li>Inventar respostas quando não sabe</li> <li>Quebrar o que funcionava ao tentar melhorar</li> <li>Esquecer o contexto entre sessões</li> <li>Fazer o que foi pedido, não o que era necessário</li> </ul> <p>Com harness, você define:</p> <ul> <li> <strong>Regras absolutas</strong> — o que o agente nunca faz</li> <li> <strong>Protocolo PEV</strong> — Plan → Execute → Verify antes de qualquer tarefa</li> <li> <strong>Memória de sessão</strong> — o agente retoma de onde parou</li> <li> <strong>Directives</strong> — SOPs carregados sob demanda para tarefas específicas</li> <li> <strong>Regra de Hashimoto</strong> — cada erro vira uma melhoria permanente</li> </ul> <h2> Bifrost — um harness para qualquer runtime </h2> <p>Construí o <strong>Bifrost</strong> como um framework de harness engineering<br> que funciona com Claude Code, Antigravity, OpenCode e Cursor.</p> <p>Instalação em 1 minuto:<br> </p> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code>npx harness-engineering </code></pre> </div> <p>O que você recebe:</p> <ul> <li> <code>AGENTS.md</code> — regras canônicas do agente</li> <li>10 directives reais (session-memory, diagnose, testing, deployment...)</li> <li>8 skills reais (brainstorming, debugging-strategies, security-auditor...)</li> <li>Scripts de automação (sync, build, health-check)</li> <li>CI com 9 checks automáticos</li> </ul> <p>Para projetos existentes com detecção automática de stack:<br> </p> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code>npx harness-engineering adopt </code></pre> </div> <p>Ele detecta Next.js, React, Python, Go, Rust, Prisma, Stripe e<br> pré-configura o harness para a sua stack.</p> <h2> A estrutura em 3 camadas </h2> <p>directives/ ← Camada 1: SOPs — o QUE fazer<br> agente (você) ← Camada 2: roteamento e decisão<br> execution/ ← Camada 3: scripts determinísticos</p> <p>O agente é probabilístico. Scripts são confiáveis.<br> O harness define quando usar cada um.</p> <h2> A Regra de Hashimoto </h2> <p>A parte mais poderosa do harness não é o que já está lá —<br> é o que você adiciona depois de cada erro.</p> <p>Quando o agente erra, você classifica o tipo:</p> <ul> <li> <strong>A</strong> — trigger faltando (a directive existia mas não foi carregada)</li> <li> <strong>B</strong> — directive incompleta (SOP não cobriu o edge case)</li> <li> <strong>C</strong> — context overflow (janela cheia)</li> <li> <strong>D</strong> — hallucination (inventou sem verificar)</li> <li> <strong>E</strong> — permission violation (agiu sem autorização)</li> </ul> <p>Cada tipo tem um arquivo diferente para corrigir.<br> Com o tempo, o harness fica cada vez mais difícil de quebrar.</p> <h2> Começando </h2> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code><span class="c"># Projeto novo</span> npx harness-engineering <span class="c"># Projeto existente</span> npx harness-engineering adopt <span class="c"># Diagnóstico do ambiente</span> npx harness-engineering doctor <span class="c"># Verificar integridade</span> npx harness-engineering check </code></pre> </div> <p>Repositório: <a href="https://github.com/JRoberto1/Bifrost_Harness-Engineering" rel="noopener noreferrer">https://github.com/JRoberto1/Bifrost_Harness-Engineering</a></p> <p>Se o conceito fizer sentido para você, ⭐ no repo ajuda outros<br> desenvolvedores a descobrir.</p> ai claudecode productivity webdev