9. Delegar y modos de autonomía
Delegar es dejar que un rol del equipo responda en tu nombre a lo que el flujo te reserva (confirmar, aprobar, aceptar, elegir), con tus criterios. No cambia el flujo, no quita los Permisos y no te saca del proyecto: puedes recuperar el control cuando quieras. Todo ocurre en el chat del proyecto (capítulo 8); los pasos que te esperan siempre se marcan en el editor del equipo (capítulo 5).
Los tres modos: quién decide en cada uno
| Modo | Quién decide | Cómo lo ves | Cuándo encaja |
|---|---|---|---|
| Supervisado | Tú, todo lo que el flujo te reserva | Chip 👁 Supervisado, en gris | Al empezar, o en un proyecto delicado |
| Semiautónomo | El rol delegado, salvo en los pasos reservados, que te esperan | Chip 🤝 Semiautónomo · {Rol} y la lista de pasos que te esperan | Avanzar rápido y decidir tú los puntos clave |
| Autónomo | El rol delegado, en todos los pasos del flujo | Chip ⚡ Autónomo · {Rol} | Confías en tus criterios y revisas al final |
En Lyra, los pasos reservados son «Listo para construir» y «Prueba del usuario». Un equipo cuyo flujo no marca ningún paso reservado delega todo: al delegar, quedas en Autónomo. Si el rol delegado ya no está en el equipo, el chip sale como ⚠ Supervisado en ámbar y la delegación no tiene efecto (ver Barra superior, capítulo 8).
Cómo activar la delegación
- Pulsa el chip 🤝 Delegar de la barra superior (siempre a la vista, sin abrir ningún menú). Se abre el diálogo Delegar tus responsabilidades.
- En Quién decide en tu nombre, elige cualquier rol del equipo (o Nadie: decido yo).
- Escribe tus criterios (opcional; por ejemplo, «Prefiere la opción más sencilla. Acepta los fallos medios y bajos como pendientes. Si tiene dudas, que me pregunte»).
- Lee el recuadro del modo resultante, que se recalcula al cambiar de rol: Supervisado («Nadie decide por ti…»), Semiautónomo («{Rol} decide en tu nombre, salvo en N pasos que te esperan:», con la lista de esos pasos, «número. paso — rol») o Autónomo («{Rol} decide en tu nombre en todos los pasos del flujo…»).
- Elige qué Acciones que el rol delegado puede hacer (ver Qué no delega el rol por defecto) y guarda.
Vale para cualquier equipo y cualquier rol: la app no cambia el flujo, solo le dice al agente quién responde. Los pasos reservados no se eligen en el diálogo: se marcan en el editor del equipo, en Flujo (casilla Puede decidirlo el rol delegado; ver el capítulo 5).
La franja sobre el chat nombra siempre el modo: «Supervisado: decides tú todo lo que el flujo te reserva.» en tono neutro, con Delegar…; «Semiautónomo: {Rol} decide en tu nombre. Te esperan N pasos: …» o «Autónomo: {Rol} decide en tu nombre en todos los pasos.», con tus criterios, Cambiar… y Dejar de delegar. El chip de la barra superior dice lo mismo. Para dejar de delegar también puedes pulsar el chip y elegir Nadie: decido yo. Al activar la delegación, cambiarla o quitarla (y al cambiar los pasos reservados del flujo), el chat deja una nota y el agente se entera con tu próximo mensaje (también en los chats que ya tenían sesión).
Aviso de Preparación. Si al pulsar Guardar con un rol elegido hay señales en rojo en Preparación del proyecto, el diálogo muestra antes «Hay señales en rojo antes de delegar» con la lista de esas señales (y cuántas quedan sin comprobar). Ver Preparación cierra sin guardar y abre la sección; Activar de todos modos guarda la delegación; Volver regresa al diálogo con lo que escribiste. El aviso no impide delegar.
Cómo decide el rol delegado
- Todo lo que el flujo te reserva (confirmar el resumen de una petición, aprobar entregables y gates, elegir entre alternativas, aceptar el resultado, decidir el siguiente paso) lo decide ese rol en el propio mensaje, bajo una línea «{Rol}, en nombre del usuario:» con su justificación, sin abrir el panel de preguntas.
- En los pasos reservados, en cambio, el rol te pregunta con el panel de siempre y el avance se detiene hasta que respondes.
- Criterios de los gates. Si un gate delegable tiene criterios de aceptación, el rol delegado los recibe con la instrucción de juzgar cada uno contra el último entregable y citarlos (✓, ✗ o no comprobable, con un motivo) en su línea de decisión. Si cambias los criterios con la delegación activa, el agente los recibe con tu siguiente mensaje. En esos gates no hay Revisión de criterios aparte; en los pasos reservados, sí (ver El chat, capítulo 8).
- Si el flujo te pide probar el producto, el rol ejecuta las comprobaciones que puede y registra cada resultado como ejecutado en tu nombre; lo que no puede ejecutar queda como no ejecutado, nunca como superado.
- Si escribes en el chat, lo que digas manda sobre el rol delegado.
A qué nivel se aprueba
La aprobación es por entregable y por gate, no por cada acción del agente. Dentro de un paso, el rol trabaja sin pedir un turno nuevo: implementa, prueba y corrige. Lo que se decide (tú, o el rol delegado en tu nombre) es el resultado del paso: el entregable o el gate que lo cierra.
Por ejemplo, en un paso de implementación el desarrollador edita varios archivos, ejecuta las comprobaciones y corrige un fallo, todo en el mismo paso. Nadie aprueba cada edición: lo que se decide después es el gate de la prueba (en Lyra, «Prueba del usuario»). Lo que sí puede pedirse acción por acción son los Permisos, que son otro ajuste (apartado siguiente).
Delegación y Permisos: dos ajustes distintos
| Ajuste | Qué decide | Dónde se cambia |
|---|---|---|
| Delegar | Las preguntas del flujo: confirmar, aprobar, aceptar, elegir | Chip 🤝 Delegar (barra superior) |
| Permisos | Las acciones del agente: editar un archivo, ejecutar un comando | Menú del agente → modo de permisos |
Los tres modos de permisos (el diálogo Permiso: {qué} se explica en el capítulo 8, El chat):
- Preguntar siempre — pide permiso para cada acción.
- Aceptar ediciones de archivos — no pregunta para editar archivos; sí para comandos.
- Automático — no pregunta (con Codex, delega en su revisor automático).
Para que el sprint avance sin ti, pon Permisos en Aceptar ediciones de archivos o Automático: con Preguntar siempre, el avance se detiene en cada permiso aunque delegues. La delegación es un ajuste personal del proyecto (en .team-ai-console/state.json): no viaja por git ni afecta a otras personas del proyecto.
Qué no delega el rol por defecto
Las acciones difíciles de deshacer siguen preguntándote aunque delegues: subir a un remoto de git, desplegar, borrar datos, pagar o contratar servicios, y ampliar el alcance que confirmaste. En el diálogo, Acciones que el rol delegado puede hacer tiene seis acciones fijas, cada una con Me pregunta (por defecto) o Puede hacerlo:
- Subir a la rama del sprint
- Mezclar o subir a la rama principal
- Desplegar
- Borrar datos
- Pagar o contratar servicios
- Ampliar el alcance
Al permitir una de las difíciles de deshacer (la rama principal, desplegar, borrar o pagar), la fila avisa «⚠ Es difícil de deshacer: el rol lo hará sin preguntarte.». Se guardan con la delegación y Dejar de delegar las borra. La lista de acciones manda sobre los pasos: un paso delegable como «¿Subir a git?» sigue preguntándote antes de subir si Subir a la rama del sprint dice Me pregunta.
Cómo se detiene el avance automático
Con la delegación activa, al acabar cada turno la app hace sola lo que el agente propone, sin que pulses el botón: activa el rol de Cambiar a: {Rol} (línea «Cambio automático a {Rol} por delegación en {Rol delegado}.»), sigue con el paso siguiente del mismo rol en lugar de Continuar («Continuación automática de {Rol}…»), sigue en este chat cuando el agente propone Nuevo chat: con el nombre del chat en el que ya estás, en lugar de Continuar aquí («Continuación automática en este chat…»), y abre el chat de cada fase aunque Chats por fase automáticos esté desmarcado («Apertura automática del chat…»; la casilla no cambia y vuelve a valer al dejar de delegar). Así el sprint avanza de la entrevista al fin del sprint sin clics.
Se detiene, y queda el botón de siempre, cuando:
- el mensaje acaba en pregunta;
- hay un permiso o una pregunta por responder (como la de subir a git);
- el agente repite la misma propuesta sin que cambie el paso;
- llega un paso reservado, que espera tu respuesta en el panel de preguntas;
- se propone el chat de otro sprint al terminar: ese chat lo abres tú.
Recuperas el control parando el turno, escribiendo en el chat o con Dejar de delegar: el avance pendiente no se hace y el botón queda disponible.
Dónde queda registrada cada decisión
- En el chat: el mensaje del rol, bajo «{Rol}, en nombre del usuario:», con su justificación.
- En el entregable: «Decidido por {Rol} en nombre del usuario», con el criterio aplicado y la fecha.
- En el cierre del sprint: la sección Decisiones tomadas en nombre del usuario, con la lista completa; con pasos reservados, termina con la línea «Pasos que decidió el usuario: …».
- En tu estado personal del proyecto (
.team-ai-console/state.json): la delegación, con tus criterios y las acciones permitidas. No viaja por git.
Revisa esa sección al cerrar cada sprint.
Qué no promete la delegación
La delegación no es ejecución sin supervisión: el equipo sigue su flujo, tú decides cuánto delegas y puedes recuperar el control en cualquier momento. Los Permisos y las acciones difíciles de deshacer siguen bajo tu control mientras no los abras tú. Lo que el rol decide por ti queda escrito para que lo revises, y si algo no te convence puedes corregirlo: pedir cambios o empezar una nueva ronda.