@ingeniomaps/cauce 0.36.0 → 0.38.0

package/CHANGELOG.md

@@ -14,6 +14,40 @@ desde este repositorio no va, porque el que lee no puede actuar sobre eso. Cuand
 unas pocas líneas casi siempre es porque cuenta cómo se descubrió el problema o por qué se eligió el
 diseño — eso vive en el commit y en el código.
 
+## [0.38.0] - 2026-08-19
+
+### Añadido
+
+- **Gemini recibe `onboard` y `team`, que sólo tenía como prosa.** Estaban descritos en `GEMINI.md` y no
+  existía ningún comando detrás, así que quien venía de otro runner los buscaba en la lista y no
+  aparecían.
+
+- **`automation install` termina diciendo cómo se invoca lo que acaba de instalar.** Una línea con los
+  nombres exactos para ese runner, que es lo que evita buscar en una lista de cincuenta skills el nombre
+  que se usó en otro lado.
+
+### Cambiado
+
+- **Una convención para el nombre de cada recorrido.** El nombre es el mismo en todos los runners
+  —`onboard`, `team`, `autobuild`, `integration-sync`, `integration-promote`—; el prefijo lo pone cada
+  uno según su espacio de nombres: `/onboard` en Claude, `/cauce:onboard` en Gemini, `cauce:onboard` en
+  Antigravity. Codex no tiene comandos y opera el protocolo desde sus instrucciones.
+
+  Los comandos de Gemini se mudaron de `/ops:` a `/cauce:`. Si actualizás una instalación anterior,
+  `.gemini/commands/ops/` queda huérfano: se borra a mano, `install` no toca lo que ya no declara.
+
+## [0.37.0] - 2026-08-19
+
+### Cambiado
+
+- **El arranque deja de completar una dimensión que nadie preguntó.** Al llegar al tope de tres
+  preguntas puede quedar una afuera —quién lo usa, qué está muerto, qué externo hay—, y una corrida real
+  la escribió igual, deducida del README y de las respuestas a las otras. Todo plausible, nada dicho por
+  una persona, y sin marca: se leía con el mismo peso que lo que alguien contestó. Ahora esa dimensión
+  queda «Por definir» con su pregunta en el INBOX, y lo que se deduce de otra respuesta va marcado
+  `(supuesto)` por plausible que sea. Rige en el recorrido ejecutable y en los tres runners que operan el
+  arranque leyendo instrucciones.
+
 ## [0.36.0] - 2026-08-19
 
 ### Corregido

package/README.md

