orca-multiagent-kit 1.3.0 → 1.4.1
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 +2 -2
- package/CHANGELOG.md +32 -1
- package/GUIA.html +34 -9
- package/README.md +9 -2
- package/VERSION +1 -1
- package/core/AGENTS.md +3 -3
- package/docs/MANUAL.md +13 -9
- package/docs/OLIMPO.md +413 -0
- package/docs/PLUGIN-ORCA.md +5 -4
- package/install.sh +34 -0
- package/orca-plugin/src/kit.test.ts +11 -0
- package/package.json +1 -1
- package/rules/95-multi-agent.md +19 -11
- package/skills/kit-init/SKILL.md +4 -2
- package/skills/orca/SKILL.md +58 -18
- package/skills/orca/references/adapters/speckit.md +1 -1
- package/skills/orca/references/engine-manual.md +6 -8
- package/skills/orca/references/engine-orca.md +9 -4
- package/skills/orca/references/engine-subagents.md +3 -0
- package/skills/orca/references/integrate.md +42 -3
- package/skills/orca/references/ledger.md +10 -7
- package/skills/orca/references/olimpo.md +92 -0
- package/skills/orca/references/setup.md +13 -7
- package/skills/orca/references/units.md +7 -2
- package/skills/orca/references/worker-contract.md +6 -2
- package/templates/.worktreeinclude +7 -3
- package/templates/ORCHESTRATION.md +28 -19
- package/templates/models.md +29 -0
- package/templates/orca.yaml +10 -2
|
@@ -1,26 +1,30 @@
|
|
|
1
1
|
# ORCHESTRATION.md — Cómo se reparte el trabajo entre agentes
|
|
2
2
|
> La lee la skill `orca` (coordinador) antes de repartir trabajo. Generar o actualizar: «inicializa el proyecto» (`kit-init`).
|
|
3
3
|
> Mantenla corta (≤ ~80 líneas). Complementa a `STACK.md`; no repite sus comandos.
|
|
4
|
+
> Aquí va solo lo propio de **este** proyecto. Qué rol hace cada unidad y con qué nivel de modelo lo decide la skill (`references/olimpo.md`); qué modelo es cada nivel está en `~/.agents/models.md`. No escribas nombres de modelos aquí.
|
|
4
5
|
|
|
5
6
|
## 0. Autonomía
|
|
6
7
|
- Nivel: semi <!-- manual | semi | auto -->
|
|
7
|
-
- manual: confirmas el plan de rondas, cada ronda y
|
|
8
|
-
- semi: confirmas el plan de rondas
|
|
9
|
-
- auto: solo confirmas el merge final
|
|
10
|
-
- Nunca se mergea a la rama por defecto
|
|
8
|
+
- manual: confirmas el plan de rondas, cada ronda, cada merge y la limpieza
|
|
9
|
+
- semi: confirmas el plan de rondas, el merge final y la limpieza (recomendado)
|
|
10
|
+
- auto: solo confirmas el merge final y la limpieza
|
|
11
|
+
- Nunca se mergea a la rama por defecto, se hace push ni se borran worktrees o ramas sin confirmación, en ningún nivel.
|
|
11
12
|
|
|
12
|
-
## 1.
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
|
18
|
-
|
|
19
|
-
|
|
|
13
|
+
## 1. Reparto
|
|
14
|
+
- Proveedores activos: claude <!-- ids de agente separados por comas, p. ej. claude, antigravity, codex -->
|
|
15
|
+
- Dominios sensibles de este proyecto (rol Ariadna, nivel alto, revisión cruzada):
|
|
16
|
+
- auth, permisos, cripto, pagos <!-- añade los tuyos: cálculo fiscal, tenancy, facturación… con sus rutas -->
|
|
17
|
+
- Excepciones al reparto por roles (vacío = se aplica `olimpo.md` tal cual):
|
|
18
|
+
| Unidad, capa o ruta | Rol / proveedor fijado | Motivo |
|
|
19
|
+
|---|---|---|
|
|
20
|
+
| | | |
|
|
21
|
+
- Roles propios del proyecto (opcional; mismas columnas que `olimpo.md`):
|
|
22
|
+
| Rol | Trabajo | Nivel | Revisión | Guardarraíl |
|
|
23
|
+
|---|---|---|---|---|
|
|
24
|
+
| | | | | |
|
|
20
25
|
- Máximo de workers simultáneos: 3
|
|
21
|
-
- Motor preferido: orca | subagents | manual
|
|
22
26
|
- Commits locales de workers: sí | no
|
|
23
|
-
- Revisión cruzada (otro proveedor revisa el diff): unidades L y sensibles
|
|
27
|
+
- Revisión cruzada (otro proveedor revisa el diff): unidades L y sensibles | todas | nunca
|
|
24
28
|
- Reintentos automáticos por unidad: 1
|
|
25
29
|
- Presupuesto por unidad: por talla (S 15 min · M 60 min · L dividir) | <minutos fijos>
|
|
26
30
|
|
|
@@ -32,19 +36,24 @@ pnpm-lock.yaml
|
|
|
32
36
|
```
|
|
33
37
|
|
|
34
38
|
## 3. Entorno de worktree
|
|
35
|
-
|
|
36
|
-
-
|
|
39
|
+
Todo worktree nuevo queda listo para probar en local antes de que el worker edite nada.
|
|
40
|
+
- Rama padre (destino del merge final): la de por defecto <!-- o develop, release/x… Siempre se parte de origin/<padre> actualizado -->
|
|
41
|
+
- Ficheros de entorno que se copian (solo desarrollo): los de `.worktreeinclude`
|
|
42
|
+
- Dependencias: instalar en cada worktree | symlink vía `orca.yaml` (`sharedDirectories`)
|
|
37
43
|
- Base de datos: compartida, migra solo una unidad por ronda | una BD/esquema por worktree (`DATABASE_URL=..._<unit>`)
|
|
38
44
|
- `PORT_BASE`: 3100 (worker n usa 3100+n)
|
|
39
|
-
- Setup
|
|
45
|
+
- Setup de cada worktree (lo ejecuta Orca desde `orca.yaml`; sin Orca, viaja en el bloque `SETUP` del despacho):
|
|
40
46
|
```
|
|
41
|
-
|
|
47
|
+
# 1. copiar desde el checkout principal los ficheros de .worktreeinclude
|
|
48
|
+
# 2. <comando install de STACK.md §3>
|
|
42
49
|
```
|
|
50
|
+
- Comprobación de que el entorno arranca: `<comando typecheck o test rápido de STACK.md §3>`
|
|
43
51
|
|
|
44
52
|
## 4. Flujo por defecto
|
|
45
53
|
- Entrada habitual: spec-kit | plan por sprints | chat
|
|
46
|
-
- Rama de integración: `feat/<feature>` (nunca directo a la rama por defecto)
|
|
54
|
+
- Rama de integración: `feat/<feature>`, creada desde `origin/<padre>` (nunca directo a la rama por defecto)
|
|
47
55
|
- Quién mergea: coordinador tras "sí" del usuario
|
|
56
|
+
- Limpieza tras el merge final: el coordinador enseña worktrees, ramas y copias de entorno, y los borra tras "sí" del usuario
|
|
48
57
|
- Estado del run: `.work/runs/<run>/run.md` (lo escribe solo el coordinador; permite reanudar)
|
|
49
58
|
|
|
50
59
|
## 5. No delegar nunca
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# models.md — Qué modelo usa cada nivel, por proveedor
|
|
2
|
+
> Fichero **tuyo**: el kit lo crea una vez en `~/.agents/models.md` y no lo vuelve a tocar al reinstalar.
|
|
3
|
+
> Lo lee la skill `orca` antes de cada plan de rondas (`references/olimpo.md` §Modelos). Es el único sitio donde aparece el nombre de un modelo.
|
|
4
|
+
> Qué es cada nivel: `alto` = arquitectura, seguridad, normativa, revisión crítica y código sensible · `medio` = implementación, tests, infraestructura · `bajo` = tareas mecánicas.
|
|
5
|
+
|
|
6
|
+
## Cómo se rellena una fila
|
|
7
|
+
- `modelo`: un alias estable del proveedor, un id exacto o un patrón con `*`. Con patrón, si casan varios ids de la lista del proveedor, se usa el de versión más alta.
|
|
8
|
+
- `esfuerzo` (opcional): nivel de razonamiento, si el proveedor lo admite aparte del modelo.
|
|
9
|
+
- Celda vacía = ese nivel no tiene modelo en ese proveedor: las unidades `alto` irán a otro; las demás se lanzan con el modelo por defecto del proveedor.
|
|
10
|
+
|
|
11
|
+
## claude
|
|
12
|
+
- descubrir: — <!-- usa alias: apuntan solos al modelo vigente, no hay nada que actualizar -->
|
|
13
|
+
| nivel | modelo | esfuerzo |
|
|
14
|
+
|---|---|---|
|
|
15
|
+
| alto | opus | |
|
|
16
|
+
| medio | sonnet | |
|
|
17
|
+
| bajo | haiku | |
|
|
18
|
+
|
|
19
|
+
## antigravity
|
|
20
|
+
- descubrir: agy models <!-- la skill la ejecuta en cada run y compara con «vistos» -->
|
|
21
|
+
- vistos: <!-- lo escribe la skill: ids de la última comprobación -->
|
|
22
|
+
- comprobado: <!-- lo escribe la skill: AAAA-MM-DD -->
|
|
23
|
+
| nivel | modelo | esfuerzo |
|
|
24
|
+
|---|---|---|
|
|
25
|
+
| alto | | |
|
|
26
|
+
| medio | | |
|
|
27
|
+
| bajo | | |
|
|
28
|
+
|
|
29
|
+
<!-- Otro proveedor (codex, cursor…): copia un bloque, pon su id de agente como título y, si su CLI lista modelos, la orden en «descubrir». -->
|
package/templates/orca.yaml
CHANGED
|
@@ -1,5 +1,13 @@
|
|
|
1
|
-
# Orca:
|
|
2
|
-
# Solo se aplican si existen en el checkout principal Y están en .gitignore. kit-init ajusta esta lista.
|
|
1
|
+
# Orca: cómo queda listo cada worktree nuevo. kit-init ajusta este fichero al proyecto.
|
|
3
2
|
worktree:
|
|
3
|
+
# Directorios gitignorados que cada worktree comparte (symlink) con el checkout principal.
|
|
4
|
+
# Solo se aplican si existen en el checkout principal Y están en .gitignore.
|
|
4
5
|
sharedDirectories:
|
|
5
6
|
- node_modules
|
|
7
|
+
|
|
8
|
+
# Hooks del repo. Los .env de desarrollo no van aquí: los copia Orca desde .worktreeinclude.
|
|
9
|
+
# scripts:
|
|
10
|
+
# setup: | # tras crear el worktree (worker-start --setup run): instala dependencias si no se comparten
|
|
11
|
+
# pnpm install --frozen-lockfile
|
|
12
|
+
# archive: | # antes de borrarlo (orca worktree rm --run-hooks): para lo que el worktree levantó
|
|
13
|
+
# docker compose down
|