Creación de sesiones y colaboración en Git

Dos características que funcionan en pareja: generar subtareas en sesiones hijas independientes con vspawn (opcionalmente en worktrees git aislados), y una fusión gráfica para volver a unir ramas paralelas. Juntas, convierten el escenario de “varios agentes trabajando en el mismo repositorio en paralelo” en un flujo de trabajo cotidiano.

1. Qué es la generación

Desde cualquier sesión, separa una subtarea: VelaTerm crea una nueva sesión hija ** bajo** el nodo actual (el árbol se vuelve jerárquico: padre → hijo → nieto), opcionalmente le asigna un worktree git aislado, y pasa la descripción de la tarea como el primer mensaje de la nueva sesión; el nuevo agente comienza a trabajar en cuanto se inicia, sin necesidad de explicaciones adicionales.

Lo que obtienes es una sesión real dentro del árbol: su propio proceso, completamente interactivo y reanudable, que puedes observar o acceder en cualquier momento. No se trata de una tarea oculta en segundo plano.

2. Cuatro puntos de entrada

Los dos comandos de terminal se inyectan automáticamente en el PATH de cada sesión; no se requiere instalación alguna.

Requisito previo para las habilidades /: antes de que Claude pueda usar /vspawn o /vspawn-tree (o generar sesiones hijas por iniciativa propia); habilita Habilidades Vela en Ajustes ▸ General. Esto instala las habilidades /vspawn, /vspawn-tree y /vopen como un paquete en ~/.claude/skills/; se mantienen actualizadas automáticamente con las actualizaciones de la aplicación. Después de habilitarlas, inicia una nueva sesión de Claude (o reinicia una existente) para que el agente las cargue. Sin esto, Claude simplemente no conoce estos comandos; solo funcionan los vspawn / vspawn-tree introducidos por terminal.

3. Confirmar antes de generar

Por defecto, cada generación muestra primero una tarjeta de confirmación (en la esquina superior derecha, no modal, que no roba el foco):

• Tres campos editables: el prompt (multilínea), el tipo de agente (por defecto el del padre) y worktree git separado.
• “Iniciar” pone en marcha la sesión hija; “Cancelar” descarta la solicitud. Cuando un agente genera varias a la vez, las tarjetas se procesan una por una (el recuento restante se muestra en la tarjeta).
• Si prefieres omitir por completo la confirmación, desactiva “Confirmar antes de generar” en Ajustes ▸ Comportamiento.

4. Worktrees: paralelismo sin interferencias

Con la opción de worktree activada, la sesión hija trabaja en una nueva rama dentro de su propio directorio de trabajo, aislada del espacio de trabajo principal y de las demás sesiones hijas. Esa es la estructura adecuada para el paralelismo multiagente. La gestión se realiza desde el menú contextual de la sesión bajo “Worktree ▸”: ver cambios, copiar/abrir la carpeta del worktree, eliminar el worktree (con opción de forzar la eliminación de cambios no confirmados).

La generación desde un directorio que no sea git sigue funcionando; simplemente recurre a compartir el directorio del padre, sin worktree.

5. Fusión: fusión gráfica Git

Cuando el trabajo está terminado, lo integras. Cualquier sesión cuyo directorio de trabajo sea un repositorio git (con o sin worktree): haz clic con el botón derecho → "Git ▸ Fusión…” para abrir el diálogo de fusión:

• **Elige tanto la rama de origen como la de destino **, y puedes intercambiar direcciones: fusionar la rama de una sesión hija de vuelta en la principal, o traer la principal a la hija para actualizar su línea de base, todo desde el mismo diálogo.
• La fusión se ejecuta en el árbol de trabajo donde está desplegada la rama de destino; si el árbol de origen tiene cambios no confirmados, se confirman primero para que no se pierda nada.
• En caso de conflicto, la escena se deja tal cual para que tú (o un agente) la resuelvas en la terminal y continúes.

La fusión no elimina automáticamente el worktree; límpialo después mediante “Worktree ▸ Eliminar worktree…” una vez estés seguro.

6. Un flujo de trabajo típico

1. En la sesión principal, pide a Claude que analice la tarea y luego /vspawn-tree refactor the checkout module para generarla (se requieren Habilidades Vela; véase §2).
2. Revisa el prompt en la tarjeta de confirmación y haz clic en Iniciar; la sesión hija comienza en su propio worktree, visible en la barra lateral debajo de su padre, con un punto que se vuelve verde.
3. Continúas trabajando en la sesión principal; cuando la sesión hija hace alguna consulta o termina, su punto se vuelve amarillo y se emite una notificación.
4. Accede para revisar, luego haz clic con el botón derecho → "Git ▸ Fusión…” para fusionar su rama de vuelta en la principal.
5. Usa “Worktree ▸ Eliminar worktree…” para limpiar, y luego archiva la sesión hija como registro.