Presentando operate.txt: Una especificación YAML para agentes de IA que navegan productos SaaS.
Un desarrollador ha creado operate.txt, una especificación para documentar cómo los agentes de IA deben interactuar con aplicaciones web. El archivo aborda problemas encontrados al usar la función de uso informático de Claude para navegar un producto SaaS, donde el agente de IA cuestionaba repetidamente si las pantallas de carga indicaban funcionalidad rota.
Problema y solución
Al usar Claude Code + uso informático para navegar BrandyBee (un producto SaaS) como usuario por primera vez, el desarrollador identificó puntos problemáticos específicos donde Claude tuvo dificultades:
- Durante un análisis de marca que toma 90-120 segundos, Claude preguntó "¿Es esto un estado de carga o hay algo mal?" al 28% de completado
- Un botón "Aprobar" que activa llamadas API pagadas sin confirmación en la interfaz
- Un menú desplegable de Idioma que solo se llena después de seleccionar País
- Procesos asíncronos que toman 2-5 minutos y parecen estancados
Cada vez, la respuesta fue "no, eso es normal, solo espera". Esto llevó a la creación de operate.txt como equivalente a robots.txt para rastreadores o sitemap.xml para motores de búsqueda, pero específicamente para agentes de IA que operan productos.
Especificación operate.txt
El archivo operate.txt es un archivo YAML alojado en yourdomain.com/operate.txt que documenta:
- Qué es cada pantalla
- Cómo se ven los estados de carga y cuánto tiempo toman
- Qué acciones son irreversibles
- La ruta paso a paso para tareas comunes
- Qué los agentes nunca deben hacer
La sección más útil es async_actions, que le dice a los agentes detalles como "este proceso toma 90-120 segundos, no actualices, no navegues fuera, aquí están las etapas por las que pasa".
Proceso de creación y ejemplos
El desarrollador hizo de código abierto la especificación con ejemplos reales incluyendo su propio SaaS, una plantilla de comercio electrónico y una plantilla de panel de control SaaS en https://github.com/serdem1/operate.txt.
El proceso de creación implica hacer que Claude navegue tu producto, observar dónde duda, luego hacer que Claude redacte el archivo operate.txt. El desarrollador corrige lo que Claude entiende mal, creando un ciclo de retroalimentación donde la IA encuentra brechas y el humano las llena.
📖 Read the full source: r/ClaudeAI
👀 Ver también
Agente Kanban de VS Code: Gestión de tareas basada en Markdown para agentes de codificación con IA
VS Code Agent Kanban es una extensión que crea un tablero kanban compatible con GitOps dentro de VS Code utilizando archivos markdown como registros de tareas. Aborda la degradación del contexto en los agentes de codificación con IA al preservar las conversaciones de planificación, las decisiones y los detalles de implementación en archivos .md controlados por versión.
Desarrollador Crea Herramienta para Generación Realista de Bases de Datos Relacionales
Un desarrollador creó una herramienta que genera bases de datos relacionales completamente cargadas con datos realistas, resolviendo el problema de crear bases de datos de prueba con relaciones de clave externa intactas y consistencia entre tablas.
Rival-Review: Un Bucle de Revisión Cruzada de Modelos para Planes de Agentes de IA
Rival-review es una herramienta con licencia MIT que utiliza un segundo modelo de IA para auditar los planes de un agente de codificación de IA principal antes de su ejecución, detectando problemas como planes de reversión defectuosos, agujeros de seguridad y decisiones basadas en estados obsoletos.
Punto de Referencia de Revisión de Código con IA: Comparación de Claude, Gemini, Codex, Qwen y MiniMax
Un benchmark evaluó cinco modelos de IA en 15 solicitudes de extracción de Milvus con errores conocidos. Claude detectó el 53% de los errores en modo crudo, mientras que el debate adversario entre modelos aumentó la detección al 80%.