@@ -139,8 +139,20 @@ no puede hacer, así que ese recorrido vive en el runner:
 /autobuild  ejecuta una tarea ya promovida, fase por fase.
 ```
 
-Claude y Antigravity lo traen como recorrido ejecutable; Codex y Gemini lo operan siguiendo las
-instrucciones que `automation install` les deja. Sin runner, la [tabla de comandos](#comandos) y
+### Cómo se lo llama en cada runner
+
+El nombre del recorrido es el mismo en todos —`onboard`, `team`, `autobuild`, `integration-sync`,
+`integration-promote`—; el prefijo lo pone cada runner según su espacio de nombres:
+
+| Runner | Se invoca | |
+|---|---|---|
+| Claude | `/onboard` | workflow ejecutable |
+| Gemini | `/cauce:onboard` | comando |
+| Antigravity | `cauce:onboard` | skill |
+| Codex | — | opera el protocolo desde sus instrucciones |
+
+`automation install` termina diciendo la lista exacta para el runner que instalaste, que es lo que
+evita buscar en Gemini el nombre que se usó en Claude. Sin runner, la [tabla de comandos](#comandos) y
 [FLOW.md](template/planning/FLOW.md) hacen el mismo camino a mano.
 
 Dentro del proyecto el CLI se invoca con `node tools/ops.js` —o `npx cauce`, que la dependencia deja

package/automatization/runners/antigravity/manifest.json

@@ -60,5 +60,15 @@
       "list"
     ],
     "expect": "cauce"
+  },
+  "commands": {
+    "invocation": "cauce:{name}",
+    "names": [
+      "onboard",
+      "team",
+      "autobuild",
+      "integration-sync",
+      "integration-promote"
+    ]
   }
 }

package/automatization/runners/antigravity/skills/onboard/SKILL.md

@@ -60,7 +60,12 @@ falló los cinco puntos sin darse cuenta, y todos del mismo lado —lo que no pr
    no te corresponde se perdió en vez de quedar escrito para alguien.
 5. **`ops` no es un servicio del producto.** No va en el mapa real: es la instancia desde la que trabajás.
 
-6. **Corré `node {{OPS_DIR}}tools/ops.js onboard`.** Si te vuelve a ofrecer la pregunta de apertura, la
+6. **Ninguna dimensión se completa sin haberla preguntado.** Si llegaste al tope de preguntas y una
+   quedó afuera —quién lo usa, qué está muerto, qué externo hay— va «Por definir» con su pregunta en
+   `{{OPS_DIR}}planning/INBOX.md`, aunque puedas imaginar la respuesta. Y lo que deducís de otra
+   respuesta va marcado `(supuesto)`, por plausible que sea: sin la marca se lee con el mismo peso que
+   lo que la persona dijo, y nadie va a volver a preguntarlo.
+7. **Corré `node {{OPS_DIR}}tools/ops.js onboard`.** Si te vuelve a ofrecer la pregunta de apertura, la
    instancia sigue vacía: no escribiste nada, y no hay nada que informar. Una corrida real entregó un
    resumen en pasado —«registrado», «documentado», «creada la primera épica»— sobre archivos que en el
    disco seguían siendo el molde. Estar bloqueado es un resultado legítimo; narrarlo como entrega, no.

package/automatization/runners/claude/manifest.json

@@ -53,5 +53,15 @@
     "checkpointing": false,
     "nativeSkills": true
   },
-  "roleSkills": ".claude/skills"
+  "roleSkills": ".claude/skills",
+  "commands": {
+    "invocation": "/{name}",
+    "names": [
+      "onboard",
+      "team",
+      "autobuild",
+      "integration-sync",
+      "integration-promote"
+    ]
+  }
 }

package/automatization/runners/codex/AGENTS.md

@@ -57,7 +57,9 @@ Antes de darlo por terminado, comprobá cinco cosas mirando el disco: preguntast
 formulario; la épica se llama `epic-NNN-<slug>.md` con `status: open` —`epic-001.md` no lo lee nadie—;
 las secciones de `{{OPS_DIR}}organization/` siguen siendo las del molde y lo tuyo se agregó adentro;
 `{{OPS_DIR}}planning/HUMAN_ACTIONS.md` tiene una fila por credencial, por externo y por la autoridad de
-push; y `ops` no figura como servicio del producto en el mapa. Cerrá corriendo
+push; y `ops` no figura como servicio del producto en el mapa. una dimensión que no
+llegaste a preguntar va «Por definir» con su pregunta en `{{OPS_DIR}}planning/INBOX.md` en vez de
+completarse deduciéndola, y lo que deducís de otra respuesta va marcado `(supuesto)`. Cerrá corriendo
 `node {{OPS_DIR}}tools/ops.js onboard`: si te vuelve a ofrecer la pregunta de apertura, no escribiste
 nada y no hay nada que informar. Estar bloqueado es un resultado legítimo; narrarlo como entrega, no.
 

package/automatization/runners/codex/manifest.json

@@ -19,5 +19,9 @@
     "projectInstructions": true,
     "checkpointing": false,
     "nativeSkills": false
+  },
+  "commands": {
+    "invocation": "",
+    "names": []
   }
 }

package/automatization/runners/gemini/GEMINI.md

@@ -50,7 +50,9 @@ Antes de darlo por terminado, comprobá cinco cosas mirando el disco: preguntast
 formulario; la épica se llama `epic-NNN-<slug>.md` con `status: open` —`epic-001.md` no lo lee nadie—;
 las secciones de `{{OPS_DIR}}organization/` siguen siendo las del molde y lo tuyo se agregó adentro;
 `{{OPS_DIR}}planning/HUMAN_ACTIONS.md` tiene una fila por credencial, por externo y por la autoridad de
-push; y `ops` no figura como servicio del producto en el mapa. Cerrá corriendo
+push; y `ops` no figura como servicio del producto en el mapa. una dimensión que no
+llegaste a preguntar va «Por definir» con su pregunta en `{{OPS_DIR}}planning/INBOX.md` en vez de
+completarse deduciéndola, y lo que deducís de otra respuesta va marcado `(supuesto)`. Cerrá corriendo
 `node {{OPS_DIR}}tools/ops.js onboard`: si te vuelve a ofrecer la pregunta de apertura, no escribiste
 nada y no hay nada que informar. Estar bloqueado es un resultado legítimo; narrarlo como entrega, no.
 

package/automatization/runners/gemini/README.md

@@ -9,8 +9,12 @@ Adaptador mediante configuración de proyecto, `GEMINI.md`, checkpointing y coma
 node tools/ops.js automation install . gemini
 ```
 
