13. Cambiar de equipo o actualizar su versión

Un proyecto puede pasar a otro equipo (por ejemplo, de Ceres a Vela cuando la idea ya está definida, de Orión a Vela para construir en la app, o de Vela a Andrómeda para desplegar) o a una versión nueva de su mismo equipo (por ejemplo, un equipo propio actualizado). Se abre con Cambiar de equipo… en el menú del agente o en el panel Roles. Es un asistente de tres pasos:

1. Equipo nuevo — las tarjetas de equipos. La del equipo actual muestra “● Equipo actual · {versión}” y, si hay una versión más nueva disponible, “→ versión X disponible”. Si el proyecto tuvo antes otros equipos, arriba aparece Volver a un equipo anterior, con la fecha en que lo dejaste.
2. Revisión — Ahora y Después (equipo, idioma y versión; se puede cambiar el idioma, también para pasar el mismo equipo a su otro idioma), los roles que se quedan, salen y entran, y Qué va a pasar: si es una actualización del mismo equipo, en qué paso está el flujo, en qué paso empieza el nuevo equipo (su Sprint 0), el documento de entrega, los chats y la copia de seguridad. Se elige el modelo para escribir la entrega (los que tu plan de Claude Code no incluye salen desactivados: ver Modelos por rol). La entrega la escribe el agente del proyecto (o, si no está instalado, el que haya); en el progreso se ve Agente: …. Con Codex se usa su modelo predeterminado. El botón es Cambiar de equipo o Actualizar a la versión X.
3. Cambio — progreso y resultado: resumen, documento de entrega, puntos pendientes recogidos, qué revisar primero y dónde quedó guardado el equipo anterior. Botón Abrir con el nuevo equipo.

Qué hace el cambio:

• El código y los documentos (docs/) no se tocan; se sustituyen los roles, el flujo y las plantillas.
• El equipo anterior se guarda en .team-ai-console/team-history/ y puedes volver a él desde el mismo asistente.
• El flujo empieza en el Sprint 0 del nuevo equipo. Se abre un chat nuevo, Cambio de equipo; los chats anteriores se conservan.
• Claude Code escribe el documento de entrega en docs/handoff/: qué existe, qué está pendiente, qué rol asume cada responsabilidad y qué debe producir el Sprint 0. Es la entrada del nuevo equipo. Si la entrega falla o la cancelas, el cambio queda hecho y puedes Volver a generar la entrega.
• La app solo dice que el proyecto “ya usa ese equipo” si coinciden el equipo, el idioma, la versión y los archivos.

Aviso al abrir el proyecto. Si la app trae una versión más nueva del equipo que usa el proyecto (el mismo equipo, en el mismo idioma), al abrirlo aparece un aviso: “Hay una versión nueva de {equipo}”, con la versión actual y la nueva. Actualizar a la versión X abre el asistente ya en el paso de revisión; Ahora no lo deja para otro momento (volverá a avisar la próxima vez); No avisar más de esta versión lo silencia para esa versión (si llega otra más nueva, avisará de nuevo). Sirve para todos los equipos de la app, declaren su versión o la lleven en la firma. Si no se puede saber qué versión tiene el proyecto, se trata como una versión anterior: el aviso dice que usa una versión que no se puede identificar y ofrece la de la app. El aviso solo sale en proyectos individuales, no en los que tienen la colaboración activa.

Limitaciones actuales: solo en proyectos individuales (sin colaboración activa) y con el agente parado. El equipo nuevo debe estar permitido por tu licencia.

Mejoras del equipo: de la retrospectiva al catálogo

Al cerrar un sprint, un rol puede proponer un cambio al propio equipo (por ejemplo, una regla nueva en la ficha de un rol). Esas propuestas se ven en la pestaña Mejoras del proyecto (selector de vista, junto a Backlog), con el número de pendientes: Mejoras (2).

Cómo se propone. Una propuesta es un archivo .md en docs/team-improvements/ del proyecto (la carpeta de documentos que use el proyecto), por ejemplo mejora-2026-11-03-textos-en-ingles.md. Lo puede escribir el rol (con Claude Code o con Codex: la app solo lee archivos) o tú mismo. Formato:

