Apoio escrito: projetar as condições de execução
O vídeo “Harness Engineering is much more than CLAUDE.MD” amplia a ideia de harness: um arquivo de instruções é apenas uma parte do sistema. O resultado de um agente depende também do contexto que recebe, das ferramentas que pode chamar, dos dados que preserva, dos limites aplicados e de como o trabalho é verificado.
Abrir diagrama em tamanho original
Pense em um agente que altera um projeto de software. As instruções descrevem convenções e objetivo. O contexto dá acesso aos arquivos e à solicitação atual. As ferramentas permitem ler, editar e executar comandos. As políticas determinam que operações podem ocorrer. As verificações, como compilação, revisão de diff e critérios de aceitação, ajudam a detectar resultados incorretos.
Um bom harness torna explícitos os limites entre esses componentes. Ele pode registrar chamadas, erros e saídas; limitar acesso a arquivos; interromper ações destrutivas; e retornar evidências para que o modelo decida o próximo passo. A observabilidade ajuda a responder “o que aconteceu?” sem depender de uma impressão final do agente.
Isso não torna o modelo infalível. Uma instrução ambígua continua ambígua; uma ferramenta sem validação pode executar uma ação ruim; e um teste fraco pode aprovar comportamento incorreto. Engenharia de harness reduz riscos e torna falhas mais detectáveis, sem substituir bons requisitos e revisão.
Antes de adotar uma ferramenta ou arquivo de configuração mostrado no vídeo, pergunte: qual problema ele resolve, qual permissão exige, que evidência produz e como outro sistema poderia resolver a mesma necessidade?
Pergunta de recuperação: cite um elemento do harness que controla o que o agente pode fazer e outro que ajuda a conferir o que ele fez.
Para aprofundar
- OpenAI: Harness engineering — documentação, verificações, restrições arquiteturais e ciclos de feedback em um ambiente agent-first.
- Anthropic: Building effective agents — diferenças entre workflows definidos e agentes com decisões dinâmicas.
Material complementar da Fernanda
- Guia de Claude Code: instruções do projeto — Leia CLAUDE.md, Tools e Skills como peças de um ambiente de agente. Instruções orientam o comportamento; permissões e validações precisam ser aplicadas pelo ambiente.
Pratique com /aprender
Copie o comando e cole no chat para iniciar uma prática guiada:
/aprender Quero projetar o harness mínimo para um agente que edita um arquivo de configuração. Ajude-me a especificar contexto, ferramentas permitidas, limites de segurança, registro de execução e verificações do resultado. Peça que eu decida cada componente antes de sugerir uma resposta e apresente um modo de falha para eu revisar.