Planificación y ejecución

Un flujo de trabajo de planificación y ejecución reparte un trabajo entre dos roles: una sesión de planificación, que prepara y revisa el trabajo, y una o varias sesiones de ejecución, que lo llevan a cabo. Este capítulo describe cómo iniciar un flujo de trabajo desde el menú o desde una sesión, revisar una división en tareas, elegir los directorios de trabajo y seguir el progreso del flujo de trabajo.

1. Cómo funciona el flujo de trabajo

Un flujo de trabajo tiene dos roles, y cada uno se ejecuta como una sesión propia en la barra lateral:

• Planificación y revisión. La sesión de planificación estudia la tarea y el proyecto, redacta el encargo para la sesión de ejecución y revisa cada resultado. Solicita correcciones hasta que el resultado es aceptable, y solo lo acepta después de comprobar los cambios reales y las evidencias de verificación.
• Ejecución. La sesión de ejecución implementa el encargo e informa del resultado. Las correcciones se envían a la misma sesión de ejecución, que conserva su contexto entre rondas.

La sesión de ejecución aparece en la barra lateral como hija de la sesión de planificación. Ambas sesiones se ejecutan en la vista de conversación. Los mensajes que se intercambian los roles muestran el icono del agente remitente, el nombre de la sesión y el rol («Planificación» o «Ejecución»), de modo que puede seguir el intercambio en cualquiera de las dos conversaciones.

Ambos roles necesitan un agente que admita la vista de conversación: Claude Code, Codex, OpenCode, Pi u OMP. La sesión de planificación y la de ejecución pueden usar agentes, modelos y esfuerzos de razonamiento distintos.

Puede leer, responder o interrumpir cualquiera de las dos sesiones en cualquier momento. Las solicitudes de permiso de ambos roles siguen esperando su respuesta.

2. Iniciar desde el menú

Abra el menú contextual de un proyecto, un grupo o una sesión, o su submenú «Nueva sesión hija», y elija «Nueva sesión de planificación/ejecución…». El cuadro de diálogo contiene lo siguiente:

• «Crear en»: dónde se creará la sesión de planificación. La sesión de ejecución se crea debajo de la sesión de planificación.
• «Instrucciones de la tarea»: describa la tarea, los requisitos y los criterios de aceptación. Puede pegar imágenes; se envían con la tarea de la sesión de planificación y con el primer encargo de la sesión de ejecución.
• «Dividir automáticamente en varias tareas»: consulte el §4.
• «Planificación y revisión» y «Ejecución»: el agente («Tipo de sesión»), el «Modelo» y el «Esfuerzo de razonamiento» de cada rol. Las opciones de modelo y esfuerzo proceden del agente seleccionado. El cuadro de diálogo recuerda las últimas opciones elegidas para cada rol.
• «Ruta del directorio de trabajo» y la opción de directorio: consulte el §5.

Elija «Crear e iniciar» para iniciar la sesión de planificación. Esta crea la sesión de ejecución cuando el plan está listo. Abrir o cancelar el cuadro de diálogo no crea nada. El cuadro de diálogo tiene su propia dirección, de modo que puede copiar el enlace, actualizar la página o usar Atrás y Adelante sin perderlo.

3. Iniciar desde una sesión

En cualquier sesión que inicie VelaTerm, ejecute:

vspawn --plan-execute \
  --plan-agent claude --plan-model opus --plan-effort high \
  --exec-agent codex --exec-model gpt-5.5 --exec-effort medium \
  "Implement the agreed changes and verify all acceptance criteria"

En Claude Code, /vspawn --plan-execute <task> hace lo mismo; en Codex, use $vspawn --plan-execute <task>. La habilidad redacta una tarea autónoma a partir de la conversación actual antes de iniciar el flujo de trabajo. Estas habilidades requieren Vela Skills (Ajustes ▸ General).

La nueva sesión de planificación se crea debajo de la sesión que ejecutó el comando. La solicitud abre primero la tarjeta de confirmación descrita en Creación de sesiones y colaboración en Git §4, donde puede revisar y modificar la tarea y la configuración de ambos roles.

