orca-multiagent-kit 1.6.0 → 1.7.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 +4 -3
- package/CHANGELOG.md +41 -1
- package/GUIA.html +11 -9
- package/README.md +22 -23
- package/VERSION +1 -1
- package/bin/backup.js +44 -0
- package/bin/fetch.js +243 -0
- package/bin/hooks.js +187 -0
- package/bin/omk.js +127 -51
- package/bin/run/cleanup.js +402 -0
- package/bin/run/git.js +641 -0
- package/bin/run/glob.js +193 -0
- package/bin/run/ledger.js +243 -0
- package/bin/run/plan.js +328 -0
- package/bin/run/units.js +101 -0
- package/bin/run/util.js +116 -0
- package/bin/run.js +224 -0
- package/bin/setup.js +81 -8
- package/bin/sync.js +222 -0
- package/bin/ui.js +8 -4
- package/bin/update.js +169 -0
- package/core/AGENTS.md +7 -7
- package/docs/EJECUTABLE.md +5 -4
- package/docs/MANUAL.md +16 -3
- package/docs/ORQUESTADOR.md +59 -1
- package/docs/PLUGIN-ORCA.md +34 -16
- package/hooks/orca-gate.cjs +402 -0
- package/install.sh +26 -13
- package/orca-plugin/README.md +3 -1
- package/orca-plugin/orca-plugin.json +2 -2
- package/orca-plugin/src/kit.test.ts +35 -13
- package/orca-plugin/src/kit.ts +64 -19
- package/orca-plugin/src/panel-state.ts +11 -3
- package/orca-plugin/src/panel.check.ts +71 -0
- package/orca-plugin/src/panel.test.tsx +69 -4
- package/orca-plugin/src/panel.tsx +32 -16
- package/orca-plugin/src/protocol.ts +39 -0
- package/orca-plugin/src/tabs/autonomy.tsx +3 -1
- package/orca-plugin/src/tabs/history.test.tsx +1 -0
- package/orca-plugin/src/tabs/history.tsx +1 -0
- package/orca-plugin/src/tabs/notices.test.tsx +1 -0
- package/orca-plugin/src/tabs/worktrees.test.tsx +1 -0
- package/orca-plugin/src/ui/action-card.tsx +112 -0
- package/orca-plugin/src/worker/actions.test.ts +288 -0
- package/orca-plugin/src/worker/actions.ts +292 -0
- package/orca-plugin/src/worker/context.ts +4 -1
- package/orca-plugin/src/worker/history.ts +3 -3
- package/orca-plugin/src/worker/notices.ts +1 -4
- package/orca-plugin/src/worker.test.ts +24 -6
- package/orca-plugin/src/worker.ts +79 -83
- package/output-styles/csr-minimal.md +1 -0
- package/package.json +3 -3
- package/rules/50-done-gate.md +1 -1
- package/rules/95-multi-agent.md +13 -3
- package/skills/kit-init/SKILL.md +16 -4
- package/skills/orca/SKILL.md +27 -5
- package/skills/orca/references/adapters/artifact.md +2 -0
- package/skills/orca/references/adapters/chat.md +2 -0
- package/skills/orca/references/adapters/native-plan.md +6 -0
- package/skills/orca/references/adapters/plan-file.md +2 -0
- package/skills/orca/references/engine-manual.md +7 -5
- package/skills/orca/references/engine-subagents.md +4 -4
- package/skills/orca/references/integrate.md +14 -2
- package/skills/orca/references/ledger.md +1 -1
- package/skills/orca/references/olimpo.md +1 -1
- package/skills/orca/references/plan.md +2 -1
- package/skills/orca/references/units.md +1 -1
- package/skills/orca/references/worker-contract.md +2 -2
- package/templates/AGENTS.md +2 -2
- package/templates/CLAUDE.md +1 -1
- package/templates/claude-settings.json +25 -0
|
@@ -1,5 +1,11 @@
|
|
|
1
1
|
# Adaptador: plan nativo del agente
|
|
2
2
|
|
|
3
|
+
## Cuándo se usa
|
|
4
|
+
En cuanto el usuario aprueba el plan o dice «implementa el plan», **antes de la primera edición** (puerta de reparto, `~/.agents/AGENTS.md` §6). En Claude Code lo recuerda además el hook `PostToolUse` sobre `ExitPlanMode` de `.claude/settings.json`; en Antigravity y el resto no hay hook: manda la regla.
|
|
5
|
+
- Si el plan ya trae la sección `Reparto` (la escribe quien planifica), parte de su veredicto y de su tabla: compruébalos contra el repo y sigue en `SKILL.md` §2–§3.
|
|
6
|
+
- Si no la trae, haz ahora `SKILL.md` §1 con los pasos del plan.
|
|
7
|
+
- Si el contexto se ha vaciado al aprobar, el plan está en el fichero que el agente guardó (Claude Code lo escribe en disco antes de pedir la aprobación): léelo de ahí.
|
|
8
|
+
|
|
3
9
|
## Claude Code (modo plan)
|
|
4
10
|
El plan aprobado está en la conversación (salida de plan mode). Pasos:
|
|
5
11
|
1. Extrae los pasos numerados. Cada grupo de pasos que produce un incremento verificable = una unidad.
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# Adaptador: plan en fichero (`planes/*.md`, `.plans/*.md`, salida de `plan.md`)
|
|
2
2
|
|
|
3
|
+
**Cuándo se usa**: «implementa/ejecuta/sigue `planes/x.md`» (o un plan pegado o adjunto) con ≥2 sprints pendientes, antes de la primera edición (puerta de reparto, `~/.agents/AGENTS.md` §6). «Comienza el Sprint N» es un solo entregable: va por `plan.md` modo 2, sin repartir.
|
|
4
|
+
|
|
3
5
|
## Formato esperado
|
|
4
6
|
El de `plan.md` (sprints con `Archivos`, `Depende de`, `Paralelo`, `Criterios de aceptación`). Si el plan es del antiguo `planificar` (sin esos campos), dedúcelos de la descripción del sprint y márcalos con `ASSUMPTION:`.
|
|
5
7
|
|
|
@@ -3,12 +3,14 @@
|
|
|
3
3
|
Para cuando no hay Orca ni subagentes, o se mezclan proveedores sin Orca.
|
|
4
4
|
|
|
5
5
|
## 1. Crear worktrees
|
|
6
|
-
Desde
|
|
6
|
+
Desde tu checkout, por cada unidad de la ronda, a partir del commit base de la ronda (la rama de integración tras el último merge):
|
|
7
7
|
```bash
|
|
8
|
-
|
|
8
|
+
omk run worktree <run> U2 # ../<repo>.wt/<run>/u2 en la rama wt/<run>/u2, con los .env de .worktreeinclude, anotado en run.md
|
|
9
|
+
# sin omk: git worktree add ../<repo>.wt/<run>/u2 -b wt/<run>/u2 <sha-base>
|
|
9
10
|
```
|
|
11
|
+
`omk run worktree` solo copia de `.worktreeinclude` ficheros ignorados por git, dentro del checkout, sin enlaces ni `..`, y nunca uno cuyo nombre parezca de producción (lo dice con `RISK:`).
|
|
10
12
|
`<sha-base>` es el commit de la rama de integración, que nació de una base fresca (`SKILL.md` §4); nunca el de una rama local sin contrastar con `origin`.
|
|
11
|
-
Después, **en cada worktree, ejecuta tú el setup** de `ORCHESTRATION.md` §3: copia los ficheros de `.worktreeinclude` desde el checkout principal (solo `.env` de desarrollo)
|
|
13
|
+
Después, **en cada worktree, ejecuta tú el setup** de `ORCHESTRATION.md` §3: sin `omk`, copia los ficheros de `.worktreeinclude` desde el checkout principal (solo `.env` de desarrollo); en los dos casos, instala dependencias o enlaza los directorios compartidos. Comprueba que el comando `install`/`typecheck` de `STACK.md` §3 pasa antes de dejar el brief. Anota la ruta del worktree como `ref` en `run.md` (`ledger.md`).
|
|
12
14
|
|
|
13
15
|
## 2. Dejar el brief
|
|
14
16
|
Escribe el mensaje de despacho completo (con `worker-contract.md` entero) en `<worktree>/.work/BRIEF.md` (dentro del worktree, ignorado por git) y en `.work/runs/<run>/briefs/<unit>.md` del principal.
|
|
@@ -16,8 +18,8 @@ Escribe el mensaje de despacho completo (con `worker-contract.md` entero) en `<w
|
|
|
16
18
|
## 3. Instrucciones al usuario (una sola vez, en bloque)
|
|
17
19
|
```
|
|
18
20
|
Abre un agente en cada carpeta y pégale: «Lee .work/BRIEF.md y ejecútalo: es una unidad de un run orquestado con su contrato. Entrega el informe en .work/REPORT.md»
|
|
19
|
-
U1 → ../<repo
|
|
20
|
-
U2 → ../<repo
|
|
21
|
+
U1 → ../<repo>.wt/<run>/u1 (Claude Code, modelo <medio de models.md>)
|
|
22
|
+
U2 → ../<repo>.wt/<run>/u2 (Antigravity, modelo <alto de models.md>)
|
|
21
23
|
Cuando terminen, dime «ronda lista».
|
|
22
24
|
```
|
|
23
25
|
|
|
@@ -3,17 +3,17 @@
|
|
|
3
3
|
Un solo proveedor, sin Orca. Más barato de montar; menos visibilidad.
|
|
4
4
|
|
|
5
5
|
## Antes de lanzar
|
|
6
|
-
- El worktree
|
|
6
|
+
- **El worktree lo creas tú**, no el entorno: `omk run worktree <run> <U>` (sin `omk`, `engine-manual.md` §1). Sale de la cabeza de la rama de integración, en la rama `wt/<run>/<u>`, con su `.env` de desarrollo, y queda anotado en `run.md`. Su ruta va en la línea `WORKTREE:` del despacho.
|
|
7
7
|
- Unidad en `dispatching` en `run.md` antes de lanzar; `dispatched` con el nombre o id del subagente después (`ledger.md`).
|
|
8
8
|
- **Modelo**: pasa al subagente el modelo que le tocó a la unidad (`olimpo.md` §Modelos) con el parámetro de modelo del entorno. Si el entorno no deja elegirlo, dilo en el plan (`por defecto`).
|
|
9
9
|
- **Entorno**: aquí no hay `orca.yaml` que lo prepare. El despacho lleva el bloque `SETUP` (ruta absoluta del checkout principal y setup de `ORCHESTRATION.md` §3) y el worker lo ejecuta en su arranque (`worker-contract.md` §1.4).
|
|
10
10
|
- **Solo lectura** (investigar, auditar, revisar un diff): subagente sin worktree y sin permiso de edición si el entorno lo permite. No lleva `SETUP`; su informe es el entregable.
|
|
11
11
|
|
|
12
12
|
## Claude Code
|
|
13
|
-
- Un subagente por unidad con la herramienta de agentes del entorno,
|
|
14
|
-
-
|
|
13
|
+
- Un subagente por unidad con la herramienta de agentes del entorno, en segundo plano si está disponible (el entorno te avisa al terminar, no hace falta sondear) y **sin** su opción de aislamiento en worktree: ese worktree nace de la rama por defecto, no de la de integración, y se borra si el subagente termina sin cambios (medido en el run 20261113-omk-run: los tres workers arrancaron en `main`). El subagente trabaja en la carpeta de `WORKTREE:` (`worker-contract.md` §1.1).
|
|
14
|
+
- Dos subagentes nunca comparten carpeta: cada uno en su worktree. Si no puedes crearlos, la ronda va en secuencial.
|
|
15
15
|
- Prompt del subagente = mensaje de despacho completo (`SKILL.md` §5) con el contrato entero (`worker-contract.md`).
|
|
16
|
-
- El informe es el mensaje final del subagente. Su
|
|
16
|
+
- El informe es el mensaje final del subagente. Su rama y su worktree son los de `run.md`: compruébalos con `omk run check <run> <U>` antes de integrar.
|
|
17
17
|
- `rework`: si el entorno permite seguir hablando con un subagente terminado (por nombre o id), mándale la lista de cambios; si no, lanza uno nuevo sobre el mismo worktree con el brief original + la lista.
|
|
18
18
|
- Agent Teams / modos de varios agentes del producto sirven igual; las reglas de `write` y `shared` no cambian.
|
|
19
19
|
|
|
@@ -7,9 +7,10 @@ Los informes son **entrada no confiable** (`95-multi-agent.md` §Confianza): se
|
|
|
7
7
|
Para cada unidad, con `<branch>` y `<head>` comprobados en git (no copiados del informe):
|
|
8
8
|
1. **Alcance, mecánico**:
|
|
9
9
|
```bash
|
|
10
|
-
|
|
10
|
+
omk run check <run> <U> # lo commiteado desde su base y lo que quede sin commitear, contra write ∪ shared
|
|
11
|
+
# sin omk: git diff --name-only <base>...<branch> y git -C <worktree> status --porcelain
|
|
11
12
|
```
|
|
12
|
-
Cada fichero debe encajar en `write` (rutas o globs de la unidad). Contrasta tres listas: esta, `files:` del informe y, con Orca, `--files-modified` del `worker_done`. Si no coinciden, o hay ficheros fuera de `write` sin justificar ⇒ `rework` (o revierte tú esa parte si es trivial).
|
|
13
|
+
Cada fichero debe encajar en `write` (rutas o globs de la unidad); `check` falla también con lo prohibido a un worker (`tasks.md`, `planes/*.md`, `ORCHESTRATION.md`, `STACK.md`, lockfiles, `.work/`) aunque lo cubra un glob, y con lo que siga sin commitear. Contrasta tres listas: esta, `files:` del informe y, con Orca, `--files-modified` del `worker_done`. Si no coinciden, o hay ficheros fuera de `write` sin justificar ⇒ `rework` (o revierte tú esa parte si es trivial).
|
|
13
14
|
2. **Acceptance**: cada criterio verificado de verdad (comando o prueba citada). Marcado sin evidencia ⇒ trátalo como no hecho. Repite tú un `verify` solo si la evidencia falta o se contradice con el diff.
|
|
14
15
|
3. **Calidad**: criterios de bloqueo de `60-git-workflow.md` §Revisión (corrección, seguridad, pérdida de datos, contrato roto, falta de test). No bloquees por estilo que impone el formateador.
|
|
15
16
|
4. **Contratos entre unidades**: si dos unidades hablan entre sí (API ↔ UI, tipos), que coincidan.
|
|
@@ -23,6 +24,12 @@ Orden topológico por `depends_on` → prioridad (P1 antes que P2) → la que me
|
|
|
23
24
|
## 3. Integrar en la rama de integración
|
|
24
25
|
Con autonomía `semi` o `auto`, la confirmación 1 del run ya autoriza estos commits y merges (solo en ramas de trabajo y en la rama de integración, nunca en la de por defecto). Con `manual`, pide un «sí» por ronda. Si un worker no hizo commits, haz tú un commit atómico en su worktree con los cambios revisados (`feat(<ámbito>): <unidad>`). Luego, por unidad:
|
|
25
26
|
```bash
|
|
27
|
+
omk run set <run> <U> status=accepted
|
|
28
|
+
omk run merge <run> <U> --dry-run # ensayo con merge-tree; sale con 1 y la lista de ficheros si hay conflicto
|
|
29
|
+
omk run merge <run> <U> # merge --no-ff en la rama de integración y run.md a merged con su sha; nunca push
|
|
30
|
+
```
|
|
31
|
+
`omk run merge` se niega fuera de la rama de integración, con el árbol sucio, hacia la rama por defecto, con la unidad sin `accepted` o si `check` falla. Sin `omk`, a mano:
|
|
32
|
+
```bash
|
|
26
33
|
git switch feat/<feature> # rama de integración del run
|
|
27
34
|
git merge-tree --write-tree HEAD <branch> >/dev/null \
|
|
28
35
|
|| echo "conflicto previsto" # ensayo sin tocar el árbol (git ≥ 2.38)
|
|
@@ -52,6 +59,10 @@ Un worktree integrado deja una copia de los `.env`, dependencias y una rama que
|
|
|
52
59
|
|
|
53
60
|
**1. Inventario (sale de git, no de la memoria ni de los informes)**
|
|
54
61
|
```bash
|
|
62
|
+
omk run cleanup <run> # ensayo: tabla tipo | nombre | estado | acción, sin tocar nada
|
|
63
|
+
```
|
|
64
|
+
Junta los worktrees y ramas `wt/<run>/…` y los de `run.md`, y por cada uno dice si está integrado y limpio (se borraría) o por qué se queda: cambios sin commit, commits sin integrar, bloqueado, rama protegida (por defecto, integración, actual) o ruta que git no lista. Sin `omk`, a mano:
|
|
65
|
+
```bash
|
|
55
66
|
git fetch origin --prune
|
|
56
67
|
git worktree list --porcelain # worktrees del run: los de la columna worktree de run.md
|
|
57
68
|
git -C <worktree> status --porcelain # cambios sin commit que se perderían
|
|
@@ -75,6 +86,7 @@ remoto: origin/feat/003-recargas existe → no la toco salvo que me lo pidas
|
|
|
75
86
|
**3. Borrado, solo de lo aprobado y en este orden**
|
|
76
87
|
- Solo se borra lo que es **integrado y limpio**. Una rama sin integrar, o un worktree con cambios sin commit, no entra en el «sí»: se lista aparte y se pregunta por cada uno diciendo qué se perdería.
|
|
77
88
|
- Orca: `worker-release` de cada dispatch y `orca worktree rm` (`engine-orca.md` §6).
|
|
89
|
+
- Con `omk`: `omk run cleanup <run> --apply` borra solo lo que el ensayo marcó para borrar (`git worktree remove` sin `--force`, `git branch -d`), anota `cleanup: done|pending` en `run.md` y sale con 1 si algo no se pudo borrar.
|
|
78
90
|
- Git a mano:
|
|
79
91
|
```bash
|
|
80
92
|
git worktree remove <ruta> # sin --force: se niega si quedan cambios; se lleva las copias de .env y las dependencias
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
Un run dura horas y sobrevive a cosas que el coordinador no controla: compactación del contexto, cierre del agente, caída de Orca, reinicio del equipo. El estado vive en un fichero, no en la conversación.
|
|
4
4
|
|
|
5
5
|
## Fichero
|
|
6
|
-
`.work/runs/<run>/run.md` del checkout
|
|
6
|
+
`.work/runs/<run>/run.md` del checkout del coordinador (con Orca, su workspace). Lo escribe **solo** el coordinador (los workers no lo ven), y con `omk run`, no a mano: `omk run new` lo crea con las unidades de `units.md` en `pending`; `omk run set <run> <U> clave=valor…` cambia una fila (`status` respeta las transiciones de abajo, pasar a `dispatching` cuenta un intento y `updated` se pone solo); `omk run meta <run> clave=valor…` cambia la cabecera y `omk run log <run> <texto>` añade al log. Sin `omk`, edítalo a mano con este formato:
|
|
7
7
|
```markdown
|
|
8
8
|
# run 20261107-recargas
|
|
9
9
|
- input: speckit specs/003-recargas
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# Olimpo: roles, niveles de modelo y quién revisa a quién
|
|
2
2
|
|
|
3
3
|
Lo lee el coordinador al repartir (`SKILL.md` §2). Decide **qué rol** hace cada unidad, **con qué nivel de modelo** y **quién la revisa**. No decide qué se reparte (`95-multi-agent.md`) ni cómo se integra (`integrate.md`).
|
|
4
|
-
Origen de los nombres y fichas completas del equipo: `docs/OLIMPO.md` del kit (no hace falta leerlo para repartir
|
|
4
|
+
Origen de los nombres y fichas completas del equipo: `docs/OLIMPO.md` en el repositorio del kit (https://github.com/FernandoBaqueroo/orca-multiagent-kit/blob/main/docs/OLIMPO.md); no se instala en `~/.agents` ni hace falta leerlo para repartir.
|
|
5
5
|
|
|
6
6
|
## Cadena de decisión (una sola, en este orden)
|
|
7
7
|
```
|
|
@@ -30,7 +30,8 @@ Objetivo: <1–2 líneas> · Creado: AAAA-MM-DD · Estado: en curso
|
|
|
30
30
|
- ...
|
|
31
31
|
- Verificación:
|
|
32
32
|
```
|
|
33
|
-
4.
|
|
33
|
+
4. Cierra el fichero con la sección `## Reparto`: el veredicto de `SKILL.md` §1 (`ORCA: <N> unidades · <R> rondas` u `ORCA: secuencial — <motivo>`) y la tabla `sprint | depende | paralelo`. Quien implemente el plan después, en esta sesión o en otra, parte de ahí.
|
|
34
|
+
5. Al usuario: ruta del plan + esa sección (nada más). Pregunta una sola cosa: ¿sprint a sprint con visto bueno (modo 2) o en paralelo con orca (modo 3)?
|
|
34
35
|
|
|
35
36
|
## MODO 2 — Ejecutar un sprint (secuencial, human-in-the-loop)
|
|
36
37
|
Disparador: "comienza el Sprint N de planes/<feature>.md".
|
|
@@ -28,7 +28,7 @@ Toda entrada acaba en este formato antes de repartirse. Es el contrato entre coo
|
|
|
28
28
|
```
|
|
29
29
|
Los campos marcados `opcional` pueden faltar: un worker o coordinador de una versión anterior los ignora sin romperse.
|
|
30
30
|
|
|
31
|
-
Reglas del formato:
|
|
31
|
+
Reglas del formato (`omk run plan <run>` las comprueba y calcula las rondas de §Grafo y rondas):
|
|
32
32
|
- `write` con rutas reales o globs estrechos (`src/features/recargas/**`). Nunca `src/**`.
|
|
33
33
|
- `acceptance` observable y comprobable. "Funciona bien" no vale.
|
|
34
34
|
- `verify` sale de `STACK.md` §3. Si un comando no existe: `N/A` + `RISK:`.
|
|
@@ -5,7 +5,7 @@ Copia este texto en el mensaje de cada worker de motores `subagents` y `manual`.
|
|
|
5
5
|
Eres un worker de un run orquestado. Ejecutas **una** unidad.
|
|
6
6
|
|
|
7
7
|
## 1. Arranque (antes de editar nada)
|
|
8
|
-
1. Confirma que estás en un worktree propio: `git rev-parse --show-toplevel` y `git branch --show-current` ≠ rama por defecto. Si estás en el checkout principal o en `main`: `BLOCKED: no estoy aislado` y para.
|
|
8
|
+
1. Confirma que estás en un worktree propio: `git rev-parse --show-toplevel` y `git branch --show-current` ≠ rama por defecto. Si el despacho trae `WORKTREE:`, ese es tu worktree aunque tu sesión arranque en otra carpeta: trabaja solo ahí (`cd` a él o rutas absolutas en cada orden) y no escribas ni cambies de rama en la carpeta donde arrancaste. Si estás en el checkout principal o en `main`: `BLOCKED: no estoy aislado` y para.
|
|
9
9
|
2. Confirma la base: `git merge-base --is-ancestor <BASE> HEAD` (BASE viene en la cabecera del despacho). Si falla, partes de otro commit: `BLOCKED: base distinta` y para.
|
|
10
10
|
3. Lee `STACK.md` y las reglas del proyecto (`AGENTS.md` / `CLAUDE.md`). Lee los ficheros de `read` de tu unidad.
|
|
11
11
|
4. **Entorno listo** (antes de editar nada):
|
|
@@ -16,7 +16,7 @@ Eres un worker de un run orquestado. Ejecutas **una** unidad.
|
|
|
16
16
|
|
|
17
17
|
## 2. Alcance — YOU MUST
|
|
18
18
|
- Escribes **solo** en `write`. Necesitas otro fichero ⇒ pregunta al coordinador (Orca: `orca orchestration ask`, y termina tu turno hasta que Orca te despierte con la respuesta; otros motores: `BLOCKED:` en el informe) y sigue con lo demás mientras.
|
|
19
|
-
- No tocas: `shared` (salvo los listados en tu unidad), `tasks.md`, `planes/*.md`, `ORCHESTRATION.md`, `STACK.md`, lockfiles, ficheros generados. Si necesitas una dependencia nueva: pídela, no la instales.
|
|
19
|
+
- No tocas: `shared` (salvo los listados en tu unidad), `tasks.md`, `planes/*.md`, `ORCHESTRATION.md`, `STACK.md`, lockfiles, ficheros generados, migraciones ajenas. Si necesitas una dependencia nueva: pídela, no la instales.
|
|
20
20
|
- Si el despacho trae una línea `ROL:`, su guardarraíl es parte de tu alcance. No interpretas un personaje: aplicas esa regla.
|
|
21
21
|
- No reabres decisiones de `notes`. Si crees que una está mal: `RISK:` en el informe, e implementas lo decidido.
|
|
22
22
|
- No haces merge, push, rebase sobre otras ramas ni borras ramas. Commits locales en tu rama **solo** si `ORCHESTRATION.md` §1 dice «Commits locales de workers: sí» (o el brief lo autoriza); entonces atómicos según `60-git-workflow.md`. Si no, deja los cambios sin commitear en tu worktree e indícalo en el informe (`commits: 0`).
|
package/templates/AGENTS.md
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
|
-
<!-- AGENTS:BEGIN project
|
|
1
|
+
<!-- AGENTS:BEGIN project -->
|
|
2
2
|
# Reglas del proyecto
|
|
3
3
|
|
|
4
4
|
1. Lee `./STACK.md` antes de la primera edición de cada sesión: versiones, comandos y límites. Comandos: solo los de `STACK.md` §3; si falta uno, dilo, no lo inventes.
|
|
5
5
|
2. Aplican las reglas globales (`~/.agents/AGENTS.md`) y su router (`~/.agents/rules/`). Lee bajo demanda, no todo. Si tu agente no las tiene cargadas, léelas ahora.
|
|
6
6
|
3. Ningún cambio se da por terminado sin `~/.agents/rules/50-done-gate.md` y la tabla de gates.
|
|
7
7
|
4. Respuestas mínimas: resultado primero, ≤4 líneas de prosa, sin narrar herramientas. Detalle solo si se pide.
|
|
8
|
-
5. Trabajo multiagente: antes de repartir, lee `./ORCHESTRATION.md`. Una unidad = un worktree = una rama; los ficheros `shared` solo los toca una unidad por ronda; los workers no editan `tasks.md`, `planes/*.md`, `ORCHESTRATION.md`, `STACK.md
|
|
8
|
+
5. Trabajo multiagente: antes de la primera edición de un trabajo con ≥2 entregables separables (venga de un prompt, de un plan aprobado, de un plan en fichero, de un artefacto o de un ticket), carga la skill `orca` y, antes de editar, deja en el chat su veredicto en una línea `ORCA: …` (si reparte, con el plan de rondas, y espera la respuesta del usuario) (`~/.agents/AGENTS.md` §6); todo plan que escribas termina con una sección `Reparto`. Antes de repartir, lee `./ORCHESTRATION.md`. Una unidad = un worktree = una rama; los ficheros `shared` solo los toca una unidad por ronda; los workers no editan `tasks.md`, `planes/*.md`, `ORCHESTRATION.md`, `STACK.md`, lockfiles, ficheros generados ni migraciones ajenas, no mergean ni hacen push, y entregan informe. Briefs e informes en `.work/` (ignorado por git).
|
|
9
9
|
|
|
10
10
|
## Overrides de este proyecto
|
|
11
11
|
<!-- Solo lo que se desvía de las reglas globales. Si está vacío, mejor. -->
|
package/templates/CLAUDE.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- AGENTS:BEGIN project-claude
|
|
1
|
+
<!-- AGENTS:BEGIN project-claude -->
|
|
2
2
|
<!-- Claude Code lee CLAUDE.md en vez de AGENTS.md cuando existen los dos: este import hace que lea las mismas reglas que el resto de agentes. No añadas reglas aquí: van en AGENTS.md. -->
|
|
3
3
|
@AGENTS.md
|
|
4
4
|
<!-- AGENTS:END -->
|
|
@@ -23,5 +23,30 @@
|
|
|
23
23
|
"Bash(git push --force:*)",
|
|
24
24
|
"Bash(curl:* | bash)"
|
|
25
25
|
]
|
|
26
|
+
},
|
|
27
|
+
"hooks": {
|
|
28
|
+
"UserPromptSubmit": [
|
|
29
|
+
{
|
|
30
|
+
"hooks": [
|
|
31
|
+
{
|
|
32
|
+
"type": "command",
|
|
33
|
+
"command": "echo '[Orca Multiagent Kit] Puerta de reparto (~/.agents/AGENTS.md 6): si este mensaje pide implementar algo con 2 o mas entregables separables, carga la skill orca y, antes del primer Edit/Write, escribe en el chat una linea visible que empiece por ORCA: con su veredicto (secuencial con su motivo, o N unidades seguida del plan de rondas y espera la respuesta del usuario) y registrala ejecutando echo con esa misma linea. En modo plan va como ultima seccion del plan. No aplica a preguntas, a un solo entregable, a un worker (UNIT:), a /speckit.implement ni si ya hay un veredicto ORCA: para este trabajo.'",
|
|
34
|
+
"timeout": 5
|
|
35
|
+
}
|
|
36
|
+
]
|
|
37
|
+
}
|
|
38
|
+
],
|
|
39
|
+
"PostToolUse": [
|
|
40
|
+
{
|
|
41
|
+
"matcher": "ExitPlanMode",
|
|
42
|
+
"hooks": [
|
|
43
|
+
{
|
|
44
|
+
"type": "command",
|
|
45
|
+
"command": "echo '{\"hookSpecificOutput\":{\"hookEventName\":\"PostToolUse\",\"additionalContext\":\"[Orca Multiagent Kit] Plan aprobado. Antes de la primera edicion: si el plan tiene 2 o mas entregables separables, carga la skill orca (entrada: plan nativo, references/adapters/native-plan.md) y escribe su veredicto en una linea que empiece por ORCA: (y registrala ejecutando echo con esa misma linea). Con un solo entregable, implementalo directamente, sin esa linea.\"}}'",
|
|
46
|
+
"timeout": 5
|
|
47
|
+
}
|
|
48
|
+
]
|
|
49
|
+
}
|
|
50
|
+
]
|
|
26
51
|
}
|
|
27
52
|
}
|