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.
@@ -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 cada merge
8
- - semi: confirmas el plan de rondas y el merge final (recomendado)
9
- - auto: solo confirmas el merge final
10
- - Nunca se mergea a la rama por defecto ni se hace push sin confirmación, en ningún nivel.
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. Agentes
13
- | Capa / área | Agente por defecto | Alternativa | Motivo |
14
- |---|---|---|---|
15
- | UI (componentes, páginas, estilos) | | | |
16
- | API / lógica de servidor | | | |
17
- | Datos (esquema, migraciones, SQL) | coordinador | — | toca `shared` |
18
- | Tests E2E / verificación en navegador | | | |
19
- | Revisión de diffs al integrar | | | segundo proveedor = segunda opinión |
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 (auth, permisos, cripto, pagos, migraciones) | todas | nunca
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
- - Dependencias: symlink vía `orca.yaml` (`sharedDirectories`) | `pnpm install` en setup
36
- - Variables de entorno: `.worktreeinclude` copia → `.env.local` (solo desarrollo)
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 tras crear worktree (si no lo hace Orca):
45
+ - Setup de cada worktree (lo ejecuta Orca desde `orca.yaml`; sin Orca, viaja en el bloque `SETUP` del despacho):
40
46
  ```
41
- TODO:
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». -->
@@ -1,5 +1,13 @@
1
- # Orca: directorios gitignorados que cada worktree comparte (symlink) con el checkout principal.
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