8. El área de trabajo (un proyecto abierto)

Al abrir un proyecto, la ventana se divide en: barra superior, panel lateral (izquierda), chat (centro) y visor de documentos (derecha). Los separadores entre paneles se pueden arrastrar; con doble clic vuelven a su tamaño.

Barra superior

De izquierda a derecha:

• Nueva ventana — el primer botón de la izquierda: abre otra ventana de la app en la pantalla inicial; la ventana actual sigue en el proyecto. Es lo mismo que File → New Window. Sin una licencia que incluya varias ventanas se ve con 🔒.
• ‹ Proyectos — vuelve a la pantalla inicial.
• Nombre del proyecto y su estado: Listo, Arrancando…, “{Rol} está trabajando…”, “Ejecutando: {herramienta}”, “Listo · N en segundo plano” o Error. En ventanas de 1360 px de ancho o menos, el estado se ve solo como un punto de color; al pasar el ratón por encima se ve el texto. Un nombre de proyecto largo se corta con “…”; al pasar el ratón se ve el nombre completo y la carpeta.
• Mientras hay trabajo en curso, el punto de estado cambia a una etiqueta de actividad: IA (cálida, con el icono latiendo) cuando trabaja el modelo, que consume plan; Local (fría, fija) cuando se ejecuta una herramienta en tu equipo, como un comando o la lectura y edición de archivos, que no consume plan. Una herramienta que dura menos de 300 ms no la cambia. Mientras una herramienta espera tu permiso, cuenta como Local. Las herramientas que no se pueden clasificar (por ejemplo, las de servidores MCP) no cambian la etiqueta: se ve el punto de siempre. Lo mismo en reposo o con error. Al pasar el ratón por la etiqueta se ve «IA — consume plan» o «Local — sin consumo».
• En proyectos compartidos: el indicador de sincronización (Sincronizado, Sincronizando…, Sin conexión, Error…; al pulsarlo sincroniza) y el turno (“Turno: {rol} · {persona}”).
• El aviso de versión nueva de la app, si la hay.
• El selector de vista Chat · Backlog · Mejoras · Consumo · Equipo · Pendientes — qué se ve en el centro de la ventana (ver Selector de vista, abajo).
• Ocultar visor / Mostrar visor — el visor de documentos.
• El estado de la licencia, en una cápsula con un punto de color: verde con Con licencia; ámbar en el periodo de gracia o en modo lectura; roja sin licencia o con la licencia caducada, revocada, en otra máquina o no válida. Al pulsarla se abre el panel de licencia.
• Chip del modo de autonomía — el chip de la delegación (ver el capítulo 9) nombra el modo: 👁 Supervisado en gris si decides tú; 🤝 Semiautónomo · {Rol} en el color de acento si delegaste y el flujo tiene pasos reservados; ⚡ Autónomo · {Rol} relleno del color de acento si delegaste y no hay pasos reservados; ⚠ Supervisado en ámbar si el rol delegado ya no está en el equipo (al pasar el ratón explica que la delegación no tiene efecto). En una ventana estrecha se oculta el nombre del rol, nunca el modo. Al pulsarlo se abre el diálogo de la delegación.
• {Agente} · {modelo} ▾ — el menú del agente. El botón muestra el agente y el modelo con los que responde el rol activo: con Claude Code y Codex instalados, puede ser otro agente que el del chat (ver Un agente distinto por rol).
  • Agente (Claude Code o Codex) que ejecuta los turnos de este chat. Queda fijo cuando el chat arranca; para usar otro agente, abre un chat nuevo. Con los dos agentes instalados es el agente «Proyecto»: lo usan los roles que no tienen agente propio.
  • Modelo — Por defecto, uno de la lista u Otro… (escribes el id o alias). Debajo se indica el modelo que el agente dice estar usando. Este modelo solo se aplica al agente del chat: si el rol activo usa el otro agente, una nota debajo lo dice («Este modelo solo se aplica a Claude Code. Full Stack Developer usa Codex con su propio modelo.»).
  • Modelos por rol… (ver Modelos por rol).
  • Cambiar de equipo… (ver Cambiar de equipo).
  • Permisos — Preguntar siempre, Aceptar ediciones de archivos o Automático (ver Permisos).
  • Chats por fase automáticos — activado por defecto (ver Chats por fase).
  • La versión de la app.
• La sesión del agente (la del agente del rol activo): “Sesión iniciada” con Cerrar sesión (en ventanas de 1360 px de ancho o menos, solo Cerrar sesión), o Iniciar sesión. Si la sesión usa una API de pago, aparece API de pago en naranja.
  • Al abrir el proyecto (y al cambiar de agente), si la comprobación de la sesión tarda más de un instante, aparece un aviso en el centro: «Comprobando la sesión de {agente}…», con una barra de actividad. Se cierra solo al terminar. Ocultar lo cierra y la comprobación sigue; el resultado se ve aquí, en la barra. Si no hay sesión, el aviso lo dice y ofrece Iniciar sesión; si no encuentra el agente o falla, explica qué hacer y ofrece Reintentar; si pasan 15 segundos sin respuesta, dice que está tardando demasiado y deja Reintentar o Cerrar y seguir usando la app. Las comprobaciones de cuando vuelves a la ventana siguen siendo silenciosas.
• El selector de idioma ES | EN y el botón de tema.

Si las opciones no caben en la ventana (por ejemplo, con la ventana a su ancho mínimo), la fila de la barra se puede desplazar: aparece un degradado con una flecha › (o ‹) en el borde por el que quedan opciones. Pulsa la flecha, usa la rueda o el trackpad, o recorre las opciones con Tab, que trae a la vista la que tiene el foco. Si todo cabe, la barra se ve como siempre y no aparece ninguna flecha.

Todos los controles de la barra tienen la misma altura y ningún texto se parte en dos líneas.

Selector de vista

El selector Chat · Backlog · Mejoras · Consumo · Equipo · Pendientes de la barra superior elige qué se ve en el centro de la ventana. Siempre hay una opción marcada (la de fondo blanco); al abrir un proyecto es Chat. Pulsar la opción que ya está marcada no hace nada: para volver al chat, elige Chat.

• Chat — la conversación con el equipo.
• Backlog — las peticiones pendientes del proyecto (ver Backlog).
• Mejoras — las propuestas de mejora del equipo, con el número de pendientes (ver capítulo 13, Mejoras del equipo).
• Consumo — el uso de la IA en el proyecto (ver Consumo de la IA). Si tu licencia no lo incluye, la opción lleva 🔒 y al pulsarla se abre el aviso de la licencia en vez de cambiar de vista.
• Pendientes — lo que espera a una persona en los chats del proyecto, con el número de elementos en la propia pestaña: Pendientes (3) (de 100 en adelante, «99+»; sin número si no hay ninguno). Ver Pendientes, más abajo.
• Equipo — el panel de colaboración (ver El panel Equipo). Si hay identidad de colaboración, la opción lleva tu nombre: Equipo · {tu nombre} (si es largo, se recorta con «…»; en ventanas de 1360 px de ancho o menos solo se ve Equipo; el nombre completo aparece al pasar el ratón).

El chat sigue trabajando. Cambiar de vista no detiene ni pausa al agente: la respuesta en curso se sigue escribiendo y, al volver a Chat, el chat está como lo dejaste (la posición del scroll y el texto que estabas escribiendo). Si el agente escribe un mensaje mientras ves otra vista, aparece un punto amarillo en la opción Chat, que desaparece al volver.

