12. Adoptar un proyecto existente

Para trabajar con un equipo sobre un proyecto que ya tiene código hecho fuera de la app. Se abre con Adoptar un proyecto existente… en la pantalla inicial, o desde la pantalla de preparación al abrir una carpeta con código y sin equipo. Es un asistente de cuatro pasos, con los pasos arriba y Cancelar la adopción / ‹ Atrás / Siguiente › siempre abajo:

1. Carpeta — Elegir la carpeta…. La app la revisa y muestra Qué va a pasar: todo lo que hay en la carpeta pasa a app/; si tiene git, .git/ se queda en la raíz (el historial se conserva y nada se confirma); los archivos de CI o despliegue que habrá que actualizar; y que el agente que elijas (Claude Code o Codex) escribirá la documentación inicial. Si la carpeta no se puede adoptar (está vacía, ya es un proyecto de la app, ya tiene una carpeta app/ con contenido), lo explica.
2. Equipo — las tarjetas de equipos con el botón Elegir este equipo. El elegido se marca.
3. Opciones — resumen (carpeta y equipo, cada uno con Cambiar), idioma del equipo, Agente que analiza el proyecto (solo los instalados: con los dos, Claude Code viene elegido y puedes cambiar a Codex; con uno solo, ya está elegido), modelo para generar la documentación (la lista es la del agente elegido; con Claude Code, los modelos que tu plan no incluye salen desactivados: ver Modelos por rol), modelo de cada rol y el aviso de que mover el proyecto es un cambio real en el disco. Botón Adoptar el proyecto. Si no hay ningún agente instalado, un aviso explica cómo resolverlo (instalar Claude Code o Codex, o indicar su ruta en Inicio → Agentes) con Comprobar de nuevo, y no se puede adoptar hasta que haya uno.
4. Adopción — progreso: se mueve el proyecto, se copia el equipo y el agente lee el código y escribe la documentación (Agente: …, archivos leídos, documentos escritos, tiempo). Con cualquiera de los dos agentes solo puede escribir en la carpeta de documentos y en AGENTS.md. El agente usado queda como el agente del proyecto. Se puede Cancelar la documentación: el proyecto queda adoptado y se puede generar después. Al terminar se ve el resumen, la lista de documentos generados, cuántas afirmaciones quedaron marcadas como [SUPUESTO] y Abrir el proyecto.

La documentación inicial incluye los documentos vivos del equipo (brief, arquitectura, estándares con los comandos reales, backlog, deuda técnica, estrategia de pruebas, contexto, glosario…) y un registro de la adopción (en docs/sprints/sprint-0-adopcion/, o sprint-0-adoption/ si el equipo es en inglés). El flujo empieza en el cierre del Sprint 0: el rol inicial revisa contigo los documentos generados y empieza el Sprint 1. Si algo falla antes de la documentación, la app deshace el movimiento.