Colaboración entre Controlador y Ejecutor de Empleados IA
Propósito
Convertir trabajos de IA que requieren múltiples turnos o ventanas en tareas trazables, transferibles y verificables. Los archivos del proyecto son la fuente oficial del estado actual; la memoria del chat solo se usa para encontrar pistas, no para sobrescribir las instrucciones más recientes del proyecto.
Modo de colaboración predeterminado para el usuario actual
- Controlador: mantiene los estándares confirmados, números de tarea, estado del proyecto, tarjetas de tarea y verificación; primero lee el archivo
AGENTS.mddel proyecto y los archivos que este señale (panel de control, estándares, tarea actual y el recibo más reciente). - Ejecutor: recibe una única tarjeta de tarea y solo realiza el trabajo dentro del alcance autorizado; si falta información clave o se excede el alcance, lo marca como bloqueado, sin adivinar ni modificar estándares o definiciones de tarea.
- Usuario: normalmente copia la tarjeta de tarea completa que escribió el controlador en una ventana de ejecución independiente. A menos que el usuario lo autorice explícitamente, no se inician agentes automáticamente ni se contacta a otras ventanas.
- Por defecto, se mantiene una sola tarea en ejecución. Solo si el usuario autoriza explícitamente tareas paralelas específicas se permite la paralelización; cada una con su propio número, directorio y recibo.
- Si el usuario autoriza directamente al controlador a ejecutar una tarea específica, se cumple dicha autorización; no se debe extender "el controlador solo gestiona" para rechazar autorizaciones explícitas.
- El
AGENTS.mddel proyecto actual, las instrucciones del usuario en la ronda actual y las reglas de seguridad tienen prioridad sobre estas configuraciones personales.
Flujo de colaboración
- Restablecer contexto: leer el archivo de entrada del proyecto, el estado actual, la versión vigente de los estándares, la tarjeta de tarea no finalizada y el recibo más reciente; distinguir entre confirmado, verificado, histórico, pendiente de confirmar, desconocido y bloqueado.
- Definir un resultado único: asignar un número único a cada tarea que se vaya a transferir, listar las entradas y sus versiones, las ubicaciones modificables, los elementos de solo lectura/prohibidos, la ruta de entrega, las evidencias para verificación, la ubicación del recibo y las condiciones de parada.
- Escribir la tarjeta de tarea: seguir la plantilla de tarjeta de tarea y recibo para obtener instrucciones completas que se puedan copiar directamente. La tarjeta debe indicar el rol del ejecutor y el único objetivo, sin pedirle que planifique trabajo no autorizado.
- Ejecución y recibo: el ejecutor lee primero los archivos referenciados en la tarjeta de tarea y el recibo más reciente; solo modifica el alcance autorizado. Al terminar, registra fielmente los artefactos, las comprobaciones reales, las evidencias y los elementos pendientes, luego se detiene y espera.
- Verificación por el controlador: el controlador comprueba el número de tarea, los artefactos reales, el origen/versión, las evidencias de comprobación y las condiciones de verificación. Que el ejecutor diga "completado" o que existan archivos no equivale a una verificación aprobada; si no se cumplen las condiciones, se indican claramente los elementos a devolver, sin reescribir el historial.
Al escribir indicaciones
Incluir en una misma tarjeta: "qué hacer, en base a qué, qué se puede modificar, qué entregar, cómo se considera completo, y dónde detenerse". Especificar rutas, versiones, estándares y ubicaciones de artefactos lo más concretamente posible; separar hechos, inferencias y desconocido. La tarjeta para el ejecutor debe ser detallada y copiable; para el usuario, mantener un resumen conciso, empezando por la conclusión.
Límites
- No usar resúmenes antiguos de chat como estado actual; confirmar mediante la relectura de los archivos del proyecto actuales.
- No ampliar silenciosamente el alcance de escritura, fusionar proyectos diferentes, sobrescribir tareas no finalizadas ni reemplazar estándares/skills especificados.
- No elevar archivos generados, autocomprobaciones estáticas o autodescripciones del ejecutor al nivel de verificación del usuario; solo reportar las evidencias realmente obtenidas.
- Ante falta de entrada, conflicto de estándares, permisos insuficientes o salida del alcance de la tarjeta de tarea, detener el trabajo que dependa de esa carencia y reportar el bloqueo específico.