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
El flujo de trabajo de codificación autónoma envía 163 mil líneas durante la noche usando Claude Code.
Un desarrollador construyó un flujo de trabajo autónomo que completó 72 tareas durante la noche, generando 163,643 líneas de código y más de 6,400 pruebas aprobadas con una tasa de éxito del 85% en el primer intento.
Realizando pruebas locales de Qwen 3.6 27B como co-agente validador de Codex
Un desarrollador construyó un conjunto de pruebas reproducible para evaluar perfiles GGUF de Qwen 3.6 27B (llama.cpp) como validador auxiliar para Codex, encontrando que los perfiles de contexto de 128k son necesarios para tareas de contexto largo y que hay una pérdida mínima de precisión con caché KV q8.
md-redline: herramienta GUI para revisar y entregar documentos de markdown a Claude
md-redline es una herramienta de código abierto que te permite abrir archivos markdown en una interfaz gráfica, dejar comentarios en línea almacenados como marcadores HTML en el archivo .md, y pasar el documento a Claude para actualizaciones. Se ejecuta localmente sin necesidad de cuenta, nube o base de datos.
PgAdmin 4 9.13 Agrega Panel de Asistente de IA a la Herramienta de Consulta
PgAdmin 4 versión 9.13 introduce un panel de Asistente de IA en la Herramienta de Consulta que puede generar SQL a partir de lenguaje natural cuando la IA está configurada. La actualización también incluye un diseño de Espacio de Trabajo para la edición de consultas sin distracciones y conexiones de servidor ad-hoc.