Como fazer com que os agentes consigam simular seu próprio trabalho.
Pessoal, nos últimos meses estive muito focado em transformar o trabalho de agentes, que não são determinísticos, em algo o mais determinístico possível. Na maior parte das vezes isso inclui criar mocks para o agente simular testes e2e e exploratórios, simular cenários infelizes etc...
Depois de fazer vários harness locais de validação, resolvi fazer algo mais sólido e extensível. Fiz este projeto open source para ajudar nisso.
Se você precisa que seu agente de codificação teste múltiplos cenários e use um ambiente simulado para testar a entrega, acho que este projeto pode te ajudar.
Alguns exemplos do que dá para fazer:
- E-mail sem mandar e-mail: a aplicação envia por SMTP normalmente e o agente abre a caixa de entrada simulada para conferir assunto, destinatário e link de confirmação.
- Pagamento que falha: você pede ao agente "simula o Stripe recusando o cartão" ou "manda o webhook duas vezes", e ele confere se o seu código trata a cobrança duplicada.
- Fila e storage da nuvem localmente: Azure Service Bus, Blob Storage, Key Vault, Amazon Kinesis, Pub/Sub, Kafka e ActiveMQ rodam no mesmo container, com a aplicação apontando para ele
como se fosse o serviço real. - IA sem gastar token: endpoints compatíveis com OpenAI, Anthropic e Gemini respondem com regras que você define. Dá para forçar um 429 e ver se o retry funciona.
- Cenário brasileiro: Pix, NFS-e nacional, Correios, ViaCEP, Mercado Pago, Asaas, todos com dados sintéticos.
- Cenários infelizes sob demanda: timeout, 500, chave desativada, certificado errado, relógio adiantado para testar expiração.
- Linha do tempo: tudo o que a aplicação chamou fica registrado. Quando uma chamada não tem rota, o próprio agente vê o "não respondido" e cria a resposta.
Ele expõe um servidor MCP e REST, então o Claude Code, o Cursor ou outro agente controla tudo conversando: cria um ambiente por projeto, configura os cenários e lê o que aconteceu. São 45 plugins prontos no catálogo, e um plugin novo é só um arquivo YAML.
Código e documentação: https://edivanteixeira.github.io/stuntman/
100% opensource
Feedback e PRs são bem-vindos, principalmente de quem quiser um provedor que ainda não está lá.