Pendientes. La vista lista, de todos los chats del proyecto abiertos en esta sesión de la app, lo que espera a una persona: Pregunta (una pregunta del rol con opciones), Permiso (un permiso de herramienta), Gate (una pregunta de aprobación de un paso del flujo), Cambio de rol (el rol propone Cambiar a:), Cambio de chat (propone Nuevo chat: o seguir el ciclo en el mismo chat) y Turno recibido (en colaboración, el turno pasó a ti; aparece aquí además de la notificación del sistema). Cada fila dice el tipo, qué espera (máximo dos líneas), el rol, el chat y cuánto lleva esperando (se actualiza cada 30 segundos); la que más tiempo lleva esperando va arriba. Desde aquí no se responde nada: Abrir te lleva al chat (con la pregunta o el permiso a la vista) y, en un gate, Ver documento abre en el visor el documento que revisa y Ver cambios abre la pestaña Cambios del visor. El número de la pestaña baja en cuanto respondes en el chat. Un pie recuerda que solo se ven los chats abiertos en esta sesión: lo que preguntó un chat antes de cerrar la app no puede conocerse.

Cabecera de Backlog, Mejoras, Consumo, Equipo y Pendientes. Estas vistas tienen arriba una cabecera con su título y el nombre del proyecto (por ejemplo, «Backlog · mi-proyecto»). Mientras el agente trabaja, a la derecha se ve un punto amarillo y «{rol} sigue trabajando en Chat», con el rol activo.

Con el teclado. El selector es un solo punto de tabulación: las flechas ← y → pasan de una opción a otra (al llegar al final vuelven al principio), Inicio y Fin van a la primera y a la última, e Intro o Espacio eligen la opción. Los lectores de pantalla anuncian la opción seleccionada.

Si el agente usa una API de pago por uso en lugar de tu plan, además aparece un aviso en el proyecto: cada mensaje se cobra aparte de tu suscripción; para usar tu plan, cierra la sesión e inicia sesión con tu cuenta de Claude o de ChatGPT.

Panel lateral

Una barra de iconos a la izquierda cambia entre secciones:

• Flujo — los pasos del flujo del equipo agrupados por fases, con “Paso N de M”. Los pasos completados llevan ✓, el actual se marca como ACTUAL y los opcionales o condicionales aparecen atenuados. Cada paso ocupa una sola línea, con su número (o ✓) y su nombre, y todas las filas tienen la misma altura; un nombre que no cabe se recorta con «…». Al pasar el ratón por un paso se ve su número y su nombre completo, el rol que lo hace (por ejemplo «4. Especificación de diseño — UI/UX Designer») y su descripción. En proyectos compartidos, cada paso muestra la persona dueña del rol. El panel solo muestra dónde está el trabajo: el paso avanza al activar el siguiente rol y cuando el rol indica en qué paso trabaja (también si el mismo rol pasa de un paso a otro). Al activar un rol, el paso es el siguiente de ese rol; si su paso anterior está más cerca (se vuelve a él tras una revisión con cambios, por ejemplo de code-review al Full Stack Developer), el paso es ese anterior: implementation, no git-push. Si abres un chat nuevo cuando el flujo está en su último paso (el cierre del ciclo o del sprint), el flujo pasa al inicio del ciclo siguiente.
  • Aviso de paso sin actualizar. Si tras un Cambiar a: la respuesta del agente no marca su paso, bajo «Paso N de M» aparece el aviso «El paso del flujo puede estar desactualizado: el agente no lo marcó al cambiar de rol.». Solo informa: si el paso no es el correcto, usa Saltar a un paso…. Se quita solo cuando una respuesta marca el paso o el paso cambia, y con ×. No se guarda: no sigue al cambiar de chat ni al reabrir la app.
  • Agente y modelo del rol activo. Bajo el nombre del paso actual, una línea dice con qué agente y qué modelo trabaja el rol activo, por ejemplo «Claude Code · Opus 5.5». Antes de que ese rol responda por primera vez, es el modelo configurado (el del rol o el que sugiere el equipo) y lleva la etiqueta previsto; si nadie define modelo, muestra el modelo por defecto de la app con «(por defecto de la app)», por ejemplo «Claude Code · Sonnet (por defecto de la app)». Tras su respuesta, es el modelo que informó el agente y la etiqueta desaparece. Si no coincide con el configurado, una línea ámbar añade «≠ distinto del configurado: …»: solo informa, no cambia nada. Al pasar el ratón se ve la explicación completa. El modelo informado se recuerda por rol mientras la app está abierta: al cambiar de rol, la línea vuelve a previsto hasta que el rol nuevo responda. Con Codex, el modelo que se ve es el que la app pide para el turno; Codex no confirma cuál usó.
• Roles — la lista de roles del equipo, con el rol Activo resaltado y el Propuesto (el que sugiere el rol que acaba de terminar). Muestra el dueño de cada rol (en proyectos compartidos) y su modelo, si tiene uno asignado. Enlaces: Modelos por rol… y Cambiar de equipo…. Al pasar el ratón sobre un rol se ve la frase para activarlo (“Cambiar a: {rol}”).
• Documentos — el árbol de la carpeta de documentos del proyecto (docs/ y sus subcarpetas), tal como está en disco; los Adjuntos; y la Definición del equipo (team-ai-console.json, el documento del flujo y los documentos de cada rol). Abrir carpeta abre la carpeta en el explorador de archivos. ¿Cómo personalizar? abre una guía de cómo añadir roles, cambiar la carpeta de documentos o los botones rápidos. Al pulsar un documento se abre en el visor. Con los equipos de la app actualizados (Vela 4.10, Orión 1.6, Andrómeda 5.4 y Lyra 3.2), cada sprint nuevo guarda sus documentos en su propia carpeta, docs/sprints/sprint-N-nombre/ (el nombre sale del chat del sprint: «Sprint 14 - Subcarpeta por sprint» → sprint-14-subcarpeta-por-sprint); los documentos de sprints anteriores siguen sueltos en docs/sprints/, sin moverse.
• Diagnóstico — los problemas encontrados en la definición del equipo (por ejemplo, un documento de rol que no existe o un paso del flujo con un rol desconocido), o “La definición del equipo se leyó sin problemas”.
• Preparación (icono de casilla de verificación) — siete señales que dicen si el proyecto está listo para que los roles trabajen con más autonomía; el icono lleva una insignia roja con el número de señales en rojo. Ver Preparación del proyecto.

Preparación del proyecto

La sección Preparación del panel lateral muestra siete señales, cada una con un icono de forma distinta, su color y una etiqueta: Lista (círculo verde con ✓), Atención (triángulo ámbar con !), Falla (círculo rojo con ✕) o Sin comprobar (círculo discontinuo gris). Debajo de cada nombre, una línea dice por qué está así. Arriba, el resumen («5 listas · 1 en atención · 1 en rojo») y cuándo fue la última comprobación con comandos («Última comprobación: hace 3 min (al pulsar Comprobar)» o «Aún no se han ejecutado los comandos del proyecto.»).

