AGENTS.md y rules
El comportamiento del commander es markdown en tu proyecto, no código del binario, un núcleo corto en AGENTS.md o CLAUDE.md, y skills.
Tu AGENTS.md o CLAUDE.md
vx init escribe el núcleo del commander en el AGENTS.md de tu proyecto, o en su CLAUDE.md cuando el proyecto no tiene AGENTS.md, dentro de un bloque que administra (el slot). El archivo es tuyo; solo lo que está entre los marcadores es de vexillum.
Esta es la decisión central del producto: la inteligencia del commander es markdown, el binario es plomería.
Qué va dónde
| Dónde | Siempre cargado | Tema |
|---|---|---|
Slot (en AGENTS.md o CLAUDE.md) | sí | Role check, vocabulary, authority, tone, y una instrucción dura: cargar la skill vexillum antes de cualquier paso operativo. |
Skill vexillum | a pedido | Despachar un soldier (siempre vx dispatch, nunca la herramienta de subagentes propia del commander), elegir modelo y effort, aterrizar, hacer ship, hacer strike, y el sentinel. |
models.json | lo lee vx models | Los valores de cada perfil de modelo y effort. |
Separarlos mantiene chico el costo siempre activo: el commander paga el detalle solo en el momento en que despacha, aterriza, hace ship o hace strike. El riesgo de cualquier diseño a pedido es que el modelo se olvide de cargar el detalle, y por eso el slot lleva esa instrucción como regla dura.
Elegir modelo y effort
La elección son datos en models.json: el commander corre vx models, lee la línea when de cada perfil, elige el que encaja y despacha con --profile. Qué perfil encaja con una tarea es criterio, y eso queda en markdown; los valores de modelo y effort los editás vos. vexillum valida los valores pero nunca los elige.
Editar y actualizar
- El slot está protegido por un hash: si editás adentro,
upgradete muestra el diff y no lo pisa sin--force. Ver El slot de AGENTS.md. upgraderefresca las skills y una editada se reporta, no se reemplaza. Ver Skills.models.jsones tuyo:initnunca lo pisa yupgradenunca lo toca.