-Instala `.gemini/settings.json`, el contexto raíz `GEMINI.md` y los comandos `/ops:autobuild`,
-`/ops:integration-sync` y `/ops:integration-promote`.
+Instala `.gemini/settings.json`, el contexto raíz `GEMINI.md` y los comandos `/cauce:onboard`,
+`/cauce:team`, `/cauce:autobuild`, `/cauce:integration-sync` y `/cauce:integration-promote`.
+
+Antes vivían bajo `/ops:` y eran tres: el arranque y el recorrido de equipo le llegaban sólo como prosa,
+así que alguien que venía de otro runner los buscaba en la lista y no estaban. Si actualizás una
+instalación vieja, `.gemini/commands/ops/` queda huérfano y se borra a mano.
 
 Gemini no anuncia hooks nativos en este adaptador: los guards se ejecutan como prechecks indicados por el
 protocolo y los comandos. Esta degradación está declarada en `manifest.json`, no se simula protección inexistente.

package/automatization/runners/gemini/commands/cauce/onboard.toml

@@ -0,0 +1,21 @@
+description = "Arranca una instancia recién creada: pregunta, escribe el contexto y la primera épica"
+prompt = """
+Seguí la sección «El arranque» de {{OPS_DIR}}AGENTS.md y de este contexto raíz.
+
+Empezá por `node {{OPS_DIR}}tools/ops.js onboard`: es instantáneo, y la primera línea que imprime es la
+pregunta con la que tenés que abrir. Hacésela tal cual y esperá la respuesta antes de mirar el
+inventario, sea el workspace vacío, un monolito o diez repos. Según lo que conteste, hasta tres
+preguntas más con las palabras de ese proyecto, una por vez. El inventario ya viene resuelto en esa
+salida —servicios, comandos declarados y las variables que cada uno espera—: no recorras el árbol ni
+corras comandos del proyecto para completarlo.
+
+Con eso escribí {{OPS_DIR}}organization/, la sección «Mapa real» de {{OPS_DIR}}AGENTS.md con cada
+comando tal como está declarado y de qué archivo salió, y las raíces reales en workspaceRoots. Las
+credenciales, los sistemas externos y el permiso de push van como filas de
+{{OPS_DIR}}planning/HUMAN_ACTIONS.md, sin proponer ningún valor. Una dimensión que no llegaste a
+preguntar queda «Por definir» con su pregunta en {{OPS_DIR}}planning/INBOX.md, y lo que deducís de otra
+respuesta va marcado «(supuesto)».
+
+Cerrá escribiendo la épica como epic-NNN-<slug>.md con status: open —sin slug no la lee nadie— y corré
+`node {{OPS_DIR}}tools/ops.js check planning`. Nunca promuevas al BACKLOG: esa firma es humana.
+"""

package/automatization/runners/gemini/commands/cauce/team.toml

@@ -0,0 +1,15 @@
+description = "Recorre un equipo y propone una épica candidata, sin promoverla"
+prompt = """
+Obtené el recorrido con `node {{OPS_DIR}}tools/ops.js team show <slug> --json` y ejecutá una etapa a la
+vez, adoptando en cada una el contrato del cargo que la posee. Respetá el dueño de decisión de cada
+dominio: ningún otro cargo resuelve en su lugar.
+
+Marcá el exit gate de una etapa como cumplido sólo si se cumple de verdad. Cuando falte evidencia,
+autoridad o una decisión externa, registrá la acción concreta en {{OPS_DIR}}planning/HUMAN_ACTIONS.md y
+detente: una opinión del modelo no es investigación de usuarios ni valida un problema.
+
+Si la intención resulta viable, escribí la épica en {{OPS_DIR}}planning/roadmap/ como
+epic-NNN-<slug>.md con criterios observables y cerrá con `node {{OPS_DIR}}tools/ops.js check planning`.
+Si no lo es, registrá en {{OPS_DIR}}planning/INBOX.md por qué y qué la haría viable. **Nunca promuevas
+al BACKLOG**: esa firma es humana.
+"""

