orca-multiagent-kit 1.3.0 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/AI_INSTALL.md CHANGED
@@ -8,7 +8,7 @@ Una sola fuente: `~/.agents/` (núcleo `AGENTS.md`, `rules/`, `skills/`, `templa
8
8
  ## 1. Reglas
9
9
  - Solo escribes en: `~/.agents/`, las carpetas de configuración de los agentes detectados y el proyecto indicado.
10
10
  - Todo lo que muevas o reemplaces va antes a `~/.agents/backups/<fecha>/` (el instalador ya lo hace).
11
- - No modifiques skills de terceros (`orca-cli`, `orchestration`, `supabase`, spec-kit…) ni `~/.agents/rules/personal.md`.
11
+ - No modifiques skills de terceros (`orca-cli`, `orchestration`, `supabase`, spec-kit…) ni `~/.agents/rules/personal.md`. `~/.agents/models.md` es del usuario: créalo desde `templates/models.md` solo si falta y no lo sobrescribas nunca.
12
12
  - Nunca borres contenido de `CLAUDE.md`, `AGENTS.md` o `GEMINI.md` fuera de los bloques `<!-- CSR|MAW|AGENTS:BEGIN … :END -->`.
13
13
  - No pongas rutas de un agente concreto (`~/.claude/rules`, `~/.gemini/rules`) en reglas o skills: usa `~/.agents/…`.
14
14
  - Nunca escribas en un perfil de Claude de la app Orca (`…/orca/claude-profiles/<id>/home`, el `CLAUDE_CONFIG_DIR` que Orca inyecta). Es de Orca e importa `~/.claude/CLAUDE.md`: se instala en `~/.claude`. `install.sh` ya lo hace solo.
@@ -21,7 +21,7 @@ Una sola fuente: `~/.agents/` (núcleo `AGENTS.md`, `rules/`, `skills/`, `templa
21
21
  3. `./install.sh --verify`. Todo `OK`; cualquier `MAL` se corrige antes de terminar.
22
22
  4. Reporta: agentes configurados, ruta del backup, los avisos que imprimió el instalador y el comando `--restore` para deshacerlo.
23
23
 
24
- Sin shell disponible: replica `install.sh` por pasos, en este orden: (a) copia `core/AGENTS.md`, `rules/`, `skills/`, `templates/` y `output-styles/` a `~/.agents/`; (b) en `~/.claude/CLAUDE.md` sustituye los bloques CSR/MAW por `@~/.agents/AGENTS.md` dentro de un bloque `AGENTS`; (c) `~/.gemini/GEMINI.md`, `~/.codex/AGENTS.md` y `~/.copilot/copilot-instructions.md` → enlace a `~/.agents/AGENTS.md`; (d) skills enlazadas en `~/.claude/skills/` y `~/.gemini/config/skills/`; (e) saca de `~/.claude/rules/` y `~/.gemini/rules/` los ficheros de CSR/MAW (**Claude Code carga todo `~/.claude/rules/` en cada sesión**).
24
+ Sin shell disponible: replica `install.sh` por pasos, en este orden: (a) copia `core/AGENTS.md`, `rules/`, `skills/`, `templates/` y `output-styles/` a `~/.agents/`, y `templates/models.md` a `~/.agents/models.md` si no existe; (b) en `~/.claude/CLAUDE.md` sustituye los bloques CSR/MAW por `@~/.agents/AGENTS.md` dentro de un bloque `AGENTS`; (c) `~/.gemini/GEMINI.md`, `~/.codex/AGENTS.md` y `~/.copilot/copilot-instructions.md` → enlace a `~/.agents/AGENTS.md`; (d) skills enlazadas en `~/.claude/skills/` y `~/.gemini/config/skills/`; (e) saca de `~/.claude/rules/` y `~/.gemini/rules/` los ficheros de CSR/MAW (**Claude Code carga todo `~/.claude/rules/` en cada sesión**).
25
25
 
26
26
  ## 3. Proyecto
27
27
  1. `./install.sh --project-only <ruta>`. Migra los overrides del bloque CSR antiguo a `AGENTS.md` y deja `CLAUDE.md` como `@AGENTS.md`.
package/CHANGELOG.md CHANGED
@@ -5,6 +5,30 @@ El formato sigue [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/) y e
5
5
 
6
6
  ## [Unreleased]
7
7
 
8
+ ## [1.4.0] - 2026-11-11
9
+
10
+ Olimpo: reparto por roles y niveles de modelo, y worktrees que nacen de una base fresca, listos para probar y sin residuos. Detalle en [`docs/OLIMPO.md`](docs/OLIMPO.md).
11
+
12
+ ### Añadido
13
+ - **Olimpo** (`skills/orca/references/olimpo.md`): doce roles de agente (Hefesto, Dédalo, Casandra, Temis, Ariadna, Perséfone, Proteo, Narciso, Ícaro, Argos, Atlas, Clío), cada uno con su tipo de trabajo, nivel de modelo, revisión obligatoria y guardarraíl. Las 24 fichas del equipo de origen están en `docs/OLIMPO.md`.
14
+ - **Modelos por nivel** (`alto`, `medio`, `bajo`), sin nombres de modelo en el kit. La correspondencia por proveedor vive en `~/.agents/models.md`, fichero del usuario que el instalador crea una vez y no sobrescribe. En cada run la skill consulta los modelos del proveedor (por ejemplo `agy models`): una versión nueva de una familia conocida entra sola, y una familia nueva la clasifica el coordinador con evidencia (alias y changelog del proveedor, documentación pública), comprueba que la cuenta puede usarla y lo anota en el plan de rondas, sin preguntar al usuario.
15
+ - **Recurso por unidad** (`rules/95-multi-agent.md`): coordinador, subagente de solo lectura, subagente con worktree, worker de Orca o manual, decidido unidad a unidad. Un run puede mezclar motores.
16
+ - **Base fresca**: `git fetch` y comparación con `origin/<rama padre>` antes de crear la rama de integración; si la rama local va por detrás se parte de `origin`, y si tiene commits sin subir se pregunta. Se repite antes del merge final.
17
+ - **Entorno de worktree verificado**: setup real en `ORCHESTRATION.md` §3, `scripts.setup` en `orca.yaml`, bloque `SETUP` en los despachos sin Orca y comprobación en el arranque del worker (`BLOCKED: entorno`).
18
+ - **Confirmación 3, limpieza**: tras el merge final el coordinador enseña el inventario (worktrees, ramas, copias de `.env`) y lo borra con permiso. Si se rechaza, queda `cleanup: pending` en `run.md` y se recuerda en el siguiente run.
19
+ - Modo «limpia el run» en la skill `orca`, también para worktrees de runs antiguos.
20
+ - Instalador: al preparar un proyecto, un `.env` con señales de producción (`NODE_ENV=production`, claves `sk_live_`…) se desactiva en el `.worktreeinclude` nuevo y queda como pendiente; si el fichero ya era tuyo, solo avisa. No se muestra su contenido.
21
+ - `omk verify` comprueba que existen los roles de Olimpo y `~/.agents/models.md`.
22
+ - Guía visual y web: sección de Olimpo, recurso por unidad, base fresca y limpieza.
23
+ - Campos opcionales nuevos: `role`, `tier` y `engine` en las unidades; `base_ref`, `cleanup`, rol, modelo y worktree en `run.md`; línea `ROL:` en el despacho.
24
+
25
+ ### Cambiado
26
+ - El plan de rondas enseña la base, el rol, el nivel, el modelo y el recurso de cada unidad.
27
+ - Plantilla `ORCHESTRATION.md`: la tabla «Agentes por capa» se sustituye por proveedores activos, dominios sensibles y excepciones. Las fichas existentes siguen valiendo: su tabla se lee como excepciones de proveedor.
28
+ - Motor Orca: `--setup run` y `--base-branch <rama de integración>` siempre; `--model` y `--effort` salen de `models.md` en vez de pasarse solo a petición.
29
+ - `.worktreeinclude` de plantilla incluye `.env`, `.env.local` y `.env.development.local`.
30
+ - Núcleo §6: la limpieza entra en las confirmaciones de `semi`, e invariante nueva sobre base fresca y residuos.
31
+
8
32
  ## [1.3.0] - 2026-11-07
9
33
 
10
34
  Orquestador más robusto, plugin para la app Orca, instalador para Orca y Windows, y reglas de calidad (CSR) al día. Gracias a [Necro-Coder](https://github.com/Necro-Coder).
@@ -99,7 +123,8 @@ Primera versión de **Orca Multiagent Kit**. Une CSR (Claude Session Rules, de [
99
123
  ### Eliminado
100
124
  - Copias duplicadas de reglas y skills `csr-*` dentro de cada agente, y el plugin `claude-session-rules` de Antigravity.
101
125
 
102
- [Unreleased]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.3.0...HEAD
126
+ [Unreleased]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.4.0...HEAD
127
+ [1.4.0]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.3.0...v1.4.0
103
128
  [1.3.0]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.2.0...v1.3.0
104
129
  [1.2.0]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.1.0...v1.2.0
105
130
  [1.1.0]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.0.0...v1.1.0
package/GUIA.html CHANGED
@@ -156,7 +156,7 @@ footer{margin-top:64px;color:var(--muted);font-size:13px;text-align:center}
156
156
  <div class="ambient" aria-hidden="true"><span></span><span></span></div>
157
157
  <main>
158
158
  <nav class="toc" aria-label="Secciones">
159
- <a href="#fuente">Fuente única</a><a href="#instalar">Instalar</a><a href="#proyecto">Proyecto nuevo</a><a href="#modos">Modos</a><a href="#paralelo">Paralelo</a><a href="#speckit">spec-kit</a><a href="#reglas">Reglas</a><a href="#convivencia">Convivencia</a><a href="#editar">Editar</a><a href="#frases">Frases</a><a href="#problemas">Problemas</a>
159
+ <a href="#fuente">Fuente única</a><a href="#instalar">Instalar</a><a href="#proyecto">Proyecto nuevo</a><a href="#modos">Modos</a><a href="#paralelo">Paralelo</a><a href="#olimpo">Olimpo</a><a href="#speckit">spec-kit</a><a href="#reglas">Reglas</a><a href="#convivencia">Convivencia</a><a href="#editar">Editar</a><a href="#frases">Frases</a><a href="#problemas">Problemas</a>
160
160
  </nav>
161
161
 
162
162
  <header class="hero">
@@ -246,7 +246,7 @@ chmod +x install.sh
246
246
 
247
247
  <section id="paralelo">
248
248
  <h2>Cómo trabajan en paralelo sin pisarse</h2>
249
- <p class="sub">Toda entrada se convierte en unidades de trabajo. El coordinador hace la base común (U0), cada unidad va a su worktree y su rama, y todo se integra en una rama de trabajo. Con autonomía <code>semi</code> solo confirmas dos veces: el plan de rondas y el merge final.</p>
249
+ <p class="sub">Toda entrada se convierte en unidades de trabajo. El coordinador hace la base común (U0), cada unidad va a su worktree y su rama, y todo se integra en una rama de trabajo. Todo parte de <code>origin</code> actualizado, nunca de una rama local desfasada, y cada worktree nace con sus dependencias y su <code>.env</code> de desarrollo. Con autonomía <code>semi</code> solo confirmas tres veces: el plan de rondas, el merge final y la limpieza.</p>
250
250
  <div class="glass pad diagram lanes" role="img" aria-label="Pipeline: entrada, unidades, U0 del coordinador, tres workers en paralelo en worktrees (Claude, Antigravity, Codex), integración con gates y tu sí">
251
251
  <svg viewBox="0 0 760 300">
252
252
  <g><rect class="node" x="10" y="115" width="110" height="70" rx="16"/><text x="65" y="144" text-anchor="middle" font-size="13" font-weight="600">Entrada</text><text class="lbl" x="65" y="163" text-anchor="middle">chat · plan · spec</text></g>
@@ -267,9 +267,29 @@ chmod +x install.sh
267
267
  </svg>
268
268
  </div>
269
269
  <div class="grid g3" style="margin-top:14px">
270
- <div class="glass pad"><h3>Motor <code>orca</code></h3><p class="muted small">Varios proveedores a la vez, con seguimiento en la interfaz. Requiere Orca abierto y la orquestación activada en Experimental.</p></div>
271
- <div class="glass pad"><h3>Motor <code>subagents</code></h3><p class="muted small">Un solo proveedor sin Orca: subagentes nativos de Claude, o el Agent Manager de Antigravity.</p></div>
272
- <div class="glass pad"><h3>Motor <code>manual</code></h3><p class="muted small">El agente crea los worktrees y te dice qué agente abrir en cada carpeta y con qué brief.</p></div>
270
+ <div class="glass pad"><h3>Worker de Orca</h3><p class="muted small">Para unidades de otro proveedor y revisiones cruzadas, con seguimiento en la interfaz. Requiere Orca abierto y la orquestación activada en Experimental.</p></div>
271
+ <div class="glass pad"><h3>Subagente</h3><p class="muted small">Para unidades del mismo proveedor que coordina: con worktree propio si escribe, sin worktree si solo lee (investigar, auditar, revisar).</p></div>
272
+ <div class="glass pad"><h3>Manual</h3><p class="muted small">Si no hay Orca ni subagentes, el agente crea los worktrees y te dice qué agente abrir en cada carpeta y con qué brief. El recurso se elige unidad a unidad, y un run puede mezclarlos.</p></div>
273
+ </div>
274
+ </section>
275
+
276
+ <section id="olimpo">
277
+ <h2>Olimpo: quién hace cada unidad y con qué modelo</h2>
278
+ <p class="sub">Cada unidad recibe un rol. Del rol sale el nivel de modelo, y del nivel, el modelo de cada proveedor. Los nombres de modelo viven solo en <code>~/.agents/models.md</code>, que es tuyo: cuando sale un modelo nuevo no hay que reinstalar ni reinicializar nada.</p>
279
+ <div class="glass table-wrap">
280
+ <table>
281
+ <thead><tr><th>Nivel</th><th>Trabajo</th><th>Roles</th></tr></thead>
282
+ <tbody>
283
+ <tr><td><code>alto</code></td><td>Arquitectura, seguridad, normativa, revisión crítica y código de dinero, fiscal, tenancy y auth</td><td>Hefesto, Dédalo, Casandra, Temis, Ariadna</td></tr>
284
+ <tr><td><code>medio</code></td><td>Implementación, ADR técnicos, investigación, tests e infraestructura</td><td>Perséfone, Proteo, Narciso, Ícaro, Argos, Atlas</td></tr>
285
+ <tr><td><code>bajo</code></td><td>Tareas mecánicas: índices, tableros, plantillas, formateo, enlaces, extracción</td><td>Clío</td></tr>
286
+ </tbody>
287
+ </table>
288
+ </div>
289
+ <div class="grid g3" style="margin-top:14px">
290
+ <div class="glass pad"><h3>El plan lo enseña todo</h3><p class="muted small">Antes de tu «sí» ves, por unidad, el rol, el nivel, el modelo y el recurso que se va a usar.</p></div>
291
+ <div class="glass pad"><h3>Modelos al día solos</h3><p class="muted small">Claude usa alias. Para los demás, la skill consulta la lista del proveedor en cada run: una versión nueva de una familia conocida entra sola; una familia nueva la clasifica el agente con evidencia y te lo dice en el plan.</p></div>
292
+ <div class="glass pad"><h3>Guardarraíles, no personajes</h3><p class="muted small">Cada rol trae una regla: el código sensible lleva revisión de otro proveedor, un hallazgo de seguridad alto bloquea el merge, el coordinador delega.</p></div>
273
293
  </div>
274
294
  </section>
275
295
 
@@ -299,6 +319,8 @@ chmod +x install.sh
299
319
  <div class="glass pad rule"><span class="dot"></span><div><h3>Los workers no tocan el estado</h3><p class="muted small">Ni <code>tasks.md</code>, ni planes, ni <code>STACK.md</code>. Tampoco hacen merge ni push.</p></div></div>
300
320
  <div class="glass pad rule"><span class="dot"></span><div><h3>Sin informe no hay unidad</h3><p class="muted small">Formato fijo: qué se hizo, ficheros, criterios verificados, tabla de gates.</p></div></div>
301
321
  <div class="glass pad rule"><span class="dot core"></span><div><h3>Nunca PASS sin ejecutar</h3><p class="muted small">Un gate que no se ejecutó se reporta como <code>SKIPPED (motivo)</code>. Al integrar se repasa el conjunto.</p></div></div>
322
+ <div class="glass pad rule"><span class="dot"></span><div><h3>Base fresca</h3><p class="muted small">Ningún worktree nace de una rama local sin contrastarla con <code>origin</code>. Si la tuya tiene commits sin subir, se te pregunta.</p></div></div>
323
+ <div class="glass pad rule"><span class="dot"></span><div><h3>Sin residuos</h3><p class="muted small">Tras el merge final ves qué worktrees, ramas y copias de <code>.env</code> han quedado. Se borran solo con tu «sí».</p></div></div>
302
324
  <div class="glass pad rule"><span class="dot warn"></span><div><h3>Lo pequeño no se orquesta</h3><p class="muted small">Un cambio claro se hace directamente y pasa <code>csr-gate</code>.</p></div></div>
303
325
  </div>
304
326
  </section>
@@ -330,7 +352,8 @@ chmod +x install.sh
330
352
  <tr><td>Una regla tuya que el kit no debe pisar</td><td><code>~/.agents/rules/personal.md</code></td><td>Nada</td></tr>
331
353
  <tr><td>Una skill</td><td><code>orca-multiagent-kit/skills/&lt;skill&gt;/</code></td><td><code>./install.sh</code></td></tr>
332
354
  <tr><td>Reglas de un proyecto</td><td><code>AGENTS.md</code> del proyecto, en <em>Overrides</em></td><td>Nada</td></tr>
333
- <tr><td>Reparto de agentes de un proyecto</td><td><code>ORCHESTRATION.md</code></td><td>Nada</td></tr>
355
+ <tr><td>Proveedores activos y dominios sensibles de un proyecto</td><td><code>ORCHESTRATION.md</code></td><td>Nada</td></tr>
356
+ <tr><td>Qué modelo usa cada nivel en cada proveedor</td><td><code>~/.agents/models.md</code></td><td>Nada</td></tr>
334
357
  </tbody>
335
358
  </table>
336
359
  </div>
@@ -350,7 +373,9 @@ chmod +x install.sh
350
373
  <details><summary>Antigravity no ve las skills</summary><p>Comprueba los enlaces en <code>~/.gemini/config/skills/</code> con <code>--verify</code> y reinicia Antigravity. Si se queja del plugin <code>claude-session-rules</code>, desactívalo: su contenido ya está en el núcleo.</p></details>
351
374
  <details><summary>El agente orquesta tareas pequeñas</summary><p>Dile «hazlo inline». Si pasa a menudo, ajusta los umbrales en <code>rules/95-multi-agent.md</code>, en «Cuándo paralelizar».</p></details>
352
375
  <details><summary>Conflictos en <code>tasks.md</code> o en el plan</summary><p>Un worker lo editó. Revierte su cambio en ese fichero: solo el coordinador marca tareas.</p></details>
353
- <details><summary>Un worktree arranca sin dependencias o sin <code>.env</code></summary><p>Repite «inicializa el proyecto». Lo que va en <code>orca.yaml</code> y <code>.worktreeinclude</code> tiene que existir y estar en <code>.gitignore</code>. Solo <code>.env</code> de desarrollo.</p></details>
376
+ <details><summary>Un worktree arranca sin dependencias o sin <code>.env</code></summary><p>El worker lo detecta al arrancar y se para con <code>BLOCKED: entorno</code>. Repite «inicializa el proyecto»: rellena el setup de <code>ORCHESTRATION.md</code> y <code>orca.yaml</code>. Lo que va en <code>.worktreeinclude</code> tiene que existir y estar en <code>.gitignore</code>. Solo <code>.env</code> de desarrollo: el instalador desactiva los que parecen de producción.</p></details>
377
+ <details><summary>Ha salido un modelo nuevo</summary><p>No hay que hacer nada. Con Claude, los alias apuntan solos al modelo vigente. Con los demás, la skill lo ve en el siguiente run y, si es de una familia nueva, decide ella su nivel con lo que publica el proveedor y te lo dice en el plan de rondas. Para cambiarlo a mano, edita <code>~/.agents/models.md</code>.</p></details>
378
+ <details><summary>Quedan worktrees o ramas de un run antiguo</summary><p>Di «limpia el run». El agente enseña el inventario y borra solo lo integrado y sin cambios pendientes, tras tu «sí».</p></details>
354
379
  <details><summary>Quiero volver atrás</summary><p><code>./install.sh --restore &lt;fecha&gt;</code> con la fecha que imprimió la instalación. Los backups están en <code>~/.agents/backups/</code>.</p></details>
355
380
  </div>
356
381
  </section>
@@ -373,8 +398,8 @@ chmod +x install.sh
373
398
 
374
399
  var MODES=[
375
400
  {id:'directo',name:'Directo',when:'Un cambio lógico y claro, en pocos ficheros.',chain:[['agente','lo hace él solo'],['csr-gate','pasa los gates']],engine:'un agente',say:'Añade validación de email al formulario de registro',out:'orca ni se activa: orquestar lo pequeño cuesta más que hacerlo.'},
376
- {id:'spec',name:'spec-kit',when:'Tu flujo habitual: specify → plan → tasks. Al implementar, se reparte solo si compensa.',chain:[['/speckit.implement','lo escribes como siempre'],['hook orca','¿compensa repartir?'],['tú','confirmas el plan de rondas'],['workers','una user story por worktree'],['integración','gates y [x] en tasks.md'],['tú','confirmas el merge final']],engine:'orca',say:'/speckit.implement',out:'Si no compensa, implement sigue normal, con un agente.'},
377
- {id:'chat',name:'Petición',when:'Pides una feature grande sin spec. El agente detecta las partes independientes.',chain:[['orca','sola, por iniciativa del agente'],['unidades','reescribe tu petición como brief'],['tú','confirmas el plan de rondas'],['workers','en paralelo'],['tú','confirmas el merge final']],engine:'orca · subagentes',say:'Añade el módulo de notificaciones: email, push y preferencias',out:'Lo mismo sirve con un plan del modo plan o un implementation_plan.md.'},
401
+ {id:'spec',name:'spec-kit',when:'Tu flujo habitual: specify → plan → tasks. Al implementar, se reparte solo si compensa.',chain:[['/speckit.implement','lo escribes como siempre'],['hook orca','¿compensa repartir?'],['tú','confirmas el plan de rondas'],['workers','una user story por worktree'],['integración','gates y [x] en tasks.md'],['tú','confirmas el merge final'],['tú','confirmas la limpieza']],engine:'orca',say:'/speckit.implement',out:'Si no compensa, implement sigue normal, con un agente.'},
402
+ {id:'chat',name:'Petición',when:'Pides una feature grande sin spec. El agente detecta las partes independientes.',chain:[['orca','sola, por iniciativa del agente'],['unidades','reescribe tu petición como brief'],['tú','confirmas el plan de rondas'],['workers','en paralelo'],['tú','confirmas el merge final'],['tú','confirmas la limpieza']],engine:'orca · subagentes',say:'Añade el módulo de notificaciones: email, push y preferencias',out:'Lo mismo sirve con un plan del modo plan o un implementation_plan.md.'},
378
403
  {id:'plan',name:'Sprints',when:'Quieres un plan por sprints antes de tocar código.',chain:[['orca','modo plan'],['planes/x.md','sprints con ficheros y dependencias'],['tú','sprint a sprint o en paralelo']],engine:'un agente · orca',say:'Planifica en sprints el panel de administración',out:'Mantiene los dos modos de planificar y añade el paralelo.'},
379
404
  {id:'race',name:'Carrera',when:'Bug difícil de causa desconocida, o varias soluciones plausibles.',chain:[['orca','modo carrera'],['test','reproducción que falla'],['2–3 agentes','mismo problema'],['tabla','puntuación de diffs'],['tú','eliges la ganadora']],engine:'orca',say:'Carrera entre Claude y Gemini: el pago se duplica a veces',out:'Gana el mejor diff, no el mejor informe.'}
380
405
  ];
package/README.md CHANGED
@@ -139,7 +139,11 @@ Solo tienes que conocer dos frases. El resto lo deciden los agentes.
139
139
  | `speckit-orca-implement` | Hook de spec-kit: decide si `/speckit.implement` se reparte | **Automática** al escribir `/speckit.implement` |
140
140
  | `csr-stack` · `csr-gate` · `csr-audit` | Ficha del stack, puerta de validez, auditoría de seguridad | Automáticas al cerrar tareas, o «pasa los gates» / «audita» |
141
141
 
142
- **Autonomía** (en `ORCHESTRATION.md`): `semi` por defecto. Confirmas el plan de rondas y el merge final, y nada más salvo decisiones de producto. `manual` pide confirmación en cada ronda; `auto`, solo el merge final. En ningún nivel se mergea a la rama por defecto ni se hace push sin tu confirmación.
142
+ **Autonomía** (en `ORCHESTRATION.md`): `semi` por defecto. Confirmas el plan de rondas, el merge final y la limpieza, y nada más salvo decisiones de producto. `manual` pide confirmación en cada ronda; `auto`, solo el merge final y la limpieza. En ningún nivel se mergea a la rama por defecto, se hace push ni se borran worktrees o ramas sin tu confirmación.
143
+
144
+ **Olimpo: roles y modelos.** Cada unidad recibe un rol (arquitectura, seguridad, código sensible, datos, interfaz, verificación, mecánico…) y de él sale el nivel de modelo: `alto`, `medio` o `bajo`. Qué modelo es cada nivel en cada proveedor lo dice un fichero tuyo, `~/.agents/models.md`, que el kit crea una vez y no vuelve a tocar: cuando sale un modelo nuevo no hay que reinstalar ni reinicializar nada. El plan de rondas enseña el rol, el modelo y el recurso (subagente, worker de Orca…) de cada unidad antes de que digas «sí». Detalle: [`docs/OLIMPO.md`](docs/OLIMPO.md).
145
+
146
+ **Worktrees sanos.** Cada run parte de `origin` actualizado (nunca de una rama local desfasada), cada worktree nace con sus dependencias y su `.env` de desarrollo, y al terminar el coordinador enseña qué worktrees, ramas y copias de entorno han quedado y los borra con tu permiso.
143
147
 
144
148
  Convive con skills externas como **impeccable**, **supabase**, **spec-kit** y las de la app **Orca**: cada una manda en su terreno, y la puerta de validez y las prohibiciones se aplican siempre.
145
149
 
@@ -171,6 +175,8 @@ flowchart LR
171
175
  - Los workers no editan `tasks.md`, planes ni `STACK.md`, y no hacen merge.
172
176
  - Sin informe no hay unidad.
173
177
  - Nunca `PASS` de algo no ejecutado.
178
+ - Ningún worktree nace de una rama local sin contrastarla con `origin`.
179
+ - Nada se borra sin tu permiso, y nada integrado se queda sin ofrecerte borrarlo.
174
180
  - Lo pequeño no se orquesta.
175
181
 
176
182
  <a id="estructura"></a>
@@ -183,7 +189,7 @@ orca-multiagent-kit/
183
189
  ├── rules/ 00-router … 95-multi-agent + lang/ (17 lenguajes)
184
190
  ├── skills/ kit-init · orca · speckit-orca-implement · csr-*
185
191
  ├── speckit-extension/ extensión de spec-kit (hook before_implement)
186
- ├── templates/ AGENTS.md · CLAUDE.md · STACK.md · ORCHESTRATION.md · orca.yaml · .worktreeinclude
192
+ ├── templates/ AGENTS.md · CLAUDE.md · STACK.md · ORCHESTRATION.md · orca.yaml · .worktreeinclude · models.md
187
193
  ├── output-styles/ csr-minimal (Claude Code)
188
194
  ├── orca-plugin/ plugin de Orca: comandos del kit, contrato del worker, barra de estado
189
195
  ├── install.sh instala · migra · verifica · restaura · adopta
@@ -205,6 +211,7 @@ orca-multiagent-kit/
205
211
  | [Guía visual](https://fernandobaqueroo.github.io/orca-multiagent-kit/guia.html) ([`GUIA.html`](GUIA.html)) | El flujo de trabajo completo, con esquemas |
206
212
  | [`docs/MANUAL.md`](docs/MANUAL.md) | Instalación detallada, migración, convivencia y problemas frecuentes |
207
213
  | [`AI_INSTALL.md`](AI_INSTALL.md) | Una IA que tiene que instalar o integrar el kit |
214
+ | [`docs/OLIMPO.md`](docs/OLIMPO.md) | Roles, niveles de modelo, recurso por unidad y ciclo de vida de los worktrees |
208
215
  | [`docs/PLUGIN-ORCA.md`](docs/PLUGIN-ORCA.md) | Quien usa Orca y quiere el kit integrado en la app |
209
216
  | [`CHANGELOG.md`](CHANGELOG.md) | Historial de versiones ([SemVer](https://semver.org/lang/es/)) |
210
217
 
package/VERSION CHANGED
@@ -1 +1 @@
1
- 1.3.0
1
+ 1.4.0
package/core/AGENTS.md CHANGED
@@ -1,4 +1,4 @@
1
- # Reglas operativas globales (Orca Multiagent Kit v1.3.0 · CSR + MAW)
1
+ # Reglas operativas globales (Orca Multiagent Kit v1.4.0 · CSR + MAW)
2
2
  <!-- Fuente única para todos los agentes (import o enlace). Edita el kit y reinstala; no edites copias. -->
3
3
 
4
4
  ## 0. Precedencia
@@ -57,8 +57,8 @@ Ningún código es válido hasta pasar, en orden y sin saltos (módulos en `~/.a
57
57
  - **Usa la skill `orca` por iniciativa propia**, sin esperar a que te lo pidan, cuando la tarea tenga ≥2 partes independientes de >15 min (varias user stories, sprints, módulos o pantallas) o el usuario mencione paralelo, Orca, worktrees o varios agentes. Ella decide si compensa y, si no, lo dice en una línea y sigues tú.
58
58
  - En proyectos con spec-kit, `/speckit.implement` llama a `orca` automáticamente (hook `before_implement`). No hace falta pedirlo.
59
59
  - Cambio único y claro ⇒ sin orquestar: hazlo y pasa `csr-gate`.
60
- - Respeta la autonomía de `./ORCHESTRATION.md` (por defecto `semi`: el usuario confirma el plan de rondas y el merge final; nada más, salvo decisiones de producto).
61
- - **Invariantes — YOU MUST**: (1) una unidad = un worktree = una rama; (2) los ficheros `shared` de `ORCHESTRATION.md` los toca una sola unidad por ronda o el coordinador; (3) un worker no edita `tasks.md`, `planes/*.md`, `ORCHESTRATION.md`, `STACK.md`, lockfiles ni migraciones ajenas; (4) un worker no mergea, ni hace push, ni borra ramas; (5) todo worker entrega su informe; (6) salir del alcance ⇒ `BLOCKED:` y preguntar; (7) nunca merge a la rama por defecto ni push sin confirmación.
60
+ - Respeta la autonomía de `./ORCHESTRATION.md` (por defecto `semi`: el usuario confirma el plan de rondas, el merge final y la limpieza de worktrees y ramas; nada más, salvo decisiones de producto).
61
+ - **Invariantes — YOU MUST**: (1) una unidad = un worktree = una rama; (2) los ficheros `shared` de `ORCHESTRATION.md` los toca una sola unidad por ronda o el coordinador; (3) un worker no edita `tasks.md`, `planes/*.md`, `ORCHESTRATION.md`, `STACK.md`, lockfiles ni migraciones ajenas; (4) un worker no mergea, ni hace push, ni borra ramas; (5) todo worker entrega su informe; (6) salir del alcance ⇒ `BLOCKED:` y preguntar; (7) nunca merge a la rama por defecto ni push sin confirmación; (8) ningún worktree nace de una rama local sin contrastar con `origin`, y todo worktree integrado se ofrece para borrar al cerrar el run.
62
62
  Detalle: `~/.agents/rules/95-multi-agent.md`.
63
63
 
64
64
  ## 7. Router (leer bajo demanda, no todo a la vez)
package/docs/MANUAL.md CHANGED
@@ -1,4 +1,4 @@
1
- # Orca Multiagent Kit v1.1.0 — Una sola fuente de reglas y skills para todos tus agentes
1
+ # Orca Multiagent Kit — Una sola fuente de reglas y skills para todos tus agentes
2
2
 
3
3
  Une **CSR** (claude_session_rules: calidad, seguridad, tests, hablar poco) y **MAW** (trabajo multiagente sin pisarse) en **un único sitio**, `~/.agents/`, que leen a la vez Claude Code, Antigravity, Codex, Copilot CLI, Cursor y Devin.
4
4
 
@@ -62,7 +62,7 @@ orca-multiagent-kit/
62
62
  ├── speckit-extension/orca/ hook before_implement de spec-kit
63
63
  ├── output-styles/csr-minimal.md (estilo de salida de Claude Code)
64
64
  └── templates/ AGENTS.md · CLAUDE.md · STACK.md · ORCHESTRATION.md · orca.yaml ·
65
- .worktreeinclude · claude-settings.json
65
+ .worktreeinclude · claude-settings.json · models.md
66
66
  ```
67
67
 
68
68
  ---
@@ -91,12 +91,12 @@ Más opciones:
91
91
 
92
92
  ### Qué hace exactamente
93
93
  1. **Backup** de todo lo que toca en `~/.agents/backups/<fecha>/`, con las mismas rutas relativas a tu carpeta personal. `--restore` lo devuelve a su sitio.
94
- 2. Copia núcleo, reglas, skills, plantillas y estilo a `~/.agents/`. Solo reemplaza **sus** skills: `orca-cli`, `orchestration`, `supabase` y el resto se quedan como están. Si creas `~/.agents/rules/personal.md`, no lo toca nunca.
94
+ 2. Copia núcleo, reglas, skills, plantillas y estilo a `~/.agents/`. Solo reemplaza **sus** skills: `orca-cli`, `orchestration`, `supabase` y el resto se quedan como están. Si creas `~/.agents/rules/personal.md`, no lo toca nunca. Crea `~/.agents/models.md` (qué modelo usa cada nivel en cada proveedor) solo si no existe; si ya lo tienes, tampoco lo toca.
95
95
  3. **Claude Code**: quita de `CLAUDE.md` los bloques CSR y MAW, pone el bloque con el import y **conserva el resto** de lo que tuvieras escrito. Saca de `~/.claude/rules/` los ficheros de CSR y MAW (los tuyos se quedan), enlaza las skills y el output style.
96
96
  4. **Antigravity**: `GEMINI.md` pasa a ser un enlace al núcleo. Retira las reglas copiadas de `~/.gemini/rules/`, las plantillas y el plugin `claude-session-rules` (todo va al backup) y enlaza las skills en `~/.gemini/config/skills/`.
97
97
  5. **Codex / Copilot / Devin**: enlazan su fichero global de instrucciones al núcleo. Sus skills ya las leen desde `~/.agents/skills/`.
98
98
  6. **Cursor**: no guarda las reglas de usuario en ficheros. El instalador te da la línea para pegar en **Settings → Rules → User Rules**.
99
- 7. **Proyecto** (`--project`): reescribe `AGENTS.md` y `CLAUDE.md` con el formato del kit y **migra tus "Overrides de este proyecto"** del bloque CSR antiguo. Crea `STACK.md`, `ORCHESTRATION.md`, `orca.yaml`, `.worktreeinclude` y `.claude/settings.json` si faltan, y añade `.work/` al `.gitignore`.
99
+ 7. **Proyecto** (`--project`): reescribe `AGENTS.md` y `CLAUDE.md` con el formato del kit y **migra tus "Overrides de este proyecto"** del bloque CSR antiguo. Crea `STACK.md`, `ORCHESTRATION.md`, `orca.yaml`, `.worktreeinclude` y `.claude/settings.json` si faltan, y añade `.work/` al `.gitignore`. Si un `.env` del proyecto parece de producción, lo desactiva en el `.worktreeinclude` nuevo y te lo deja como pendiente.
100
100
 
101
101
  Reinstalar es idempotente: sirve también para actualizar después de editar el kit.
102
102
 
@@ -107,8 +107,8 @@ Reinstalar es idempotente: sirve también para actualizar después de editar el
107
107
  Abre el agente en el repo y escribe **«inicializa el proyecto»** (skill `kit-init`). No hace falta terminal ni el instalador:
108
108
  1. Crea o migra `AGENTS.md` (con tus overrides del CSR antiguo) y deja `CLAUDE.md` como `@AGENTS.md`.
109
109
  2. Si `STACK.md` falta o está vacío, ejecuta `csr-stack`: **detecta el stack** leyendo manifiestos, configuración, versiones y comandos reales del repo. No necesitas describirle nada.
110
- 3. Prepara la orquestación: `ORCHESTRATION.md` (con su nivel de autonomía), `orca.yaml`, `.worktreeinclude`, `.work/` en `.gitignore` y, si hay spec-kit, el hook `before_implement`.
111
- 4. Te hace como máximo 4 preguntas en una tanda (lo que no se puede deducir: nivel ASVS, reparto de agentes…) y propone el commit.
110
+ 3. Prepara la orquestación: `ORCHESTRATION.md` (nivel de autonomía, proveedores activos, dominios sensibles y el setup real de cada worktree), `orca.yaml`, `.worktreeinclude`, `.work/` en `.gitignore` y, si hay spec-kit, el hook `before_implement`. Si a `~/.agents/models.md` le falta un proveedor activo, clasifica sus modelos en niveles y lo rellena.
111
+ 4. Te hace como máximo 4 preguntas en una tanda (lo que no se puede deducir: nivel ASVS, proveedores activos…) y propone el commit.
112
112
 
113
113
  Si el agente detecta un repo sin `AGENTS.md` o sin `STACK.md`, te ofrecerá `kit-init` él solo. Desde la terminal, `./install.sh --project <ruta>` hace la parte de ficheros, pero la detección del stack la sigue haciendo el agente.
114
114
 
@@ -129,7 +129,9 @@ Igual que antes; lo único que cambia es dónde vive cada cosa.
129
129
  | Cerrar una tarea | «pasa los gates» (`csr-gate`) |
130
130
  | Antes de publicar o tocar algo sensible | «audita la seguridad» (`csr-audit`) |
131
131
 
132
- **Autonomía** (`ORCHESTRATION.md` §0): `semi` por defecto. Confirmas el plan de rondas (autoriza los commits del run en ramas de trabajo) y el merge final; en medio solo te interrumpe por decisiones de producto. `manual` confirma cada ronda; `auto`, solo el merge final. Nunca hay merge a la rama por defecto ni push sin confirmación.
132
+ **Autonomía** (`ORCHESTRATION.md` §0): `semi` por defecto. Confirmas el plan de rondas (autoriza los commits del run en ramas de trabajo), el merge final y la limpieza de worktrees y ramas; en medio solo te interrumpe por decisiones de producto. `manual` confirma cada ronda; `auto`, solo el merge final y la limpieza. Nunca hay merge a la rama por defecto, push ni borrado de worktrees o ramas sin confirmación.
133
+
134
+ **Roles y modelos** ([`OLIMPO.md`](OLIMPO.md)): cada unidad lleva un rol y un nivel de modelo (`alto`, `medio`, `bajo`). El modelo concreto de cada nivel y proveedor está en `~/.agents/models.md`, que es tuyo: el instalador lo crea si falta y no lo sobrescribe. Para cambiar qué modelo usa un nivel, edita ese fichero; no hay que reinstalar.
133
135
 
134
136
  El detalle está en `skills/orca/SKILL.md` y sus `references/`, y en `rules/95-multi-agent.md`.
135
137
 
@@ -141,6 +143,7 @@ El detalle está en `skills/orca/SKILL.md` y sus `references/`, y en `rules/95-m
141
143
  |---|---|---|
142
144
  | Una regla global (todos los agentes) | `~/Documents/orca-multiagent-kit/core/AGENTS.md` o `rules/…` | `./install.sh` |
143
145
  | Una regla solo tuya que el kit no debe pisar | `~/.agents/rules/personal.md` | nada: el núcleo lo lee |
146
+ | Qué modelo usa cada nivel en cada proveedor | `~/.agents/models.md` | nada: `orca` lo lee en cada run |
144
147
  | Una skill | `~/Documents/orca-multiagent-kit/skills/<skill>/` | `./install.sh` |
145
148
  | Reglas de un proyecto | `AGENTS.md` del proyecto, sección *Overrides* | nada |
146
149
 
@@ -173,7 +176,8 @@ Puedes editar directamente en `~/.agents/`, pero la próxima reinstalación lo s
173
176
  - **Nivel técnico** (`rules/10-communication.md`): la versión anterior te describía como "backend avanzado (Python, Kubernetes…)". Ahora pone fullstack con tu stack real. Ajústalo si no te encaja.
174
177
  - **Windows (Git Bash)**: el kit necesita enlaces simbólicos nativos. Activa el *Modo de desarrollador* (Configuración → Sistema → Para programadores) o abre Git Bash como administrador. Si no se pueden crear, el instalador se para antes de tocar nada; nunca deja copias. Detalle en [`INSTALADOR-ORCA-WINDOWS.md`](INSTALADOR-ORCA-WINDOWS.md).
175
178
  - **Claude dentro de la app Orca**: Orca lanza Claude con un perfil propio (`CLAUDE_CONFIG_DIR=…/orca/claude-profiles/<id>/home`) que importa `~/.claude/CLAUDE.md`. El instalador lo detecta, instala en `~/.claude` y no toca el perfil, así que puedes ejecutarlo desde una terminal de Orca.
176
- - **Permisos**: Orca y Antigravity ejecutan sin confirmación. Copia solo `.env` de desarrollo a los worktrees (`.worktreeinclude`) y revisa los permisos que tiene guardados Antigravity.
179
+ - **Permisos**: Orca y Antigravity ejecutan sin confirmación. Copia solo `.env` de desarrollo a los worktrees (`.worktreeinclude`) y revisa los permisos que tiene guardados Antigravity. Las copias se borran con el worktree, en la limpieza que el coordinador te pide confirmar al cerrar cada run.
180
+ - **Worktrees de runs antiguos**: si quedan worktrees o ramas de un run que no se limpió, di «limpia el run». El agente enseña el inventario y borra solo lo integrado y sin cambios pendientes, tras tu «sí».
177
181
 
178
182
  ---
179
183
 
@@ -194,7 +198,7 @@ Puedes editar directamente en `~/.agents/`, pero la próxima reinstalación lo s
194
198
 
195
199
  ```bash
196
200
  ./install.sh --restore <fecha-del-primer-backup> # vuelve al estado anterior
197
- rm -rf ~/.agents/AGENTS.md ~/.agents/rules ~/.agents/templates ~/.agents/output-styles
201
+ rm -rf ~/.agents/AGENTS.md ~/.agents/rules ~/.agents/templates ~/.agents/output-styles ~/.agents/models.md
198
202
  rm -rf ~/.agents/skills/csr-* ~/.agents/skills/orca ~/.agents/skills/kit-init ~/.agents/skills/speckit-orca-implement ~/.agents/speckit-ext
199
203
  ```
200
204