• Al abrir el proyecto solo se leen archivos. Las señales 4 a 7 se calculan leyendo los documentos, el estado local de git (sin red) y los datos de la app. Las tres primeras necesitan ejecutar comandos o consultar el remoto, así que quedan Sin comprobar, salvo que lo que falta ya se vea en los archivos (por ejemplo, no hay comando ni carpeta de pruebas, o no hay configuración de CI): entonces salen en Falla.
• Comprobar. Ejecuta los comandos del proyecto sin agente, así que no gasta tokens ni aparece en Consumo: comprueba que las dependencias están instaladas (por ejemplo npm ls), ejecuta las pruebas, arranca la app 10 segundos y la detiene, y consulta la última ejecución del CI. Mientras corre se ve «Comprobando… 12 s» con Cancelar, y cada señal se resuelve al terminar la suya. Todo se corta a los 120 segundos; una señal que no terminó a tiempo queda en Atención con «No terminó en el tiempo previsto.». Los comandos salen de los manifiestos de la carpeta del código (package.json, pyproject.toml, Cargo.toml, go.mod, Makefile).
• Al iniciar un sprint (al abrir el chat de un sprint nuevo, también desde el Backlog) la comprobación con comandos se lanza sola y la cabecera lo dice: «(al iniciar el sprint)».
• Pedir a {rol}. En una señal en Falla (y en Atención de Documentos al día), si el equipo tiene un rol que puede resolverla, un botón te lleva al chat con la petición ya escrita en el cuadro, sin enviarla: la lees, la cambias si quieres y pulsas Enviar. Si ese rol no es el activo, la petición va precedida de «Cambiar a: {rol}». El rol se elige por su área: pruebas → calidad (o implementación), comandos y repositorio → implementación, CI → operaciones (o implementación), documentos → documentación, supuestos → producto. Si el equipo no tiene ninguno, no hay botón. La señal 7 no pide a un rol: ofrece Editar modelos, que abre los modelos por rol, y Ver roles con los roles afectados.
• Con Claude Code y con Codex las siete señales son las mismas; la de agente y modelos nombra el agente con el que trabaja cada rol.
• Cómo se comprueba esto, al pie, despliega este resumen dentro del propio panel.

Visor de documentos

Muestra el documento elegido, Con formato (Markdown) o como Fuente, con Mostrar en Finder / Mostrar en la carpeta y × para cerrarlo. Se actualiza solo cuando cambia el archivo y, cuando el equipo escribe un documento nuevo, muestra el más reciente.

Estados del visor. El cuerpo del visor nunca queda en blanco: mientras lee el documento muestra «Cargando…»; si el documento no tiene texto, «Este documento está vacío.»; si el archivo no se puede abrir (ya no existe, sin permiso…), una caja de error «No se pudo abrir este documento» con el motivo y Reintentar; y si el contenido no se puede mostrar con formato, una caja con Ver como texto (lo muestra como fuente) y Reintentar. Si falla el propio visor, un aviso «El visor de documentos tuvo un problema.» con Reintentar y Cerrar visor. En todos los casos la cabecera del visor, el chat y la lista de documentos siguen usables, y al pulsar otro documento se abre con normalidad.

Archivos que no son de texto. Una imagen, un .zip u otro archivo binario no se carga en el visor: en su lugar sale un recuadro gris «No se puede previsualizar este archivo», con el nombre, la extensión y el tamaño (por ejemplo «Archivo .zip · 48,3 MB»), y la cabecera solo deja Mostrar en Finder / Mostrar en la carpeta para abrirlo con otra aplicación. La app solo mira el principio del archivo, así que un binario grande no la ralentiza. Los archivos de texto se abren como siempre, tengan la extensión que tengan o ninguna.

Enlaces. Pulsar un enlace nunca saca la ventana de la app. En las respuestas del agente (chat del sprint y «Aparte»), cada enlace se abre según su destino:

