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
OpenClaw PARA Habilidade Organizacional Classifica Automaticamente Arquivos em Projetos, Áreas, Recursos, Arquivos
Um desenvolvedor criou uma habilidade OpenClaw que aplica o método PARA (Projetos, Áreas, Recursos, Arquivos) para organizar arquivos, classificando automaticamente o conteúdo em vez de despejar tudo no diretório raiz.
Seja Meu Mordomo: Pipeline Multi-Agente para Verificação de Código em IA
Be My Butler é um pipeline de múltiplos agentes de código aberto onde diferentes modelos de IA revisam o código uns dos outros por meio de verificação cega. O sistema aborda o problema de agentes de IA relatarem incorretamente seu próprio código como funcional.
Agente de IA Cowork Causa Problemas de Entrada no Teclado em Laptops Windows
Um usuário relatou que o agente Cowork AI causou problemas persistentes de entrada do teclado em um Dell Latitude 9430, onde apenas as primeiras teclas digitadas eram registradas. A solução envolveu um procedimento específico de reset do controlador embutido para modelos Latitude.
re_gent: Git para Agentes de Codificação de IA – Controle de Versão para Atividade do Agente
re_gent é uma ferramenta de código aberto que fornece controle de versão para sessões de agentes de IA, rastreando cada chamada de ferramenta, armazenando prompts e diffs de arquivos, e permitindo comandos como `rgt log`, `rgt blame` e `rgt rewind` (em breve).