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
Weejur: Una Interfaz de Usuario Sencilla para Publicar en GitHub Pages
Weejur es una herramienta gratuita que proporciona una interfaz de usuario simplificada para publicar sitios web a través de GitHub Pages, permitiendo a los usuarios pegar HTML o subir archivos después de iniciar sesión con OAuth.
Reemplazando complejas tuberías de recuperación con simples comandos de shell de git para agentes LLM.
Un desarrollador reemplazó toda su tubería de recuperación de agentes de IA (sentence-transformers, rank-bm25, tubería de LLM de dos pasos) con una sola herramienta que permite al agente ejecutar comandos de shell de solo lectura en un repositorio git, reduciendo el tamaño de la imagen Docker en ~3 GB y eliminando problemas de tiempo de espera.
Panel de Código Abierto Revela los Costos Reales de Computación del Código Claude
Un desarrollador ingeniería inversa de la fórmula de límite de tasa de Claude Code para construir un panel de control local que muestra el porcentaje de uso en tiempo real, los costos reales en dólares, la tasa de consumo, las horas pico y qué habilidades/ganchos se están activando. La herramienta reveló que un plan de $100/mes consumió $13,286 en cómputo de API equivalente en un mes.
Herramienta de Vigilancia de Código Abierto Aborda el Problema de Identidad del Agente en el Ecosistema OpenClaw
Un usuario de OpenClaw que construía un servicio web descubrió tráfico de agentes indistinguible de usuarios humanos, lo que impulsó el desarrollo de Vigil: una capa de identidad de código abierto basada en W3C DID que proporciona credenciales criptográficas e historial de comportamiento para agentes.