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.