Apresentando o operate.txt: Uma especificação YAML para agentes de IA que navegam por produtos SaaS

Um desenvolvedor criou o operate.txt, uma especificação para documentar como os agentes de IA devem interagir com aplicações web. O arquivo aborda problemas encontrados ao usar o recurso de uso do computador do Claude para navegar em um produto SaaS, onde o agente de IA questionava repetidamente se as telas de carregamento indicavam funcionalidade quebrada.
Problema e solução
Ao usar o Claude Code + uso do computador para navegar no BrandyBee (um produto SaaS) como um usuário pela primeira vez, o desenvolvedor identificou pontos de dor específicos onde o Claude teve dificuldades:
- Durante uma análise de marca que leva 90-120 segundos, o Claude perguntou "Isso é um estado de carregamento ou há algo errado?" aos 28% de conclusão
- Um botão "Aprovar" que aciona chamadas de API pagas sem interface de confirmação
- Um menu suspenso de Idioma que só é preenchido após a seleção do País
- Processos assíncronos que levam 2-5 minutos e parecem travados
Cada vez, a resposta foi "não, isso é normal, apenas espere". Isso levou à criação do operate.txt como equivalente ao robots.txt para rastreadores ou sitemap.xml para mecanismos de busca, mas especificamente para agentes de IA operando produtos.
Especificação do operate.txt
O arquivo operate.txt é um arquivo YAML hospedado em yourdomain.com/operate.txt que documenta:
- O que cada tela é
- Como são os estados de carregamento e quanto tempo eles levam
- Quais ações são irreversíveis
- O caminho passo a passo para tarefas comuns
- O que os agentes nunca devem fazer
A seção mais útil é async_actions, que informa aos agentes detalhes como "este processo leva 90-120 segundos, não atualize, não navegue para longe, aqui estão os estágios pelos quais ele passa".
Processo de criação e exemplos
O desenvolvedor disponibilizou o código aberto da especificação com exemplos reais, incluindo seu próprio SaaS, um modelo de e-commerce e um modelo de painel SaaS em https://github.com/serdem1/operate.txt.
O processo de criação envolve fazer o Claude navegar pelo seu produto, observar onde ele hesita e, em seguida, fazer o Claude redigir o arquivo operate.txt. O desenvolvedor corrige o que o Claude entende errado, criando um ciclo de feedback onde a IA encontra lacunas e o humano as preenche.
📖 Read the full source: r/ClaudeAI
👀 See Also

Agente de revisão de PR open source PrixAI detecta 10/10 bugs plantados a um custo 6x menor que o CodeRabbit
Um usuário do Reddit construiu o PrixAI, um agente de revisão de PR de código aberto que usa modelos de inferência locais/baratos para igualar os recursos do CodeRabbit com um custo 6 vezes menor, detectando todos os 10 problemas intencionalmente inseridos em um PR de teste.

Plugins de Código Claude de Código Aberto para Protocolos de Comércio Agente
A OrcaQubits lançou oito plugins Claude Code de código aberto que implementam protocolos de comércio agentivo, incluindo UCP, ACP, AP2 e A2A, com licenciamento MIT e suporte para plataformas como Magento 2, BigCommerce e WooCommerce.

Specsmaxxing: Combatendo a Psicose de IA com Especificações YAML e ACAI
Acai.sh apresenta Specsmaxxing: um método para combater agentes de IA perdendo contexto ao escrever requisitos em YAML e usar Critérios de Aceitação numerados para IA (ACAI) que os agentes referenciam no código.

SDK de Código Aberto para Trabalho de Conhecimento em IA
O kw-sdk da ClioAI oferece uma estrutura estruturada para agentes de IA que realizam trabalho de conhecimento, implementando um loop de autoverificação com briefing de tarefas, criação de rubricas e verificação.