Si no se indica ningún agente, una sesión de planificación iniciada desde una sesión de Claude, Codex, OpenCode, Pi u OMP usa el mismo agente; desde cualquier otra sesión, usa Claude Code. Un modelo o un esfuerzo que el agente seleccionado no admite se rechaza antes de que se inicie nada.

Las sesiones nuevas no ven la conversación desde la que se iniciaron. Incluya en la tarea las decisiones tomadas hasta el momento, los cambios existentes, las restricciones y la ubicación de entrega requerida.

4. Dividir en varias tareas

Active «Dividir automáticamente en varias tareas» en el cuadro de diálogo o añada --split-tasks a vspawn --plan-execute. La sesión de planificación analiza entonces el trabajo y propone entre 1 y 12 tareas independientes. No se inicia ninguna sesión de ejecución hasta que usted las confirma.

La propuesta abre el cuadro de diálogo «Revisar tareas de ejecución»:

• Seleccione una tarea de la lista para editar su «Nombre de la sesión», sus «Instrucciones de la tarea», su agente, su «Modelo» y su «Esfuerzo de razonamiento». Los cambios se conservan al pasar de una tarea a otra.
• «Quitar tarea» descarta una tarea; «Deshacer eliminación» la recupera. Debe quedar al menos una tarea.
• El botón de inicio («Iniciar N sesiones») crea una sesión de ejecución por cada tarea.
• Al cerrar el cuadro de diálogo, la propuesta sigue en espera y un enlace «Revisar tareas de ejecución» permanece en pantalla para volver a abrirlo. Si cancela la propuesta, el flujo de trabajo se detiene sin crear sesiones de ejecución.
• El cuadro de diálogo tiene su propia dirección y se mantiene al actualizar la página; los cambios que aún no se han confirmado se pierden al actualizar.

Cuando se usa la habilidad con división en tareas, esta añade --yes para que solo aparezca esta revisión final. La revisión permite cambiar la configuración de cada sesión de ejecución, pero no la de la sesión de planificación, que ya está en ejecución.

Una sola sesión de planificación recibe los informes de todas las sesiones de ejecución y revisa cada tarea por separado, con sus propias rondas de corrección. El flujo de trabajo en su conjunto solo se completa cuando se han aceptado todas las tareas.

Divida el trabajo en tareas que no editen los mismos archivos. Cada sesión de ejecución ejecuta su propio proceso de agente, así que elija el número de tareas teniendo en cuenta los recursos del equipo.

5. Directorios de trabajo y worktrees

La opción de directorio se aplica a todos los roles del flujo de trabajo:

Los worktrees nuevos parten del commit actual y no incluyen los cambios pendientes de commit. Si no se puede crear un worktree, la sesión afectada no se inicia; no se recurre a otro directorio. En la línea de comandos, --worktree por sí solo equivale a shared.

Los resultados permanecen en los worktrees hasta que usted los fusiona. Use «Git ▸ Merge…» en una sesión para fusionar una rama (consulte Creación de sesiones y colaboración en Git §6). El flujo de trabajo no fusiona ramas, no hace push ni elimina worktrees por sí solo.

6. Seguimiento del progreso

• La conversación de planificación muestra cada informe y cada corrección a medida que se producen. Mientras las sesiones de ejecución trabajan, la sesión de planificación espera sus informes.
• vflow status <workflow-id> muestra el estado de un flujo de trabajo, sus tareas, sus sesiones y la ronda actual. El ID del flujo de trabajo aparece en los mensajes del flujo.
• vflow stop <workflow-id> detiene las rondas siguientes y pide a las sesiones en ejecución que se detengan. Al detener todo el flujo de trabajo se detienen sus tareas; detener una sola tarea no afecta a las demás.
• vstat muestra qué sesiones están trabajando, solicitando permiso o esperando. Que una sesión de ejecución esté en espera no significa necesariamente que haya terminado su tarea; solo cuenta la aceptación de la sesión de planificación.
• Si un rol termina su turno sin traspasar el trabajo, el flujo de trabajo queda bloqueado. Revise la conversación, responda lo que sea necesario y continúe desde la sesión de planificación.

Los comandos se describen en Comandos de sesión.