5. Equipos y roles: crea tus propios roles y equipos

Además de los equipos que vienen con la app, puedes crear los tuyos: roles sueltos, que guardas en un catálogo para reutilizarlos, y equipos completos, con sus roles, su flujo y sus documentos. Todo se hace desde Equipos y roles, en la barra lateral de Inicio, con un agente que te entrevista y redacta contigo. En resumen:

1. En la pestaña Roles, crea o importa los roles que necesitas (o deja que el agente los redacte contigo).
2. En la pestaña Equipos IA, crea un equipo (vacío o copiando uno de la app), añade sus roles, define su flujo (que puede ser condicional) y redacta sus documentos.
3. Pulsa ▶ Probar el equipo para verlo trabajar en un proyecto de prueba, y expórtalo en un .tacteam para compartirlo.

Necesita una licencia con las funciones de roles y equipos (ver Licencias).

La galería de roles y equipos

Una sola pantalla con una cabecera común y tres pestañas: Equipos IA (Pestaña Equipos IA; la que se ve al entrar), Roles (Pestaña Roles) y Catálogo (El catálogo descargable). La cabecera tiene, de izquierda a derecha, el título Equipos y roles, con «Explora, crea y edita los roles y los equipos de IA.» debajo; las pestañas, cada una con su contador (cuántos equipos o roles hay en total, sin contar filtros); el buscador Buscar por nombre, uno solo para las dos pestañas (el texto se conserva al cambiar de pestaña); Importar ▾, con las entradas de la pestaña visible, y el botón principal, que cambia con la pestaña: + Nuevo equipo o + Nuevo rol. Las pestañas se cambian con un clic o con las flechas ← y → del teclado (Inicio y Fin van a la primera y a la última); cada una conserva su posición y lo que tenías abierto. Los avisos salen bajo la cabecera en una sola línea, con ✕ para cerrarlos: en verde con ✓ los de algo hecho (por ejemplo «Lyra guardado. Versión 1.0.0 → 1.1.0.»), en azul los de roles importados y en rojo los errores. Es una galería: lista los roles y los equipos con sus acciones. Al abrir el detalle o un documento de un rol, ocupa toda la pantalla (sin la cabecera) hasta que vuelves a la lista (← Roles). El enlace Todos los equipos → de Proyectos abre esta pantalla en la pestaña Equipos IA. En una ventana estrecha, la cabecera pasa a varias filas y las tarjetas bajan de 4 columnas a 3, 2 o 1.

La pantalla dedicada de un rol o un equipo

Cuando creas un rol o un equipo, o eliges editarlo (o pulsas el nombre de un equipo de la app, o Ver el equipo en su tarjeta desplegada), la ventana deja Inicio y su menú lateral y muestra una pantalla completa dedicada a ese rol o equipo, igual que al abrir un proyecto (la ventana pasa a su tamaño de trabajo y, mientras cambia, se ve «Abriendo…»):

• Arriba, la barra de la pantalla de proyecto: ← Equipos y roles, el tipo (Rol o Equipo), el nombre, la versión («v1.2.0 → v1.2.1» si hay cambios sin guardar: la versión que tendrá al guardar) y el estado con un punto de color: Listo (verde), El agente escribe…, Cambios sin guardar (naranja), Guardando…, Guardado o Cambios descartados (un momento, tras guardar o restablecer), Error (rojo) o Solo lectura (gris). En un equipo, además, su validación (✔ Completo, ⚠ N avisos o ✖ N errores; al pulsarla lleva a la pestaña Validación) y, si hay roles con versión nueva en el catálogo, «N roles con versión nueva» (lleva a la pestaña Roles). A la derecha, el agente y el modelo del editor, la sesión del agente, el idioma de la app y el tema. Nueva ventana es el primer botón de la izquierda, antes de Volver (abre otra ventana de la app en la pantalla inicial; esta sigue igual, con lo que estés editando; sin una licencia que incluya varias ventanas se ve con 🔒).
• Guardar, Cancelar y Restablecer. A la derecha de la barra, antes del idioma y del tema, el grupo Restablecer · Cancelar · Guardar, siempre visible (en una ventana estrecha, en su propia fila bajo la barra). Ningún cambio se guarda hasta que pulsas Guardar, sea del tipo que sea: el texto, los metadatos y las variantes de un rol; los datos, los roles, el flujo y los documentos de un equipo; y lo que aplica o escribe el agente del chat. Mientras haya cambios sin guardar, la barra dice Cambios sin guardar y Guardar está activo; sin cambios, está apagado («No hay cambios que guardar»). Se compara el contenido: si escribes algo y lo borras, no queda nada pendiente.
  • Guardar (o ⌘S / Ctrl+S, también con el cursor en el chat o en el texto) guarda todo de una vez y deja el editor abierto; la barra dice «Guardado» un momento. Si no se puede guardar, sale «No se pudo guardar: …» y los cambios siguen pendientes. Es lo único que sube la versión (ver Versión).
  • Restablecer pide confirmar («¿Descartar todos los cambios sin guardar y volver a lo último guardado?» · Restablecer / Conservar los cambios) y deja todo como en el último Guardar (o como al abrir, si aún no guardaste), sin cerrar el editor. Las tarjetas del chat ya aplicadas pasan a «↩ Deshecho» y el chat lo anota con una línea («Se descartaron los cambios sin guardar; …»). La conversación con el agente no se borra.
  • Cancelar sin cambios cierra el editor; con cambios pide confirmar («Hay cambios sin guardar. ¿Descartarlos y cerrar?» · Descartar y cerrar / Seguir editando) y vuelve a la galería sin guardar nada. Si el rol o el equipo es nuevo y sin lo descartado queda vacío, pregunta después Conservarlo o Borrarlo.
  • Mientras el agente escribe, Guardar y Restablecer están apagados («Espera a que el agente termine»); Cancelar sigue activo y su confirmación avisa de que el agente se detendrá.
  • Cambiar de paso, de vista o de documento dentro del editor no pregunta: los cambios siguen pendientes. Si la app se cierra de golpe, lo que no guardaste se pierde.
• Debajo, el rol o el equipo a la izquierda y el chat con el agente a la derecha, con un divisor que puedes arrastrar (o mover con las flechas). En una ventana estrecha, una mitad cada vez, con las pestañas Rol / Equipo y Chat.
• ← Equipos y roles te devuelve a la galería, en la misma pestaña y en el mismo punto de la lista, con la tarjeta del rol o del equipo señalada un momento y, si la versión subió, el aviso «… guardado. Versión … → …» (con el nombre del equipo; en un rol, «Guardado. Versión … → …»). Siempre te avisa si hay algo pendiente, en una franja bajo la barra: si el agente está escribiendo, Detener y salir o Seguir esperando; si tienes cambios sin guardar, Guardar y salir, Descartar y salir o Seguir editando (que solo cierra la franja); si el rol o el equipo que acabas de crear sigue vacío, Conservarlo o Borrarlo. Con el agente escribiendo y cambios sin guardar, Detener y salir para al agente y después pregunta qué hacer con los cambios. Sin nada pendiente, vuelve sin preguntar. Lo mismo ocurre si cierras la ventana, abres un proyecto (⌘O / Ctrl+O) o sales de la app (⌘Q) con una pantalla dedicada abierta. En las franjas, Esc equivale a Seguir editando.

El catálogo de roles (pestaña Roles)

El catálogo de roles de la app: aquí guardas roles sueltos (su documento y sus datos) para reutilizarlos, sin tener que abrir un equipo. No es lo mismo que el panel Roles de un proyecto abierto (el de los modelos por rol). El catálogo empieza vacío.

Cabecera (la común): con esta pestaña, el botón principal es + Nuevo rol y Importar ▾ ofrece Un archivo .tacrole… y Desde un equipo…. Debajo, el filtro de área como una fila de chips redondos (Todas y una por cada área de los roles del catálogo, con un punto de su color; el elegido lleva el borde oscuro y la letra en negrita) y, a la derecha, el filtro de idioma como selector segmentado (Todos los idiomas, Español, Inglés; siempre hay uno marcado) y el número de roles que se ven. Si hay muchas áreas, los chips pasan a otra línea. Si nada coincide: «Ningún rol coincide.».

Catálogo vacío: un recuadro de borde discontinuo, centrado, con un «+», «Todavía no hay roles en el catálogo», «Los roles son las piezas con las que se arman los equipos. Crea uno con el agente o impórtalo.» y los botones + Nuevo rol, Desde un archivo .tacrole y Desde un equipo.

Ficha de un rol: como la de una persona, centrada: un avatar redondo grande con las iniciales del rol, del color de su área y con un anillo del mismo color; debajo el nombre y el área (en su color); el resumen (hasta tres líneas); una línea con la versión (por ejemplo «v1.2.0»), el origen (Propio o De la app), los idiomas como dos chips de color, siempre ES (cálido) y EN (azul) en ese orden (el idioma que el rol no tiene se ve atenuado, tachado y con el borde discontinuo; al pasar el ratón dice, por ejemplo, «Inglés — no disponible») y el número de variantes si tiene más de una (al pasar el ratón, sus nombres). Debajo, una etiqueta de equipos: «Aún no está en ningún equipo» o, si tus equipos lo llevan, los iconos de esos equipos (de su categoría; hasta 3 y un «+N»), y al pasar el ratón qué equipos son y en qué versión. En el pie, Editar (solo en roles propios), Detalles y el menú ··· con Duplicar, Exportar y Borrar (en un rol de la app, Duplicar y Exportar). Detalles despliega la tarjeta a todo el ancho, como en Proyectos, sin abrir ningún editor: el área, la versión y el origen (por ejemplo «Desarrollo · v1.0.0 · Distribuido con la app»), el resumen completo, las Variantes (si tiene más de una), Se usa en con cada equipo propio que lo lleva y su versión (o «Ningún equipo propio lo usa»), la fecha del último cambio y el enlace Ver el rol completo, que abre la página del rol (igual que pulsar su nombre); Menos la vuelve a plegar. Solo hay una tarjeta desplegada a la vez: desplegar otra pliega la anterior. Una carpeta de rol que la app no puede leer aparece como «No se pudo leer «carpeta»», con el motivo y Borrar.