---
tipo: mejora-equipo
equipo: galaxy
archivo: team/flow/uud.md
sprint: 122
estado: pendiente
---

## Motivo
El diseñador entregó la especificación sin comprobar los textos en inglés y hubo que repetirla.

## Evidencia
Ronda 2 del Sprint 122 (fallo repetido en dos sprints).

## Antes
```text
- Accesible por defecto.
```

## Después
```text
- Accesible por defecto.
- Los textos nuevos se escriben en español y en inglés en la misma especificación.
```

equipo es el id del equipo (el template.id de team-ai-console.json), archivo es el archivo del equipo que cambia y Antes / Después son el texto exacto que se sustituye y el nuevo. También se aceptan las claves en inglés (type: team-improvement, team, file, status) y los títulos Reason, Evidence, Before y After. Un archivo que no sigue el formato no se muestra como tarjeta: la pestaña dice «N archivos no reconocidos» y, al desplegarlo, el motivo de cada uno.

La tarjeta «Propuesta de mejora del equipo». Muestra el equipo, el archivo y el sprint, el motivo, el Antes y el Después lado a lado (uno encima del otro cuando la pestaña es estrecha: la ventana pequeña o las barras laterales anchas), la evidencia y tres acciones:

• Aplicar al proyecto — cambia el archivo del equipo de este proyecto. Si el texto «antes» ya no está en el archivo (o está más de una vez, o el cambio ya estaba hecho), no se cambia nada y la tarjeta lo dice. Si el equipo del proyecto era un equipo firmado de la app, después cuenta como equipo editado (ver Licencias).
• Aplicar al equipo del catálogo — lleva el cambio a tu equipo propio de Equipos y roles para que llegue a los proyectos futuros. La app sale del proyecto y abre el editor del equipo con el cambio ya aplicado en el borrador, una franja que dice de qué proyecto y sprint viene y a qué versión subirá, y el documento afectado abierto. Revisa y pulsa Guardar: antes de guardar pasan las comprobaciones del editor; si fallan, no se guarda, la versión no sube y la franja dice el motivo (el paso Comprobaciones lo detalla). Cancelar o Restablecer descartan el cambio y la propuesta sigue pendiente. Al salir del editor vuelves al proyecto. Si tienes varios equipos propios y ninguno tiene ese id, eliges el destino en una lista. Pide la función de licencia Modificar equipos: sin ella, el botón lleva 🔒 y al pulsarlo explica por qué.
• Descartar — la propuesta pasa a Resueltas, sin confirmación.

Equipos de la app. Si la propuesta es para un equipo firmado de la app, la tarjeta avisa de que ese equipo no se modifica y cambia sus acciones: Copiar y aplicar copia el equipo a Tus equipos y abre su editor con el cambio preparado (pide Crear equipos y Modificar equipos), y Guardar como propuesta deja una copia en docs/team-proposals/ del proyecto (sin licencia). Aplicar al proyecto y Descartar siguen disponibles.

Resueltas. Debajo de las pendientes, plegadas, con su estado: Aplicada al proyecto, En el catálogo · v{versión}, Guardada como propuesta o Descartada. El estado se guarda en el propio archivo (estado:), así que se conserva entre sesiones. Ver la propuesta abre el archivo en el visor.

Registro «Mejoras del equipo». Cada mejora guardada desde un proyecto se anota en team/IMPROVEMENTS.md del equipo propio, en el mismo Guardar, y viaja con la versión. En el editor del equipo, el paso Identidad lo muestra al final: versión, qué cambió, proyecto y sprint, evidencia y fecha, lo más reciente arriba. Los equipos de la app no guardan este registro.

Llega a los demás proyectos. La versión nueva del equipo propio se anuncia en los otros proyectos que lo usan con el aviso de versión nueva (arriba, Aviso al abrir el proyecto), y en la revisión de Ahora y Después se ve el archivo cambiado.