orca-multiagent-kit 0.0.0-stage → 1.2.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 +49 -0
- package/CHANGELOG.md +79 -0
- package/GUIA.html +401 -0
- package/LICENSE +21 -0
- package/README.md +240 -2
- package/VERSION +1 -0
- package/bin/omk.js +175 -0
- package/bin/ui.js +165 -0
- package/core/AGENTS.md +80 -0
- package/docs/MANUAL.md +208 -0
- package/install.sh +403 -0
- package/output-styles/csr-minimal.md +14 -0
- package/package.json +23 -4
- package/rules/00-router.md +28 -0
- package/rules/10-communication.md +58 -0
- package/rules/20-clean-code.md +59 -0
- package/rules/30-security.md +81 -0
- package/rules/31-security-audit.md +58 -0
- package/rules/40-testing.md +48 -0
- package/rules/50-done-gate.md +66 -0
- package/rules/60-git-workflow.md +49 -0
- package/rules/70-performance.md +36 -0
- package/rules/75-reliability.md +36 -0
- package/rules/80-supply-chain.md +35 -0
- package/rules/90-docs-comments.md +36 -0
- package/rules/95-multi-agent.md +56 -0
- package/rules/lang/cpp.md +26 -0
- package/rules/lang/csharp.md +27 -0
- package/rules/lang/dart-flutter.md +26 -0
- package/rules/lang/go.md +30 -0
- package/rules/lang/infra.md +33 -0
- package/rules/lang/java.md +29 -0
- package/rules/lang/kotlin.md +25 -0
- package/rules/lang/php.md +27 -0
- package/rules/lang/python.md +33 -0
- package/rules/lang/react.md +32 -0
- package/rules/lang/ruby.md +23 -0
- package/rules/lang/rust.md +32 -0
- package/rules/lang/shell.md +24 -0
- package/rules/lang/sql.md +29 -0
- package/rules/lang/swift.md +31 -0
- package/rules/lang/typescript.md +32 -0
- package/rules/lang/web.md +31 -0
- package/skills/csr-audit/SKILL.md +14 -0
- package/skills/csr-gate/SKILL.md +16 -0
- package/skills/csr-stack/SKILL.md +23 -0
- package/skills/kit-init/SKILL.md +61 -0
- package/skills/orca/SKILL.md +88 -0
- package/skills/orca/references/adapters/artifact.md +32 -0
- package/skills/orca/references/adapters/chat.md +33 -0
- package/skills/orca/references/adapters/native-plan.md +18 -0
- package/skills/orca/references/adapters/plan-file.md +20 -0
- package/skills/orca/references/adapters/speckit.md +42 -0
- package/skills/orca/references/engine-manual.md +30 -0
- package/skills/orca/references/engine-orca.md +36 -0
- package/skills/orca/references/engine-subagents.md +19 -0
- package/skills/orca/references/integrate.md +37 -0
- package/skills/orca/references/plan.md +48 -0
- package/skills/orca/references/race.md +35 -0
- package/skills/orca/references/setup.md +26 -0
- package/skills/orca/references/units.md +44 -0
- package/skills/orca/references/worker-contract.md +49 -0
- package/skills/speckit-orca-implement/SKILL.md +17 -0
- package/speckit-extension/orca/README.md +15 -0
- package/speckit-extension/orca/commands/implement.md +16 -0
- package/speckit-extension/orca/extension.yml +26 -0
- package/templates/.worktreeinclude +4 -0
- package/templates/AGENTS.md +13 -0
- package/templates/CLAUDE.md +4 -0
- package/templates/ORCHESTRATION.md +49 -0
- package/templates/STACK.md +91 -0
- package/templates/claude-settings.json +27 -0
- package/templates/orca.yaml +5 -0
package/AI_INSTALL.md
ADDED
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
# AI_INSTALL.md — Instrucciones para una IA
|
|
2
|
+
|
|
3
|
+
Eres un agente (Claude Code, Antigravity, Codex, Copilot, Cursor, Devin u otro) y te han pedido **instalar Orca Multiagent Kit**, **migrar desde CSR/MAW v1** o **integrarlo en un proyecto**. `README.md` y `docs/MANUAL.md` son para humanos.
|
|
4
|
+
|
|
5
|
+
## 0. Principio
|
|
6
|
+
Una sola fuente: `~/.agents/` (núcleo `AGENTS.md`, `rules/`, `skills/`, `templates/`). Cada agente **apunta** ahí con un import o un enlace simbólico. Si te encuentras copiando reglas dentro de la carpeta de un agente, para: eso es lo que este kit elimina.
|
|
7
|
+
|
|
8
|
+
## 1. Reglas
|
|
9
|
+
- Solo escribes en: `~/.agents/`, las carpetas de configuración de los agentes detectados y el proyecto indicado.
|
|
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`.
|
|
12
|
+
- Nunca borres contenido de `CLAUDE.md`, `AGENTS.md` o `GEMINI.md` fuera de los bloques `<!-- CSR|MAW|AGENTS:BEGIN … :END -->`.
|
|
13
|
+
- No pongas rutas de un agente concreto (`~/.claude/rules`, `~/.gemini/rules`) en reglas o skills: usa `~/.agents/…`.
|
|
14
|
+
|
|
15
|
+
## 2. Instalación global / migración
|
|
16
|
+
1. `./install.sh --dry-run`. Enseña al usuario la lista de cambios y pide un «sí»: toca su configuración global.
|
|
17
|
+
2. `./install.sh` (o `--agents <lista>` si el usuario lo limita).
|
|
18
|
+
3. `./install.sh --verify`. Todo `OK`; cualquier `MAL` se corrige antes de terminar.
|
|
19
|
+
4. Reporta: agentes configurados, ruta del backup, los avisos que imprimió el instalador y el comando `--restore` para deshacerlo.
|
|
20
|
+
|
|
21
|
+
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**).
|
|
22
|
+
|
|
23
|
+
## 3. Proyecto
|
|
24
|
+
1. `./install.sh --project-only <ruta>`. Migra los overrides del bloque CSR antiguo a `AGENTS.md` y deja `CLAUDE.md` como `@AGENTS.md`.
|
|
25
|
+
2. Ejecuta la skill `kit-init`: migra las reglas, detecta el stack (`csr-stack`) prepara la orquestación y, si hay spec-kit, activa el hook `before_implement`. Sin terminal, `kit-init` hace también el paso 1.
|
|
26
|
+
3. Si `CLAUDE.md` tenía reglas propias fuera del bloque, propón moverlas a `AGENTS.md` (sección *Overrides*) para que las vean todos los agentes. No lo hagas sin confirmación.
|
|
27
|
+
4. No hagas commit sin permiso. Se commitean `AGENTS.md`, `CLAUDE.md`, `STACK.md`, `ORCHESTRATION.md`, `orca.yaml`, `.worktreeinclude` y `.claude/settings.json`; `.work/` no.
|
|
28
|
+
|
|
29
|
+
## 4. Agente no soportado por el instalador
|
|
30
|
+
1. Busca en **su documentación oficial**: (a) fichero de instrucciones globales; (b) si admite imports (`@ruta`) o enlaces simbólicos; (c) directorio de skills globales y si ya lee `~/.agents/skills`.
|
|
31
|
+
2. Preferencia: lee `~/.agents/skills` de serie > enlace simbólico de su fichero global a `~/.agents/AGENTS.md` > import > (último recurso) una línea en sus ajustes: «Al empezar, lee y aplica ~/.agents/AGENTS.md».
|
|
32
|
+
3. Nunca copies el contenido del núcleo dentro del agente.
|
|
33
|
+
4. Si lo integras, añádelo a `install.sh` (detección + `link`) y a `--verify`, siguiendo el patrón de Codex.
|
|
34
|
+
|
|
35
|
+
## 5. Comprobación final (obligatoria)
|
|
36
|
+
```
|
|
37
|
+
prueba | esperado | estado
|
|
38
|
+
--verify | todo OK |
|
|
39
|
+
ls ~/.claude/rules ~/.gemini/rules | sin ficheros de CSR/MAW |
|
|
40
|
+
grep -c 'CSR:BEGIN' ~/.claude/CLAUDE.md | 0 |
|
|
41
|
+
nueva sesión: «¿dónde están tus reglas de seguridad?» | ~/.agents/rules/30-security.md |
|
|
42
|
+
nueva sesión con spec-kit: `/speckit.implement` | el hook orca decide y muestra el plan de rondas |
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
## 6. Qué no hacer
|
|
46
|
+
- Editar `~/.agents/AGENTS.md` para un proyecto concreto: eso va en el `AGENTS.md` del proyecto.
|
|
47
|
+
- Activar Orca, cambiar permisos de agentes o desactivar plugins sin que el usuario lo pida.
|
|
48
|
+
- Escribir comandos de Orca de memoria: la fuente es `orca skills get orchestration`.
|
|
49
|
+
- Copiar `.env` con secretos de producción a `.worktreeinclude` o a plantillas.
|
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
Todos los cambios relevantes de este proyecto se documentan aquí.
|
|
4
|
+
El formato sigue [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/) y el proyecto usa [Versionado Semántico](https://semver.org/lang/es/).
|
|
5
|
+
|
|
6
|
+
## [Unreleased]
|
|
7
|
+
|
|
8
|
+
## [1.2.0] - 2026-11-07
|
|
9
|
+
|
|
10
|
+
### Añadido
|
|
11
|
+
- **Salida nueva de `omk`**: spinner por fase, color lima, símbolos de estado (`+` creado, `=` sin cambios, `!` aviso) y tiempo total. Sin dependencias.
|
|
12
|
+
- El resumen final separa **Pendiente** (lo que tienes que hacer tú) de **Para tu información**, y acaba con los siguientes pasos (`omk verify`, `omk init`, `omk restore`).
|
|
13
|
+
- `omk verify` agrupa las comprobaciones por agente y da un total.
|
|
14
|
+
- Cursor: el instalador detecta si ya tienes la regla de usuario y deja de pedirla.
|
|
15
|
+
- `./install.sh` sin `omk` muestra la misma estructura en texto, con color en terminal.
|
|
16
|
+
- `omk update` compara con la última versión de npm y, si no tienes permisos (instalación con `sudo`), explica cómo arreglarlo en vez de mostrar el error de npm.
|
|
17
|
+
- La release se publica sola al fusionar en `main` un cambio de `VERSION` (GitHub y npm).
|
|
18
|
+
- `check.sh` detecta `$VAR` pegado a un carácter no ASCII, que rompe bash 3.2 en macOS.
|
|
19
|
+
|
|
20
|
+
### Corregido
|
|
21
|
+
- `omk init` en un proyecto con spec-kit fallaba con «Directory not found: ~/.agents/speckit-ext/orca» si aún no se había ejecutado `omk install` con esta versión. Ahora usa la extensión del propio kit y avisa de que falta `omk install`.
|
|
22
|
+
- macOS: un mensaje con `«$FIX»` cortaba el instalador (bash 3.2 tomaba `«` como parte del nombre de la variable).
|
|
23
|
+
- «deshacer» solo aparece cuando hay copia de seguridad que restaurar.
|
|
24
|
+
- Banner: la barra de carga del pie, que no representaba nada, se sustituye por las skills que instala el kit.
|
|
25
|
+
|
|
26
|
+
### Cambiado
|
|
27
|
+
- Publicado en npm: `npx orca-multiagent-kit install` y `npm i -g orca-multiagent-kit`, sin el prefijo `github:`.
|
|
28
|
+
- Las releases publican en npm con Trusted Publishing (OIDC), sin tokens guardados en el repo.
|
|
29
|
+
|
|
30
|
+
## [1.1.0] - 2026-11-07
|
|
31
|
+
|
|
32
|
+
Orquestación automática: ya no hace falta conocer ni invocar fases. Escribes `/speckit.implement` (o pides la tarea con normalidad) y el kit decide si compensa repartirla.
|
|
33
|
+
|
|
34
|
+
### Añadido
|
|
35
|
+
- Skill **`orca`**: punto de entrada único al desarrollo orquestado. El agente la usa por iniciativa propia cuando una tarea tiene partes independientes. Decide si compensa, divide, reparte, vigila e integra.
|
|
36
|
+
- **Niveles de autonomía** en `ORCHESTRATION.md` (`manual`, `semi`, `auto`). Por defecto, `semi`: solo se confirman el plan de rondas y el merge final.
|
|
37
|
+
- **Extensión de spec-kit `orca`** (`speckit-extension/orca`) con hook `before_implement` obligatorio: `/speckit.implement` reparte las user stories si compensa y, si no, sigue como siempre. La skill `speckit-orca-implement` resuelve el comando en cualquier agente.
|
|
38
|
+
- `kit-init`, `omk init` e `install.sh --project` activan el hook en proyectos con `.specify/`.
|
|
39
|
+
- Rama de integración por run (`feat/<feature>`): los merges intermedios nunca tocan la rama por defecto.
|
|
40
|
+
|
|
41
|
+
### Cambiado
|
|
42
|
+
- Las 8 skills `maw-*` pasan a ser referencias internas de `orca` (`skills/orca/references/`). El instalador retira las antiguas.
|
|
43
|
+
- Con Orca, el contrato del worker ya no duplica lo que Orca inyecta (`worker_done`, preguntas, heartbeats); solo se añaden las reglas de alcance.
|
|
44
|
+
- Núcleo §6: orquestación proactiva, autonomía y nueva invariante (nunca merge a la rama por defecto ni push sin confirmación).
|
|
45
|
+
|
|
46
|
+
### Eliminado
|
|
47
|
+
- Skills `maw-route`, `maw-brief`, `maw-plan`, `maw-dispatch`, `maw-worker`, `maw-integrate`, `maw-race` y `maw-setup` (consolidadas en `orca`).
|
|
48
|
+
|
|
49
|
+
## [1.0.0] - 2026-11-07
|
|
50
|
+
|
|
51
|
+
Primera versión de **Orca Multiagent Kit**. Une CSR (Claude Session Rules, de [Necro-Coder](https://github.com/Necro-Coder)) y MAW (Multi-Agent Work) en una fuente única para varios proveedores.
|
|
52
|
+
|
|
53
|
+
### Añadido
|
|
54
|
+
- Fuente única en `~/.agents/` (`AGENTS.md`, `rules/`, `skills/`, `templates/`, `output-styles/`), leída por Claude Code, Antigravity, Codex, Copilot CLI, Cursor y Devin mediante import, enlace simbólico o lectura nativa.
|
|
55
|
+
- **MAW — Multi-Agent Work**: regla `95-multi-agent` y skills `maw-route`, `maw-brief` (adaptadores spec-kit, plan en fichero, plan nativo, chat y artefacto), `maw-plan`, `maw-dispatch` (motores Orca, subagentes y manual), `maw-worker`, `maw-integrate`, `maw-race` y `maw-setup`.
|
|
56
|
+
- Skill `kit-init`: inicializa o migra un proyecto con un solo prompt (reglas, detección del stack y orquestación).
|
|
57
|
+
- Plantillas de proyecto: `AGENTS.md`, `CLAUDE.md` (`@AGENTS.md`), `ORCHESTRATION.md`, `orca.yaml`, `.worktreeinclude`.
|
|
58
|
+
- `install.sh`: detección de agentes, migración desde instalaciones previas de CSR/MAW con backup, `--verify`, `--restore`, `--adopt`, `--dry-run`, `--project`. Compatible con bash 3.2 (macOS).
|
|
59
|
+
- `GUIA.html`: guía visual del flujo de trabajo.
|
|
60
|
+
- Convivencia con skills externas (impeccable, supabase, spec-kit, Orca): precedencia por terreno en el núcleo.
|
|
61
|
+
- Batería de pruebas del instalador (`tests/`), comprobaciones estáticas (`scripts/check.sh`) y CI en Linux y macOS.
|
|
62
|
+
- Releases con zip descargable y `SHA256SUMS`.
|
|
63
|
+
|
|
64
|
+
### Cambiado (respecto a CSR original)
|
|
65
|
+
- El núcleo de CSR se unifica a partir de sus dos copias (Claude y Antigravity). Se conservan las mejoras de la versión de Antigravity: prefijos `BLOCKED`/`CONFLICT`/`DEFERRED`, sin tablas decorativas y excepciones de brevedad.
|
|
66
|
+
- Las reglas usan rutas neutrales (`~/.agents/rules/…`) en vez de las de cada agente.
|
|
67
|
+
- `idioma-siempre` pasa al núcleo (§1) y `comunicacion-densa` se fusiona en `10-communication`.
|
|
68
|
+
- Nivel técnico del usuario en `10-communication`: perfil fullstack.
|
|
69
|
+
|
|
70
|
+
### Corregido
|
|
71
|
+
- Claude Code cargaba en cada sesión todas las reglas copiadas en `~/.claude/rules/` (unas 29), lo que anulaba la carga progresiva de CSR. Ahora las reglas viven fuera de las carpetas que los agentes cargan automáticamente.
|
|
72
|
+
|
|
73
|
+
### Eliminado
|
|
74
|
+
- Copias duplicadas de reglas y skills `csr-*` dentro de cada agente, y el plugin `claude-session-rules` de Antigravity.
|
|
75
|
+
|
|
76
|
+
[Unreleased]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.2.0...HEAD
|
|
77
|
+
[1.2.0]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.1.0...v1.2.0
|
|
78
|
+
[1.1.0]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.0.0...v1.1.0
|
|
79
|
+
[1.0.0]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/releases/tag/v1.0.0
|
package/GUIA.html
ADDED
|
@@ -0,0 +1,401 @@
|
|
|
1
|
+
<!doctype html>
|
|
2
|
+
<html lang="es">
|
|
3
|
+
<head>
|
|
4
|
+
<meta charset="utf-8">
|
|
5
|
+
<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
|
|
6
|
+
<title>Orca Multiagent Kit · Flujo de trabajo</title>
|
|
7
|
+
<meta name="claude:viewport-fit-sides" content="cover">
|
|
8
|
+
<link rel="preconnect" href="https://fonts.googleapis.com">
|
|
9
|
+
<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500&display=swap">
|
|
10
|
+
<style>
|
|
11
|
+
/* Layout: una columna de lectura (≈760px) con paneles de cristal; color solo en los esquemas */
|
|
12
|
+
:root{
|
|
13
|
+
--bg:#f5f5f7; --bg-deep:#e9e9ee; --fg:#1d1d1f; --muted:#6e6e73; --hair:rgba(0,0,0,.09);
|
|
14
|
+
--glass:rgba(255,255,255,.62); --glass-edge:rgba(255,255,255,.9); --glass-shadow:0 1px 0 rgba(255,255,255,.7) inset,0 10px 30px -12px rgba(0,0,0,.18);
|
|
15
|
+
--code-bg:rgba(0,0,0,.045);
|
|
16
|
+
--c-core:#4d7c0f; --c-claude:#65a30d; --c-gemini:#3f6212; --c-codex:#84cc16; --c-other:#6b7266; --c-gate:#7c3aed; --c-warn:#a3b18a;
|
|
17
|
+
--sans:-apple-system,BlinkMacSystemFont,"SF Pro Text","Helvetica Neue",Helvetica,Arial,sans-serif;
|
|
18
|
+
--display:-apple-system,BlinkMacSystemFont,"SF Pro Display","Helvetica Neue",Helvetica,Arial,sans-serif;
|
|
19
|
+
--mono:"JetBrains Mono",ui-monospace,"SF Mono",Menlo,Consolas,monospace;
|
|
20
|
+
--r:22px;
|
|
21
|
+
}
|
|
22
|
+
@media (prefers-color-scheme: dark){:root:not([data-theme="light"]){
|
|
23
|
+
--bg:#050605; --bg-deep:#0e120c; --fg:#f5f5f7; --muted:#98989d; --hair:rgba(255,255,255,.12);
|
|
24
|
+
--glass:rgba(28,28,30,.55); --glass-edge:rgba(255,255,255,.14); --glass-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 14px 40px -16px rgba(0,0,0,.8);
|
|
25
|
+
--code-bg:rgba(255,255,255,.07);
|
|
26
|
+
--c-core:#c6ff3d; --c-claude:#c6ff3d; --c-gemini:#e4ff8f; --c-codex:#9be22d; --c-other:#8b9384; --c-gate:#b48cff; --c-warn:#d9f99d;
|
|
27
|
+
color-scheme:dark}}
|
|
28
|
+
:root[data-theme="dark"]{
|
|
29
|
+
--bg:#050605; --bg-deep:#0e120c; --fg:#f5f5f7; --muted:#98989d; --hair:rgba(255,255,255,.12);
|
|
30
|
+
--glass:rgba(28,28,30,.55); --glass-edge:rgba(255,255,255,.14); --glass-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 14px 40px -16px rgba(0,0,0,.8);
|
|
31
|
+
--code-bg:rgba(255,255,255,.07);
|
|
32
|
+
--c-core:#c6ff3d; --c-claude:#c6ff3d; --c-gemini:#e4ff8f; --c-codex:#9be22d; --c-other:#8b9384; --c-gate:#b48cff; --c-warn:#d9f99d;
|
|
33
|
+
color-scheme:dark}
|
|
34
|
+
|
|
35
|
+
*{box-sizing:border-box}
|
|
36
|
+
body{background:var(--bg);color:var(--fg);font-family:var(--sans);font-size:16px;line-height:1.55;-webkit-font-smoothing:antialiased;
|
|
37
|
+
padding-left:max(16px,env(safe-area-inset-left,0px));padding-right:max(16px,env(safe-area-inset-right,0px));padding-block:0 64px;overflow-x:hidden}
|
|
38
|
+
.ambient{position:fixed;inset:-20% -10% auto;height:70vh;z-index:0;pointer-events:none;filter:blur(70px);opacity:.55}
|
|
39
|
+
.ambient span{position:absolute;border-radius:50%;background:var(--bg-deep)}
|
|
40
|
+
.ambient span:nth-child(1){width:46vw;height:46vw;left:4%;top:8%;background:color-mix(in srgb,var(--c-core) 16%,transparent)}
|
|
41
|
+
.ambient span:nth-child(2){width:38vw;height:38vw;right:6%;top:0;background:color-mix(in srgb,var(--c-gate) 12%,transparent)}
|
|
42
|
+
main{position:relative;z-index:1;max-width:820px;margin:0 auto}
|
|
43
|
+
|
|
44
|
+
nav.toc{position:sticky;top:env(safe-area-inset-top,0px);z-index:5;margin:0 auto 8px;display:flex;gap:4px;overflow-x:auto;padding:10px 4px;scrollbar-width:none}
|
|
45
|
+
nav.toc::-webkit-scrollbar{display:none}
|
|
46
|
+
nav.toc a{flex:none;font-size:13px;color:var(--muted);text-decoration:none;padding:6px 12px;border-radius:999px;background:var(--glass);border:1px solid var(--glass-edge);backdrop-filter:blur(18px) saturate(1.6);-webkit-backdrop-filter:blur(18px) saturate(1.6)}
|
|
47
|
+
nav.toc a:hover,nav.toc a:focus-visible{color:var(--fg)}
|
|
48
|
+
body::before{content:"";position:fixed;inset:0 0 auto;height:env(safe-area-inset-top,0px);z-index:10;background:var(--bg)}
|
|
49
|
+
|
|
50
|
+
header.hero{padding:56px 0 28px}
|
|
51
|
+
.eyebrow{font-size:12px;letter-spacing:.08em;text-transform:uppercase;color:var(--muted);font-weight:600}
|
|
52
|
+
h1{font-family:var(--display);font-size:clamp(34px,6vw,54px);line-height:1.05;letter-spacing:-.025em;margin:10px 0 14px;font-weight:700;text-wrap:balance}
|
|
53
|
+
.lede{font-size:clamp(17px,2.2vw,20px);color:var(--muted);max-width:60ch;margin:0}
|
|
54
|
+
h2{font-family:var(--display);font-size:clamp(24px,3.4vw,32px);letter-spacing:-.02em;line-height:1.15;margin:0 0 6px;text-wrap:balance}
|
|
55
|
+
h3{font-size:17px;margin:0 0 4px;letter-spacing:-.01em}
|
|
56
|
+
section{margin-top:56px;scroll-margin-top:64px}
|
|
57
|
+
.sub{color:var(--muted);margin:0 0 20px;max-width:62ch}
|
|
58
|
+
p{margin:0 0 12px}
|
|
59
|
+
|
|
60
|
+
.glass{background:var(--glass);border:1px solid var(--glass-edge);border-radius:var(--r);box-shadow:var(--glass-shadow);backdrop-filter:blur(24px) saturate(1.8);-webkit-backdrop-filter:blur(24px) saturate(1.8)}
|
|
61
|
+
.pad{padding:22px}
|
|
62
|
+
.grid{display:grid;gap:14px}
|
|
63
|
+
.g2{grid-template-columns:repeat(auto-fit,minmax(240px,1fr))}
|
|
64
|
+
.g3{grid-template-columns:repeat(auto-fit,minmax(200px,1fr))}
|
|
65
|
+
.grid>*{min-width:0}
|
|
66
|
+
.muted{color:var(--muted)}
|
|
67
|
+
.small{font-size:14px}
|
|
68
|
+
|
|
69
|
+
code,.mono{font-family:var(--mono);font-size:.86em}
|
|
70
|
+
:not(pre)>code{background:var(--code-bg);padding:.1em .4em;border-radius:6px}
|
|
71
|
+
.cmd{position:relative;display:flex;align-items:flex-start;gap:10px;background:var(--code-bg);border-radius:14px;padding:12px 12px 12px 16px;margin:8px 0}
|
|
72
|
+
.cmd pre{margin:0;flex:1;min-width:0;overflow-x:auto;font-family:var(--mono);font-size:13.5px;line-height:1.6}
|
|
73
|
+
.cmd pre .c{color:var(--muted)}
|
|
74
|
+
.copy{flex:none;font:500 12px var(--sans);color:var(--fg);background:var(--glass);border:1px solid var(--hair);border-radius:999px;padding:5px 11px;cursor:pointer}
|
|
75
|
+
.copy:hover{border-color:var(--muted)}
|
|
76
|
+
.copy:focus-visible,button:focus-visible,a:focus-visible,summary:focus-visible{outline:2px solid var(--c-core);outline-offset:2px}
|
|
77
|
+
|
|
78
|
+
/* esquema: fuente única */
|
|
79
|
+
.diagram{overflow-x:auto}
|
|
80
|
+
.diagram svg{display:block;width:100%;min-width:560px;height:auto}
|
|
81
|
+
.diagram text{font-family:var(--sans);fill:var(--fg)}
|
|
82
|
+
.diagram .lbl{font-size:12px;fill:var(--muted)}
|
|
83
|
+
.diagram .mono{font-family:var(--mono);font-size:11.5px;fill:var(--muted)}
|
|
84
|
+
.flow{fill:none;stroke-width:2;stroke-dasharray:4 7;animation:flow 1.6s linear infinite}
|
|
85
|
+
@keyframes flow{to{stroke-dashoffset:-22}}
|
|
86
|
+
.node{fill:var(--glass);stroke:var(--hair)}
|
|
87
|
+
.pulse{animation:pulse 2.8s ease-in-out infinite;transform-origin:center;transform-box:fill-box}
|
|
88
|
+
@keyframes pulse{0%,100%{opacity:.25;transform:scale(1)}50%{opacity:.55;transform:scale(1.08)}}
|
|
89
|
+
.legend{display:flex;flex-wrap:wrap;gap:8px 18px;margin-top:12px;font-size:13px;color:var(--muted)}
|
|
90
|
+
.legend i{display:inline-block;width:18px;height:0;border-top:2px dashed currentColor;vertical-align:middle;margin-right:6px}
|
|
91
|
+
|
|
92
|
+
/* pasos de instalación */
|
|
93
|
+
.steps{counter-reset:s;display:grid;gap:14px}
|
|
94
|
+
.step{display:grid;grid-template-columns:36px 1fr;gap:14px;align-items:start}
|
|
95
|
+
.step::before{counter-increment:s;content:counter(s);width:36px;height:36px;border-radius:50%;display:grid;place-items:center;font-weight:600;font-size:15px;background:var(--fg);color:var(--bg)}
|
|
96
|
+
.step>div{min-width:0}
|
|
97
|
+
|
|
98
|
+
/* selector de modos */
|
|
99
|
+
.modes{display:flex;flex-wrap:wrap;gap:8px;margin-bottom:14px}
|
|
100
|
+
.modes button{font:500 14px var(--sans);color:var(--fg);background:var(--glass);border:1px solid var(--glass-edge);border-radius:999px;padding:8px 16px;cursor:pointer;transition:background .25s,color .25s,transform .2s}
|
|
101
|
+
.modes button[aria-selected="true"]{background:var(--fg);color:var(--bg)}
|
|
102
|
+
.modes button:active{transform:scale(.97)}
|
|
103
|
+
.mode-panel{display:grid;grid-template-columns:1.1fr 1fr;gap:20px;animation:rise .45s cubic-bezier(.2,.8,.2,1)}
|
|
104
|
+
@keyframes rise{from{opacity:.4;transform:translateY(6px)}to{opacity:1;transform:none}}
|
|
105
|
+
.mode-panel>*{min-width:0}
|
|
106
|
+
.chain{display:flex;flex-direction:column;gap:8px;margin:0;padding:0;list-style:none}
|
|
107
|
+
.chain li{display:flex;align-items:center;gap:10px;font-size:14px}
|
|
108
|
+
.chain li b{font-family:var(--mono);font-weight:500;font-size:12.5px;padding:4px 10px;border-radius:999px;border:1px solid var(--hair);background:var(--glass)}
|
|
109
|
+
.chain li+li::before{content:"";position:absolute}
|
|
110
|
+
.say{font-size:15px;padding:12px 14px;border-radius:14px;background:var(--code-bg);margin-top:10px}
|
|
111
|
+
.say small{display:block;color:var(--muted);font-size:12px;margin-bottom:2px}
|
|
112
|
+
|
|
113
|
+
/* pipeline multiagente */
|
|
114
|
+
.lanes svg{min-width:640px}
|
|
115
|
+
.bar{animation:grow 6s cubic-bezier(.4,0,.2,1) infinite}
|
|
116
|
+
@keyframes grow{0%{transform:scaleX(.02)}55%,100%{transform:scaleX(1)}}
|
|
117
|
+
.bar{transform-origin:left;transform-box:fill-box}
|
|
118
|
+
.b2{animation-delay:.6s}.b3{animation-delay:1.2s}
|
|
119
|
+
|
|
120
|
+
/* tablas */
|
|
121
|
+
.table-wrap{overflow-x:auto}
|
|
122
|
+
table{width:100%;border-collapse:collapse;font-size:14px}
|
|
123
|
+
th,td{text-align:left;padding:11px 12px;border-bottom:1px solid var(--hair);vertical-align:top}
|
|
124
|
+
th{font-size:12px;letter-spacing:.06em;text-transform:uppercase;color:var(--muted);font-weight:600}
|
|
125
|
+
tr:last-child td{border-bottom:0}
|
|
126
|
+
|
|
127
|
+
/* invariantes */
|
|
128
|
+
.rule{display:flex;gap:12px;align-items:flex-start}
|
|
129
|
+
.rule .dot{flex:none;width:10px;height:10px;border-radius:50%;margin-top:7px;background:var(--c-gate)}
|
|
130
|
+
.dot.core{background:var(--c-core)}.dot.warn{background:var(--c-warn)}
|
|
131
|
+
|
|
132
|
+
/* frases */
|
|
133
|
+
.phrases{display:flex;flex-wrap:wrap;gap:8px}
|
|
134
|
+
.phrase{font:14px var(--sans);color:var(--fg);background:var(--glass);border:1px solid var(--glass-edge);border-radius:12px;padding:9px 13px;cursor:pointer;text-align:left;transition:transform .2s}
|
|
135
|
+
.phrase:hover{transform:translateY(-1px)}
|
|
136
|
+
.phrase span{display:block;font-size:11.5px;color:var(--muted);font-family:var(--mono)}
|
|
137
|
+
|
|
138
|
+
details{border-bottom:1px solid var(--hair);padding:14px 0}
|
|
139
|
+
details:last-child{border-bottom:0}
|
|
140
|
+
summary{cursor:pointer;font-weight:600;list-style:none;display:flex;justify-content:space-between;gap:12px}
|
|
141
|
+
summary::-webkit-details-marker{display:none}
|
|
142
|
+
summary::after{content:"+";color:var(--muted);font-weight:400;transition:transform .25s}
|
|
143
|
+
details[open] summary::after{transform:rotate(45deg)}
|
|
144
|
+
details p{margin:10px 0 0;color:var(--muted)}
|
|
145
|
+
|
|
146
|
+
.toast{position:fixed;left:50%;bottom:calc(24px + env(safe-area-inset-bottom,0px));transform:translate(-50%,20px);opacity:0;transition:.3s;background:var(--fg);color:var(--bg);padding:9px 16px;border-radius:999px;font-size:14px;z-index:20;pointer-events:none}
|
|
147
|
+
.toast.on{opacity:1;transform:translate(-50%,0)}
|
|
148
|
+
footer{margin-top:64px;color:var(--muted);font-size:13px;text-align:center}
|
|
149
|
+
|
|
150
|
+
@media (max-width:640px){.mode-panel{grid-template-columns:1fr}header.hero{padding-top:36px}}
|
|
151
|
+
@media (prefers-reduced-motion:reduce){*,*::before,*::after{animation:none!important;transition:none!important}}
|
|
152
|
+
</style>
|
|
153
|
+
</head>
|
|
154
|
+
<body>
|
|
155
|
+
|
|
156
|
+
<div class="ambient" aria-hidden="true"><span></span><span></span></div>
|
|
157
|
+
<main>
|
|
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>
|
|
160
|
+
</nav>
|
|
161
|
+
|
|
162
|
+
<header class="hero">
|
|
163
|
+
<div class="eyebrow">Orca Multiagent Kit v1.1 · CSR + MAW</div>
|
|
164
|
+
<h1>Un solo sitio para las reglas de todos tus agentes</h1>
|
|
165
|
+
<p class="lede">Claude Code, Antigravity, Codex, Copilot y Cursor leen las mismas reglas y las mismas skills desde <code>~/.agents/</code>. Trabajan en paralelo, cada uno en su worktree, y nada se mergea sin tu «sí».</p>
|
|
166
|
+
</header>
|
|
167
|
+
|
|
168
|
+
<section id="fuente">
|
|
169
|
+
<h2>La fuente única</h2>
|
|
170
|
+
<p class="sub">Editas una vez y todos los agentes ven el cambio. Ningún agente guarda copias propias: o importan el núcleo, o lo enlazan, o lo leen tal cual.</p>
|
|
171
|
+
<div class="glass pad diagram" role="img" aria-label="Esquema: ~/.agents en el centro, conectado a Claude Code por import, a Antigravity, Codex y Copilot por enlace, y a Cursor de forma nativa">
|
|
172
|
+
<svg viewBox="0 0 760 340">
|
|
173
|
+
<defs>
|
|
174
|
+
<filter id="soft" x="-20%" y="-20%" width="140%" height="140%"><feGaussianBlur stdDeviation="14"/></filter>
|
|
175
|
+
</defs>
|
|
176
|
+
<!-- conexiones -->
|
|
177
|
+
<path class="flow" style="stroke:var(--c-claude)" d="M270 150 C 230 150, 230 70, 200 70"/>
|
|
178
|
+
<path class="flow" style="stroke:var(--c-gemini)" d="M270 190 C 230 190, 230 270, 200 270"/>
|
|
179
|
+
<path class="flow" style="stroke:var(--c-codex)" d="M490 150 C 530 150, 530 70, 560 70"/>
|
|
180
|
+
<path class="flow" style="stroke:var(--c-other)" d="M490 170 H 560"/>
|
|
181
|
+
<path class="flow" style="stroke:var(--c-other)" d="M490 190 C 530 190, 530 270, 560 270"/>
|
|
182
|
+
<!-- núcleo -->
|
|
183
|
+
<circle class="pulse" cx="380" cy="170" r="82" fill="var(--c-core)" filter="url(#soft)"/>
|
|
184
|
+
<rect x="270" y="112" width="220" height="116" rx="22" fill="var(--bg)" opacity=".92"/><rect class="node" x="270" y="112" width="220" height="116" rx="22"/>
|
|
185
|
+
<text x="380" y="146" text-anchor="middle" font-size="16" font-weight="700">~/.agents</text>
|
|
186
|
+
<text class="mono" x="380" y="168" text-anchor="middle">AGENTS.md · núcleo</text>
|
|
187
|
+
<text class="mono" x="380" y="186" text-anchor="middle">rules/ · bajo demanda</text>
|
|
188
|
+
<text class="mono" x="380" y="204" text-anchor="middle">skills/ · csr · orca · tuyas</text>
|
|
189
|
+
<!-- agentes -->
|
|
190
|
+
<g><rect class="node" x="25" y="40" width="175" height="60" rx="16"/><circle cx="45" cy="70" r="6" fill="var(--c-claude)"/><text x="59" y="67" font-size="14" font-weight="600">Claude Code</text><text class="lbl" x="59" y="85">import en CLAUDE.md</text></g>
|
|
191
|
+
<g><rect class="node" x="25" y="240" width="175" height="60" rx="16"/><circle cx="45" cy="270" r="6" fill="var(--c-gemini)"/><text x="59" y="267" font-size="14" font-weight="600">Antigravity</text><text class="lbl" x="59" y="285">GEMINI.md → enlace</text></g>
|
|
192
|
+
<g><rect class="node" x="560" y="40" width="180" height="60" rx="16"/><circle cx="580" cy="70" r="6" fill="var(--c-codex)"/><text x="594" y="67" font-size="14" font-weight="600">Codex</text><text class="lbl" x="594" y="85">AGENTS.md → enlace</text></g>
|
|
193
|
+
<g><rect class="node" x="560" y="140" width="180" height="60" rx="16"/><circle cx="580" cy="170" r="6" fill="var(--c-other)"/><text x="594" y="167" font-size="14" font-weight="600">Copilot CLI</text><text class="lbl" x="594" y="185">instructions → enlace</text></g>
|
|
194
|
+
<g><rect class="node" x="560" y="240" width="180" height="60" rx="16"/><circle cx="580" cy="270" r="6" fill="var(--c-other)"/><text x="594" y="267" font-size="14" font-weight="600">Cursor</text><text class="lbl" x="594" y="285">skills nativas · 1 línea</text></g>
|
|
195
|
+
</svg>
|
|
196
|
+
<div class="legend"><span>Las skills: enlaces en Claude y Antigravity; Codex, Copilot y Cursor leen <code>~/.agents/skills</code> de serie.</span></div>
|
|
197
|
+
</div>
|
|
198
|
+
<div class="grid g2" style="margin-top:14px">
|
|
199
|
+
<div class="glass pad"><h3>Siempre cargado</h3><p class="muted small">El núcleo (~80 líneas): idioma, cómo responder, puerta de validez, prohibiciones, reglas multiagente y el router.</p></div>
|
|
200
|
+
<div class="glass pad"><h3>Bajo demanda</h3><p class="muted small">Las reglas de <code>rules/</code> y las skills solo se leen cuando la tarea las necesita. Antes, Claude cargaba todo CSR en cada mensaje.</p></div>
|
|
201
|
+
</div>
|
|
202
|
+
</section>
|
|
203
|
+
|
|
204
|
+
<section id="instalar">
|
|
205
|
+
<h2>Instalar (una vez por ordenador)</h2>
|
|
206
|
+
<p class="sub">Migra instalaciones anteriores automáticamente, con backup de todo lo que toca.</p>
|
|
207
|
+
<div class="steps">
|
|
208
|
+
<div class="step"><div><h3>Mira qué haría, sin tocar nada</h3>
|
|
209
|
+
<div class="cmd"><pre>cd ~/Documents/orca-multiagent-kit
|
|
210
|
+
chmod +x install.sh
|
|
211
|
+
./install.sh --dry-run</pre><button class="copy" type="button">Copiar</button></div></div></div>
|
|
212
|
+
<div class="step"><div><h3>Instala y verifica</h3>
|
|
213
|
+
<div class="cmd"><pre>./install.sh
|
|
214
|
+
./install.sh --verify</pre><button class="copy" type="button">Copiar</button></div>
|
|
215
|
+
<p class="muted small">Al final imprime avisos (por ejemplo, la línea para pegar en las reglas de usuario de Cursor) y el comando <code>--restore</code> para deshacerlo todo.</p></div></div>
|
|
216
|
+
<div class="step"><div><h3>Reinicia los agentes</h3><p class="muted small">Claude Code, Antigravity y los demás que uses. A partir de aquí todos leen <code>~/.agents</code>.</p></div></div>
|
|
217
|
+
<div class="step"><div><h3>Opcional: comparte una skill externa con todos</h3>
|
|
218
|
+
<div class="cmd"><pre>./install.sh --adopt ~/.gemini/config/plugins/user-workflows/skills/impeccable</pre><button class="copy" type="button">Copiar</button></div>
|
|
219
|
+
<p class="muted small">La mueve a <code>~/.agents/skills</code>, deja un enlace en su sitio y la enlaza en Claude. Una sola copia.</p></div></div>
|
|
220
|
+
</div>
|
|
221
|
+
</section>
|
|
222
|
+
|
|
223
|
+
<section id="proyecto">
|
|
224
|
+
<h2>Proyecto nuevo o antiguo: un solo prompt</h2>
|
|
225
|
+
<p class="sub">Abre cualquier agente en el repo y escribe «inicializa el proyecto». El stack lo detecta solo, leyendo el repo: no hace falta describírselo.</p>
|
|
226
|
+
<div class="glass pad diagram lanes" role="img" aria-label="kit-init: reglas, stack con csr-stack, orquestación y hook de spec-kit, y resumen">
|
|
227
|
+
<svg viewBox="0 0 760 150">
|
|
228
|
+
<path class="flow" style="stroke:var(--c-core)" d="M150 75 H 230"/><path class="flow" style="stroke:var(--c-core)" d="M380 75 H 450"/><path class="flow" style="stroke:var(--c-core)" d="M600 75 H 630"/>
|
|
229
|
+
<g><rect class="node" x="10" y="30" width="140" height="90" rx="18"/><text x="80" y="62" text-anchor="middle" font-size="14" font-weight="600">Reglas</text><text class="mono" x="80" y="82" text-anchor="middle">AGENTS.md</text><text class="mono" x="80" y="98" text-anchor="middle">CLAUDE.md → @</text></g>
|
|
230
|
+
<g><rect class="node" x="230" y="30" width="150" height="90" rx="18"/><text x="305" y="62" text-anchor="middle" font-size="14" font-weight="600">Stack</text><text class="mono" x="305" y="82" text-anchor="middle">csr-stack</text><text class="mono" x="305" y="98" text-anchor="middle">→ STACK.md</text></g>
|
|
231
|
+
<g><rect class="node" x="450" y="30" width="150" height="90" rx="18"/><text x="525" y="62" text-anchor="middle" font-size="14" font-weight="600">Orquestación</text><text class="mono" x="525" y="82" text-anchor="middle">+ hook spec-kit</text><text class="mono" x="525" y="98" text-anchor="middle">→ ORCHESTRATION</text></g>
|
|
232
|
+
<g><rect class="node" x="630" y="30" width="125" height="90" rx="18"/><text x="692" y="62" text-anchor="middle" font-size="14" font-weight="600">Listo</text><text class="mono" x="692" y="82" text-anchor="middle">≤4 preguntas</text><text class="mono" x="692" y="98" text-anchor="middle">commit</text></g>
|
|
233
|
+
</svg>
|
|
234
|
+
</div>
|
|
235
|
+
<p class="muted small" style="margin-top:12px">Si el repo tenía el bloque CSR antiguo, tus «Overrides de este proyecto» se migran solos. En un repo sin <code>AGENTS.md</code> ni <code>STACK.md</code>, el agente te lo ofrecerá sin que se lo pidas.</p>
|
|
236
|
+
</section>
|
|
237
|
+
|
|
238
|
+
<section id="modos">
|
|
239
|
+
<h2>Qué pasa según cómo trabajes</h2>
|
|
240
|
+
<p class="sub">No eliges tú: la skill <code>orca</code> decide sola si compensa repartir y lo dice en una línea, por ejemplo <code>ORCA: 4 unidades · 2 rondas · motor orca · autonomía semi</code>. Si no te convence, díselo («hazlo tú solo», «sin Orca»).</p>
|
|
241
|
+
<div class="glass pad">
|
|
242
|
+
<div class="modes" role="tablist" aria-label="Modos de trabajo"></div>
|
|
243
|
+
<div id="mode-panel" role="tabpanel"></div>
|
|
244
|
+
</div>
|
|
245
|
+
</section>
|
|
246
|
+
|
|
247
|
+
<section id="paralelo">
|
|
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>
|
|
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
|
+
<svg viewBox="0 0 760 300">
|
|
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>
|
|
253
|
+
<path class="flow" style="stroke:var(--c-core)" d="M120 150 H 150"/>
|
|
254
|
+
<g><rect class="node" x="150" y="115" width="110" height="70" rx="16"/><text x="205" y="144" text-anchor="middle" font-size="13" font-weight="600">unidades</text><text class="lbl" x="205" y="163" text-anchor="middle">unidades</text></g>
|
|
255
|
+
<path class="flow" style="stroke:var(--c-core)" d="M260 150 H 290"/>
|
|
256
|
+
<g><rect class="node" x="290" y="115" width="100" height="70" rx="16"/><text x="340" y="144" text-anchor="middle" font-size="13" font-weight="600">U0</text><text class="lbl" x="340" y="163" text-anchor="middle">coordinador</text></g>
|
|
257
|
+
<path class="flow" style="stroke:var(--c-claude)" d="M390 150 C 410 150, 410 60, 430 60"/>
|
|
258
|
+
<path class="flow" style="stroke:var(--c-gemini)" d="M390 150 H 430"/>
|
|
259
|
+
<path class="flow" style="stroke:var(--c-codex)" d="M390 150 C 410 150, 410 240, 430 240"/>
|
|
260
|
+
<g><rect class="node" x="430" y="30" width="170" height="60" rx="14"/><text x="445" y="54" font-size="12.5" font-weight="600">U1 · Claude Code</text><text class="mono" x="445" y="70">orca/run/u1</text><rect x="445" y="77" width="140" height="4" rx="2" fill="var(--hair)"/><rect class="bar" x="445" y="77" width="140" height="4" rx="2" fill="var(--c-claude)"/></g>
|
|
261
|
+
<g><rect class="node" x="430" y="120" width="170" height="60" rx="14"/><text x="445" y="144" font-size="12.5" font-weight="600">U2 · Antigravity</text><text class="mono" x="445" y="160">orca/run/u2</text><rect x="445" y="167" width="140" height="4" rx="2" fill="var(--hair)"/><rect class="bar b2" x="445" y="167" width="140" height="4" rx="2" fill="var(--c-gemini)"/></g>
|
|
262
|
+
<g><rect class="node" x="430" y="210" width="170" height="60" rx="14"/><text x="445" y="234" font-size="12.5" font-weight="600">U3 · Codex</text><text class="mono" x="445" y="250">orca/run/u3</text><rect x="445" y="257" width="140" height="4" rx="2" fill="var(--hair)"/><rect class="bar b3" x="445" y="257" width="140" height="4" rx="2" fill="var(--c-codex)"/></g>
|
|
263
|
+
<path class="flow" style="stroke:var(--c-gate)" d="M600 60 C 620 60, 620 150, 640 150"/>
|
|
264
|
+
<path class="flow" style="stroke:var(--c-gate)" d="M600 150 H 640"/>
|
|
265
|
+
<path class="flow" style="stroke:var(--c-gate)" d="M600 240 C 620 240, 620 150, 640 150"/>
|
|
266
|
+
<g><rect class="node" x="640" y="105" width="110" height="90" rx="16"/><text x="695" y="135" text-anchor="middle" font-size="13" font-weight="600">integrar</text><text class="lbl" x="695" y="154" text-anchor="middle">revisión</text><text class="lbl" x="695" y="170" text-anchor="middle">tu «sí» · gates</text></g>
|
|
267
|
+
</svg>
|
|
268
|
+
</div>
|
|
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>
|
|
273
|
+
</div>
|
|
274
|
+
</section>
|
|
275
|
+
|
|
276
|
+
<section id="speckit">
|
|
277
|
+
<h2>Con spec-kit</h2>
|
|
278
|
+
<p class="sub">Las decisiones siguen siendo tuyas (specify → clarify → plan → tasks). Al escribir <code>/speckit.implement</code>, el hook <code>before_implement</code> de la extensión <code>orca</code> decide si compensa repartir. Si compensa, te enseña el plan de rondas; si no, implement sigue normal.</p>
|
|
279
|
+
<div class="glass table-wrap">
|
|
280
|
+
<table>
|
|
281
|
+
<thead><tr><th>spec-kit</th><th>Se convierte en</th><th>Lo hace</th></tr></thead>
|
|
282
|
+
<tbody>
|
|
283
|
+
<tr><td>Phase 1 Setup + Phase 2 Foundational</td><td><code>U0</code>, ronda 0</td><td>Coordinador, con commit base</td></tr>
|
|
284
|
+
<tr><td>Phase de cada User Story (US1, US2…)</td><td>Una unidad por story</td><td>Un worker por worktree, según <code>ORCHESTRATION.md</code></td></tr>
|
|
285
|
+
<tr><td>Tareas <code>[P]</code> dentro de una story</td><td>Siguen en esa unidad</td><td>Sus propios subagentes, si quiere</td></tr>
|
|
286
|
+
<tr><td>Phase final Polish</td><td>Última ronda</td><td>Tras integrar las stories</td></tr>
|
|
287
|
+
<tr><td>Marcar <code>[x]</code> en <code>tasks.md</code></td><td>—</td><td>Solo el coordinador, al integrar</td></tr>
|
|
288
|
+
</tbody>
|
|
289
|
+
</table>
|
|
290
|
+
</div>
|
|
291
|
+
</section>
|
|
292
|
+
|
|
293
|
+
<section id="reglas">
|
|
294
|
+
<h2>Las reglas que nunca se rompen</h2>
|
|
295
|
+
<p class="sub">Están en el núcleo, así que todos los agentes las conocen aunque no se cargue ninguna skill.</p>
|
|
296
|
+
<div class="grid g2">
|
|
297
|
+
<div class="glass pad rule"><span class="dot"></span><div><h3>Una unidad, un worktree</h3><p class="muted small">Y una rama. Nunca dos agentes en la misma carpeta.</p></div></div>
|
|
298
|
+
<div class="glass pad rule"><span class="dot"></span><div><h3>Ficheros compartidos, de uno en uno</h3><p class="muted small">Esquema de BD, router, layout, lockfiles, <code>DESIGN.md</code>: una sola unidad por ronda, o el coordinador.</p></div></div>
|
|
299
|
+
<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
|
+
<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
|
+
<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>
|
|
302
|
+
<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
|
+
</div>
|
|
304
|
+
</section>
|
|
305
|
+
|
|
306
|
+
<section id="convivencia">
|
|
307
|
+
<h2>Convive con tus otras skills</h2>
|
|
308
|
+
<p class="sub">Una skill externa manda en su terreno cuando la invocas. La puerta de validez y las prohibiciones se aplican siempre.</p>
|
|
309
|
+
<div class="glass table-wrap">
|
|
310
|
+
<table>
|
|
311
|
+
<thead><tr><th>Skill</th><th>Relación</th></tr></thead>
|
|
312
|
+
<tbody>
|
|
313
|
+
<tr><td><code>impeccable</code></td><td>Diseño de UI. <code>orca</code> la usa en las unidades de interfaz y pasa su <code>audit</code> al integrar. Su <code>audit</code> (diseño) y <code>csr-audit</code> (seguridad) se complementan. Hoy solo la ve Antigravity: usa <code>--adopt</code> para compartirla.</td></tr>
|
|
314
|
+
<tr><td><code>supabase</code></td><td>Complementa las reglas de seguridad (RLS) y de fiabilidad (migraciones).</td></tr>
|
|
315
|
+
<tr><td><code>orca-cli</code>, <code>orchestration</code></td><td>Sin cambios. <code>orca</code> las usa para los comandos exactos de tu versión de Orca.</td></tr>
|
|
316
|
+
<tr><td>spec-kit</td><td>No se modifica. Se lee su <code>tasks.md</code>.</td></tr>
|
|
317
|
+
<tr><td><code>planificar</code></td><td>Sustituida por <code>orca</code> («planifica en sprints»): mismos dos modos más el paralelo. Desactívala cuando lo hayas probado.</td></tr>
|
|
318
|
+
</tbody>
|
|
319
|
+
</table>
|
|
320
|
+
</div>
|
|
321
|
+
</section>
|
|
322
|
+
|
|
323
|
+
<section id="editar">
|
|
324
|
+
<h2>Dónde se cambia cada cosa</h2>
|
|
325
|
+
<div class="glass table-wrap">
|
|
326
|
+
<table>
|
|
327
|
+
<thead><tr><th>Quieres cambiar</th><th>Edita</th><th>Después</th></tr></thead>
|
|
328
|
+
<tbody>
|
|
329
|
+
<tr><td>Una regla para todos los agentes</td><td><code>orca-multiagent-kit/core/AGENTS.md</code> o <code>rules/</code></td><td><code>./install.sh</code></td></tr>
|
|
330
|
+
<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
|
+
<tr><td>Una skill</td><td><code>orca-multiagent-kit/skills/<skill>/</code></td><td><code>./install.sh</code></td></tr>
|
|
332
|
+
<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>
|
|
334
|
+
</tbody>
|
|
335
|
+
</table>
|
|
336
|
+
</div>
|
|
337
|
+
<p class="muted small" style="margin-top:12px">Nunca copies reglas dentro de <code>CLAUDE.md</code>, <code>GEMINI.md</code> o los ajustes de Cursor: esas copias son las que acaban divergiendo.</p>
|
|
338
|
+
</section>
|
|
339
|
+
|
|
340
|
+
<section id="frases">
|
|
341
|
+
<h2>Frases que funcionan</h2>
|
|
342
|
+
<p class="sub">Toca una para copiarla. Sirven igual en cualquier agente.</p>
|
|
343
|
+
<div class="phrases" id="phrases"></div>
|
|
344
|
+
</section>
|
|
345
|
+
|
|
346
|
+
<section id="problemas">
|
|
347
|
+
<h2>Si algo falla</h2>
|
|
348
|
+
<div class="glass pad">
|
|
349
|
+
<details><summary>Un agente no sigue las reglas</summary><p><code>./install.sh --verify</code> y reinicia el agente. En Claude, el bloque de <code>~/.claude/CLAUDE.md</code> tiene que contener <code>@~/.agents/AGENTS.md</code>. En sesiones de Cowork no se cargan imports de fuera de la carpeta de trabajo.</p></details>
|
|
350
|
+
<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
|
+
<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
|
+
<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>
|
|
354
|
+
<details><summary>Quiero volver atrás</summary><p><code>./install.sh --restore <fecha></code> con la fecha que imprimió la instalación. Los backups están en <code>~/.agents/backups/</code>.</p></details>
|
|
355
|
+
</div>
|
|
356
|
+
</section>
|
|
357
|
+
|
|
358
|
+
<footer>Orca Multiagent Kit v1.0.0 · Esta guía está en <code>orca-multiagent-kit/GUIA.html</code> · Detalle técnico: <code>docs/MANUAL.md</code> · Para una IA: <code>AI_INSTALL.md</code></footer>
|
|
359
|
+
</main>
|
|
360
|
+
<div class="toast" id="toast" role="status" aria-live="polite"></div>
|
|
361
|
+
|
|
362
|
+
<script>
|
|
363
|
+
(function(){
|
|
364
|
+
var toast=document.getElementById('toast'),tt;
|
|
365
|
+
function say(m){toast.textContent=m;toast.classList.add('on');clearTimeout(tt);tt=setTimeout(function(){toast.classList.remove('on')},1600)}
|
|
366
|
+
function copy(text,el){
|
|
367
|
+
function fallback(){try{var r=document.createRange();r.selectNodeContents(el);var s=getSelection();s.removeAllRanges();s.addRange(r);say('Seleccionado: pulsa ⌘C')}catch(e){}}
|
|
368
|
+
try{navigator.clipboard.writeText(text).then(function(){say('Copiado')},fallback)}catch(e){fallback()}
|
|
369
|
+
}
|
|
370
|
+
document.querySelectorAll('.cmd .copy').forEach(function(b){
|
|
371
|
+
b.addEventListener('click',function(){var pre=b.parentNode.querySelector('pre');copy(pre.textContent,pre)});
|
|
372
|
+
});
|
|
373
|
+
|
|
374
|
+
var MODES=[
|
|
375
|
+
{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.'},
|
|
378
|
+
{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
|
+
{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
|
+
];
|
|
381
|
+
var bar=document.querySelector('.modes'),panel=document.getElementById('mode-panel');
|
|
382
|
+
function render(i){
|
|
383
|
+
var m=MODES[i];
|
|
384
|
+
bar.querySelectorAll('button').forEach(function(b,j){b.setAttribute('aria-selected',j===i?'true':'false')});
|
|
385
|
+
var chain=m.chain.map(function(c){return '<li><b>'+c[0]+'</b><span class="muted">'+c[1]+'</span></li>'}).join('');
|
|
386
|
+
panel.innerHTML='<div class="mode-panel"><div><h3>Cuándo</h3><p class="muted">'+m.when+'</p><p class="small"><span class="muted">Motor habitual:</span> <code>'+m.engine+'</code></p><div class="say"><small>Por ejemplo, escribes</small>«'+m.say+'»</div><p class="muted small" style="margin-top:10px">'+m.out+'</p></div><div><h3>Qué pasa</h3><ul class="chain">'+chain+'</ul></div></div>';
|
|
387
|
+
}
|
|
388
|
+
MODES.forEach(function(m,i){var b=document.createElement('button');b.type='button';b.setAttribute('role','tab');b.textContent=m.name;b.addEventListener('click',function(){render(i)});bar.appendChild(b)});
|
|
389
|
+
render(1);
|
|
390
|
+
|
|
391
|
+
var PH=[
|
|
392
|
+
['inicializa el proyecto','kit-init'],['/speckit.implement','se reparte solo si compensa'],['hazlo en paralelo','orca'],
|
|
393
|
+
['planifica en sprints …','orca · plan'],['carrera entre Claude y Gemini: …','orca · carrera'],['hazlo tú solo, sin repartir','sin orquestar'],
|
|
394
|
+
['pasa los gates','csr-gate'],['audita la seguridad del diff','csr-audit']
|
|
395
|
+
];
|
|
396
|
+
var box=document.getElementById('phrases');
|
|
397
|
+
PH.forEach(function(p){var b=document.createElement('button');b.type='button';b.className='phrase';b.innerHTML='«'+p[0]+'»<span>'+p[1]+'</span>';b.addEventListener('click',function(){copy(p[0],b)});box.appendChild(b)});
|
|
398
|
+
})();
|
|
399
|
+
</script>
|
|
400
|
+
</body>
|
|
401
|
+
</html>
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Fernando Baquero (FernandoBaqueroo) and Necro-Coder
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|