oh-my-muse 0.2.0 → 0.2.1

package/bin/lib.mjs

@@ -258,7 +258,7 @@ export const NOTIFY_SETUP_OPTIONS = [
     name: "message",
     aliases: ["text"],
     value: "<text>",
-    desc: "Default message template (supports {{projectName}} {{event}} {{date}} and $ENV).",
+    desc: "Default message template (supports {{projectName}} {{event}} {{date}} and $ENV; $ENV expands only from the CLI, never from the hook — Muse filters hook env).",
     channels: ["telegram", "discord", "slack", "file"],
     required: false,
     secret: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-muse",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Native Muse Code plugin: specialist skills, orchestrator commands, and turn-end notifications",
   "keywords": [
     "muse",
@@ -34,6 +34,6 @@
     "node": ">=20"
   },
   "scripts": {
-    "test": "node --test test/cli.test.mjs test/e2e.test.mjs test/validators.test.mjs test/tarball.test.mjs test/notify-config.test.mjs"
+    "test": "node --test test/cli.test.mjs test/e2e.test.mjs test/validators.test.mjs test/tarball.test.mjs test/notify-config.test.mjs test/orchestration.test.mjs test/hygiene.test.mjs"
   }
 }

package/plugin/.muse-plugin/plugin.json

@@ -2,7 +2,7 @@
   "schemaVersion": 1,
   "name": "oh-my-muse",
   "displayName": "Oh My Muse",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Specialist skills and orchestrator commands for Muse Code, with turn-end notifications.",
   "compat": {
     "source": "native",

package/plugin/commands/omm-advisor.md

@@ -5,28 +5,82 @@ argument-hint: <question>
 
 # OMM Advisor
 
-Answer the requested question with three independent advisors reconciled
-into one decision: $ARGUMENTS
+Responde la pregunta con tres asesores independientes reconciliados en
+una decisión: $ARGUMENTS
+
+## Reglas de orquestación (obligatorias)
+
+1. DEBES empezar llamando a `read_skill bundled:workflow-authoring` y
+   seguir su perfil Workflow API V1 con el esquema
+   `complete/evidence/unresolved`. Sin esta lectura no hay oleadas.
+   Tras esa lectura, OBLIGATORIO: `read_skill
+   plugin:oh-my-muse:omm-narration` y obedecer sus cuatro plantillas
+   (arranque, cabecera de oleada, tarjeta de oleada, cierre) en el
+   idioma del usuario.
+2. DEBES orquestar con la herramienta Workflow. PROHIBIDO implementar,
+   investigar o editar en el hilo principal: el hilo principal solo
+   anuncia el plan, lanza Workflows, narra entre oleadas e integra el
+   resultado al final.
+3. Si la herramienta Workflow no está disponible en tu sesión, DEBES
+   decirlo explícitamente ("Workflow no disponible: paro sin ejecutar")
+   y parar. PROHIBIDO seguir en silencio en el hilo principal.
+4. Un Workflow por oleada: DEBES lanzar una llamada a la herramienta
+   Workflow POR CADA oleada del plan (nunca un único Workflow para
+   todo). Un Workflow solo devuelve su resultado al terminar y el padre
+   no puede narrar mientras se ejecuta; entre oleadas, narra el
+   progreso.
+5. PROHIBIDO encadenar dos llamadas a Workflow sin haber escrito antes
+   la tarjeta de fin de oleada (`✔`/`⚠`/`✖` + `**Gate:**` +
+   `**Siguiente:**`) y la cabecera `▶` de la siguiente oleada. La
+   narración va en el hilo principal: el resultado del Workflow es
+   para el padre, el usuario ve la tarjeta.
+
+## Contrato de progreso (visible para el usuario)
+
+- Antes de lanzar: publica el plan con las oleadas, los roles de cada
+  oleada y el gate de cada una.
+- Tras cada oleada: por cada hijo informa rol + hallazgos clave (2-3
+  líneas) + archivos tocados + `unresolved`. Después anuncia la
+  decisión del gate (avanza / reintenta / para).
+- Al final: informe con qué se hizo, verificación (gates del repo) y
+  pendientes (`unresolved` restantes).
+
+## Forma de cada `input` (obligatoria)
+
+- El `input` de cada hijo DEBE empezar con "Primero llama a read_skill plugin:oh-my-muse:<rol>." (sustituye `<rol>` por el rol de ese hijo:
+  `architect`, `critic`, `security-reviewer` asesores, `planner`
+  reconciliador) y pedir el esquema
+  `complete/evidence/unresolved/summary/files/decisions`
+  (`complete:boolean`, `evidence:string[]`, `unresolved:string[]`,
+  `summary:string` — máx. 2 líneas, `files:string[]`,
+  `decisions:string[]`).
+- Cada `input` completo DEBE respetar el límite de 4096 bytes UTF-8
+  (texto + refs + contexto compacto + `summary`/`files`/`decisions`
+  juntos).
+- Cada llamada de hijo lleva `label: "w<N>-<rol>"` (p. ej.
+  `w2-implementer`).
 
 ## Setup
 
-1. Load the `workflow-authoring` skill and follow its Workflow API V1 profile.
-   Subagents exist only inside the Workflow you author here.
-2. Load the `harness` and `verify` skills and obey them for the whole run.
-3. Use only these specialists: `architect`, `critic`, `security-reviewer`
-   (advisors), `planner` (reconciler). There are no tiers and no per-agent
-   models; the session model does all the work.
+Usa solo estos especialistas: `architect`, `critic`,
+`security-reviewer` (asesores), `planner` (reconciliador). No hay
+niveles ni modelos por agente; el modelo de la sesión hace todo el
+trabajo. Carga además las skills `harness` y `verify` y obedécelas
+durante toda la ejecución.
+
+## Oleadas
 
-## Wave plan
+Una llamada a Workflow por oleada:
 
-1. **Independent advisors**: consult exactly three advisors independently
-   (`architect`, `critic`, `security-reviewer`). Advisors must not see each
-   other's output before writing their own.
-2. **Reconcile**: `planner` merges the three outputs afterwards — keep what
-   they agree on, resolve disagreements with evidence from the repository,
-   and record any remaining dissent explicitly.
+1. **Asesores independientes**: consulta exactamente a tres asesores
+   (`architect`, `critic`, `security-reviewer`) en un Workflow. Los
+   asesores no deben ver la salida de los otros antes de escribir la
+   suya.
+2. **Reconciliación**: `planner` fusiona las tres salidas en un
+   segundo Workflow — conserva lo acordado, resuelve desacuerdos con
+   evidencia del repo y registra el disenso restante explícitamente.
 
 ## Gate
 
-The reconciled decision must cite each advisor and resolve every
-disagreement. Never present a single advisor's view as the consensus.
+La decisión reconciliada debe citar a cada asesor y resolver cada
+desacuerdo. Nunca presentes la visión de un solo asesor como consenso.

package/plugin/commands/omm-autopilot.md

@@ -5,27 +5,85 @@ argument-hint: <change>
 
 # OMM Autopilot
 
-Run the requested change with a single driver owning it end to end: $ARGUMENTS
+Ejecuta el cambio con un único conductor responsable de principio a
+fin: $ARGUMENTS
+
+## Reglas de orquestación (obligatorias)
+
+1. DEBES empezar llamando a `read_skill bundled:workflow-authoring` y
+   seguir su perfil Workflow API V1 con el esquema
+   `complete/evidence/unresolved`. Sin esta lectura no hay oleadas.
+   Tras esa lectura, OBLIGATORIO: `read_skill
+   plugin:oh-my-muse:omm-narration` y obedecer sus cuatro plantillas
+   (arranque, cabecera de oleada, tarjeta de oleada, cierre) en el
+   idioma del usuario.
+2. DEBES orquestar con la herramienta Workflow. PROHIBIDO implementar,
+   investigar o editar en el hilo principal: el hilo principal solo
+   anuncia el plan, lanza Workflows, narra entre oleadas e integra el
+   resultado al final.
+3. Si la herramienta Workflow no está disponible en tu sesión, DEBES
+   decirlo explícitamente ("Workflow no disponible: paro sin ejecutar")
+   y parar. PROHIBIDO seguir en silencio en el hilo principal.
+4. Un Workflow por oleada: DEBES lanzar una llamada a la herramienta
+   Workflow POR CADA oleada del plan (nunca un único Workflow para
+   todo). Un Workflow solo devuelve su resultado al terminar y el padre
+   no puede narrar mientras se ejecuta; entre oleadas, narra el
+   progreso.
+5. PROHIBIDO encadenar dos llamadas a Workflow sin haber escrito antes
+   la tarjeta de fin de oleada (`✔`/`⚠`/`✖` + `**Gate:**` +
+   `**Siguiente:**`) y la cabecera `▶` de la siguiente oleada. La
+   narración va en el hilo principal: el resultado del Workflow es
+   para el padre, el usuario ve la tarjeta.
+
+## Contrato de progreso (visible para el usuario)
+
+- Antes de lanzar: publica el plan con las oleadas, los roles de cada
+  oleada y el gate de cada una.
+- Tras cada oleada: por cada hijo informa rol + hallazgos clave (2-3
+  líneas) + archivos tocados + `unresolved`. Después anuncia la
+  decisión del gate (avanza / reintenta / para).
+- Al final: informe con qué se hizo, verificación (gates del repo) y
+  pendientes (`unresolved` restantes).
+
+## Forma de cada `input` (obligatoria)
+
+- El `input` de cada hijo DEBE empezar con "Primero llama a read_skill plugin:oh-my-muse:<rol>." (sustituye `<rol>` por el rol de ese hijo:
+  `implementer` conductor, `researcher`, `tester`, `debugger`,
+  `docs-writer` ayudantes) y pedir el esquema
+  `complete/evidence/unresolved/summary/files/decisions`
+  (`complete:boolean`, `evidence:string[]`, `unresolved:string[]`,
+  `summary:string` — máx. 2 líneas, `files:string[]`,
+  `decisions:string[]`).
+- Cada `input` completo DEBE respetar el límite de 4096 bytes UTF-8
+  (texto + refs + contexto compacto + `summary`/`files`/`decisions`
+  juntos).
+- Cada llamada de hijo lleva `label: "w<N>-<rol>"` (p. ej.
+  `w2-implementer`).
 
 ## Setup
 
-1. Load the `workflow-authoring` skill and follow its Workflow API V1 profile.
-   Subagents exist only inside the Workflow you author here.
-2. Load the `harness` and `verify` skills and obey them for the whole run.
-3. Use only these specialists: `implementer` (driver), `researcher`,
-   `tester`, `debugger`, `docs-writer` (helpers). There are no tiers and no
-   per-agent models; the session model does all the work.
+Usa solo estos especialistas: `implementer` (conductor), `researcher`,
+`tester`, `debugger`, `docs-writer` (ayudantes). No hay niveles ni
+modelos por agente; el modelo de la sesión hace todo el trabajo. Carga
+además las skills `harness` y `verify` y obedécelas durante toda la
+ejecución.
+
+## Oleadas
 
-## Wave plan
+Un único conductor (`implementer`) es dueño del cambio de principio a
+fin. Ejecuta estas oleadas, una llamada a Workflow por oleada:
 
-1. **Driver step**: exactly one driver (`implementer`) owns the change end
-   to end and drives it to completion.
-2. **Helper wave**: helpers (`researcher`, `tester`, `debugger`,
-   `docs-writer`) support the driver in parallel and never take over the diff.
+1. **Ayudantes investigan**: `researcher` (y `debugger` si hay un fallo
+   que reproducir) trabajan en paralelo en un Workflow y devuelven
+   evidencia al conductor. No tocan el diff.
+2. **El conductor implementa**: un Workflow con el `implementer` que
+   aplica el cambio de principio a fin.
+3. **Ayudantes verifican**: `tester`, `debugger` y `docs-writer` en
+   paralelo en un Workflow; el conductor integra sus salidas en el
+   diff final, verifica con los gates propios del repo e informa.
 
 ## Gate
 
-The driver owns the final diff; helpers never commit over the driver. If
-helpers disagree, the driver decides and records why. The driver integrates
-helper outputs, verifies the result with the repository's own gates, and
-reports done.
+El conductor es dueño del diff final; los ayudantes nunca escriben
+sobre él. Si los ayudantes discrepan, el conductor decide y registra
+por qué.

package/plugin/commands/omm-pipeline.md

@@ -5,24 +5,75 @@ argument-hint: <work>
 
 # OMM Pipeline
 
-Run the requested work as a strict sequence, one step at a time: $ARGUMENTS
+Ejecuta el trabajo en secuencia estricta, un paso cada vez: $ARGUMENTS
+
+## Reglas de orquestación (obligatorias)
+
+1. DEBES empezar llamando a `read_skill bundled:workflow-authoring` y
+   seguir su perfil Workflow API V1 con el esquema
+   `complete/evidence/unresolved`. Sin esta lectura no hay oleadas.
+   Tras esa lectura, OBLIGATORIO: `read_skill
+   plugin:oh-my-muse:omm-narration` y obedecer sus cuatro plantillas
+   (arranque, cabecera de oleada, tarjeta de oleada, cierre) en el
+   idioma del usuario.
+2. DEBES orquestar con la herramienta Workflow. PROHIBIDO implementar,
+   investigar o editar en el hilo principal: el hilo principal solo
+   anuncia el plan, lanza Workflows, narra entre oleadas e integra el
+   resultado al final.
+3. Si la herramienta Workflow no está disponible en tu sesión, DEBES
+   decirlo explícitamente ("Workflow no disponible: paro sin ejecutar")
+   y parar. PROHIBIDO seguir en silencio en el hilo principal.
+4. Un Workflow por oleada: DEBES lanzar una llamada a la herramienta
+   Workflow POR CADA oleada del plan (nunca un único Workflow para
+   todo). Un Workflow solo devuelve su resultado al terminar y el padre
+   no puede narrar mientras se ejecuta; entre oleadas, narra el
+   progreso.
+5. PROHIBIDO encadenar dos llamadas a Workflow sin haber escrito antes
+   la tarjeta de fin de oleada (`✔`/`⚠`/`✖` + `**Gate:**` +
+   `**Siguiente:**`) y la cabecera `▶` de la siguiente oleada. La
+   narración va en el hilo principal: el resultado del Workflow es
+   para el padre, el usuario ve la tarjeta.
+
+## Contrato de progreso (visible para el usuario)
+
+- Antes de lanzar: publica el plan con las oleadas, los roles de cada
+  oleada y el gate de cada una.
+- Tras cada oleada: por cada hijo informa rol + hallazgos clave (2-3
+  líneas) + archivos tocados + `unresolved`. Después anuncia la
+  decisión del gate (avanza / reintenta / para).
+- Al final: informe con qué se hizo, verificación (gates del repo) y
+  pendientes (`unresolved` restantes).
+
+## Forma de cada `input` (obligatoria)
+
+- El `input` de cada hijo DEBE empezar con "Primero llama a read_skill plugin:oh-my-muse:<rol>." (sustituye `<rol>` por el rol de ese hijo:
+  `planner`, `implementer`, `tester`, `reviewer`) y pedir el esquema
+  `complete/evidence/unresolved/summary/files/decisions`
+  (`complete:boolean`, `evidence:string[]`, `unresolved:string[]`,
+  `summary:string` — máx. 2 líneas, `files:string[]`,
+  `decisions:string[]`).
+- Cada `input` completo DEBE respetar el límite de 4096 bytes UTF-8
+  (texto + refs + contexto compacto + `summary`/`files`/`decisions`
+  juntos).
+- Cada llamada de hijo lleva `label: "w<N>-<rol>"` (p. ej.
+  `w2-implementer`).
 
 ## Setup
 
-1. Load the `workflow-authoring` skill and follow its Workflow API V1 profile.
-   Subagents exist only inside the Workflow you author here.
-2. Load the `harness` and `verify` skills and obey them for the whole run.
-3. Use only these specialists: `planner`, `implementer`, `tester`,
-   `reviewer`. There are no tiers and no per-agent models; the session model
-   does all the work.
+Usa solo estos especialistas: `planner`, `implementer`, `tester`,
+`reviewer`. No hay niveles ni modelos por agente; el modelo de la
+sesión hace todo el trabajo. Carga además las skills `harness` y
+`verify` y obedécelas durante toda la ejecución.
 
-## Wave plan
+## Oleadas
 
-Run steps in the given order, exactly one at a time. After every step, run
-its `verifyCommand` (default: `npm test`) and require exit code 0 before
-advancing. Never skip, reorder, or parallelize steps.
+Cada paso es una oleada: un Workflow por paso, en el orden dado, de
+uno en uno. Nunca saltes, reordenes ni paralelices pasos. Tras cada
+oleada ejecuta su `verifyCommand` (por defecto `npm test`) y exige
+código de salida 0 antes de avanzar. Narra el progreso entre oleadas.
 
 ## Gate
 
-Each step must end with `verifyCommand` exit 0; any nonzero exit blocks the
-pipeline. Fix the step and re-verify before advancing.
+Cada paso debe terminar con `verifyCommand` en 0; cualquier salida no
+cero bloquea el pipeline. Corrige el paso y re-verifica antes de
+avanzar.

package/plugin/commands/omm-ralph.md

@@ -5,25 +5,78 @@ argument-hint: <work>
 
 # OMM Ralph
 
-Advance the requested work in a single-check loop: $ARGUMENTS
+Avanza el trabajo en un bucle de un solo chequeo: $ARGUMENTS
+
+## Reglas de orquestación (obligatorias)
+
+1. DEBES empezar llamando a `read_skill bundled:workflow-authoring` y
+   seguir su perfil Workflow API V1 con el esquema
+   `complete/evidence/unresolved`. Sin esta lectura no hay oleadas.
+   Tras esa lectura, OBLIGATORIO: `read_skill
+   plugin:oh-my-muse:omm-narration` y obedecer sus cuatro plantillas
+   (arranque, cabecera de oleada, tarjeta de oleada, cierre) en el
+   idioma del usuario.
+2. DEBES orquestar con la herramienta Workflow. PROHIBIDO implementar,
+   investigar o editar en el hilo principal: el hilo principal solo
+   anuncia el plan, lanza Workflows, narra entre oleadas e integra el
+   resultado al final.
+3. Si la herramienta Workflow no está disponible en tu sesión, DEBES
+   decirlo explícitamente ("Workflow no disponible: paro sin ejecutar")
+   y parar. PROHIBIDO seguir en silencio en el hilo principal.
+4. Un Workflow por oleada: DEBES lanzar una llamada a la herramienta
+   Workflow POR CADA oleada del plan (nunca un único Workflow para
+   todo). Un Workflow solo devuelve su resultado al terminar y el padre
+   no puede narrar mientras se ejecuta; entre oleadas, narra el
+   progreso.
+5. PROHIBIDO encadenar dos llamadas a Workflow sin haber escrito antes
+   la tarjeta de fin de oleada (`✔`/`⚠`/`✖` + `**Gate:**` +
+   `**Siguiente:**`) y la cabecera `▶` de la siguiente oleada. La
+   narración va en el hilo principal: el resultado del Workflow es
+   para el padre, el usuario ve la tarjeta.
+
+## Contrato de progreso (visible para el usuario)
+
+- Antes de lanzar: publica el plan con las oleadas, los roles de cada
+  oleada y el gate de cada una.
+- Tras cada oleada: por cada hijo informa rol + hallazgos clave (2-3
+  líneas) + archivos tocados + `unresolved`. Después anuncia la
+  decisión del gate (avanza / reintenta / para).
+- Al final: informe con qué se hizo, verificación (gates del repo) y
+  pendientes (`unresolved` restantes).
+
+## Forma de cada `input` (obligatoria)
+
+- El `input` de cada hijo DEBE empezar con "Primero llama a read_skill plugin:oh-my-muse:<rol>." (sustituye `<rol>` por el rol de ese hijo:
+  `planner`, `implementer`, `tester`, `reviewer`, `debugger`) y pedir
+  el esquema
+  `complete/evidence/unresolved/summary/files/decisions`
+  (`complete:boolean`, `evidence:string[]`, `unresolved:string[]`,
+  `summary:string` — máx. 2 líneas, `files:string[]`,
+  `decisions:string[]`).
+- Cada `input` completo DEBE respetar el límite de 4096 bytes UTF-8
+  (texto + refs + contexto compacto + `summary`/`files`/`decisions`
+  juntos).
+- Cada llamada de hijo lleva `label: "w<N>-<rol>"` (p. ej.
+  `w2-implementer`).
 
 ## Setup
 
-1. Load the `workflow-authoring` skill and follow its Workflow API V1 profile.
-   Subagents exist only inside the Workflow you author here.
-2. Load the `harness` and `verify` skills and obey them for the whole run.
-3. Use only these specialists: `planner`, `implementer`, `tester`,
-   `reviewer`, `debugger`. There are no tiers and no per-agent models; the
-   session model does all the work.
+Usa solo estos especialistas: `planner`, `implementer`, `tester`,
+`reviewer`, `debugger`. No hay niveles ni modelos por agente; el
+modelo de la sesión hace todo el trabajo. Carga además las skills
+`harness` y `verify` y obedécelas durante toda la ejecución.
 
-## Wave plan
+## Oleadas
 
-Pick the next unfinished step and run only that step. End the iteration with
-one check: pass (advance) or fail (retry with a fix). Keep each iteration
-small and self-contained; never batch multiple steps. Loop until every step
-passes its check.
+Cada iteración del bucle es una oleada: un Workflow por iteración.
+Elige el siguiente paso sin terminar y ejecuta solo ese paso. Termina
+la iteración con un único chequeo: pasa (avanza) o falla (reintenta
+con una corrección). Mantén cada iteración pequeña y autocontenida;
+nunca agrupes varios pasos. Repite hasta que todos los pasos pasen su
+chequeo, narrando el progreso entre iteraciones.
 
 ## Gate
 
-One step per loop iteration; each iteration ends with a single pass/fail
-check. The run is done only when every step has passed.
+Un paso por iteración; cada iteración termina con un único chequeo
+pasa/falla. La ejecución termina solo cuando todos los pasos han
+pasado.

package/plugin/commands/omm-team.md

@@ -5,33 +5,86 @@ argument-hint: <goal>
 
 # OMM Team
 
-Run the requested goal as an orchestrated team effort: $ARGUMENTS
+Ejecuta el objetivo como un equipo orquestado: $ARGUMENTS
+
+## Reglas de orquestación (obligatorias)
+
+1. DEBES empezar llamando a `read_skill bundled:workflow-authoring` y
+   seguir su perfil Workflow API V1 con el esquema
+   `complete/evidence/unresolved`. Sin esta lectura no hay oleadas.
+   Tras esa lectura, OBLIGATORIO: `read_skill
+   plugin:oh-my-muse:omm-narration` y obedecer sus cuatro plantillas
+   (arranque, cabecera de oleada, tarjeta de oleada, cierre) en el
+   idioma del usuario.
+2. DEBES orquestar con la herramienta Workflow. PROHIBIDO implementar,
+   investigar o editar en el hilo principal: el hilo principal solo
+   anuncia el plan, lanza Workflows, narra entre oleadas e integra el
+   resultado al final.
+3. Si la herramienta Workflow no está disponible en tu sesión, DEBES
+   decirlo explícitamente ("Workflow no disponible: paro sin ejecutar")
+   y parar. PROHIBIDO seguir en silencio en el hilo principal.
+4. Un Workflow por oleada: DEBES lanzar una llamada a la herramienta
+   Workflow POR CADA oleada del plan (nunca un único Workflow para
+   todo). Un Workflow solo devuelve su resultado al terminar y el padre
+   no puede narrar mientras se ejecuta; entre oleadas, narra el
+   progreso.
+5. PROHIBIDO encadenar dos llamadas a Workflow sin haber escrito antes
+   la tarjeta de fin de oleada (`✔`/`⚠`/`✖` + `**Gate:**` +
+   `**Siguiente:**`) y la cabecera `▶` de la siguiente oleada. La
+   narración va en el hilo principal: el resultado del Workflow es
+   para el padre, el usuario ve la tarjeta.
+
+## Contrato de progreso (visible para el usuario)
+
+- Antes de lanzar: publica el plan con las oleadas, los roles de cada
+  oleada y el gate de cada una.
+- Tras cada oleada: por cada hijo informa rol + hallazgos clave (2-3
+  líneas) + archivos tocados + `unresolved`. Después anuncia la
+  decisión del gate (avanza / reintenta / para).
+- Al final: informe con qué se hizo, verificación (gates del repo) y
+  pendientes (`unresolved` restantes).
+
+## Forma de cada `input` (obligatoria)
+
+- El `input` de cada hijo DEBE empezar con "Primero llama a read_skill plugin:oh-my-muse:<rol>." (sustituye `<rol>` por el rol de ese hijo:
+  `researcher`, `planner`, `implementer`, `tester`, `reviewer`,
+  `critic`) y pedir el esquema
+  `complete/evidence/unresolved/summary/files/decisions`
+  (`complete:boolean`, `evidence:string[]`, `unresolved:string[]`,
+  `summary:string` — máx. 2 líneas, `files:string[]`,
+  `decisions:string[]`).
+- Cada `input` completo DEBE respetar el límite de 4096 bytes UTF-8
+  (texto + refs + contexto compacto + `summary`/`files`/`decisions`
+  juntos).
+- Cada llamada de hijo lleva `label: "w<N>-<rol>"` (p. ej.
+  `w2-implementer`).
 
 ## Setup
 
-1. Load the `workflow-authoring` skill and follow its Workflow API V1 profile.
-   Subagents exist only inside the Workflow you author here.
-2. Load the `harness` and `verify` skills and obey them for the whole run.
-3. Use only these specialists: `researcher`, `planner`, `implementer`,
-   `tester`, `reviewer`, `critic`. There are no tiers and no per-agent models;
-   the session model does all the work.
+Usa solo estos especialistas: `researcher`, `planner`, `implementer`,
+`tester`, `reviewer`, `critic`. No hay niveles ni modelos por agente;
+el modelo de la sesión hace todo el trabajo. Carga además las skills
+`harness` y `verify` y obedécelas durante toda la ejecución.
 
-## Wave plan
+## Oleadas
 
-Represent the goal as typed steps (id, title, agent, files, verifyCommand),
-then run them in these waves:
+Representa el objetivo como pasos tipados (id, título, agente,
+archivos, verifyCommand) y ejecútalos en estas oleadas, una llamada a
+Workflow por oleada:
 
-1. **Parallel research**: all read-only steps (`researcher`, or steps with no
-   agent assigned) run together.
-2. **Serialized same-file edits**: steps touching the same files run in order,
-   one group per distinct file set, never in parallel.
-3. **File-independent writes**: steps with no files, or disjoint file sets,
-   run in parallel.
-4. **Reviewer loop**: send the resulting diff to `reviewer` and fix blocking
-   findings until the verdict is `approve`.
+1. **Investigación paralela**: todos los pasos de solo lectura
+   (`researcher`, o pasos sin agente asignado) juntos en un Workflow.
+2. **Ediciones del mismo archivo, en serie**: los pasos que tocan los
+   mismos archivos van en orden, un Workflow por grupo de archivos.
+   Nunca en paralelo.
+3. **Escrituras independientes**: pasos sin archivos o con archivos
+   disjuntos, en paralelo en un Workflow.
+4. **Bucle de revisión**: un Workflow por iteración que envía el diff
+   a `reviewer`; corrige los hallazgos bloqueantes hasta que el
+   veredicto sea `approve`.
 
 ## Gate
 
-`reviewer` must approve, and same-file edits must never run in parallel.
-Never report done while reviewer findings are open. Prove every wave with
-the repository's own gates before finishing.
+`reviewer` debe aprobar, y las ediciones del mismo archivo nunca van en
+paralelo. Nunca informes "hecho" con hallazgos abiertos. Demuestra cada
+oleada con los gates propios del repo antes de terminar.

package/plugin/commands/omm-ultraqa.md

@@ -5,27 +5,83 @@ argument-hint: <change>
 
 # OMM UltraQA
 
-Quality-gate the requested change with zero failures allowed: $ARGUMENTS
+Pasa el cambio por la puerta de calidad: cero fallos permitidos:
+$ARGUMENTS
+
+## Reglas de orquestación (obligatorias)
+
+1. DEBES empezar llamando a `read_skill bundled:workflow-authoring` y
+   seguir su perfil Workflow API V1 con el esquema
+   `complete/evidence/unresolved`. Sin esta lectura no hay oleadas.
+   Tras esa lectura, OBLIGATORIO: `read_skill
+   plugin:oh-my-muse:omm-narration` y obedecer sus cuatro plantillas
+   (arranque, cabecera de oleada, tarjeta de oleada, cierre) en el
+   idioma del usuario.
+2. DEBES orquestar con la herramienta Workflow. PROHIBIDO implementar,
+   investigar o editar en el hilo principal: el hilo principal solo
+   anuncia el plan, lanza Workflows, narra entre oleadas e integra el
+   resultado al final.
+3. Si la herramienta Workflow no está disponible en tu sesión, DEBES
+   decirlo explícitamente ("Workflow no disponible: paro sin ejecutar")
+   y parar. PROHIBIDO seguir en silencio en el hilo principal.
+4. Un Workflow por oleada: DEBES lanzar una llamada a la herramienta
+   Workflow POR CADA oleada del plan (nunca un único Workflow para
+   todo). Un Workflow solo devuelve su resultado al terminar y el padre
+   no puede narrar mientras se ejecuta; entre oleadas, narra el
+   progreso.
+5. PROHIBIDO encadenar dos llamadas a Workflow sin haber escrito antes
+   la tarjeta de fin de oleada (`✔`/`⚠`/`✖` + `**Gate:**` +
+   `**Siguiente:**`) y la cabecera `▶` de la siguiente oleada. La
+   narración va en el hilo principal: el resultado del Workflow es
+   para el padre, el usuario ve la tarjeta.
+
+## Contrato de progreso (visible para el usuario)
+
+- Antes de lanzar: publica el plan con las oleadas, los roles de cada
+  oleada y el gate de cada una.
+- Tras cada oleada: por cada hijo informa rol + hallazgos clave (2-3
+  líneas) + archivos tocados + `unresolved`. Después anuncia la
+  decisión del gate (avanza / reintenta / para).
+- Al final: informe con qué se hizo, verificación (gates del repo) y
+  pendientes (`unresolved` restantes).
+
+## Forma de cada `input` (obligatoria)
+
+- El `input` de cada hijo DEBE empezar con "Primero llama a read_skill plugin:oh-my-muse:<rol>." (sustituye `<rol>` por el rol de ese hijo:
+  `tester`, `reviewer`, `security-reviewer`, `critic`) y pedir el
+  esquema
+  `complete/evidence/unresolved/summary/files/decisions`
+  (`complete:boolean`, `evidence:string[]`, `unresolved:string[]`,
+  `summary:string` — máx. 2 líneas, `files:string[]`,
+  `decisions:string[]`).
+- Cada `input` completo DEBE respetar el límite de 4096 bytes UTF-8
+  (texto + refs + contexto compacto + `summary`/`files`/`decisions`
+  juntos).
+- Cada llamada de hijo lleva `label: "w<N>-<rol>"` (p. ej.
+  `w2-implementer`).
 
 ## Setup
 
-1. Load the `workflow-authoring` skill and follow its Workflow API V1 profile.
-   Subagents exist only inside the Workflow you author here.
-2. Load the `harness` and `verify` skills and obey them for the whole run.
-3. Use only these specialists: `tester`, `reviewer`, `security-reviewer`,
-   `critic`. There are no tiers and no per-agent models; the session model
-   does all the work.
+Usa solo estos especialistas: `tester`, `reviewer`,
+`security-reviewer`, `critic`. No hay niveles ni modelos por agente;
+el modelo de la sesión hace todo el trabajo. Carga además las skills
+`harness` y `verify` y obedécelas durante toda la ejecución.
+
+## Oleadas
 
-## Wave plan
+Una llamada a Workflow por oleada:
 
-1. **Parallel checks**: fan out to `tester`, `reviewer`,
-   `security-reviewer` (and `critic` for the plan) all at once.
-2. **Zero-failure gate**: apply the gate below as a final sequential step.
+1. **Chequeos en paralelo**: `tester`, `reviewer`,
+   `security-reviewer` (y `critic` para el plan) a la vez en un
+   Workflow.
+2. **Gate de cero fallos**: aplica el gate siguiente como paso final
+   secuencial en un segundo Workflow.
 
 ## Gate
 
-Zero failures allowed: every check must pass with no errors, no skipped
-assertions, and no open blockers. One failure anywhere fails the whole run;
-failed runs return to the owner with file:line findings. Never waive a
-blocker. Report the full failure list, ordered by severity, with
-reproduction steps.
+Cero fallos: cada chequeo debe pasar sin errores, sin aserciones
+omitidas y sin bloqueantes abiertos. Un fallo en cualquier punto falla
+la ejecución entera; las ejecuciones fallidas vuelven al dueño con
+hallazgos archivo:línea. Nunca dispenses un bloqueante. Informa la
+lista completa de fallos ordenada por severidad, con pasos de
+reproducción.

package/plugin/commands/omm-ultrawork.md

@@ -5,26 +5,82 @@ argument-hint: <work>
 
 # OMM Ultrawork
 
-Run the requested work with maximum parallelism: $ARGUMENTS
+Ejecuta el trabajo con el máximo paralelismo: $ARGUMENTS
+
+## Reglas de orquestación (obligatorias)
+
+1. DEBES empezar llamando a `read_skill bundled:workflow-authoring` y
+   seguir su perfil Workflow API V1 con el esquema
+   `complete/evidence/unresolved`. Sin esta lectura no hay oleadas.
+   Tras esa lectura, OBLIGATORIO: `read_skill
+   plugin:oh-my-muse:omm-narration` y obedecer sus cuatro plantillas
+   (arranque, cabecera de oleada, tarjeta de oleada, cierre) en el
+   idioma del usuario.
+2. DEBES orquestar con la herramienta Workflow. PROHIBIDO implementar,
+   investigar o editar en el hilo principal: el hilo principal solo
+   anuncia el plan, lanza Workflows, narra entre oleadas e integra el
+   resultado al final.
+3. Si la herramienta Workflow no está disponible en tu sesión, DEBES
+   decirlo explícitamente ("Workflow no disponible: paro sin ejecutar")
+   y parar. PROHIBIDO seguir en silencio en el hilo principal.
+4. Un Workflow por oleada: DEBES lanzar una llamada a la herramienta
+   Workflow POR CADA oleada del plan (nunca un único Workflow para
+   todo). Un Workflow solo devuelve su resultado al terminar y el padre
+   no puede narrar mientras se ejecuta; entre oleadas, narra el
+   progreso.
+5. PROHIBIDO encadenar dos llamadas a Workflow sin haber escrito antes
+   la tarjeta de fin de oleada (`✔`/`⚠`/`✖` + `**Gate:**` +
+   `**Siguiente:**`) y la cabecera `▶` de la siguiente oleada. La
+   narración va en el hilo principal: el resultado del Workflow es
+   para el padre, el usuario ve la tarjeta.
+
+## Contrato de progreso (visible para el usuario)
+
+- Antes de lanzar: publica el plan con las oleadas, los roles de cada
+  oleada y el gate de cada una.
+- Tras cada oleada: por cada hijo informa rol + hallazgos clave (2-3
+  líneas) + archivos tocados + `unresolved`. Después anuncia la
+  decisión del gate (avanza / reintenta / para).
+- Al final: informe con qué se hizo, verificación (gates del repo) y
+  pendientes (`unresolved` restantes).
+
+## Forma de cada `input` (obligatoria)
+
+- El `input` de cada hijo DEBE empezar con "Primero llama a read_skill plugin:oh-my-muse:<rol>." (sustituye `<rol>` por el rol de ese hijo:
+  `researcher`, `implementer`, `tester`, `refactorer`, `file-picker`,
+  `docs-writer`) y pedir el esquema
+  `complete/evidence/unresolved/summary/files/decisions`
+  (`complete:boolean`, `evidence:string[]`, `unresolved:string[]`,
+  `summary:string` — máx. 2 líneas, `files:string[]`,
+  `decisions:string[]`).
+- Cada `input` completo DEBE respetar el límite de 4096 bytes UTF-8
+  (texto + refs + contexto compacto + `summary`/`files`/`decisions`
+  juntos).
+- Cada llamada de hijo lleva `label: "w<N>-<rol>"` (p. ej.
+  `w2-implementer`).
 
 ## Setup
 
-1. Load the `workflow-authoring` skill and follow its Workflow API V1 profile.
-   Subagents exist only inside the Workflow you author here.
-2. Load the `harness` and `verify` skills and obey them for the whole run.
-3. Use only these specialists: `researcher`, `implementer`, `tester`,
-   `refactorer`, `file-picker`, `docs-writer`. There are no tiers and no
-   per-agent models; the session model does all the work.
+Usa solo estos especialistas: `researcher`, `implementer`, `tester`,
+`refactorer`, `file-picker`, `docs-writer`. No hay niveles ni modelos
+por agente; el modelo de la sesión hace todo el trabajo. Carga además
+las skills `harness` y `verify` y obedécelas durante toda la ejecución.
+
+## Oleadas
 
-## Wave plan
+Optimiza el tiempo de reloj, no el número de pasos. Una llamada a
+Workflow por oleada:
 
-Run every independent step at once in a single parallel wave. Order steps
-only when there is a true data dependency, and state what the dependency is.
-Merge parallel results at the end and resolve conflicts explicitly. Optimize
-for wall-clock time, not for step count.
+1. **Oleada paralela**: todos los pasos independientes a la vez en un
+   Workflow. Ordena pasos solo ante una dependencia real de datos, y
+   di cuál es.
+2. **Oleada de dependientes** (solo si la 1 declaró dependencias):
+   los pasos que esperaban datos de la oleada 1, en un Workflow.
+   Fusiona los resultados paralelos al final y resuelve los conflictos
+   explícitamente.
 
 ## Gate
 
-The run completes when every step reports done. Every step must still pass
-the repository's own gates for its touched area before the run is reported
-done.
+La ejecución termina cuando todos los pasos informan hecho. Cada paso
+debe pasar los gates propios del repo de su área antes de informar
+hecho.

package/plugin/skills/omm-narration/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: omm-narration
+description: Narration cards for orchestrator commands (start, wave, close). Do not use for single-step edits, and never show raw Workflow JSON to the user.
+user-invocable: false
+---
+
+# OMM Narration
+
+You are the narrator, not just the orchestrator. The user never sees raw
+Workflow JSON: the Workflow result is for the parent, the user sees the
+card. Write every card in the user's language.
+
+Fixed sober icons only: 🏮 ▶ ✔ ⚠ ✖ ✅. No other emoji, no JSON dumps.
+
+## Arranque (once, before the first Workflow)
+
+1. First call `read_skill bundled:table-fit`, then keep every table narrow.
+2. Publish exactly:
+
+```text
+## 🏮 OMM <Orquestador> · <objetivo en una línea>
+
+<una frase de enfoque: qué va a cambiar cuando termine.>
+
+| Oleada | Roles | Paralelo | Gate |
+| ------ | ----- | -------- | ---- |
+| 1/M …  | …     | sí/no    | …    |
+```
+
+## Antes de cada oleada (always, right before launching its Workflow)
+
+```text
+### ▶ Oleada N/M · <nombre>
+
+<una línea con el porqué de esta oleada ahora.>
+
+- <rol> → <encargo en una línea>
+```
+
+Give each child call the readable label `w<N>-<rol>` (e.g.
+`w2-implementer`) via `label` / `phase("…")`: per-child labels are the
+only naming knob with a durable surface (see `docs/OPEN-QUESTIONS.md`
+D4). At milestones each child MAY emit `[<rol>] <acción>` via `log()`,
+but never depend on it being seen (O5): the cards are the guaranteed
+surface.
+
+## Tras cada oleada (always, before launching the next Workflow)
+
+Pick the header that matches the gate: `### ✔ Oleada N/M completada`,
+`### ⚠ Oleada N/M con pendientes` or `### ✖ Oleada N/M fallida`.
+Then exactly:
+
+```text
+| Rol | Resultado | Archivos | Pendiente |
+| --- | --------- | -------- | --------- |
+| …   | <máx. 2 líneas> | …  | …         |
+
+**Gate:** avanza | reintenta | para — <motivo>
+**Siguiente:** <oleada siguiente o "nada: cierre">
+```
+
+Hard rule: PROHIBIDO lanzar el siguiente Workflow sin haber escrito
+antes esta tarjeta y la cabecera `▶` de la siguiente oleada.
+
+## Cierre (once, after the last gate)
+
+```text
+## ✅ Hecho
+
+| Oleada | Estado | Gate |
+| ------ | ------ | ---- |
+| …      | ✔/⚠/✖  | …    |
+```
+
+Then, in this order, with real observed output only:
+
+1. `git diff --stat` real (run it, paste it).
+2. Resultado literal de los tests (paste the gate output, never a
+   paraphrase).
+3. Pendientes (`unresolved` restantes, or "ninguno").
+4. Siguiente paso sugerido (one line).