Conceptos
Cómo funciona vexillum
Los roles, y la vida de una tarea desde el dispatch hasta el strike.
Los roles
| Término | Qué es |
|---|---|
| general | Vos, el humano. Le hablás solo al commander. |
| commander | La sesión de agente con la que hablás: Claude Code por defecto, o Pi u OpenCode. Lee tu pedido y el núcleo de AGENTS.md del proyecto, y despacha y sigue a los soldiers. |
| soldier | Una sesión de agente que el commander inicia para hacer una tarea, en su propio camp. Claude Code por defecto, o Pi u OpenCode cuando su perfil de modelo lo dice. |
| camp | El git worktree aislado de un soldier, en su propia branch. |
| mission | Una tarea que cambia código y entrega algo para aterrizar. |
| scout | Una tarea que solo investiga y reporta. Nunca hace commit ni push. |
| sentinel | Un proceso en segundo plano que vigila a los soldiers y despierta al commander cuando uno termina. |
La vida de una tarea
- Pedís. En la sesión del commander (Claude Code por defecto) decís qué querés.
- El commander despacha. Siguiendo la skill
vexillumcorrevx dispatch "<prompt>" --kind mission|scout --model <m> --effort <e>. - Se adquiere un camp. vexillum toma un worktree limpio del pool del proyecto (o crea uno) en una branch nueva,
vexillum/<task-id>, bifurcada de tu branch actual. - Arranca un soldier. Se abre una sesión real e interactiva del harness del soldier (Claude Code por defecto) en un pane de herdr dentro de ese camp. El comando vuelve rápido: en cuanto herdr ve al soldier trabajando (o ya terminado), sin esperar a que termine el trabajo.
- El sentinel vigila. Consulta el estado en vivo del soldier y registra el resultado en disco. Ver Sentinel.
- Se despierta al commander. El cambio le llega al commander, así te reporta aunque su turno ya hubiera terminado: por un hook
Stopen Claude Code, una extensión de wake en Pi, o el sentinel publicando en la sesión en OpenCode (ver Sentinel). - Decidís vos. Para una mission, la aterrizás o la enviás. Para un scout, el commander transmite el reporte.
- Se hace strike del camp, que vuelve al pool, una vez que no queda nada por perder.
Qué te da el aislamiento y qué no
Un camp aísla los commits y el working tree del soldier de los tuyos. No pone el proceso en un sandbox: un soldier tiene acceso total al host con tu usuario del sistema. El control de seguridad real es la aprobación antes de aterrizar.
Dónde vive la inteligencia
El binario es plomería determinista (estado en disco, worktrees, panes, rechazos). Elegir un modelo, decidir si preguntarte, redactar un reporte: eso es criterio del commander, guiado por markdown. Ver AGENTS.md y rules.