Contexto e arquitetura do projeto
Em um repositório com agentes, é essencial ter um arquivo como CLAUD.md ou AGENTS.md na raiz, que contém comandos para subir banco e Redis, configurações de multi-tenancy, e convenções de código. Este documento é o mesmo que você daria a um novo membro da equipe.
Verificação e segurança
A regra mais importante é que o agente deve rodar o mesmo que a CI (Controle de Introdução) antes de dizer que terminou. Isso inclui ferramentas como lint, test e build. Se algo dá errado, a verificação é crucial para garantir que o agente entenda que não funcionou.
Limites de autonomia
A engenharia de harness permite definir limites claros para o agente. Ele deve fazer o que é permitido e evitar o que é negado. Isso evita que erros se tornem problemas maiores.
Memória e aprendizado
O agente deve aprender com erros e não repetir o mesmo erro duas vezes. Isso é feito através de uma memória que registra cada falha e permite que o agente aprenda com o passar do tempo.
Separar contexto
É importante separar o agente do contexto do trabalho e do contexto dos projetos pessoais. Isso evita que erros de configuração sejam aplicados em ambientes diferentes.
Conclusão
A engenharia de harness é uma ferramenta simples, mas poderosa que permite dar autonomia aos agentes sem correr o risco de quebrar o projeto. É uma abordagem que cada desenvolvedor deve considerar para garantir que seus agentes funcionem de forma eficaz e segura.
Checklist para montar o seu harness
- Crie um arquivo como
CLAUD.mdouAGENTS.mdcom comandos, arquitetura e convenções do projeto. - Escreva o que não fazer, não só o que fazer.
- Faça o agente rodar o mesmo que a CI antes de dizer que terminou.
- Separe o que ele faz sozinho do que precisa da sua aprovação.
- Transforme cada erro não óbvio numa linha de memória.
- Separe o contexto do trabalho do contexto dos projetos pessoais.
- Revise o harness de tempos em tempos e tire segredos de arquivos de configuração.
Obrigado por ler! 🚀