Las rutas se buscan desde la carpeta del proyecto; una ruta absoluta solo se abre si está dentro de ella. Si un enlace no se puede abrir, aparece encima del cuadro de escribir un aviso breve que dice por qué: el archivo no existe en el proyecto, apunta fuera de la carpeta del proyecto, el visor no puede mostrar ese tipo de archivo (binario o de más de 1 MB), el tipo de enlace no lo abre la app (por ejemplo ftp:), el enlace apunta a otra parte de la respuesta (#seccion) o no se pudo abrir el navegador. El aviso desaparece a los 6 segundos (se queda mientras tienes el ratón encima o el foco en él) y se cierra antes con ×. En «Aparte», que no tiene visor, el documento se abre en el visor de la ventana principal del proyecto, que pasa al frente; si el proyecto no está abierto en ninguna ventana, el aviso dice «Abre el proyecto en su ventana principal para ver el documento.». Al pasar el ratón sobre un enlace se ve su destino. Los enlaces dentro de un documento del visor se explican en Pestañas del visor, más abajo.

Pestañas del visor. Al pulsar, dentro de un documento del visor, un enlace a otro documento del proyecto (por ejemplo, los de index.md), ese documento se abre en una pestaña nueva del visor. La tira de pestañas aparece encima de la cabecera solo cuando hay alguna así; la primera pestaña es el documento que elegiste en el panel Documentos, el chat o «Aparte», y no se cierra (el visor entero se cierra con su × de siempre, y con él las pestañas extra). Cada pestaña extra lleva su × para cerrarla; al cerrar la que estás viendo, queda la de su izquierda. Con el teclado, ← y → pasan de una pestaña a otra, Intro la abre y Supr cierra una extra. Cómo se sigue cada enlace:

• Si el documento ya está abierto en una pestaña, se activa esa en lugar de abrir otra.
• Un enlace http:// o https:// se abre en el navegador del sistema; el visor no cambia. Otros tipos de enlace (por ejemplo mailto:) no hacen nada.
• Un enlace con sección (documento.md#seccion) abre el documento y va a esa sección; un enlace #seccion solo va a esa sección del documento que estás viendo. Si la sección no existe, el documento se queda arriba.
• Las rutas se buscan desde la carpeta del documento que tiene el enlace (../ permitido) y deben quedar dentro del proyecto. Un enlace a un documento que no existe muestra bajo la cabecera el aviso «No se puede abrir este enlace: «…» no existe en el proyecto.», con Cerrar aviso; también se cierra al pulsar una pestaña o al abrir otro enlace.
• Elegir otro documento en el panel Documentos sustituye el de la primera pestaña (o activa su pestaña si ya está abierto en una extra).

Ver / Editar. En la cabecera del visor hay un selector Ver | Editar. Ver es la lectura de siempre. Editar cambia el contenido por el texto Markdown del documento para escribir en él, en el mismo panel:

• Se pueden editar los documentos .md de la carpeta de documentos del proyecto (docs/ y sus subcarpetas, adjuntos incluidos). Los de la definición del equipo (team/) y los archivos que no son .md se leen sin editar: Editar sale desactivado con el aviso «Solo se pueden editar los documentos .md de la carpeta de documentos». La guía «¿Cómo personalizar?» no muestra el selector.
• Editar requiere una licencia vigente que incluya Editar documentos (también en el periodo de gracia sin conexión). Con una licencia que no la incluye, una licencia caducada o sin licencia, Editar sale con un 🔒 y, al pulsarlo, se abre el diálogo Editar documentos con Ver la licencia. Si la licencia deja de valer mientras editas, el visor vuelve a Ver y, si tenías cambios sin guardar, te enseña tu texto para que lo copies.
• Guardar (o ⌘S / Ctrl+S) escribe el archivo; Descartar vuelve al último texto guardado. A la derecha se ve «Cambios sin guardar» o, al guardar, «Guardado».
• Si intentas pasar a Ver, abrir otro documento, cambiar o cerrar una pestaña o cerrar el visor con cambios sin guardar, una franja te avisa: Guardar y continuar, Descartar y continuar o Seguir editando. (Salir del proyecto no avisa todavía.)
• Si el documento cambia en disco mientras lo editas (por ejemplo, lo escribe el agente), una franja te deja elegir Cargar la versión del disco o Mantener la mía; tu texto nunca se pierde sin que lo elijas. Si al guardar el archivo había cambiado, el guardado no se hace hasta que eliges Sobrescribir o Cargar la versión del disco.
• En un proyecto con colaboración, el documento guardado viaja con la siguiente publicación del turno, como cualquier otro cambio.

Revisar. El tercer botón del selector, Ver | Editar | Revisar, sirve para revisar un entregable anotando el propio documento en lugar de describir los cambios en el chat. Sigue las mismas reglas que Editar: solo en los documentos .md de la carpeta de documentos (en los demás sale desactivado con «Solo se pueden revisar los documentos .md de la carpeta de documentos») y con la función Editar documentos de la licencia (sin ella sale con 🔒). En Revisar siempre se ve el documento con formato.

• Anotar. Selecciona un fragmento con el ratón (o con Mayús+flechas tras entrar en el documento con Tab) y elige en la burbuja Comentar, Sugerir reemplazo o Marcar para borrar. Los mismos tres botones aparecen en el margen, en la tarjeta Fragmento seleccionado, para usarlos con el teclado. Comentar y Sugerir reemplazo piden el texto (Guardar o ⌘/Ctrl+Intro; Esc cancela); Marcar para borrar crea la anotación al momento (con Editar puedes añadir un motivo).
• El margen. A la derecha (o debajo, si el visor es estrecho, plegable) se listan las anotaciones por orden en el documento: tipo, el fragmento citado, la sección, «Aparición n de total» si el fragmento se repite, tu texto y su estado (Sin enviar, Enviada, Atendida, Pendiente o No encontrado si el fragmento ya no está). Cada fragmento anotado se resalta con el color y la forma de su tipo (subrayado punteado, ondulado o tachado); pulsar una tarjeta lleva al fragmento. Editar y Borrar en cada tarjeta.
• Dónde se guardan. En .team-ai-console/annotations.json del proyecto, solo para ti: siguen ahí al cerrar y abrir el proyecto, y el .gitignore de esa carpeta las deja fuera de git.
• Pedir cambios (n). Envía al chat del rol activo un mensaje con el documento y, por cada anotación, su tipo, la sección, la línea del archivo (si se encuentra), el fragmento citado (y su número de aparición si se repite) y tu texto, con la indicación de cambiar solo esos fragmentos y dejar el resto igual. El mensaje sale en el idioma de la app y es texto normal, así que funciona igual con Claude Code y con Codex. Se envían las anotaciones sin enviar y las pendientes; mientras el rol responde un turno, el botón está desactivado con su explicación. Si había una pregunta de aprobación abierta, se responde primero «en el chat» y el mensaje se envía al terminar ese turno.
• Atendida o pendiente. Cuando el rol termina su turno, cada anotación enviada queda Atendida si su fragmento ya no está tal cual, o Pendiente si sigue igual. Un nuevo Pedir cambios vuelve a enviar las pendientes (marcadas «pendiente de la petición anterior») junto con las nuevas.
• Aprobar. Equivale a responder la opción de aprobación (por ejemplo «Construir así» o «Todo bien») en el panel de preguntas. Solo se activa cuando el documento es el entregable del paso y su pregunta de aprobación está abierta; si no, sale desactivado con la explicación. Si quedan anotaciones sin enviar, te avisa antes con Aprobar igualmente, Pedir cambios o Cancelar.

Ver qué cambió. Tras Pedir cambios, cuando el rol termina su turno aparece en la cabecera de Revisar el enlace Ver qué cambió, que abre Historial con esa comparación ya elegida.

Historial y Comparar. El cuarto botón del selector, Ver | Editar | Revisar | Historial, lista las versiones del documento abierto. Solo en los documentos .md de la carpeta de documentos (en los demás sale desactivado con «Historial solo está disponible en documentos de la carpeta de documentos») y sin licencia de pago: leer versiones no escribe nada.

• Versiones. Una tabla con una casilla Comparar, la fecha y hora, el rol y el turno que la escribió («Turno 14»); la más reciente arriba, marcada Actual. Se ven hasta 6 filas y el resto se desplaza. La app guarda una versión de cada documento que cambia en un turno y otra al pulsar Pedir cambios («antes de pedir cambios»); en un proyecto con git, se suman las del historial de git del archivo (con su commit; el rol se deduce del turno que terminó justo antes). Las versiones que guarda la app están en .team-ai-console/snapshots/, fuera de git.
• Comparar. Marca dos casillas (al marcar una tercera se desmarca la más antigua de las dos). Por defecto se compara la versión guardada al pedir cambios la última vez con la actual; si no hubo petición, las dos más recientes. La vista Documento muestra el documento con formato con lo añadido subrayado sobre fondo verde y marcado «+», y lo quitado tachado sobre fondo rojo y marcado «−», por bloques (párrafos, tablas, listas). La vista Texto muestra el Markdown con el mismo diff de Cambios. Un documento de más de 1 MB se compara solo en vista Texto.
• Anotaciones. Si enviaste anotaciones desde Revisar en ese documento, la barra dice «2 de 5 atendidas» y el margen (a la derecha con el visor ancho, debajo y plegable si es estrecho) lista cada anotación con Atendida (su fragmento cambió entre las dos versiones) o Pendiente (sigue igual).
• Funciona igual en proyectos con git y sin git.

Cambios. Encima del visor hay dos pestañas: Documento (todo lo anterior) y Cambios (n), con los archivos del proyecto que cambiaron:

• Este turno | Sprint. «Este turno» es lo que cambió desde tu último mensaje al rol (toda su respuesta); «Sprint», desde el primer turno del sprint (los chats de las fases de un mismo sprint cuentan juntos). La app guarda una instantánea del proyecto al enviar cada mensaje: con git, en un índice propio que no toca el tuyo; sin git, en .team-ai-console/snapshots/. La carpeta .team-ai-console/ no cuenta.
• Lista de archivos. «8 archivos · +142 −37» y una fila por archivo con A (añadido), M (modificado) o B (borrado), la ruta y sus líneas añadidas y quitadas. Los binarios y los de más de 1 MB se listan con «sin diff». Con las flechas ↑/↓ pasas de un archivo a otro.
• Diff. Unificada (dos números de línea y +/−) o Lado a lado (antes | después; solo con el visor de 640 px o más). Tres líneas de contexto por cambio; el resto se pliega en «Mostrar n líneas sin cambios».
• Comentar y Pedir cambios. Pulsa el número de una línea (o pulsa uno y Mayús+pulsa otro, o Mayús+↑/↓, para un rango; Esc cancela), escribe y elige Comentar (una observación o pregunta, sin editar) o Pedir cambios (el rol debe corregir esas líneas). La anotación queda bajo las líneas con Editar y Borrar. Enviar al rol (n) manda al chat del rol activo un mensaje con, por anotación, el archivo, las líneas, el fragmento citado, el tipo y tu texto; es texto normal, así que funciona igual con Claude Code y con Codex. Al terminar el turno cada anotación queda Atendida (sus líneas ya no están igual) o Pendiente; las pendientes se vuelven a enviar con las nuevas. Las anotaciones de Cambios se guardan en la app, solo para ti.
• Abrir en GitHub / GitLab. Con un remoto de GitHub o GitLab, el enlace abre la comparación de la rama con la de integración en el navegador; con la rama sin subir sale desactivado («Sube la rama para abrirlo»). Sin remoto (o con otro proveedor) no aparece.
• Desde el gate. Cuando el panel de preguntas trae la pregunta del paso de implementación o del de aceptación y hay archivos cambiados, su contexto muestra «8 archivos cambiados · Ver cambios»: abre el visor en Cambios y el panel de preguntas se queda donde está.

El chat

Empezar. En un chat vacío, la app indica el paso actual del flujo (“Empieza por aquí” o “Sigue con el flujo”) y el rol a cargo, con el botón Activar {rol}. También puedes escribir tu idea directamente o activar un rol escribiendo “Cambiar a: {rol}” (en inglés, “Switch to: {rol}”).

Escribir. Intro envía; Mayús+Intro salta de línea. Encima del cuadro de texto está la píldora del rol activo (o “Sin rol activo”) y los botones rápidos del equipo. Cada mensaje tuyo muestra a qué rol iba dirigido.

Dictar por voz. En macOS y Windows, a la derecha del cuadro de texto (antes de Enviar) hay un botón de micrófono. Un clic empieza a dictar: el botón se pone rojo, con un cuadrado de «detener» y un halo que late, y el cuadro dice «Escuchando… habla ahora». Lo que dices va apareciendo en vivo al final de lo que ya habías escrito; otro clic termina. El texto dictado se edita como cualquier otro y nunca se envía solo: sale cuando pulsas Enviar o Intro (si lo haces con el dictado activo, se envía lo que ya se ve). Si escribes, pegas o borras mientras dictas, el dictado se detiene y se conserva tu cambio. El dictado usa el idioma de la interfaz (español o inglés) y el reconocimiento de voz del sistema, en tu equipo: no usa claves ni servicios externos. En macOS funciona sin conexión si el sistema tiene ese idioma instalado para el dictado; en Windows usa el reconocimiento de voz de Windows (puede requerir activar «Reconocimiento de voz en línea» en Configuración › Privacidad › Voz). La primera vez, el sistema pide permiso para el micrófono y el reconocimiento de voz. Si falta el permiso o el dictado no está disponible (sin reconocimiento para el idioma, desactivado o sin micrófono), aparece un aviso encima del cuadro que explica qué falta; el chat sigue funcionando y el aviso se cierra con ×. El micrófono está en el chat del agente y en el chat «Aparte» (no en el editor de roles ni en otros campos) y no aparece en Linux. Nota: el dictado del propio sistema (pulsar dos veces fn en macOS, Win+H en Windows) también funciona en el cuadro del chat.

Lo que ves mientras trabaja el agente:

• El texto de la respuesta en tiempo real.
• La actividad de las herramientas del agente (leer, escribir, ejecutar comandos…), cada una con su estado: en curso, en segundo plano, terminada o error, y el tiempo que lleva.
• Detener (botón rojo) interrumpe el turno en curso.

Qué hacer ahora. Cuando el agente no está trabajando, una barra encima del cuadro de texto siempre dice qué puedes hacer:

• “{Rol} está activo: escribe en el chat para continuar.”
• “{Rol} espera tu respuesta: escríbela en el chat.” (si su último mensaje es una pregunta)
• “Siguiente paso del flujo: «{paso}», a cargo de {rol}.” con el botón Activar {rol} (si no hay ningún rol activo)
• La propuesta del rol que acaba de terminar (ver abajo), si la hay.

Cuando un rol se activa por su cuenta (por ejemplo, el rol inicial al abrir un chat nuevo) y lo anuncia con “Cambiar a: {rol}” al principio de su mensaje, la app lo marca como rol activo. Nunca se propone cambiar al rol que ya está activo.

Sugerencias del rol. Cuando un rol termina, propone el siguiente: aparece un aviso “El rol propone continuar con {rol}” con el botón Cambiar a: {rol}. Si el rol propone abrir un chat con el mismo nombre que el actual (por ejemplo, el Sprint 0 se hizo en un chat ya llamado «Sprint 1 - …»), la app no abre otro: muestra “El rol propuso abrir «{nombre}», que es este mismo chat” con el botón Continuar aquí, que lleva el flujo al primer paso del ciclo siguiente y se lo dice al rol. Si el paso siguiente es del mismo rol, el rol se propone a sí mismo y la app muestra “{rol} propone seguir con su paso siguiente” con el botón Continuar: {rol}, que le pide seguir en el mismo chat. También puede proponer un chat nuevo (por ejemplo, al empezar un sprint), con un botón para crearlo. El agente sabe en qué chat está: si propone el chat en el que ya estás, la app no lo muestra. Cuenta como el chat actual también el mismo sprint sin la fase: en «Sprint 7 - Pagos · Construir», una propuesta de «Sprint 7 - Pagos» (o de «Sprint 7 - …» con otro título) no muestra botón; «Sprint 7 - Pagos · Probar» sí, porque es otro chat. Continuar aquí solo aparece cuando el flujo está en su último paso, donde lleva al ciclo siguiente; a mitad del sprint la propuesta se ignora.

Chats por fase. Las fases del flujo marcadas con newChat (en los equipos de la app: Sprint 0, Definición y Diseño en Orión; todas las fases en Vela y en Andrómeda) empiezan en un chat nuevo. El contexto de la fase anterior ya está en los documentos: un chat largo hace que el agente repase en cada llamada todo lo que contiene, y eso es lo que más consume. Por defecto la app lo hace sola, sin pedirte nada:

• Cuando un rol termina y propone pasar a otro cuyo paso abre una de esas fases, el cambio se hace en un chat nuevo: la app lo abre con el nombre del chat actual más la fase (por ejemplo, “Brújula · Construir”) y activa en él el rol propuesto. Lo mismo si el paso llega por una marca del agente, por un salto o, en colaboración, con el turno; en ese caso el chat se abre en cuanto termina el turno en curso y es tu turno.
• Cuando el chat ya pesa (40 turnos, o unos 120 000 tokens o más repasados en cada llamada), cualquier cambio de fase abre también un chat nuevo, aunque la fase no esté marcada. Entre fases nunca interrumpe.
• El chat anterior queda en la lista con una nota de en qué chat sigue la fase, y el nuevo empieza con una nota de dónde viene. Los nombres no se repiten: la segunda vez en la misma fase es “… · Construir 2”.
• Un chat recién abierto nunca se parte en su primer turno, y un rol que acabas de activar tú en el chat (“Cambiar a: {rol}”) sigue trabajando en él.

Si prefieres decidirlo tú, desactiva Chats por fase automáticos en el menú del agente: la app vuelve a proponer el chat en la barra (“La fase «{fase}» empieza en un chat nuevo: {nombre}”) con el botón para crearlo, y a mostrar el aviso de contexto (“Este chat lleva {N} turnos y el agente repasa unos {X} tokens en cada llamada…”) cuando el chat pesa.

Estado del flujo para el agente. Con cada mensaje tuyo, cuando cambia, la app antepone (sin que se vea en el chat) una línea [Estado del flujo] con el paso actual y su id, la fase, el rol activo y el último documento escrito. Así el agente sabe dónde está sin releer documentos y marca el paso correcto.

Preguntas del rol. Cuando un rol necesita una decisión tuya, aparece el panel “El rol necesita tu decisión” con opciones cerradas (a veces se puede elegir más de una). Es un panel flotante: no oscurece la ventana, el chat de detrás sigue visible y puedes desplazarlo para releer lo anterior. Se mueve arrastrando su cabecera (el asa ⋮⋮), o con las flechas del teclado con el foco en ella (con Mayús, más rápido); no puede salir de la ventana. Es apaisado (unos 860 px de ancho, menos en ventanas estrechas; si el contenido es largo, no pasa del 60 % del alto y se desplaza por dentro) y cada pregunta sale centrada en la ventana, sin recordar dónde moviste la anterior. Encima de las opciones, el panel muestra de dónde viene la pregunta: el Rol, el Paso del flujo («4 de 12 · …») y el último Documento escrito, y el Último mensaje del agente antes de la pregunta, con su formato y su propio scroll si es largo; lo que la app no conoce no se muestra. Puedes elegir una opción o pulsar Responder en el chat para contestar libremente. Eso vale solo para esa pregunta: la siguiente con opciones vuelve a salir en el panel. Si respondes en el chat, el agente repite la pregunta con las alternativas en una lista numerada (una por línea) y puedes contestar solo con el número, por ejemplo «2».

Revisión de criterios. Si la pregunta llega en un gate con criterios de aceptación (ver El editor de equipos), el panel muestra encima de la pregunta el bloque Revisión de criterios, con «Revisor: {rol}» o «Revisor: agente del proyecto». Primero dice «⟳ Revisando criterios…»: la app lanza, una vez por pregunta, una sesión aparte, sin interfaz y de solo lectura con el mismo agente del proyecto (Claude Code o Codex), que lee el último entregable y no modifica ningún archivo. Al terminar, cada criterio sale con ✓ Cumple, ✗ No cumple o ? No comprobable y un motivo corto, y un resumen («2 cumplen, 1 no cumple, 0 no comprobables»). Si hay algún ✗ y una de las opciones coincide con una salida del gate que vuelve atrás (por ejemplo «Hay un problema»), esa opción se destaca con «La revisión sugiere esta salida»; si no hay coincidencia, no se destaca nada. Si la revisión falla o pasan 3 minutos, aparece «⚠ No se pudo revisar: … Puedes decidir igual.»; si la respuesta no se entiende, todos los criterios salen «No comprobable» con el aviso «respuesta no legible». Los botones funcionan siempre, también mientras se revisa: la revisión orienta, decides tú. Si contestas antes de que termine, se cancela. Un gate sin criterios se ve como siempre. Con la delegación activa no hay revisión aparte en los gates que decide el rol delegado (ver el capítulo 9); en los pasos reservados, sí.

Permisos. Cuando el agente quiere escribir o editar un archivo, ejecutar un comando o usar otra herramienta, se abre el diálogo Permiso: {qué} con el detalle (por ejemplo, el cambio en el archivo, con las líneas que quita y añade). Opciones: Permitir, Permitir siempre ({herramienta}) (no vuelve a preguntar por esa herramienta en esta sesión) o Denegar. Si hay varios permisos pendientes, se indica “+N en cola”. El modo de permisos del menú del agente cambia cuándo pregunta:

• 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).

Delegar en un rol. Si no quieres estar en cada confirmación, puedes delegar tus responsabilidades en un rol del equipo con el chip 🤝 Delegar de la barra superior. Cómo funcionan los tres modos, qué no delega el rol, cuándo se detiene el avance automático y dónde queda cada decisión se explica en el capítulo 9.

Adjuntar documento. Copia un documento (visión, PRD, brief, imagen…) en la carpeta de adjuntos del proyecto (normalmente docs/reference/) y se lo menciona al rol para que lo lea.

Registro. Abre el registro del proceso: sesión del agente, modelo, herramientas usadas, tiempos, errores y cuándo se enviaron cambios al remoto.

Chats. El selector de chats (con el nombre del chat actual) permite cambiar de chat, renombrarlo, borrarlo (lo quita de la app; la sesión del agente sigue en disco) y crear + Chat nuevo. Al crear un chat eliges su nombre (la app propone uno) y, opcionalmente, un rol que se activa al abrirlo. Cada chat es una sesión independiente del agente, con su historial y su rol activo, y se reanuda al volver a abrir la app. El selector se desactiva mientras hay un turno en curso. La cabecera del menú, con Nuevo chat, queda siempre arriba y a la vista; la lista de chats, del más reciente al más antiguo, se desplaza por dentro y el menú nunca sale de la ventana, aunque haya muchos chats o la ventana sea baja.

Aparte. El botón Aparte, a la derecha del selector de chats, abre un menú «¿Con quién quieres hablar?» con los roles del equipo y El modelo (sin rol, solo con el contexto del proyecto). Funciona con Claude Code y con Codex: habla con el motor y el modelo del proyecto. Al elegir uno se abre una ventana del sistema independiente (con su barra de título; la puedes arrastrar, también a otro monitor) mientras el sprint sigue en su chat:

• Una ventana por proyecto e interlocutor, y puede haber varias a la vez (hasta 8 conversaciones en toda la app; con más, el menú dice “Hay demasiadas conversaciones abiertas; descarta alguna.”). Volver a elegir el mismo interlocutor trae al frente su ventana. En el menú, cada fila marca Abierta u Oculta si esa conversación ya existe.
• El título de la ventana y su cabecera dicen quién es: “Aparte · {rol} · {proyecto} · {equipo} · Sprint N · {motor} · {modelo} · {idioma}” (el motor es Claude Code o Codex; el idioma es el del equipo). La línea de información de la ventana dice “Proyecto … · Equipo … · Sprint N · Motor … · Modelo … · Idioma …”.
• Responde aunque un rol esté trabajando en el sprint (la ventana lo indica con “El sprint sigue trabajando”), y lo que escribes ahí no cambia el paso del flujo, el rol activo ni muestra propuestas de “Cambiar a:” o de chat nuevo.
• Solo puede leer archivos del proyecto: no escribe código ni documentos y no te pide permisos. No hay opción para cambiarlo. Con Claude Code, además, no ejecuta comandos.
• Con Codex, la solo lectura la pone el propio Codex (trabaja en un entorno de solo lectura, sin pedir aprobaciones): no puede crear, cambiar ni borrar archivos aunque se lo pidas. Para leer el proyecto ejecuta comandos de solo lectura (ls, cat, rg…), que se ven como filas de herramienta en la conversación; un comando que intente escribir falla. La búsqueda web está desactivada. Si tienes servidores MCP configurados en tu Codex (~/.codex/config.toml), Codex podría usarlos desde «Aparte» y esos funcionan fuera de la solo lectura; la app rechaza los que piden aprobación, pero no puede impedir uno que no la pida (con la configuración por defecto de Codex no hay ninguno).
• Si el motor del proyecto no está instalado, la ventana dice “{motor} no está instalado o la app no lo encuentra. Instálalo o indica su ruta en Inicio → Agentes y vuelve a enviar el mensaje.”; si no tiene la sesión iniciada, “{motor} no tiene la sesión iniciada o la sesión caducó. Inicia sesión con el botón Iniciar sesión de la barra superior de la ventana del proyecto y vuelve a enviar el mensaje.”; con otro error, “No se pudo responder: {motivo}”. En todos los casos puedes volver a enviar.
• Si cambias el agente del proyecto con una conversación «Aparte» abierta, el siguiente mensaje empieza una conversación nueva con el otro motor.
• Adjuntar evidencias (una captura de un error, un log): el botón Adjuntar archivo, a la derecha de la fila de debajo de los mensajes, abre el selector del sistema (puedes elegir varios); también puedes pegar una captura en el campo de texto con ⌘V (Ctrl+V en Windows y Linux); si el portapapeles solo trae texto, se pega el texto como siempre. Se aceptan imágenes (png, jpg, gif, webp) y texto o log (txt, log, md, json, csv, yaml, xml), hasta 10 MB por archivo y 5 archivos por mensaje. Los adjuntos aparecen encima de esa fila, con su miniatura (o 🖼/📄) y su nombre; ✕ quita uno. Debajo, un aviso recuerda que los archivos se guardan en el proyecto (docs/backlog/evidence/) y pueden acabar en git: no adjuntes contraseñas ni datos personales. Si un archivo no es de un tipo aceptado, pesa demasiado, ya hay 5 en la fila o no se puede copiar, un mensaje dice por qué y la conversación sigue. Puedes enviar solo con adjuntos, sin texto. El mensaje enviado muestra “📎 Adjuntos: …” y el agente los lee. Si la conversación acaba en una petición guardada, el elemento del backlog los enlaza en una sección Evidencias y el mensaje dice “Guardada «título» en … con n archivo(s) de evidencia en …”; los que envíes después de guardar la misma petición se añaden a esa sección. Los archivos que no acaban en una petición se borran del proyecto al pulsar Descartar o al salir de la app (cerrar la ventana no borra nada). Necesita la función de la licencia Adjuntar documentos, como Adjuntar documento del chat del sprint: sin ella, el botón sale con 🔒 y pegar una imagen no la adjunta.
• Dictar por voz: el cuadro de escribir tiene el mismo botón de micrófono que el chat del agente, entre el cuadro y Enviar, con el mismo funcionamiento, avisos y permisos (ver Dictar por voz en el capítulo del chat). Además, pegar un archivo o cerrar la ventana detiene el dictado; al volver a abrirla, el micrófono está parado. Se dicta en una sola ventana a la vez: si empiezas a dictar en otra, la anterior se detiene y conserva lo que ya había escrito.
• No todo tiene que ir al backlog: puedes usar «Aparte» solo para aclarar dudas. Cuando la conversación llega a una decisión o un deseo claro, el agente te pregunta si lo guarda como petición y no la redacta hasta que digas que sí; si dices que no, no guarda nada ni vuelve a preguntar por lo mismo (solo si planteas algo distinto). Si le pides guardarla, o pulsas Guardar como petición, la redacta sin preguntar.
• Guardar como petición (o pedírselo al agente en la conversación) redacta lo hablado y la app lo guarda como elemento pendiente del backlog del proyecto, en docs/backlog/bk-AAAAMMDD-{nombre}.md (tipo —feature, cambio o bug, que propone el agente—, estado, fecha, origen y la petición: problema, decisión o deseo, criterios en borrador y resumen de la conversación), y actualiza el índice docs/backlog/index.md. Ya no escribe en docs/reference/ ni en docs/request-log.md. El mensaje “Guardada «título» en …” dice el título y la ruta. Si el agente redacta varias peticiones en una misma respuesta, la app las guarda todas, una tras otra y en el orden de la respuesta, cada una en su propio elemento del backlog y con su mensaje “Guardada «título» en …”; si alguna no se puede guardar, su mensaje “No se pudo guardar «título»: …” da el motivo y las demás se guardan igualmente (las evidencias adjuntas quedan en la primera que se guarda). El agente recibe la lista de todas las guardadas, para que no las vuelva a redactar. Si pulsaste el botón y el agente respondió sin redactarla, un aviso lo dice y el botón sigue disponible para reintentar; si falla el guardado (disco, permisos), el aviso da el motivo real. Puedes guardar varias en la misma conversación, una entrada por decisión; nunca se sobrescribe una existente. Si vuelves a guardar la misma petición (mismo título y cuerpo) en esa conversación —por ejemplo, pedirla en el chat y después pulsar el botón—, no se crea otra entrada y el mensaje “La petición «título» ya estaba guardada en …” dice dónde está. «Descartar» olvida lo guardado en la conversación.
• Lo que guardas aparece en la vista Backlog (ver abajo) y el rol que inicia el siguiente sprint te lo propone.
• La conversación se conserva mientras la app esté abierta: cerrar la ventana (botón del sistema o ⌘W) la oculta sin preguntar, y también se ocultan al dejar el proyecto; al elegir de nuevo el interlocutor, la conversación sigue donde estaba. Una ventana en la que no escribiste nada se cierra del todo. Descartar borra la conversación sin pedir confirmación (las peticiones ya guardadas se conservan, con sus evidencias; los archivos adjuntados que no acabaron en una petición se borran). Al salir de la app no queda nada.
• En la pantalla de Proyectos, si hay conversaciones, aparece el botón Aparte (n): su menú lista “{rol} · {proyecto}” y trae la ventana al frente, aunque el proyecto esté cerrado.
• Su consumo se cuenta aparte, con el motor del proyecto (ver Consumo de la IA).

Backlog. La opción Backlog del selector de vista de la barra superior abre las peticiones del proyecto guardadas en docs/backlog/; para volver al chat, elige Chat en el selector.

• Una lista con título, tipo y estado (pendiente, en sprint N o hecho) y fecha de creación (los elementos nuevos llevan también la hora, AAAA-MM-DD HH:mm; los antiguos, solo el día). El filtro En sprint · Pendientes · Hechos · Todos la acota y En sprint está marcado al abrir, con el primer elemento de la lista seleccionado. A la derecha de los filtros, el botón Fecha ↑ / ↓ ordena la lista por fecha y hora de creación: al abrir va de los más antiguos a los más recientes (Fecha ↑) y al pulsarlo se invierte (Fecha ↓); no agrupa por estado, el filtro no cambia la dirección y, al cerrar y reabrir el backlog, vuelve a En sprint y Fecha ↑. Los elementos de un mismo día sin hora se ordenan por su id. Las flechas ↑↓ recorren la lista.
• En la cabecera, Hablar aparte para añadir algo nuevo abre el mismo menú «¿Con quién quieres hablar?» que el botón Aparte del chat. Si la conversación con ese interlocutor es nueva, la ventana empieza con “Cuéntame qué quieres añadir al backlog.”; si ya existía, se muestra tal como estaba. La petición que guardes aparece en la lista sin salir del backlog. Se ve también con el backlog vacío y funciona con Claude Code y con Codex, como el botón Aparte.
• Al elegir un elemento ves su contenido en solo lectura, su origen y su ruta; Abrir en documentos lo muestra en el visor.
• Los pendientes tienen Iniciar sprint con esto: abre el chat «Sprint N+1 - {título}» (o usa el chat actual si está vacío), activa el rol que inicia el sprint y le envía la petición; el elemento pasa a en sprint N+1 y el rol no te pregunta por el backlog. El botón está deshabilitado, con el motivo debajo, si hay un sprint en curso (“Hay un sprint en curso. Termínalo antes de iniciar otro.”), mientras el agente responde o si el equipo no tiene flujo. En colaboración solo aparece en la máquina que tiene el turno.
• Para iniciar un sprint con varios pendientes, márcalos con la casilla que tiene cada pendiente a la izquierda (con Tab y Espacio también; marcar no cambia el elemento del detalle). Al marcar el primero aparece sobre la lista la barra Seleccionados: N, con Iniciar sprint con los seleccionados y Quitar selección; las marcas se conservan al cambiar de filtro y un elemento que deja de estar pendiente se desmarca solo. El botón abre el chat «Sprint N+1 - {título del primero} y {k} más» (o usa el chat actual si está vacío), envía todos los elementos al rol que inicia el sprint y los pasa a en sprint N+1. Tiene los mismos bloqueos y la misma licencia que Iniciar sprint con esto: con un sprint en curso puedes marcar, pero el botón queda deshabilitado con el motivo arriba del panel.
• Todos los elementos tienen el selector Estado (Pendiente, En sprint, Hecho), entre Iniciar sprint con esto y Eliminar, con el estado actual marcado. Puedes pasar de cualquier estado a cualquier otro: al elegir Pendiente o Hecho el cambio se aplica al momento, sin confirmación. Al elegir En sprint, aparece debajo el campo Número de sprint (con el número de sprint más alto del backlog como sugerencia): escribe un número entero mayor que 0 y pulsa Aplicar o Intro; Cancelar o Esc lo dejan como estaba. El cambio se guarda en el archivo del elemento y en docs/backlog/index.md, y la pastilla, la lista y el filtro se actualizan al instante (si el filtro activo ya no incluye el elemento, se selecciona el vecino). Un elemento hecho no ofrece Iniciar sprint con esto; si lo vuelves a pendiente, sí. Como Eliminar, necesita la función de la licencia Sprint desde el backlog (sin ella se ve con 🔒 y abre el mismo aviso).
• Todos los elementos (pendientes, en sprint o hechos) tienen Eliminar. Abre la ventana “Eliminar este elemento” con su título: Eliminar lo borra para siempre de docs/backlog/ y de su índice (no hay papelera ni deshacer en la app; si el proyecto está en git, puedes recuperarlo desde git) y se selecciona el elemento vecino; Cancelar o Esc no cambian nada. Si el elemento está en sprint N, la ventana avisa de que el sprint sigue su curso pero al aceptarlo no habrá elemento que pasar a hecho. Si el borrado falla, el motivo aparece en la propia ventana. Como Iniciar sprint con esto, en colaboración solo aparece con el turno y necesita la función de la licencia Sprint desde el backlog.
• Al empezar un sprint en un chat nuevo, la app pasa al rol inicial los pendientes del backlog (con cualquier equipo, también los de la app sin cambios): te pregunta una sola vez «¿Qué quieres incluir en este sprint?» con una ventana de selección múltiple (título y tipo de cada uno; si hay más de 4, en varias listas «Backlog 1/2», «Backlog 2/2»…, hasta 16). Puedes marcar uno o varios; si no marcas ninguno o respondes en «Otra», te pregunta qué quieres hacer y el backlog no cambia. Los elegidos pasan a en sprint N. Si eliges varios que son peticiones distintas (también desde el panel), el rol te avisa, recomienda qué entra ahora y qué dejar para sprints futuros y espera tu decisión: lo que dejas para después vuelve a pendiente. Cuando el sprint termina (el flujo llega a su último paso, el fin del sprint), la app pasa a hecho cada elemento que entró, aunque el rol no lo marque y aunque figure con otro número de sprint; si el sprint no termina (lo abandonas o vuelve a la entrevista para corregir algo), siguen en sprint N. Los elementos solo se borran con Eliminar. Con el backlog vacío no hay pregunta.
• Al abrir por primera vez un proyecto sin docs/backlog/, las filas «Futuro» abiertas de docs/request-log.md se copian una vez al backlog como pendientes (lo ya aceptado queda como historial). Sin elementos, la vista dice “Todavía no hay peticiones en el backlog…”.
• Importar issues de GitHub o GitLab. En la cabecera del backlog, el botón Importar issues… trae los issues abiertos del repositorio remoto del proyecto (origin, o el primer remoto; vale una URL HTTPS o SSH de github.com o gitlab.com) y crea un elemento pendiente por cada uno, con su título, su descripción (o “El issue no tiene descripción.”), el origen “Issue #N de {repo}” y, en el detalle, la línea Issue #N · Abrir en el navegador. El tipo sale de las etiquetas: bug es un bug, feature o enhancement es una feature y el resto es un cambio. Las pull requests y los issues cerrados no se importan. Puedes importar tantas veces como quieras: el aviso bajo la cabecera dice “{n} nuevos, {m} ya existían (de {repo}).” y nada se duplica; lo ya importado no se actualiza ni se borra aunque el issue cambie o se cierre en el remoto. Si se crea alguno y el filtro es En sprint o Hechos, pasa a Pendientes para que los veas. Cada importación trae como mucho 200 issues nuevos; si hay más, el aviso lo dice y el resto llega al volver a importar. Los repositorios públicos se leen sin credencial; para los privados, la app usa la credencial HTTPS de git que ya tengas guardada para ese host (por ejemplo, tras un push). Si falta algo, el aviso lo dice: el proyecto no es un repositorio de git, no tiene remoto, el remoto no es de github.com ni gitlab.com, el repositorio es privado o falta la credencial, el host limita las consultas o no hay red. Necesita la función de la licencia Sprint desde el backlog y, en colaboración, el turno.
• Cerrar el issue al terminar. Cuando un elemento importado pasa a hecho (al aceptar el sprint, al terminarlo o con el selector Estado), la ventana Cerrar el issue en GitHub (o “Cerrar N issues”, con una casilla por issue, si son varios) enseña el comentario que se publicará —“Resuelto en el Sprint N — {nombre}.” y, si el cierre del sprint ya está subido, su enlace— y no cierra nada hasta que pulses Cerrar issue. La app publica el comentario y después cierra el issue; si el comentario falla, el issue no se cierra y la ventana dice por qué. Ahora no (o Esc) deja el issue abierto, el detalle muestra “No se cerró desde la app” y no se vuelve a preguntar; puedes pedirlo después con Cerrar issue… en el detalle del elemento. Un issue cerrado desde la app muestra “Cerrado el {fecha}”. Cerrar necesita una credencial con permiso de escritura en el repositorio. Si hay una pregunta del rol abierta, la ventana espera a que la contestes.
• Estado del pipeline. Si el repositorio tiene GitHub Actions o GitLab CI, la pregunta del gate de aceptación (en Lyra, Prueba del usuario) muestra la franja Pipeline (CI) con el estado del último pipeline de la rama actual (En curso, Correcto, Fallido, o Cancelado u omitido), la rama, Ver pipeline y Actualizar. Es solo informativa: no cambia las opciones del gate. Sin CI, sin pipelines en esa rama o con un remoto que no es de GitHub ni GitLab, no aparece; si la consulta falla, una línea discreta dice por qué. Con la delegación activa el gate lo decide el rol delegado sin la pregunta, así que la franja no se ve.

Tareas en segundo plano. Si el agente deja tareas trabajando en segundo plano (por ejemplo, un servidor o una prueba larga), aparecen en un recuadro “Sigue en segundo plano…” con su tiempo. Cada una tiene Detener, que pide al agente que la detenga; si era la última, el rol continúa con el siguiente paso del flujo. Detener todas (con confirmación) cierra el proceso del agente y todo lo que tenía en marcha; después el rol activo sigue con el siguiente paso. Dejar de seguirlas las quita de la lista si ya terminaron y no llegó el aviso.

Saltar a un paso. El aviso “¿Quieres ir directo a otro paso del flujo?” tiene el botón Saltar a un paso…: eliges el paso de destino, ves qué pasos quedarán sin hacer y, opcionalmente, escribes el motivo. Prefiero explicarlo en el chat hace que el agente te pregunte a qué paso quieres ir. Cada salto queda registrado en .team-ai-console/workflow-log.md (en un proyecto colaborativo, en workflow-log.md de la rama de la app).

Sesión caducada. Si el agente no tiene la sesión iniciada, el chat lo avisa: usa Iniciar sesión en la barra superior y vuelve a enviar el mensaje.