Ver un rol: el documento con formato, con el selector de idioma (solo los que existen) y, si el rol tiene variantes, el de Variante (se ve el texto común más el de esa variante). Al lado, el resumen, el área, el código sugerido, la fecha de modificación, el origen («Redactado en el editor», «Copia de … v…», «Extraído del equipo … v…», «Importado de un paquete», «Distribuido con la app») y en qué equipos está en uso. Abajo, las acciones: Editar, Duplicar, Exportar, Borrar y, si se actualizó desde un paquete, Restaurar la versión anterior (v…).

Editar el documento y los metadatos: Editar abre el editor del rol (ver El editor de roles con el agente, más abajo), donde cambias el documento en la vista Definición (Vista o Texto, con una comprobación en vivo en Comprobaciones: el documento necesita un título (# …), un párrafo de introducción y las nueve secciones en este orden: Descripción, Área, Identidad, Responsabilidad principal, Skills con las que debe hacer su trabajo, Qué puede hacer, Qué no puede hacer, Calidad de su trabajo y Artefactos que produce) y los metadatos en Metadatos. Ya no hay botones sueltos «Editar documento» ni «Editar metadatos».

Vista Metadatos: el nombre, el área y el resumen en cada idioma del rol; el código que se sugiere a los equipos; las variantes (añadir, quitar, nombrar; la estándar no se quita; dentro del documento, el texto de una variante va entre <!-- variant: id --> y <!-- /variant -->), y la versión: cambiar los metadatos no la sube, salvo que marques Fijar la versión a mano y escribas otra (formato x.y.z; si es menor que la actual, te avisa). No tiene botón Guardar propio: lo que escribes queda pendiente hasta el Guardar del editor. Si un campo no es válido (por ejemplo, un nombre vacío), te lo marca y no deja seguir hasta corregirlo.

Nuevo rol: abre un diálogo con un «+», el título Nuevo rol y «Empieza por lo básico. El agente te ayudará a definir el resto en el editor.» (× lo cierra, igual que Cancelar y Esc). Pide el Nombre (obligatorio); debajo se ve el Identificador que sale del nombre, con Editar para cambiarlo a mano (si tiene un formato inválido o ya existe, el campo se abre solo con el aviso). El Área (obligatoria) se elige entre chips: Producto, Análisis, Diseño, Arquitectura, Implementación, Calidad, Operaciones, las áreas que ya hay en el catálogo y Otra, que abre un campo para escribirla. Después, el Idioma inicial (Español o English; «Podrás traducirlo después.») y Para qué equipos sirve (opcional: solo lo usa el agente para adaptar sus preguntas; no se guarda en el rol). En el pie, «Siguiente: 9 pasos con el agente», Cancelar y Crear y abrir el editor →, atenuado hasta que hay nombre, identificador válido y área. Al crearlo, el rol queda en la versión 1.0.0, con el título y las nueve secciones vacías, y se abre su pantalla dedicada con el agente.

El editor de roles con el agente

Editar abre la pantalla dedicada del rol (ver La pantalla dedicada de un rol o un equipo), en tres columnas: a la izquierda el panel de pasos, en el centro el documento y a la derecha el chat (puedes ajustar el ancho del chat arrastrando el divisor, o con las flechas del teclado; empieza en 430 px). Arriba, la barra del rol: Nueva ventana (abre otra ventana; sin una licencia que incluya varias ventanas se ve con 🔒), ‹ Equipos y roles, el nombre del rol con sus insignias y, debajo, el estado del guardado («Cambios sin guardar», «Guardando…», «Guardado», «Cambios descartados», «El agente está escribiendo…» o «Solo lectura») y la versión («v1.2.0», o «v1.2.0 → v1.2.1» si subirá al guardar); a la derecha, el idioma del documento (un par pequeño ES | EN, como el de la app: el elegido va en color de acento y el idioma que el rol aún no tiene aparece atenuado y tachado, sin poder elegirse; al pasar el ratón dice «Traducir a …»), que se repite dentro del área del documento, a la derecha de la ruta del archivo (es el mismo selector: elegir un idioma en uno lo elige en el otro), Traducir a inglés / Traducir a español (o Volver a traducir a … si el otro idioma ya existe), la sesión del agente, el idioma de la app y el tema, con el grupo Restablecer · Cancelar · Guardar delante (ver La pantalla dedicada de un rol o un equipo). Lo que escribes queda pendiente hasta Guardar (⌘S / Ctrl+S); ya no se guarda solo.

• A la izquierda, el panel de pasos dice por dónde va la definición del rol: «Definición del rol», «N de 9» con una barra (cuenta las secciones cerradas) y las nueve secciones del idioma que estás viendo, numeradas: ✓ verde cerrada (con Está bien así, o porque ya tenía contenido al abrir el editor o llegó con una traducción o una variante), azul con su número y en negrita la en curso (la primera sin cerrar, la que toca ahora), círculo ámbar la redactada sin cerrar (tiene contenido pero no se ha cerrado), círculo vacío la vacía y rojo «!» si falta el encabezado. Lo cerrado vale para la sesión: no se guarda en el rol, y al volver a abrir el editor cuenta como cerrado todo lo que tiene contenido. Pulsa un paso para ir a su sección: queda marcado (fondo azul) y el documento se desplaza hasta su tarjeta (en Texto, el cursor se pone en el encabezado de esa sección). Elegir un paso no cambia la sección en curso ni envía nada al agente; si estás en otra vista, vuelve a Definición y lleva el documento a ese paso. Al pie, bajo una línea, cuatro vistas que se abren de la misma forma, una a la vez, en el centro (la elegida queda marcada con fondo azul): Definición (el documento; es la que se ve al abrir el editor), Metadatos (el formulario de siempre, con la versión, que se puede fijar a mano), Variantes (cada una con cuántos bloques tiene en el idioma visible, Añadir variante y Quitar) y Comprobaciones, con una insignia con el número de comprobaciones pendientes (ámbar; roja si hay algún error). Cambiar de vista no pierde nada: el documento, la elección Vista/Texto y la conversación se conservan. El panel se actualiza solo al terminar cada turno del agente, al editar a mano, al aplicar una propuesta y al cambiar de idioma.
• En el centro, la vista elegida. En Definición, el documento: arriba, el conmutador Vista / Texto (las flechas izquierda y derecha cambian de opción), la ruta del archivo (por ejemplo es/full-stack-developer.md) y, si hace falta, un aviso ámbar: «N secciones vacías» (vacías o sin encabezado) o, si no hay ninguna pero sí comprobaciones, «N comprobaciones» (al pulsarlo, abre la vista Comprobaciones). Con Vista (la elegida al abrir el editor) ves el título y la introducción del rol y una tarjeta por cada sección, con su número (01…09), su título, una etiqueta Listo, En curso, Sin cerrar, Pendiente o Falta el encabezado, y su texto (o «Se completará cuando lleguéis a este punto en el chat» si está vacía); la tarjeta en curso tiene un fondo azul suave y la elegida en el panel, un borde azul. Lo que el documento tenga fuera de las nueve secciones se ve tal cual, sin tarjeta. Con Texto ves el Markdown, que puedes editar a mano: queda pendiente hasta Guardar, y la vista lo refleja al volver a ella. Antes de cada mensaje al agente, lo escrito a mano pasa a lo que el agente ve, aunque siga sin guardar. Mientras el agente trabaja, el documento queda de solo lectura y, al terminar, muestra lo que escribió. Metadatos, Variantes y Comprobaciones ocupan todo el centro, bajo su título. Comprobaciones muestra «Comprobaciones: N errores, M avisos» o «Todo en orden.» y la lista: las de la estructura del documento y las de las variantes (una variante que el documento usa y el rol no declara, o un marcador sin cerrar, es un error; una variante declarada sin ningún bloque, un aviso), con el idioma de cada una si el rol tiene varios. Los errores informan, pero no impiden cerrar.
• A la derecha, el chat con el agente. Arriba, «Asistente» con el botón del agente y el modelo («Claude Code · Por defecto ▾»), la insignia «Chat en ES» y Nueva conversación (borra la conversación de ese rol, pide confirmación; el documento no cambia; el agente y el modelo elegidos se mantienen). Elegir el agente: el botón abre un pequeño desplegable; arriba, Agente, con Claude Code y Codex (el que no está instalado sale como «… (no instalado)» y no se puede elegir). Cambiar de agente empieza una conversación nueva: si ya hay conversación, el chat pide confirmarlo («Cambiar a {agente} empieza una conversación nueva: se borrará la de ahora. El documento no cambia.» · Cambiar a {agente} / Cancelar). El agente elegido vale para todos los roles (y, en el editor de equipos, para todos los equipos), y cada agente recuerda su propio modelo. Mientras el agente trabaja no se puede cambiar. Elegir el modelo: debajo, Modelo, igual que en los ajustes de un proyecto: Por defecto (el del agente; lo dice «Modelo por defecto del agente.»), con Claude Code Fable, Opus, Sonnet y Haiku, y Otro… para escribir el id o alias de un modelo; debajo, «usando {modelo}» con el que informó el agente. El cambio se aplica al siguiente mensaje, no a la respuesta en curso. La elección se recuerda al cerrar el editor y al reiniciar la app: una para todos los roles y otra para todos los equipos. Si tu plan no incluye el modelo elegido, sale el aviso de los proyectos con Usar {otro} y Elegir otro…; después de cambiarlo, vuelve a enviar tu mensaje. El agente conversa en el idioma principal del rol (el primero de sus idiomas), aunque la app esté en otro idioma o estés editando la versión del otro idioma; «Chat en ES/EN» lo recuerda. Los avisos y botones de la app siguen en el idioma de la app. El agente entrevista (en un rol nuevo empieza él) y pregunta por lo que está en rojo en las comprobaciones.
  • Preguntas. Sus preguntas abiertas van numeradas (1., 2.…) y puedes responder por número («1: …; 2: …»). Las preguntas cerradas (sí o no, elegir entre 2–4 opciones) aparecen como una tarjeta «Pregunta del agente» en el chat, con las mismas opciones que en los proyectos: eliges y pulsas Responder, o pulsas Responder en el chat (o simplemente escribes en el cuadro) y lo que escribas es la respuesta; la tarjeta queda con tu respuesta, «Respondida en el chat» o, si el turno se interrumpió, «Sin respuesta». El agente te guía de principio a fin: cada respuesta termina con el siguiente paso (la sección en curso y, con las nueve cerradas, el resumen, una variante, la traducción y revisar y cerrar).
  • Borradores. Cada sección se trabaja como un ciclo de mejora: describes lo que quieres y el agente te muestra en el chat un borrador de la sección (tarjeta «Borrador · {sección} (ES)», con el texto en una caja desplazable). El documento de la izquierda no cambia hasta que lo apruebas: con el botón Aplicar o escribiendo en el chat que está bien («está bien», «aplícalo»…). Si pides cambios, el agente responde con un borrador nuevo y el anterior queda «Sustituido por un borrador más nuevo». Si la sección ya tenía texto, la tarjeta avisa de que lo sustituye. Una vez aplicado («✓ Aplicado»), el agente pregunta «¿Quieres que la revise y la mejore?»; si dices que sí, te propone un borrador mejorado, tantas veces como quieras. Si pulsas Está bien así con un borrador sin aplicar, el punto se cierra con lo que ya tenía el documento y el borrador queda «Sin aplicar».
  • Investigación online: cada vez que pides proponer una sección, el agente busca antes en la web cómo se define hoy ese rol en el mercado (en el chat ves la línea «Búsqueda web» con la consulta), lo dice en su mensaje y la tarjeta lista las fuentes en Basado en (hasta 5, con enlace que se abre en el navegador). Si no pudo investigar, la tarjeta lo avisa y el borrador se basa en lo que sabe el agente. Un cambio que pides sobre un borrador ya investigado no repite la búsqueda. La búsqueda web solo la tiene el agente del editor de roles.
  • Skills instalables (sección «Skills»). Al proponer la sección Skills, el agente busca además en los marketplaces de skills de Claude Code (plugins y skills.sh) y de Codex, y propone solo las que encajan con la descripción, el área y la responsabilidad del rol ya redactadas (si encuentra pocas o ninguna, lo dice). En su mensaje dice dónde buscó. La tarjeta del borrador muestra, debajo de las competencias, la subsección Skills instalables, con una fila por skill: el nombre, la etiqueta del agente para el que existe (Claude Code, Codex o Claude Code · Codex), una frase de qué aporta a este rol, la Fuente (marketplace y dirección, que se abre en el navegador) y, si la hay, la Equivalente para el otro agente. Al aplicarla, el documento del rol muestra la misma subsección (en inglés, Installable skills). El rol no se ata a ningún agente: el agente solo aparece en esas filas. Si no se pudieron consultar los marketplaces, la tarjeta avisa «No se pudieron consultar los marketplaces: la propuesta lleva solo las competencias.» y la sección se propone sin la subsección. Un rol anterior sin la subsección se ve igual que siempre; al volver a proponer Skills, se le añade.
  • Cerrar un punto. El punto solo se cierra con el botón Está bien así, que aparece sobre los atajos, en verde, junto a la línea «Paso N de 9 · {sección}», cuando la sección en curso ya tiene contenido (desactivado mientras el agente trabaja); escribir «vale» o «sigamos» en el chat no lo cierra. Mientras el punto está abierto, el agente habla solo de esa sección: no propone, pregunta ni escribe nada de las siguientes hasta que pulsas Está bien así (si se lo pides expresamente, sí te atiende otra sección). Cuando te pide elegir entre varias opciones (por ejemplo, qué viñetas conservar o quitar), te las da en una lista numerada y respondes con los números en el cuadro del chat («1, 3», «todas»), sin teclear las líneas. Al pulsarlo, el chat muestra «Punto «…» cerrado. Sigo con el siguiente.» y el agente pregunta por la sección siguiente (tras la novena, «… Sigo con el siguiente paso.» y sigue con el resumen). Una sección cerrada no se reabre desde la interfaz; si pides cambiarla en el chat, el agente la cambia. Si le pides otra cosa, la hace y después te pregunta si seguimos con lo que tocaba; si le dices que has terminado, no insiste.
  • Variantes y resumen. Si propone una variante o un resumen, aparece una tarjeta con un botón (Añadir variante «…», Usar este resumen (ES)); al pulsarlo se aplica, pasa a «Aplicado» y el agente sigue solo con el siguiente paso (en el chat aparece la línea «Resumen aplicado (ES). Sigo con el siguiente paso.»).
  • Atajos y envío. Sobre el cuadro de escribir, tres atajos: Proponer {sección en curso} (por ejemplo, Proponer Descripción: el agente investiga y te muestra el borrador de esa sección; el nombre cambia al cambiar la sección en curso y, con las nueve cerradas, pasa a Proponer resumen), Revisar el rol y Seguir (pide al agente que retome el guiado). Los mensajes del agente van sin burbuja y los tuyos, en burbuja. Con las nueve secciones cerradas, en lugar del paso sale el siguiente («Siguiente: …» o «Todo listo: puedes cerrar el editor.») con las sugerencias opcionales (una variante, la traducción). El botón ↑ envía (también Intro) y Parar detiene al agente mientras trabaja; si hay una pregunta del agente esperando, puedes escribir y enviar la respuesta aunque el agente esté trabajando.
  • El botón principal (Sprint 100). En cada momento solo un botón destaca, relleno de color: el que toca pulsar ahora. Con la sección en curso vacía, destaca el atajo Proponer {sección}. Cuando ya tiene contenido, la línea del paso añade «· ✓ Con contenido», destaca Está bien así (que cierra la sección y pasa a la siguiente) y el atajo pasa a ser discreto con el nombre Volver a proponer {sección}. Con las nueve secciones cerradas, sobre la línea del siguiente paso sale «✓ Las nueve secciones están cerradas»; destaca Proponer resumen mientras falte algún resumen, y después Revisar el rol si quedan comprobaciones pendientes (el atajo del resumen pasa a Volver a proponer resumen). Con todo listo, ningún botón destaca. Se calcula del contenido, también al abrir un rol que ya existe, y no se guarda nada. Mientras el agente trabaja, el botón destacado se ve atenuado y no se puede pulsar. En una ventana estrecha, el atajo destacado queda a la vista y el menú Atajos recoge los demás.
• Traducir: el agente crea el documento del otro idioma a partir del que estás viendo; cuando termina, el editor cambia a ese idioma y muestra la franja «Traducido por el agente. Revísalo.». Volver a traducir pide confirmar antes de sustituir el texto del otro idioma.
• Un solo agente: el de la conversación guardada del rol; si no hay, el que elegiste en el desplegable del asistente; y si no elegiste ninguno, el que está instalado o, con los dos instalados, el que tiene la sesión iniciada (con sesión en los dos, o sin saberlo, Claude Code). Así, si solo usas Codex, el editor trabaja con Codex aunque tengas Claude Code instalado sin cuenta. Trabaja en la carpeta del rol, sin proyecto abierto, y solo puede escribir ahí (nunca los metadatos: si los tocara, la app los deja como estaban). Si no está disponible (no instalado, sin sesión o con un fallo), el chat lo dice en un recuadro rojo con Reintentar y puedes seguir editando a mano.
• Una conversación por rol: al volver a abrir el editor de ese rol, la conversación sigue ahí.
• Rol listo: cuando las nueve secciones están cerradas, el resumen está en todos los idiomas, no quedan comprobaciones pendientes, el agente no trabaja y no hay nada sin guardar, aparece arriba, sobre el editor, una franja verde con ✓: Rol listo («Todos los pasos están completos y guardados. Puedes terminar o seguir editando.»). Sus botones: Terminar y volver al catálogo (sale como ← Equipos y roles), Ver el rol (sale igual y abre la ficha del rol en el catálogo) y Seguir editando (oculta la franja; el editor sigue abierto). Si cambias algo o el agente vuelve a trabajar, la franja se va y vuelve a salir cuando todo esté listo otra vez; también sale al abrir un rol que ya está completo. En solo lectura no aparece.
• Versión: sube al pulsar Guardar, si el documento cambió: el último número, o el del medio si cambian «Qué puede hacer», «Qué no puede hacer» o «Artefactos que produce». Se cuenta todo lo cambiado desde que abriste el editor, así que guardar varias veces no la sube más (1.2.0 → guardas un retoque: 1.2.1 → guardas además un cambio en «Qué puede hacer»: 1.3.0, no 1.3.1). Si fijaste la versión a mano, se respeta. Sin cambios, no sube; Cancelar y Restablecer no la tocan.
• Salir (← Equipos y roles): si guardaste algo, la galería lo dice: «Guardado. Versión 1.2.0 → 1.2.1.». Si el agente sigue trabajando, pregunta Detener y salir o Seguir esperando; con cambios sin guardar, Guardar y salir, Descartar y salir o Seguir editando; si un rol creado en el editor sigue vacío, Conservarlo o Borrarlo. Si la app se cierra de golpe, lo que no guardaste se descarta: al volver a abrir el rol, está como en el último Guardar.
• En una ventana estrecha, el editor muestra una parte cada vez, con las pestañas Rol y Chat (un punto en «Chat» avisa de una respuesta nueva). En la pestaña «Rol», el panel de pasos va plegado encima del documento («Definición del rol · N de 9»; al desplegarlo, los pasos y las vistas Definición, Metadatos, Variantes y Comprobaciones; al elegir una vista, se pliega) y la barra del rol ocupa dos líneas; el botón Está bien así está en la pestaña «Chat» (por debajo de 640 px ocupa todo el ancho).

Duplicar, borrar, exportar e importar roles

Duplicar: abre el diálogo Duplicar rol (con un «⧉», «Crea una copia de «…». Después puedes cambiarla con Editar.» y ×, Cancelar y Esc para cerrarlo). Pide solo el Nombre de la copia; debajo ves el Identificador que saldrá de él. Con el nombre vacío avisa «Escribe un nombre.»; si ya hay un rol con ese nombre, «Ya hay un rol con ese nombre.»; si no tiene letras ni dígitos, «El nombre debe incluir letras o dígitos.» (Duplicar queda deshabilitado hasta que sea válido). Al confirmar crea un rol propio nuevo, en la versión 1.0.0, con el nombre que escribiste en todos los idiomas y todo lo demás (documento de cada idioma, metadatos, variantes y comprobaciones) igual que el original, y recuerda de cuál salió. Se puede duplicar también un rol de la app. En el detalle de la copia aparece «Copia creada. ¿Quieres pulirla con el agente?» con Abrir con el agente y Ahora no (no se pierde nada si lo rechazas).

Borrar: pide confirmación y lista los equipos propios que lo llevan: conservan su copia, pero dejan de recibir actualizaciones. Los roles de la app no se borran.

Exportar: guarda el rol en un archivo .tacrole («id-versión.tacrole») para llevarlo a otra instalación. No pide ninguna función de la licencia.

Importar un archivo .tacrole: eliges el archivo y la app lo revisa antes de importarlo: nombre, id, versión, idiomas, variantes, origen e integridad (SHA-256). Un archivo dañado o modificado se rechaza con el motivo. Si el rol es nuevo, Importar; si ya lo tienes en una versión anterior, Actualizar (con la lista de cambios), y la versión anterior se guarda para poder restaurarla; si ya tienes esa misma versión, Reinstalar; si la tuya es más nueva, Importar igualmente; si el id lo usa un rol de la app, se importa con otro id («id-2»).

Importar desde un equipo: eliges un equipo de la app, uno de Tus equipos (con su idioma, ES o EN) o la carpeta de un proyecto, marcas los roles que quieres traer y, para cada uno, revisas lo que la app dedujo (nombre, código, área e id) y escribes un resumen de una línea, que es obligatorio. Si ya hay un rol con ese id, eliges Importar como id-2 u Omitir. El documento se copia tal cual, en el idioma del equipo. Al terminar, la app ofrece abrir cada rol importado con el agente («Abrir … con el agente», por ejemplo para revisar el resumen) o Ahora no.

Roles de la app: la app puede traer roles propios, firmados, marcados De la app: se ven, se duplican y se exportan, pero no se editan ni se borran (duplícalo para cambiarlo). La app trae ocho: Business Analyst, Documentador, Full Stack Developer, Product Owner, Project Manager, QA, Software Architect y UI/UX Designer. Sin licencia se ven y se añaden a tus equipos; duplicarlos o editarlos pide licencia, como el resto de roles. Si uno se modificó fuera de la app (su firma no coincide), su tarjeta y su detalle dicen «Este rol de la app fue modificado: su firma no coincide. Está bloqueado: no se puede añadir a un equipo ni usar. Para arreglarlo, reinstala la app.» En el paso Roles del editor de equipos su casilla queda desactivada con «⚠ Rol de la app modificado: bloqueado. Reinstala la app para arreglarlo.», y tampoco se puede actualizar desde él la copia de un equipo. Un equipo que ya lo llevaba conserva su copia y puede quitarlo.

Licencia: crear un rol nuevo, importar y duplicar piden Crear roles; editar el documento o los metadatos, abrir el editor con el agente y restaurar la versión anterior, Modificar roles; borrar, Eliminar roles. Sin la función, el botón se ve con 🔒. Ver, buscar y exportar siempre se pueden.

Los roles se guardan en la carpeta de datos de la app, en roles/<id>/ (un role.json y el documento de cada idioma); la conversación del editor de cada rol, aparte, en roles/.editor/ (no viaja en el .tacrole).

Tus equipos (pestaña Equipos IA)

Aquí se gestionan los equipos, en dos grupos: Tus equipos («Creados, importados o copiados. Puedes editarlos.») y, debajo, los Equipos de la app («Se actualizan con la app. Cópialos para modificarlos.»; firmados, solo para verlos y copiarlos). Con esta pestaña, el botón principal de la cabecera es + Nuevo equipo e Importar ▾ ofrece Un archivo .tacteam… o Una carpeta…. Debajo de la cabecera, una fila con tres controles: el selector de categoría (Todos, Asteroid, Nebula, Supernova, Galaxy, Moon y Comet, que agrupa los equipos propios; cada una con su icono), el de idioma (Todos los idiomas, Español, Inglés) y, a la derecha, el número de equipos que se ven. Los tres filtros y el buscador actúan a la vez y no se guardan: al reabrir la app vuelven a Todos. Si una categoría no tiene equipos: «No hay equipos en esta categoría.». Bajo la fila, los títulos de grupo TUS EQUIPOS y EQUIPOS DE LA APP en mayúsculas, cada uno con su descripción; un grupo sin equipos que coincidan no se muestra. Las tarjetas van hasta 4 por fila (3, 2 o 1 en una ventana estrecha).

Tarjeta de un equipo: la parte de arriba va teñida del color de su categoría (los tuyos, en violeta, como Comet): la categoría con su icono a la izquierda y la versión en la esquina derecha; el nombre en grande (hasta dos líneas) y las caras de sus roles (un círculo por rol con sus iniciales, del color de su área; hasta 5, o 4 y una cara «+N» si hay más; al pasar el ratón, sus nombres) con el número de roles. Debajo, la descripción (hasta tres líneas) y los idiomas como chips de color ES y EN (el que el equipo no tiene, atenuado, tachado y con el borde discontinuo), seguidos de «modificado hace …» si se conoce. Un equipo propio con errores lleva el borde rojo y la línea roja Tiene N errores de validación. Revisar; Revisar abre el equipo en su pestaña Validación; uno con solo avisos, la línea gris Tiene N avisos de validación.; uno sin errores ni avisos, ninguna. En el pie, tres controles: la acción principal (Editar en los tuyos, Copiar en los de la app), Detalles y el menú ···: en los tuyos, Renombrar, Copiar, Exportar, Restaurar la versión anterior (si la hay), Mostrar en carpeta y Borrar; en los de la app, Exportar. Renombrar abre el diálogo Renombrar equipo con el nombre actual: cambia solo el nombre en el idioma de la app (si el equipo no lo tiene, el del idioma que muestra la tarjeta, como dice el diálogo); los nombres en otros idiomas, el identificador, la carpeta y la versión no cambian. No admite un nombre vacío (Escribe un nombre.) ni el de otro de tus equipos, sin distinguir mayúsculas (Ya hay un equipo con ese nombre.); con el mismo nombre se cierra sin cambios, y Cancelar, × o Esc lo cierran sin cambiar nada. Al confirmar, la tarjeta muestra el nombre nuevo, se resalta y aparece el aviso Equipo renombrado a «…». El nombre nuevo se ve también en los proyectos que usan el equipo y en su pantalla. Pide la misma función de licencia que editar un equipo. Editar (o pulsar el nombre) abre la pantalla dedicada del equipo; en uno de la app, el nombre la abre en solo lectura. Detalles ya no abre el equipo: despliega la tarjeta a todo el ancho, como en Proyectos, con la categoría, la versión y el número de roles (por ejemplo «Supernova · v1.2 · 4 roles»), el resumen completo, Para qué proyectos se recomienda, los comandos rápidos del equipo como etiquetas y, en un equipo de la app, el enlace Ver el equipo; Menos la vuelve a plegar. Solo hay una tarjeta desplegada a la vez. Un equipo de la app que tu licencia no permite lleva 🔒 junto al nombre.

• Nuevo equipo: un diálogo con el mismo aspecto que Nuevo rol: arriba, un icono «+», el título, «Elige de dónde partir y ponle nombre. Después añadirás sus roles.» y × para cerrar. Punto de partida en chips, en este orden: Vacío (elegido por defecto; «Para quien ya sabe qué equipo quiere: nace sin roles ni flujo.»), Copia de un equipo de la app (debajo, «Recomendado para empezar: un equipo coherente en un minuto, que después adaptas.»; pierde la firma, pasa a ser propio y se propone el id {id}-custom, con el aviso «La copia pierde la firma y pasa a ser un equipo propio.») y Copia de uno de mis equipos (solo si tienes alguno); al elegir una copia, debajo aparece el desplegable con el equipo. Si abres el diálogo con Copiar en la tarjeta de un equipo, esa copia ya viene elegida. Después, Nombre, con el Identificador propuesto en una línea debajo y Editar para cambiarlo (si es repetido o tiene un formato no válido, el campo se abre solo con el aviso); Idioma principal (Español / English), que sale con el idioma de la app (al copiar, el de la app si el equipo tiene ese idioma; si no, el del equipo), y Resumen (una línea), marcado como Opcional, con la ayuda «Puedes completarlo después, al editar el equipo.»: con Vacío empieza vacío y al copiar se propone el del equipo de partida. Si vuelves a Vacío tras elegir una copia, el resumen se vacía y el idioma vuelve al de la app. Al pie, «Siguiente: se abre el equipo para añadir sus roles», Cancelar y Crear. Un equipo vacío nace en la versión 0.1.0, sin roles (y por eso con un error) y con el documento del flujo vacío (un aviso) hasta que los añades.
• Describir el proyecto y que la IA proponga el equipo (cuarto chip de Nuevo equipo, el último, con la pastilla Recomendado; con la licencia sin «Crear equipos» aparece con 🔒): para quien no sabe de roles ni de procesos. Al elegirlo, debajo, «Si no sabes por dónde empezar: cuenta en una línea para qué es el equipo y la IA te propone sus roles y su flujo. Lo revisas antes de crearlo.», y el formulario cambia: ¿Para qué tipo de proyectos es el equipo? (obligatorio, hasta 400 caracteres; por ejemplo «sitios web pequeños, como landing pages»); Si quieres, afina la propuesta (Opcional), con tres preguntas en chips que empiezan en No lo sé / que decida la IA: ¿Quién prueba?, ¿Quieres aprobar cada fase o solo el resultado? y ¿Hay diseño visual?; Nombre, aquí Opcional («Si lo dejas vacío, se usa el que proponga la IA.»); Idioma principal («La IA propone el equipo en este idioma.»), y el aviso «Usa {agente} y los tokens de tu cuenta; tarda un par de minutos.». No se pide resumen: lo pone la propuesta. Pedir la propuesta → comprueba primero («Comprobando el agente…») que el agente del editor de equipos —el elegido o, si no hay, el que tiene sesión— está instalado y con sesión; si no, lo dice con el motivo y ofrece Usar {otro} solo para esta propuesta, o, si no hay ninguno, «No hay ningún agente disponible…» con Volver a comprobar. Con el agente disponible, el diálogo se ensancha y muestra «La IA está preparando tu equipo», la barra de progreso, «Agente: … · modelo», el tiempo y lo último que hace (por ejemplo «Buscando en la web: …»). El agente puede buscar en la web, pero no escribe nada en disco. Cancelar (o Esc) lo detiene sin crear nada y vuelve al formulario con lo escrito. Si tarda más de 6 minutos, o su respuesta no se puede usar (por ejemplo «usa un rol del catálogo que no existe»), lo dice, con Ver detalles, Reintentar y Cancelar. Llega la vista previa Equipo propuesto («Revísalo con calma: no se crea nada hasta que pulses «Crear el equipo».»): el nombre, el resumen, «Español · N roles · N pasos · Identificador: …»; Quién hay en el equipo, cada rol con lo que hace y la etiqueta Del catálogo o ✦ Nuevo; Cómo trabaja, con el diagrama del flujo, y Cuándo te preguntará, una línea por aprobación («Tras «Entrevista» — …»). Si un equipo de la app ya encaja, un aviso lo dice con Copiar ese equipo, que vuelve al formulario con Copia de un equipo de la app y ese equipo elegidos. Pedir otro enfoque pide una línea («¿Qué quieres cambiar?») y trae una propuesta nueva que sustituye a la anterior (pastilla «Propuesta 2», «Propuesta 3»…), sin límite. Cancelar cierra sin crear nada. Crear el equipo construye el equipo completo, sin pasar por el editor. Primero pide confirmación: ¿Construir el equipo completo?, con lo que se va a escribir («La IA redactará y la app escribirá y comprobará:» los roles nuevos con sus nueve secciones, el documento del flujo, una ficha por rol, los gates y los procedimientos, las plantillas y las comprobaciones, con hasta dos correcciones automáticas), el aviso «Tarda varios minutos y gasta tokens de tu cuenta de {agente}.» con «Agente: … · modelo», y Volver (regresa a la misma propuesta sin crear nada) y Construir. Si la propuesta trae roles nuevos y tu licencia no incluye «Crear roles», Construir aparece con 🔒 y una nota lo explica. Al construir, el diálogo muestra Construyendo «…» con una barra de progreso, el agente y su modelo, el tiempo y las etapas en orden: «Roles nuevos · 1 de 2», «Documento del flujo», «Fichas de los roles · 3 de 5», «Gates y procedimientos», «Plantillas de los entregables», «Comprobaciones» y, si hace falta, «Corrigiendo · turno 1 de 2». El agente redacta y la app escribe y valida cada parte; el agente no escribe nada en disco ni busca en la web, y cada llamada tiene un máximo de 6 minutos. Seguir en segundo plano (o × o Esc: cerrar nunca cancela) cierra el diálogo y puedes seguir usando la app: en Equipos y roles la barra lateral lleva «✦» y la pestaña Equipos IA una franja «Construyendo «…»» con la etapa y el tiempo, Ver el progreso (vuelve al diálogo) y Cancelar. Mientras tanto el equipo no aparece en la lista y solo se construye uno a la vez: el chip de la IA de Nuevo equipo dice «Construyendo…» y lleva al progreso (los otros puntos de partida funcionan como siempre). Cancelar pide confirmación («Se deshace todo lo construido hasta ahora y los tokens gastados no se recuperan.»): con Cancelar la construcción se detiene el agente, se borran el equipo y los roles nuevos de ese intento y vuelves a la propuesta con el aviso «Construcción cancelada. No se ha creado nada…». Si el agente falla o tarda más de 6 minutos en una etapa, también se deshace todo y lo dice («No se pudo construir «…»»), con Ver detalles y Reintentar, que vuelve a la misma propuesta. Si todo va bien, termina en Equipo listo («Ya puedes usarlo en un proyecto.»): el nombre, el lema, «Español · N roles · N pasos · Identificador: …», los roles (los nuevos con ✦ IA), «✓ Comprobaciones: sin errores», cuánto tardó y, si las hubo, las correcciones de la IA; Listo cierra y deja el equipo señalado en la biblioteca, y Ajustar en el editor lo abre en Comprobaciones, donde el asistente sigue con el paso que de verdad falta. Si tras dos correcciones automáticas aún falla algo, termina en Quedan cosas por arreglar, con hasta cinco problemas en lenguaje llano (por ejemplo «Falta la plantilla «informe.md».») y Ajustar en el editor (el equipo se conserva) o Descartar el equipo, que pide confirmación y borra el equipo y los roles nuevos (los del catálogo que ya tenías no cambian). Si no estabas mirando, te enteras por la franja de Equipos IA (verde si está listo, ámbar si quedan cosas por arreglar, roja si no se pudo construir; Ver abre el resultado y × la oculta), por la insignia de Equipos y roles («✓» o «!») y, si la app no está en primer plano, por una notificación del sistema que, al pulsarla, abre el resultado. Si cierras la app mientras se construye, pregunta antes («Se está construyendo un equipo»): Cancelar y cerrar cancela y deshace lo construido; Seguir construyendo no cierra. Si la app se cerró de golpe, al volver a abrirla se borra lo que quedó a medias. Los roles creados así llevan la pastilla ✦ IA en su tarjeta del catálogo y ✦ Creado por la IA en su pantalla, con sus nueve secciones redactadas en el idioma del equipo; se editan como cualquier otro rol y la marca se conserva (al duplicarlo, la copia ya no la lleva). Los roles del catálogo que reutiliza el equipo no cambian. Funciona igual con Claude Code que con Codex, y cada llamada al agente (de la propuesta y de la construcción) queda en el registro de consumo del editor de equipos.

El editor de equipos: los ocho pasos

Pantalla dedicada del equipo (ver La pantalla dedicada de un rol o un equipo). Al crear un equipo se abre sola, en el paso Identidad. Tiene tres columnas, como el editor de roles: a la izquierda el menú de pasos, en el centro la vista del paso elegido y a la derecha el chat con el agente.

• Recorrido guiado con «Siguiente». Al pie de la vista de cada paso, una barra con el botón Siguiente te lleva por los pasos en este orden: Identidad → Roles → Flujo → Documento del flujo → Fichas por rol → Gates y procedimientos → Plantillas. En Plantillas el botón se llama Revisar comprobaciones y abre las comprobaciones (que quedan fuera del recorrido y no tienen barra). En Roles, mientras no haya ningún rol marcado, Siguiente está desactivado y a su izquierda se lee «Marca al menos un rol para continuar.»; mientras el agente escribe, también, con «El asistente está escribiendo…». Al pulsarlo, el menú resalta el paso nuevo y el panel lo muestra a la vez, sin preguntar: lo que tengas sin guardar en Identidad o en un documento sigue pendiente hasta Guardar. El panel sigue al chat: cuando el agente termina un turno y la línea «Siguiente: …» del chat apunta a otro paso (Identidad, Roles, Flujo o un paso pendiente; no un error, los avisos ni «Todo listo»), el menú y el panel pasan a ese paso solos, con un resaltado breve en el menú y sin quitarte el cursor del chat. No lo hace si durante ese turno cambiaste tú de paso, y sin roles no pasa de Roles. Los cambios sin guardar se conservan. El menú de pasos sigue abierto: puedes saltar a cualquier paso cuando quieras. La barra no sale en los equipos de la app (solo lectura).

• El botón principal de cada paso (Sprint 100). En cada paso solo un botón destaca, relleno de color: el que toca pulsar ahora. Mientras el paso no está completo, destaca el atajo del chat Proponer {paso} (u Orientar roles) y Siguiente es discreto. Cuando el paso está completo, a la izquierda de la barra sale un indicador («✓ Identidad definida», «✓ Roles elegidos», «✓ Flujo definido», «✓ Documento del flujo escrito», «✓ Fichas por rol escritas», «✓ Gates y procedimientos escritos» o «✓ Plantillas escritas»), destaca Siguiente (o Revisar comprobaciones) y el atajo sigue ahí, discreto, como Volver a proponer {paso} (o Volver a orientar roles). Un paso cuenta como completo cuando está en verde en el menú de pasos: lo decide la app por el contenido, también con los cambios sin guardar y al abrir un equipo que ya existe, y no se guarda nada; si borras el contenido, el indicador desaparece y vuelve a destacar la sugerencia. En Comprobaciones, Revisar el equipo destaca mientras haya errores o avisos. Mientras el agente escribe, el botón destacado se ve atenuado y no se puede pulsar.

• Menú de pasos («Definición del equipo», «N de 8»), con una barra de progreso y los ocho pasos de la definición, cada uno con su estado (número, ✓ hecho, ! con errores; en negrita el que está empezado): Identidad, Roles, Flujo, Documento del flujo, Fichas por rol, Gates y procedimientos, Plantillas y Comprobaciones (con la insignia de cuántas hay). Pulsar uno muestra su vista. Mientras el equipo no tiene roles, Flujo lleva la insignia ámbar pendiente (se puede abrir igualmente). El estado lo calcula la app con el equipo tal como está: un paso está hecho cuando lo que le corresponde existe y no tiene errores (los roles, cuando hay alguno; el flujo, cuando tiene pasos sin problemas; las fichas, cuando todas están escritas; los procedimientos, cuando los cuatro recomendados existen; la identidad, cuando tiene nombre, resumen, lema y para qué se recomienda). En ventana estrecha el menú va plegado encima del contenido.

• Identidad: nombre, lema, resumen y para qué se recomienda, por idioma; los botones rápidos del chat (uno por línea: cada uno es un botón del chat del proyecto que envía ese texto; deben coincidir con los comandos del sistema del documento del flujo); la versión.

• Roles: arriba, «Marca los roles que ya tienes y que formarán parte del equipo.» con el contador «N seleccionados», el buscador y la lista de tus roles existentes, cada uno con su casilla, sus insignias, área e idiomas, el selector de variante (si tiene más de una) y el aviso «⚠ Solo en …» si no existe en el idioma del equipo; los marcados van primero. Marcar una casilla añade el rol al equipo (queda pendiente hasta Guardar, como el resto de cambios); desmarcarla pide confirmación («¿Quitar el rol «…» del equipo?» · Quitar / Cancelar). Si algún paso del flujo usa el rol, su casilla está desactivada y dice «Lo usan los pasos: …. Cámbialos en Flujo para poder quitarlo.». Aquí no se crean roles: si no tienes ninguno, la lista dice «Todavía no hay roles en el catálogo.» y los creas en Equipos y roles → Roles. Debajo, la tabla de los roles del equipo (cambiar el código, quitar; el origen «Catálogo: rol vX»). Al añadir un rol, la app crea su ficha de participación (team/flow/{código}.md) con la tabla de activaciones y una fila por cada paso del flujo que ya sea suyo; al quitarlo, la borra; al cambiar su código, la renombra. Si el catálogo tiene una versión más nueva de un rol, su fila muestra Versión nueva x.y.z y el botón Actualizar: un diálogo te explica que se sustituirá la copia del rol en el equipo y que se guarda una copia de la anterior (Actualizar / Cancelar; la versión anterior del equipo se puede restaurar desde su tarjeta). Es solo para el equipo: los proyectos ya creados no cambian. Si algún rol tiene skills instalables que solo existen para un agente, encima de la tabla sale el aviso informativo ℹ Algunas skills solo existen para un agente, con una línea por rol («QA — 2 skill(s) solo para Codex.»). No impide crear ni usar el equipo: al empezar un proyecto eliges cuáles instalar y ves cuáles no son compatibles con el agente.

• Flujo, el flujo del equipo, editable (el mismo que ves en el panel de un proyecto): el nombre y la descripción del flujo, «N fases · M pasos», el conmutador Editar / Ver como en el proyecto, las pestañas Diagrama / Lista (en los dos modos; se abre en Lista y recuerda la última elegida mientras el panel siga abierto) y la línea Rol inicial: X (paso «…», inicio del ciclo) (o «primer paso» si no hay inicio de ciclo declarado). Un flujo puede ser condicional: un paso con gate declara varias salidas (avanza, vuelta atrás, mismo paso o salto), y el camino lo elige la respuesta al gate (ver Salidas de un gate).

  • Fases. Una tarjeta por fase, con su nombre y su descripción (se editan pulsando en ellos), la casilla Empieza en un chat nuevo y el menú ⋯ (Subir, Bajar y Quitar la fase, solo si está vacía).
  • Pasos. Cada paso tiene su número, el rol (solo los del equipo), su texto, las casillas Opcional y Gate (marcarla añade «(Gn)» al texto del paso, con el siguiente número libre, y la sección ## Gn — … en gates.md, que se crea si no existe; desmarcarla quita el «(Gn)»), la cobertura en la ficha (✓ En la ficha si la ficha de su rol tiene una fila con el id del paso; si no, ○ Sin fila en la ficha con el enlace Añadir fila, que la escribe), Descripción y el menú ⋯ (Subir, Bajar, Mover a «fase», Empieza aquí cada ciclo y Quitar el paso); el paso donde empieza cada ciclo lleva la etiqueta Inicio del ciclo.
  • Reordenar. Para reordenar, arrastra un paso por el asa ⋮⋮ (también a otra fase) o usa Subir y Bajar. + Paso al final de cada fase y + Fase al final del flujo.
  • Cambios y fichas. Cada cambio se ve al momento y queda pendiente hasta el Guardar de la pantalla, y las fichas lo siguen: un paso nuevo tiene su fila en la ficha de su rol (con el id y el texto del paso y el resto «por definir»), un paso que cambia de rol se lleva su fila, y un paso que se quita pierde su fila si estaba sin rellenar. Si un cambio no se puede aplicar, todo se queda como estaba y te dice por qué.
  • Problemas del flujo. Arriba, los problemas del flujo (un paso con un rol que no está en el equipo, marcado «Rol inexistente»; un identificador repetido; un inicio de ciclo que no existe; una salida de un gate que lleva a un paso que ya no existe), con Ir a (en una salida rota, lleva a su lista Lleva a).
  • Diagrama. La pestaña Diagrama (también en «Ver como en el proyecto») muestra el flujo dibujado en lugar de la lista; la cabecera, el rol inicial y los avisos siguen arriba: las fases en vertical (con la ficha Chat nuevo si abren un chat nuevo) y, dentro, un nodo por paso con su número, su rol y su texto, unidos por flechas que nunca pasan por encima de un texto ni de un nodo (las flechas entre pasos bajan por la columna de los números y el título de cada fase empieza a su derecha; la vuelta al inicio del ciclo va por el margen derecho); un paso opcional tiene el borde discontinuo, un paso con gate lleva la insignia Gn, un paso con un rol que no existe sale en rojo con «⚠», y una flecha punteada vuelve del último paso al inicio del ciclo (que lleva un contorno de color). Pulsa un nodo (o Intro con el teclado) para pasar a la pestaña Lista e ir a ese paso; Ir a de los avisos también vuelve a la lista. Si el flujo no tiene pasos, la pestaña dice «Añade pasos para ver el diagrama.». El diagrama es de solo lectura, se actualiza con cada cambio y sigue el idioma ES / EN elegido; una leyenda explica los símbolos que aparecen.
  • Salidas de un gate. Un paso con gate puede declarar los caminos que salen de él (por ejemplo, en Lyra, «Todo bien» lleva a «Documentos vivos» y «Hay un problema» vuelve a la entrevista). En Lista, bajo cada paso con Gate marcado, el bloque Salidas del gate tiene una fila por salida: su texto, la lista Lleva a con todos los pasos (el propio gate sale como «(este paso)»), una insignia con el tipo (avanza, vuelta atrás, mismo paso o salto) y Quitar; + Añadir salida añade una («Nueva salida», hacia el paso siguiente) y un gate admite hasta 6. Un gate necesita al menos dos salidas: sin ninguna, el bloque avisa en ámbar «⚠ Este gate no tiene salidas. Añade al menos dos para que el flujo diga qué pasa al resolverlo.»; con una, «⚠ Este gate tiene una sola salida. Añade al menos otra.». Mientras algún gate tenga menos de dos, el paso Flujo no se da por completo (no sale «✓ Flujo definido» y no destaca Siguiente), Comprobaciones muestra un aviso por gate («El gate G2 (paso «…») no tiene salidas: añade al menos dos…» o «…tiene una sola salida: añade al menos otra.»), cuyo Ir a lleva al paso con el foco en + Añadir salida, y el chat ofrece pedírselas al agente (ver más abajo). Es un aviso, no un error: no impide usar ni exportar el equipo. Si el equipo tiene dos idiomas, el texto se edita en el idioma elegido (ES / EN) y el destino, añadir y quitar valen para los dos. Si el paso al que lleva una salida se borra, la salida se conserva y avisa en rojo («El paso «…» ya no existe. Elige otro destino.») y en los problemas del flujo. Si desmarcas Gate, las salidas se guardan en el archivo y vuelven al marcarlo. En Diagrama, un gate con dos o más salidas crece hacia abajo con una fila por salida, con su texto dentro del nodo: la que va al paso siguiente lleva «↓» y usa la flecha de siempre; las que vuelven a un paso anterior (o al mismo gate) salen por la derecha con una flecha punteada que sube por el margen hasta el paso de destino; un salto hacia delante va con flecha continua, y una salida rota sale en rojo con «⚠» y sin flecha. Al pasar el ratón por una flecha se ve «“texto”: de “gate” a “destino”». La leyenda añade Camino que sale de un gate y Vuelta atrás desde un gate. Un gate con menos de dos salidas lleva una marca «⚠» junto a su insignia «Gn» (al pasar el ratón, «sin salidas» o «una sola salida») y la leyenda añade Gate con menos de dos salidas. En solo lectura (Ver como en el proyecto y los equipos de la app) la lista muestra una línea por salida, «texto → n · paso», o el mismo aviso ámbar si el gate tiene menos de dos. Las salidas se guardan en el archivo del flujo, en el campo exits de cada paso.
  • Puede decidirlo el rol delegado. Cada paso lleva, junto a Opcional y Gate, la casilla Puede decidirlo el rol delegado, marcada por defecto. Desmárcala para reservar el paso: con una delegación activa, el rol delegado no lo decide por ti y el equipo te pregunta en él (modo Semiautónomo, capítulo 9). Se guarda en el archivo del flujo ("delegable": false en el paso; al volver a marcarla, el campo desaparece) y vale para los dos idiomas. Sin ningún paso reservado, nada cambia: con delegación, el rol decide todo. Con al menos uno, en Diagrama cada nodo lleva un distintivo a la derecha, 🤝 Delegable (contorno fino) o 🔒 Reservado (contorno de acento más grueso), la leyenda los explica («Delegable: puede decidirlo el rol delegado», «Reservado: espera a la persona») y el nombre accesible del nodo lo dice. En solo lectura, un paso reservado muestra la insignia 🔒 Reservado. Lyra trae reservados «Listo para construir» (G2) y «Prueba del usuario» (G3).
  • Criterios de aceptación. Bajo Salidas del gate, cada paso con Gate marcado tiene el bloque Criterios de aceptación, con un contador «n/8»: hasta 8 frases que un revisor comprueba antes de que decidas, cada una verificable leyendo el último entregable (por ejemplo, «Cada criterio de la solicitud está cubierto por el diseño»). + Añadir criterio añade una fila («Nuevo criterio») y lleva el foco a su texto; Quitar la borra; con 8, + Añadir criterio se desactiva («Un gate admite hasta 8 criterios»). Sin criterios, el bloque dice «Sin criterios: este gate funciona como siempre.». Debajo, Rol revisor elige con qué rol del equipo se revisa (su documento de rol y su ficha) o Agente del proyecto (sin rol), un revisor neutro (por defecto). Si el rol revisor deja de existir, el selector lo marca «⚠ {código} — no existe» y avisa en rojo «El rol «{código}» ya no existe. Elige otro revisor.». Con dos idiomas, el texto se edita en el idioma elegido y los criterios se emparejan por posición; añadir, quitar y el rol revisor valen para los dos. Si desmarcas Gate, los criterios se guardan en el archivo y vuelven al marcarlo. En solo lectura se ve la lista y «Revisor: …». Se guardan en el archivo del flujo, en los campos criteria y reviewer del paso; ningún equipo de la app trae criterios por defecto.
  • Idiomas. Si el equipo tiene varios idiomas, el selector ES / EN elige en cuál editas los textos; los cambios de estructura (pasos, roles, opcional, chat nuevo, inicio del ciclo, gate, filas) se aplican a todos. Un equipo sin flujo muestra «Este equipo aún no tiene flujo.» con Crear flujo vacío. Ver como en el proyecto dibuja el flujo con el aspecto del panel de un proyecto, con el inicio del ciclo resaltado.

• Documento del flujo, Fichas por rol, Gates y procedimientos y Plantillas: cada vista lista los documentos de ese tipo con una línea de ayuda y, desde el principio, la forma completa del equipo: el documento del flujo, una ficha por rol, los cuatro procedimientos comunes (gates.md, elicitation.md, amendments.md, severity.md), las plantillas que citan las fichas o el documento del flujo y el historial (CHANGELOG.md). Cada documento muestra su estado: ✖ Falta (rojo, lo exige la validación), Recomendado (gris, un procedimiento o el historial que aún no existe), Vacío (solo títulos; en una ficha, sin nada escrito aparte de las filas que creó la app) o Escrito. Al pulsar uno se abre en el mismo panel para editarlo a mano, en texto o con formato, sin botones propios: lo que escribes queda pendiente hasta el Guardar de la pantalla, y volver a la lista o cambiar de idioma no pregunta. Cada documento lleva además ✦ Redactar con el agente (si falta o está vacío) o ✦ Revisar con el agente (si está escrito), que envían al chat la petición correspondiente.

• Comprobaciones (los errores y avisos, con Ir a). Además de lo de antes, la validación avisa (no bloquea) de: un documento del flujo o una ficha sin contenido; un paso que la tabla «Id del paso» del documento del flujo cita y el flujo no tiene; un «(Gn)» en un paso sin su sección en gates.md; y un comando del bloque «Comandos del sistema» del documento del flujo que no está en los botones rápidos.

El chat del editor de equipos: borradores y propuestas

• El chat con el agente, a la derecha, como en el editor de roles: un solo agente (Claude Code o Codex) que trabaja en la carpeta del equipo y conversa en el idioma principal del equipo (la insignia de idioma de la cabecera lo dice). El agente y su modelo se eligen con el botón de la cabecera, como en el editor de roles (cambiar de agente empieza una conversación nueva); la elección de los equipos es independiente de la de los roles. Te entrevista sobre cómo colabora el equipo (quién empieza, qué aprueba el usuario, qué no hace el equipo, qué pasa cuando falla una prueba) con preguntas abiertas numeradas (puedes responder por número) y preguntas cerradas con botones (una tarjeta con las opciones, Responder y Responder en el chat), y en cada turno recibe el estado del equipo: la validación, los pasos sin fila en ninguna ficha, los gates sin salidas suficientes, los documentos que faltan o están vacíos y el borrador pendiente, así que pregunta por lo que está en rojo. Redacta los documentos del equipo: los procedimientos, las plantillas y el historial los escribe directamente; el documento del flujo y las fichas los propone por borradores en el chat (ver abajo). Sobre el cuadro de escribir, la línea del siguiente paso («Siguiente: …», en el orden del recorrido —primero la identidad, después los roles y el flujo—, o «Todo listo: revisa el equipo y sal del editor») y los atajos Proponer {paso}, Revisar el equipo y Seguir. El primero cambia con el paso que tienes abierto: Proponer Identidad, Orientar roles, Proponer Flujo, Proponer Documento del flujo, Proponer Fichas por rol, Proponer Gates y procedimientos y Proponer Plantillas (en Comprobaciones no sale). En Flujo, mientras algún gate tenga menos de dos salidas, el atajo pasa a ser Proponer salidas de los gates: pide al agente las salidas que faltan, cada una con su texto y su acción (volver, avanzar o cerrar); cuando ya no faltan, vuelve a Proponer Flujo. Pide al agente un borrador de ese paso que tiene en cuenta lo que ya definiste en los anteriores (la identidad, los roles elegidos, el flujo): la identidad y el flujo llegan como propuestas con botones, los documentos como borradores (ver abajo), y nada se guarda hasta que lo aplicas. Orientar roles solo explica qué aporta cada rol disponible y qué papel faltaría cubrir: no propone roles, los marcas tú; arriba, Nueva conversación. En un equipo nuevo vacío, el agente empieza la entrevista. Mientras escribe, el documento abierto queda de solo lectura con «El agente está escribiendo…». La configuración y el flujo no los toca: si lo hiciera, la app los deja como estaban y lo dice en el chat.
• Equipo listo: cuando roles, flujo y documentos están hechos, sin errores ni avisos de validación, el agente no trabaja y no hay nada sin guardar, aparece arriba una franja verde con ✓: Equipo listo, con Terminar y volver al catálogo (sale como ← Equipos y roles), ▶ Probar el equipo (el mismo botón que el de la cabecera, con su confirmación) y Seguir editando (oculta la franja). Se va si algo cambia y vuelve cuando todo vuelve a estar listo; también sale al abrir un equipo completo. En los equipos de la app (solo lectura) no aparece.
• Borradores de documento: cuando el agente propone una parte del documento del flujo o de una ficha, aparece como una tarjeta Borrador · ruta › sección con el texto propuesto y los botones Aplicar y Descartar (o escribe «está bien» en el chat). Al aplicar, la app escribe esa sección entera (o el documento, si el borrador no indica sección) en el archivo, la tarjeta pasa a «✓ Aplicado», se abre la vista del documento y el agente sigue con el siguiente paso. Un borrador nuevo de la misma parte deja el anterior como «Sustituido por un borrador más nuevo». Mientras hay un borrador sin aplicar, el agente no escribe ese documento.
• Propuestas con botones: los cambios de roles y de flujo no los hace el agente: los propone con una tarjeta bajo su mensaje, por ejemplo «Añadir el rol QA (Estándar) al equipo» o «Insertar el paso «Revisión» (rol Team Lead) después de «Implementación»». El agente puede proponer también los textos de la identidad («Lema (ES): «…»», uno por campo e idioma: al aplicarlo se guarda en Identidad, donde puedes seguir editándolo), fases nuevas («Añadir la fase «…» al final del flujo», con o sin chat nuevo), el inicio del ciclo, los gates de un paso y las salidas de cada gate, así que después de la entrevista puede proponer el flujo entero en un solo mensaje. La tarjeta Salidas del gate «…» lista de 2 a 6 salidas, una por fila: su texto, adónde lleva («sigue en «…»», «vuelve a «…»» o «cierra el ciclo en «…»», que es el último paso del flujo) y su acción (avanza, vuelta atrás, salto o cierra); un destino que aún no existe sale como «(paso aún sin crear)». Si el gate ya tenía salidas, la tarjeta avisa «Sustituye las N salidas actuales.». Si al aplicarla el paso todavía no es gate o un destino no existe, la tarjeta lo dice («…aplica antes la propuesta de marcarlo.» o «…aplica antes las propuestas que crean ese paso.») y se puede volver a aplicar después. La app entiende la línea de salidas aunque el agente no la escriba en el formato exacto, siempre que no haya duda: el gate por su número («G1») o su nombre, el destino por el nombre del paso (sin importar mayúsculas ni tildes) o con una acción («avanzar», el paso siguiente; «volver», el anterior; «cerrar», el final), con comillas o negritas. Si no la entiende (el gate no existe o no es gate, una salida sin destino o con « · » en el texto, menos de dos o más de seis salidas, un destino que no es ningún paso o que coincide con varios), en lugar de la tarjeta aparece un aviso con borde ámbar «⚠ No se entendió una línea de salidas del gate», con la línea citada y el motivo; la app se lo devuelve sola al agente para que la corrija («Se lo he devuelto al agente para que la corrija.»), como mucho dos veces seguidas por cada mensaje tuyo; si no puede, el aviso dice «Díselo al agente para que la corrija.» y el agente lo recibe en su siguiente turno. Cada tarjeta tiene Aplicar y Descartar; con dos o más propuestas aplicables en el mismo mensaje aparece además Aplicar las N propuestas, que las aplica en orden (primero la fase, después sus pasos). Al aplicar, la tarjeta pasa a «✓ Aplicado», el cambio se resalta un momento a la izquierda (y se abre su vista, salvo que estés editando algo) y el agente lo sabe en su siguiente turno. Lo que describes en el chat sigue mandando: puedes pedir cambios con tus palabras y el agente responde con propuestas nuevas, o tocarlo tú en la pestaña Flujo. Quitar un rol pide confirmación y no se aplica si algún paso lo usa. Si la propuesta ya no se puede aplicar (el rol ya está, el paso no existe), la tarjeta dice por qué y solo ofrece Descartar.

Probar, versionar, exportar y borrar un equipo

• Probar el equipo: en la cabecera, el botón ▶ Probar el equipo (activo cuando el equipo no tiene errores de validación; pide Crear proyectos y Equipos propios) crea un proyecto de prueba en la carpeta de datos de la app («Prueba {equipo} {fecha}», fuera de la lista de equipos) con el equipo tal como está guardado, cierra el editor y abre el proyecto en esta ventana, para ver cómo arranca el rol inicial y cómo se sigue el flujo. Antes pide confirmación. Con cambios sin guardar está apagado («Guarda los cambios para probar el equipo»).
• Equipos de la app: su pantalla es de solo lectura (Datos, Roles y Flujo, sin controles) y, en lugar del chat, un recuadro «Los equipos de la app no se editan. Cópialo para editar su copia.» con Copiar a mis equipos, que vuelve a la galería con el diálogo de copia abierto.
• Versión: sube sola al pulsar Guardar, según todo lo cambiado desde que abriste la pantalla (el número del medio si cambiaron los roles o los pasos del flujo; el último si solo cambiaron textos o documentos), una sola vez aunque guardes varias veces; o la fijas a mano con Fijar la versión a mano en Identidad. Cancelar y Restablecer no la tocan. Actualizar un rol guarda la versión anterior del equipo al pulsar Guardar.
• Validación: un equipo con errores se guarda, pero no se puede exportar ni elegir para un proyecto nuevo.
• Exportar: Solo el equipo o Con sus roles de catálogo (además lleva los roles que vienen del catálogo, para añadirlos al catálogo de quien lo importe). Al importar un paquete así, la sección Roles del paquete permite elegir por rol Añadir, Actualizar u Omitir.
• Borrar pide confirmación; los proyectos ya creados con el equipo no cambian.
• Licencia: crear y copiar piden Crear equipos; editar (y con ello el chat, el flujo, aplicar propuestas y actualizar un rol) y restaurar, Modificar equipos; borrar, Eliminar equipos; importar, Equipos propios (y, para añadir los roles del paquete, Crear roles). Ver y exportar siempre se pueden. Sin Modificar equipos, la pantalla de un equipo propio se abre en solo lectura.

El catálogo descargable (pestaña Catálogo)

La tercera pestaña de Equipos y roles, Catálogo, lista los equipos y roles publicados en teamaiconsole.com y los instala sin buscar ni descargar archivos a mano. La lista se pide la primera vez que abres la pestaña en cada sesión (no al arrancar la app); mientras llega, ves la última que se descargó.

• Qué se ve: un selector Equipos | Roles y las mismas tarjetas, filtros e idiomas que en la galería: en Equipos, la categoría; en Roles, el área; en los dos, el idioma y el buscador de la cabecera («Buscar en el catálogo»). Cada tarjeta dice si ya lo tienes: ✓ Instalado · v1.2.0, o ↑ Versión nueva v1.3.0 · tienes v1.2.0 cuando el catálogo trae una versión superior a la que tienes. Detalles despliega el resumen, para quién se recomienda y sus roles (o sus variantes).
• Instalar y Actualizar: la app descarga el paquete, comprueba que es exactamente el que publica el catálogo y abre la misma revisión de la importación manual (Importar un equipo propio, Duplicar, borrar, exportar e importar roles): ves qué trae y lo confirmas con Importar (o Actualizar). Un equipo queda en Tus equipos y un rol, en la pestaña Roles, como si lo hubieras importado de un archivo; si el equipo trae roles que ya tienes, la revisión te pregunta Añadir, Actualizar u Omitir. Al terminar, Ver en Tus equipos o Ver en Roles te lleva a él. Cancelar no cambia nada. Se instala una cosa a la vez.
• Seguridad: la lista va firmada y cada paquete lleva su huella (sha256). Si la firma de la lista no es válida o un paquete no coincide con su huella, no se instala nada y un aviso rojo explica el motivo («El paquete «…» no coincide con la huella (sha256) que publica el catálogo. No se ha instalado nada.»). Una lista nueva con la firma alterada no sustituye a la buena: sigues viendo la anterior con el aviso «No se ha podido verificar la lista nueva. Se muestra la lista del {fecha}.».
• Sin conexión: ves la última lista que se descargó, con el aviso «Sin conexión, lista del {fecha}», y Instalar está desactivado hasta que vuelva la conexión (Reintentar vuelve a pedirla). Si nunca se descargó ninguna, la pestaña dice «No se pudo cargar el catálogo» con Reintentar.
• Licencia: ver el catálogo siempre se puede. Instalar un equipo pide Equipos propios y un rol, Crear roles, igual que importarlos de un archivo: sin ellas, Instalar lleva el candado 🔒 y abre el aviso de siempre.

Lo que tú creas no se publica desde la app: tus equipos y roles siguen en tu ordenador hasta que los exportas.