package/automatization/runners/gemini/manifest.json

@@ -18,16 +18,24 @@
   ],
   "artifacts": [
     {
-      "source": "commands/ops/autobuild.toml",
-      "target": ".gemini/commands/ops/autobuild.toml"
+      "source": "commands/cauce/autobuild.toml",
+      "target": ".gemini/commands/cauce/autobuild.toml"
     },
     {
-      "source": "commands/ops/integration-sync.toml",
-      "target": ".gemini/commands/ops/integration-sync.toml"
+      "source": "commands/cauce/integration-sync.toml",
+      "target": ".gemini/commands/cauce/integration-sync.toml"
     },
     {
-      "source": "commands/ops/integration-promote.toml",
-      "target": ".gemini/commands/ops/integration-promote.toml"
+      "source": "commands/cauce/integration-promote.toml",
+      "target": ".gemini/commands/cauce/integration-promote.toml"
+    },
+    {
+      "source": "commands/cauce/onboard.toml",
+      "target": ".gemini/commands/cauce/onboard.toml"
+    },
+    {
+      "source": "commands/cauce/team.toml",
+      "target": ".gemini/commands/cauce/team.toml"
     }
   ],
   "capabilities": {
@@ -37,5 +45,15 @@
     "checkpointing": true,
     "nativeSkills": true
   },
-  "roleSkills": ".gemini/skills"
+  "roleSkills": ".gemini/skills",
+  "commands": {
+    "invocation": "/cauce:{name}",
+    "names": [
+      "onboard",
+      "team",
+      "autobuild",
+      "integration-sync",
+      "integration-promote"
+    ]
+  }
 }

package/automatization/workflows/onboard.js

@@ -165,7 +165,11 @@ const drafted = await agent(
   `${BASE}\n\n${EVIDENCE}\n\nEscribí de una sola pasada el contexto de esta instancia, reemplazando el ` +
   `molde en vez de comentarlo:\n` +
   `1. ${ORG}/company.md y ${ORG}/product.md: lo que la persona contó y los nombres del repositorio ` +
-  `permiten afirmar. Lo que nada sostiene queda "Por definir" y su pregunta va a openQuestions. No des ` +
+  `permiten afirmar. Lo que nada sostiene queda "Por definir" y su pregunta va a openQuestions. Una ` +
+  `dimensión que no llegaste a preguntar no se completa deduciéndola: queda "Por definir" con su ` +
+  `pregunta en openQuestions, aunque puedas imaginar la respuesta. Y lo que sí deducís de otra ` +
+  `respuesta va marcado "(supuesto)", por plausible que sea: sin la marca se lee con el mismo peso que ` +
+  `lo que alguien dijo. No des ` +
   `por sentado que el proyecto vende algo: puede sostenerse con donaciones, presupuesto interno o ` +
   `trabajo voluntario, y una sección que no aplica se dice, no se completa con algo plausible.\n` +
   `2. La sección "## Mapa real" de ${ROOT}/AGENTS.md: una entrada por servicio con su ruta, su runtime y ` +

package/engine/automation/index.js

@@ -694,6 +694,15 @@ function install(root, name, output = console, options = {}) {
     }
   }
   installRoleSkills(root, runner, output)
+  // Cómo se lo llama acá. El nombre del recorrido es el mismo en todos los runners —`onboard`, `team`,
+  // `autobuild`—; el prefijo lo pone cada uno según su espacio de nombres, y esa diferencia es la que
+  // hace que alguien no encuentre en Gemini lo que usó en Claude. Decirlo al instalar cuesta una línea
+  // y ahorra buscarlo en una lista de cincuenta skills.
+  const invocacion = runner.commands && runner.commands.invocation
+  if (invocacion && (runner.commands.names || []).length) {
+    const lista = runner.commands.names.map((nombre) => invocacion.replace('{name}', nombre))
+    output.log(`  ${name}: se invocan como ${lista.join(', ')}`)
+  }
   if (runner.activation && activated(runner) !== true) {
     output.log(`  ${name}: falta registrarlo para que corra. Desde ${paths.install}:`)
     output.log(`    ${runner.activation.hint}`)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ingeniomaps/cauce",
-  "version": "0.36.0",
+  "version": "0.38.0",
   "description": "Sistema portable de planificación y ejecución verificable para cualquier proyecto",
   "keywords": [
     "planning",