orca-multiagent-kit 0.0.0-stage → 1.1.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 +56 -0
- package/GUIA.html +401 -0
- package/LICENSE +21 -0
- package/README.md +238 -2
- package/VERSION +1 -0
- package/bin/omk.js +147 -0
- package/core/AGENTS.md +80 -0
- package/docs/MANUAL.md +208 -0
- package/install.sh +297 -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/docs/MANUAL.md
ADDED
|
@@ -0,0 +1,208 @@
|
|
|
1
|
+
# Orca Multiagent Kit v1.1.0 — Una sola fuente de reglas y skills para todos tus agentes
|
|
2
|
+
|
|
3
|
+
Une **CSR** (claude_session_rules: calidad, seguridad, tests, hablar poco) y **MAW** (trabajo multiagente sin pisarse) en **un único sitio**, `~/.agents/`, que leen a la vez Claude Code, Antigravity, Codex, Copilot CLI, Cursor y Devin.
|
|
4
|
+
|
|
5
|
+
> **Empieza por `GUIA.html`** (ábrela en el navegador): el flujo de trabajo explicado de forma visual. Si eres una IA y te han pedido instalar o integrar esto: lee `AI_INSTALL.md`.
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## 1. Qué problemas arregla
|
|
10
|
+
|
|
11
|
+
| Problema con CSR + MAW sueltos | Qué hace el kit |
|
|
12
|
+
|---|---|
|
|
13
|
+
| CSR copiado dos veces (`~/.claude` y `~/.gemini`) y ya distinto: la versión de Antigravity tenía reglas que la de Claude no tenía (idioma, comunicación densa, sin tablas decorativas) | Un solo núcleo, `~/.agents/AGENTS.md`, que une lo mejor de las dos versiones |
|
|
14
|
+
| **Claude Code carga en cada sesión todos los `.md` de `~/.claude/rules/`**. Las 12 reglas y los 17 lenguajes de CSR estaban ahí, así que la "carga progresiva" no funcionaba en Claude: pagabas todos esos tokens en cada mensaje | Las reglas viven en `~/.agents/rules/`, que ningún agente carga solo; se leen bajo demanda, como CSR pretendía |
|
|
15
|
+
| Rutas distintas por agente (`~/.claude/rules/…` frente a `~/.gemini/rules/…`) reescritas a mano | Rutas neutrales: `~/.agents/…` en todas partes |
|
|
16
|
+
| `csr-*` duplicadas: copias en `~/.claude/skills` y un plugin aparte en Antigravity | Una copia en `~/.agents/skills/` y enlaces simbólicos |
|
|
17
|
+
| `idioma-siempre.md` y `comunicacion-densa.md` repetidos dentro de `GEMINI.md` y como ficheros sueltos | Idioma en el núcleo (§1); comunicación fusionada en `10-communication.md` |
|
|
18
|
+
| Solo Claude y Antigravity | Claude Code, Antigravity, Codex, Copilot CLI, Cursor y Devin |
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## 2. Cómo funciona
|
|
23
|
+
|
|
24
|
+
```
|
|
25
|
+
~/.agents/ ← LA ÚNICA FUENTE
|
|
26
|
+
├── AGENTS.md núcleo (~80 líneas, siempre cargado)
|
|
27
|
+
├── rules/ 00…95, lang/ bajo demanda
|
|
28
|
+
├── skills/ csr-*, orca, kit-init (+ las tuyas: orca-cli, supabase…)
|
|
29
|
+
├── templates/ plantillas de proyecto
|
|
30
|
+
└── output-styles/
|
|
31
|
+
|
|
32
|
+
Claude Code ~/.claude/CLAUDE.md → bloque con @~/.agents/AGENTS.md (import oficial)
|
|
33
|
+
~/.claude/skills/<skill> → enlace a ~/.agents/skills/<skill>
|
|
34
|
+
Antigravity ~/.gemini/GEMINI.md → enlace a ~/.agents/AGENTS.md
|
|
35
|
+
~/.gemini/config/skills/… → enlaces a ~/.agents/skills/…
|
|
36
|
+
Codex ~/.codex/AGENTS.md → enlace · skills: lee ~/.agents/skills de serie
|
|
37
|
+
Copilot CLI ~/.copilot/copilot-instructions.md → enlace · skills: lee ~/.agents/skills de serie
|
|
38
|
+
Devin CLI ~/.config/devin/AGENTS.md → enlace (solo con --agents devin)
|
|
39
|
+
Cursor skills: lee ~/.agents/skills de serie · reglas: una línea en Settings → Rules
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
Editas `~/.agents/AGENTS.md` o una skill **una vez** y todos los agentes ven el cambio. No hay copias que se puedan desincronizar.
|
|
43
|
+
|
|
44
|
+
En **cada proyecto**, `AGENTS.md` es el fichero de reglas, porque lo leen todos los agentes. `CLAUDE.md` solo contiene `@AGENTS.md`: cuando existen los dos, Claude Code lee `CLAUDE.md` en lugar de `AGENTS.md`.
|
|
45
|
+
|
|
46
|
+
---
|
|
47
|
+
|
|
48
|
+
## 3. Qué hay dentro
|
|
49
|
+
|
|
50
|
+
```
|
|
51
|
+
orca-multiagent-kit/
|
|
52
|
+
├── GUIA.html guía visual del flujo (ábrela en el navegador)
|
|
53
|
+
├── README.md · AI_INSTALL.md · VERSION · install.sh
|
|
54
|
+
├── core/AGENTS.md núcleo: precedencia, idioma, respuesta, stack, puerta de validez,
|
|
55
|
+
│ prohibiciones, multiagente, router
|
|
56
|
+
├── rules/ 00-router · 10-communication · 20-clean-code · 30-security ·
|
|
57
|
+
│ └── lang/ (17) 31-security-audit · 40-testing · 50-done-gate · 60-git-workflow ·
|
|
58
|
+
│ 70-performance · 75-reliability · 80-supply-chain ·
|
|
59
|
+
│ 90-docs-comments · 95-multi-agent
|
|
60
|
+
├── skills/ kit-init · csr-stack · csr-gate · csr-audit
|
|
61
|
+
│ orca (entrada única) · speckit-orca-implement (hook)
|
|
62
|
+
├── speckit-extension/orca/ hook before_implement de spec-kit
|
|
63
|
+
├── output-styles/csr-minimal.md (estilo de salida de Claude Code)
|
|
64
|
+
└── templates/ AGENTS.md · CLAUDE.md · STACK.md · ORCHESTRATION.md · orca.yaml ·
|
|
65
|
+
.worktreeinclude · claude-settings.json
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
---
|
|
69
|
+
|
|
70
|
+
## 4. Instalación (y migración desde CSR / MAW sueltos)
|
|
71
|
+
|
|
72
|
+
Con Node ≥ 18 lo más cómodo es el CLI: `npx github:FernandoBaqueroo/orca-multiagent-kit install`, o `npm install -g github:FernandoBaqueroo/orca-multiagent-kit` para tener `omk` siempre (`omk install`, `omk init`, `omk verify`, `omk adopt`, `omk restore`, `omk update`). Sin Node, con el zip o un clon:
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
cd ~/Documents/orca-multiagent-kit
|
|
76
|
+
chmod +x install.sh
|
|
77
|
+
./install.sh --dry-run # qué haría, sin tocar nada
|
|
78
|
+
./install.sh # instala para los agentes detectados y migra lo antiguo
|
|
79
|
+
./install.sh --verify # comprueba enlaces y que no queden copias divergentes
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
Más opciones:
|
|
83
|
+
```bash
|
|
84
|
+
./install.sh --project ~/Dev/mi-app # además, migra o prepara un proyecto
|
|
85
|
+
./install.sh --project-only ~/Dev/otra-app
|
|
86
|
+
./install.sh --agents claude,antigravity,codex
|
|
87
|
+
./install.sh --agents devin # Devin es opcional: también lee ~/.claude/CLAUDE.md
|
|
88
|
+
./install.sh --restore 20261107-091500 # deshace una instalación desde su backup
|
|
89
|
+
./install.sh --adopt ~/.gemini/config/plugins/user-workflows/skills/impeccable # skill externa → multiproveedor
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
### Qué hace exactamente
|
|
93
|
+
1. **Backup** de todo lo que toca en `~/.agents/backups/<fecha>/`, con las mismas rutas relativas a tu carpeta personal. `--restore` lo devuelve a su sitio.
|
|
94
|
+
2. Copia núcleo, reglas, skills, plantillas y estilo a `~/.agents/`. Solo reemplaza **sus** skills: `orca-cli`, `orchestration`, `supabase` y el resto se quedan como están. Si creas `~/.agents/rules/personal.md`, no lo toca nunca.
|
|
95
|
+
3. **Claude Code**: quita de `CLAUDE.md` los bloques CSR y MAW, pone el bloque con el import y **conserva el resto** de lo que tuvieras escrito. Saca de `~/.claude/rules/` los ficheros de CSR y MAW (los tuyos se quedan), enlaza las skills y el output style.
|
|
96
|
+
4. **Antigravity**: `GEMINI.md` pasa a ser un enlace al núcleo. Retira las reglas copiadas de `~/.gemini/rules/`, las plantillas y el plugin `claude-session-rules` (todo va al backup) y enlaza las skills en `~/.gemini/config/skills/`.
|
|
97
|
+
5. **Codex / Copilot / Devin**: enlazan su fichero global de instrucciones al núcleo. Sus skills ya las leen desde `~/.agents/skills/`.
|
|
98
|
+
6. **Cursor**: no guarda las reglas de usuario en ficheros. El instalador te da la línea para pegar en **Settings → Rules → User Rules**.
|
|
99
|
+
7. **Proyecto** (`--project`): reescribe `AGENTS.md` y `CLAUDE.md` con el formato del kit y **migra tus "Overrides de este proyecto"** del bloque CSR antiguo. Crea `STACK.md`, `ORCHESTRATION.md`, `orca.yaml`, `.worktreeinclude` y `.claude/settings.json` si faltan, y añade `.work/` al `.gitignore`.
|
|
100
|
+
|
|
101
|
+
Reinstalar es idempotente: sirve también para actualizar después de editar el kit.
|
|
102
|
+
|
|
103
|
+
### Después de instalar
|
|
104
|
+
- **Reinicia** Claude Code y Antigravity (y Codex o Copilot si los usas).
|
|
105
|
+
|
|
106
|
+
### Proyectos nuevos o antiguos: un solo prompt
|
|
107
|
+
Abre el agente en el repo y escribe **«inicializa el proyecto»** (skill `kit-init`). No hace falta terminal ni el instalador:
|
|
108
|
+
1. Crea o migra `AGENTS.md` (con tus overrides del CSR antiguo) y deja `CLAUDE.md` como `@AGENTS.md`.
|
|
109
|
+
2. Si `STACK.md` falta o está vacío, ejecuta `csr-stack`: **detecta el stack** leyendo manifiestos, configuración, versiones y comandos reales del repo. No necesitas describirle nada.
|
|
110
|
+
3. Prepara la orquestación: `ORCHESTRATION.md` (con su nivel de autonomía), `orca.yaml`, `.worktreeinclude`, `.work/` en `.gitignore` y, si hay spec-kit, el hook `before_implement`.
|
|
111
|
+
4. Te hace como máximo 4 preguntas en una tanda (lo que no se puede deducir: nivel ASVS, reparto de agentes…) y propone el commit.
|
|
112
|
+
|
|
113
|
+
Si el agente detecta un repo sin `AGENTS.md` o sin `STACK.md`, te ofrecerá `kit-init` él solo. Desde la terminal, `./install.sh --project <ruta>` hace la parte de ficheros, pero la detección del stack la sigue haciendo el agente.
|
|
114
|
+
|
|
115
|
+
---
|
|
116
|
+
|
|
117
|
+
## 5. Uso diario
|
|
118
|
+
|
|
119
|
+
Igual que antes; lo único que cambia es dónde vive cada cosa.
|
|
120
|
+
|
|
121
|
+
| Situación | Qué escribes |
|
|
122
|
+
|---|---|
|
|
123
|
+
| Repo nuevo o con CSR antiguo | «inicializa el proyecto» → `kit-init` |
|
|
124
|
+
| Feature con spec-kit | `/speckit.specify` → `plan` → `tasks` y luego **`/speckit.implement` como siempre**. El hook decide si se reparte |
|
|
125
|
+
| Feature grande sin spec | Pídela con normalidad. Si tiene partes independientes, `orca` propone el reparto sola |
|
|
126
|
+
| Quieres un plan antes | «planifica X en sprints» (`orca`, modo plan) |
|
|
127
|
+
| Bug raro | «carrera entre Claude y Gemini» (`orca`, modo carrera) |
|
|
128
|
+
| No quieres que se reparta | «hazlo tú solo» |
|
|
129
|
+
| Cerrar una tarea | «pasa los gates» (`csr-gate`) |
|
|
130
|
+
| Antes de publicar o tocar algo sensible | «audita la seguridad» (`csr-audit`) |
|
|
131
|
+
|
|
132
|
+
**Autonomía** (`ORCHESTRATION.md` §0): `semi` por defecto. Confirmas el plan de rondas (autoriza los commits del run en ramas de trabajo) y el merge final; en medio solo te interrumpe por decisiones de producto. `manual` confirma cada ronda; `auto`, solo el merge final. Nunca hay merge a la rama por defecto ni push sin confirmación.
|
|
133
|
+
|
|
134
|
+
El detalle está en `skills/orca/SKILL.md` y sus `references/`, y en `rules/95-multi-agent.md`.
|
|
135
|
+
|
|
136
|
+
---
|
|
137
|
+
|
|
138
|
+
## 6. Cómo cambiar reglas a partir de ahora
|
|
139
|
+
|
|
140
|
+
| Quieres cambiar… | Edita | Y luego |
|
|
141
|
+
|---|---|---|
|
|
142
|
+
| Una regla global (todos los agentes) | `~/Documents/orca-multiagent-kit/core/AGENTS.md` o `rules/…` | `./install.sh` |
|
|
143
|
+
| Una regla solo tuya que el kit no debe pisar | `~/.agents/rules/personal.md` | nada: el núcleo lo lee |
|
|
144
|
+
| Una skill | `~/Documents/orca-multiagent-kit/skills/<skill>/` | `./install.sh` |
|
|
145
|
+
| Reglas de un proyecto | `AGENTS.md` del proyecto, sección *Overrides* | nada |
|
|
146
|
+
|
|
147
|
+
Puedes editar directamente en `~/.agents/`, pero la próxima reinstalación lo sobrescribirá. La fuente de verdad es el kit; si lo versionas en git, tienes historial y lo sincronizas entre ordenadores (`git pull && ./install.sh`).
|
|
148
|
+
|
|
149
|
+
**Una regla, un sitio**: no copies reglas en `CLAUDE.md`, `GEMINI.md` ni en las reglas de Cursor. Esas copias son justo las que acaban divergiendo.
|
|
150
|
+
|
|
151
|
+
---
|
|
152
|
+
|
|
153
|
+
## 7. Convivencia con skills externas
|
|
154
|
+
|
|
155
|
+
| Skill | Dónde vive | Cómo convive |
|
|
156
|
+
|---|---|---|
|
|
157
|
+
| `impeccable` (diseño UI) | Hoy, dentro del plugin `user-workflows` de Antigravity: **solo la ve Antigravity** | Prefijos distintos, sin choques de nombre. Su `audit` es de diseño, a11y y rendimiento; `csr-audit` es de seguridad, así que se complementan. `orca` la usa en las unidades de UI y pasa su `audit` antes de cerrar una ronda con UI, y sus `PRODUCT.md`/`DESIGN.md` van a la lista `shared`. Para que la vean todos los agentes: `./install.sh --adopt <su carpeta>` |
|
|
158
|
+
| `supabase`, `supabase-postgres-best-practices` | `~/.agents/skills` | Sin cambios. Complementan `31-security-audit` (RLS) y `75-reliability` (migraciones) |
|
|
159
|
+
| `orca-cli`, `orchestration` | `~/.agents/skills` | Sin cambios. `orca` las carga para los comandos exactos de tu Orca |
|
|
160
|
+
| spec-kit (`speckit-*`) | Proyecto / plugin | No se modifica. La extensión `orca` añade un hook `before_implement`, y `orca` lee su `tasks.md` |
|
|
161
|
+
| Plugins de Antigravity (`android-cli`, `chrome-devtools`, `user-workflows`) | `~/.gemini/config/plugins` | No se tocan. Solo se retira el plugin `claude-session-rules`, que duplicaba CSR |
|
|
162
|
+
|
|
163
|
+
**Regla de precedencia** (núcleo §0): una skill externa manda en su terreno cuando la invocas o encaja con la tarea. Por ejemplo, impeccable puede "ir a por todas" en diseño aunque el núcleo pida brevedad en el chat. La puerta de validez (§4) y las prohibiciones (§5) se aplican siempre.
|
|
164
|
+
|
|
165
|
+
**`--adopt`** mueve la skill a `~/.agents/skills/` y deja un enlace en su sitio original, así el plugin la sigue encontrando. Después la enlaza en Claude y Antigravity. Si la skill se actualiza con su propio instalador, vuelve a adoptarla.
|
|
166
|
+
|
|
167
|
+
## 8. Avisos
|
|
168
|
+
|
|
169
|
+
- **Claude Code en Cowork** (app de escritorio): por seguridad, no carga imports de fuera de la carpeta de trabajo. En la CLI y en el IDE el import funciona. Si usas Cowork para programar, abre allí la carpeta del proyecto: su `AGENTS.md` (vía `CLAUDE.md`) indica que hay que leer `~/.agents/AGENTS.md`.
|
|
170
|
+
- **Cursor** lee también `~/.claude/skills` por compatibilidad, así que puede mostrar las skills dos veces. Son enlaces al mismo contenido, así que no hay riesgo de divergencia.
|
|
171
|
+
- **Devin** lee también `~/.claude/CLAUDE.md`. Por eso es opcional.
|
|
172
|
+
- **Antigravity**: si al arrancar se queja del plugin `claude-session-rules` ausente, desactívalo en sus ajustes. Su contenido ya está en el núcleo.
|
|
173
|
+
- **Nivel técnico** (`rules/10-communication.md`): la versión anterior te describía como "backend avanzado (Python, Kubernetes…)". Ahora pone fullstack con tu stack real. Ajústalo si no te encaja.
|
|
174
|
+
- **Permisos**: Orca y Antigravity ejecutan sin confirmación. Copia solo `.env` de desarrollo a los worktrees (`.worktreeinclude`) y revisa los permisos que tiene guardados Antigravity.
|
|
175
|
+
|
|
176
|
+
---
|
|
177
|
+
|
|
178
|
+
## 9. Verificación funcional (en cada agente)
|
|
179
|
+
|
|
180
|
+
| Pregunta | Respuesta correcta |
|
|
181
|
+
|---|---|
|
|
182
|
+
| «¿Qué dice la sección 4 de tus reglas globales?» | La puerta de validez en 8 fases |
|
|
183
|
+
| «¿Dónde están tus reglas de seguridad?» | `~/.agents/rules/30-security.md` |
|
|
184
|
+
| «Hola, ¿qué tal?» (en inglés) | Responde en español de España, breve |
|
|
185
|
+
| «Inicializa el proyecto» en un repo sin AGENTS.md | `kit-init`: detecta el stack, crea los ficheros, pregunta ≤4 cosas |
|
|
186
|
+
| «Añade un botón de logout» | Lo hace directamente (sin MAW) y pasa los gates |
|
|
187
|
+
| `/speckit.implement` en una spec con varias stories independientes | El hook `orca` muestra el plan de rondas y espera tu «sí» |
|
|
188
|
+
|
|
189
|
+
---
|
|
190
|
+
|
|
191
|
+
## 10. Desinstalar
|
|
192
|
+
|
|
193
|
+
```bash
|
|
194
|
+
./install.sh --restore <fecha-del-primer-backup> # vuelve al estado anterior
|
|
195
|
+
rm -rf ~/.agents/AGENTS.md ~/.agents/rules ~/.agents/templates ~/.agents/output-styles
|
|
196
|
+
rm -rf ~/.agents/skills/csr-* ~/.agents/skills/orca ~/.agents/skills/kit-init ~/.agents/skills/speckit-orca-implement ~/.agents/speckit-ext
|
|
197
|
+
```
|
|
198
|
+
|
|
199
|
+
---
|
|
200
|
+
|
|
201
|
+
## 11. Base documental
|
|
202
|
+
- Claude Code, memoria, imports y `~/.claude/rules`: https://code.claude.com/docs/en/memory
|
|
203
|
+
- Cursor, skills: https://cursor.com/docs/skills
|
|
204
|
+
- Codex, AGENTS.md y skills: https://learn.chatgpt.com/docs/customization/overview
|
|
205
|
+
- Copilot CLI, configuración y skills: https://docs.github.com/en/copilot/concepts/customizations/agent-skills
|
|
206
|
+
- Devin CLI, reglas: https://docs.devin.ai/cli/extensibility/rules
|
|
207
|
+
- Orca: https://www.onorca.dev/docs
|
|
208
|
+
- Normas de seguridad: ver la base documental del README de CSR v1 (OWASP Top 10 2025, ASVS 5.0, CWE Top 25).
|
package/install.sh
ADDED
|
@@ -0,0 +1,297 @@
|
|
|
1
|
+
#!/usr/bin/env bash
|
|
2
|
+
# Orca Multiagent Kit — fuente única de reglas y skills para todos tus agentes (CSR + MAW).
|
|
3
|
+
# ./install.sh --dry-run muestra lo que haria, sin escribir
|
|
4
|
+
# ./install.sh instala/migra para los agentes detectados
|
|
5
|
+
# ./install.sh --agents claude,codex solo esos (claude antigravity codex copilot cursor devin)
|
|
6
|
+
# ./install.sh --project /ruta ademas, migra/prepara un proyecto
|
|
7
|
+
# ./install.sh --project-only /ruta solo el proyecto
|
|
8
|
+
# ./install.sh --verify comprueba instalacion y que no queden copias divergentes
|
|
9
|
+
# ./install.sh --restore AAAAMMDD-HHMMSS deshace una instalacion desde su backup
|
|
10
|
+
# ./install.sh --adopt <carpeta-skill> hace multiproveedor una skill externa (una copia, todos la ven)
|
|
11
|
+
# Compatible con bash 3.2 (macOS).
|
|
12
|
+
set -Eeuo pipefail
|
|
13
|
+
|
|
14
|
+
SRC="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
|
15
|
+
AG="${AGENT_KIT_HOME:-$HOME/.agents}"
|
|
16
|
+
CLAUDE_DIR="${CLAUDE_CONFIG_DIR:-$HOME/.claude}"
|
|
17
|
+
GEMINI_DIR="${GEMINI_DIR:-$HOME/.gemini}"
|
|
18
|
+
CODEX_DIR="${CODEX_HOME:-$HOME/.codex}"
|
|
19
|
+
COPILOT_DIR="$HOME/.copilot"
|
|
20
|
+
CURSOR_DIR="$HOME/.cursor"
|
|
21
|
+
DEVIN_DIR="$HOME/.config/devin"
|
|
22
|
+
STAMP="$(date +%Y%m%d-%H%M%S)"
|
|
23
|
+
BK="$AG/backups/$STAMP"
|
|
24
|
+
VERSION="$(cat "$SRC/VERSION")"
|
|
25
|
+
KIT_SKILLS="kit-init orca speckit-orca-implement csr-stack csr-gate csr-audit"
|
|
26
|
+
# Skills de versiones anteriores que esta versión retira (consolidadas en "orca")
|
|
27
|
+
OLD_SKILLS="maw-route maw-brief maw-plan maw-dispatch maw-worker maw-integrate maw-race maw-setup"
|
|
28
|
+
# Ficheros de reglas que versiones anteriores (CSR v1, MAW v1) copiaban dentro de cada agente.
|
|
29
|
+
OLD_RULES="00-router.md 10-communication.md 20-clean-code.md 30-security.md 31-security-audit.md 40-testing.md 50-done-gate.md 60-git-workflow.md 70-performance.md 75-reliability.md 80-supply-chain.md 90-docs-comments.md 95-multi-agent.md comunicacion-densa.md idioma-siempre.md"
|
|
30
|
+
OLD_LANGS="cpp csharp dart-flutter go infra java kotlin php python react ruby rust shell sql swift typescript web"
|
|
31
|
+
|
|
32
|
+
PROJECT=""; PROJECT_ONLY=0; VERIFY=0; DRY=0; AGENTS=""; RESTORE=""; ADOPT=""; WARN=""
|
|
33
|
+
while [ $# -gt 0 ]; do
|
|
34
|
+
case "$1" in
|
|
35
|
+
--project) PROJECT="${2:-}"; shift 2 ;;
|
|
36
|
+
--project-only) PROJECT="${2:-}"; PROJECT_ONLY=1; shift 2 ;;
|
|
37
|
+
--agents) AGENTS="${2:-}"; shift 2 ;;
|
|
38
|
+
--verify) VERIFY=1; shift ;;
|
|
39
|
+
--dry-run) DRY=1; shift ;;
|
|
40
|
+
--restore) RESTORE="${2:-}"; shift 2 ;;
|
|
41
|
+
--adopt) ADOPT="${2:-}"; shift 2 ;;
|
|
42
|
+
-h|--help) sed -n '2,12p' "$0"; exit 0 ;;
|
|
43
|
+
*) echo "Opcion desconocida: $1" >&2; exit 2 ;;
|
|
44
|
+
esac
|
|
45
|
+
done
|
|
46
|
+
|
|
47
|
+
step() { printf '[kit] %s\n' "$1"; }
|
|
48
|
+
warn() { WARN="${WARN} - $1
|
|
49
|
+
"; }
|
|
50
|
+
run() { if [ "$DRY" -eq 1 ]; then printf ' (dry) %s\n' "$*"; else "$@"; fi; }
|
|
51
|
+
has_agent() { case ",$AGENTS," in *",$1,"*) return 0 ;; *) return 1 ;; esac; }
|
|
52
|
+
|
|
53
|
+
# Mueve una ruta al backup conservando su ruta relativa a $HOME.
|
|
54
|
+
stash() {
|
|
55
|
+
local p="$1" rel
|
|
56
|
+
[ -e "$p" ] || [ -L "$p" ] || return 0
|
|
57
|
+
rel="${p#$HOME/}"
|
|
58
|
+
run mkdir -p "$BK/$(dirname "$rel")"
|
|
59
|
+
run mv "$p" "$BK/$rel"
|
|
60
|
+
}
|
|
61
|
+
# Copia (sin mover) una ruta al backup.
|
|
62
|
+
snapshot() {
|
|
63
|
+
local p="$1" rel
|
|
64
|
+
[ -e "$p" ] || return 0
|
|
65
|
+
rel="${p#$HOME/}"
|
|
66
|
+
run mkdir -p "$BK/$(dirname "$rel")"
|
|
67
|
+
run cp -a "$p" "$BK/$rel"
|
|
68
|
+
}
|
|
69
|
+
# Deja $2 como enlace simbolico a $1. Si habia otra cosa, va al backup.
|
|
70
|
+
link() {
|
|
71
|
+
local target="$1" l="$2"
|
|
72
|
+
if [ -L "$l" ] && [ "$(readlink "$l")" = "$target" ]; then return 0; fi
|
|
73
|
+
stash "$l"
|
|
74
|
+
run mkdir -p "$(dirname "$l")"
|
|
75
|
+
run ln -s "$target" "$l"
|
|
76
|
+
}
|
|
77
|
+
# Quita los bloques gestionados (CSR, MAW, AGENTS) de un fichero, conservando el resto.
|
|
78
|
+
strip_blocks() { # $1 fichero -> stdout
|
|
79
|
+
awk 'BEGIN{tag=""}
|
|
80
|
+
tag=="" && match($0,/<!-- (CSR|MAW|AGENTS):BEGIN/) {tag=substr($0,RSTART+5,RLENGTH-11); next}
|
|
81
|
+
tag!="" { if (index($0,"<!-- " tag ":END -->")) tag=""; next }
|
|
82
|
+
{print}' "$1" | cat -s | awk 'NF{f=1} f'
|
|
83
|
+
}
|
|
84
|
+
# Lineas de "Overrides de este proyecto" dentro de un bloque CSR/AGENTS de proyecto.
|
|
85
|
+
extract_overrides() { # $1 fichero -> stdout
|
|
86
|
+
awk 'BEGIN{inb=0;ov=0}
|
|
87
|
+
/<!-- (CSR|AGENTS):BEGIN project/ {inb=1; next}
|
|
88
|
+
inb && /<!-- (CSR|AGENTS):END -->/ {inb=0; ov=0; next}
|
|
89
|
+
inb && /^## Overrides de este proyecto/ {ov=1; next}
|
|
90
|
+
inb && ov && !/^<!--/ && !/^-[[:space:]]*$/ && NF>0 {print}' "$1"
|
|
91
|
+
}
|
|
92
|
+
write_file() { # $1 destino, stdin contenido
|
|
93
|
+
if [ "$DRY" -eq 1 ]; then cat >/dev/null; printf ' (dry) escribir %s\n' "$1"; else mkdir -p "$(dirname "$1")"; cat > "$1"; fi
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
[ -f "$SRC/core/AGENTS.md" ] || { echo "No encuentro core/AGENTS.md en $SRC" >&2; exit 1; }
|
|
97
|
+
|
|
98
|
+
# ------------------------------------------------------------------ restore
|
|
99
|
+
if [ -n "$RESTORE" ]; then
|
|
100
|
+
R="$AG/backups/$RESTORE"; [ -d "$R" ] || { echo "No existe $R" >&2; exit 1; }
|
|
101
|
+
step "Restaurando desde $R"
|
|
102
|
+
(cd "$R" && find . \( -type f -o -type l \) | sed 's#^\./##') | while IFS= read -r rel; do
|
|
103
|
+
dest="$HOME/$rel"
|
|
104
|
+
# si algun directorio padre es ahora un enlace (p. ej. una skill enlazada), quita el enlace: no escribir a traves de el
|
|
105
|
+
p="$(dirname "$dest")"
|
|
106
|
+
while [ "$p" != "$HOME" ] && [ "$p" != "/" ]; do [ -L "$p" ] && run rm -f "$p"; p="$(dirname "$p")"; done
|
|
107
|
+
if [ -L "$dest" ] || [ -f "$dest" ]; then run rm -f "$dest"; fi
|
|
108
|
+
run mkdir -p "$(dirname "$dest")"; run cp -a "$R/$rel" "$dest"
|
|
109
|
+
done
|
|
110
|
+
step "Hecho. Los enlaces creados donde antes no habia nada se mantienen; borralos a mano si quieres."
|
|
111
|
+
exit 0
|
|
112
|
+
fi
|
|
113
|
+
|
|
114
|
+
# ------------------------------------------------------------------ agentes
|
|
115
|
+
if [ -z "$AGENTS" ]; then
|
|
116
|
+
[ -d "$CLAUDE_DIR" ] && AGENTS="$AGENTS,claude"
|
|
117
|
+
[ -d "$GEMINI_DIR" ] && AGENTS="$AGENTS,antigravity"
|
|
118
|
+
[ -d "$CODEX_DIR" ] && AGENTS="$AGENTS,codex"
|
|
119
|
+
[ -d "$COPILOT_DIR" ] && AGENTS="$AGENTS,copilot"
|
|
120
|
+
[ -d "$CURSOR_DIR" ] && AGENTS="$AGENTS,cursor"
|
|
121
|
+
AGENTS="${AGENTS#,}" # devin solo con --agents (opt-in)
|
|
122
|
+
fi
|
|
123
|
+
|
|
124
|
+
# ------------------------------------------------------------------ adopt
|
|
125
|
+
if [ -n "$ADOPT" ]; then
|
|
126
|
+
SKD="${ADOPT%/}"
|
|
127
|
+
[ -f "$SKD/SKILL.md" ] || { echo "No es una skill (falta SKILL.md): $SKD" >&2; exit 1; }
|
|
128
|
+
[ -L "$SKD" ] && { echo "Ya es un enlace: $SKD -> $(readlink "$SKD")" >&2; exit 1; }
|
|
129
|
+
NAME="$(basename "$SKD")"; DEST="$AG/skills/$NAME"
|
|
130
|
+
[ -e "$DEST" ] && { echo "Ya existe $DEST. Si es la misma skill, borra una de las dos copias antes." >&2; exit 1; }
|
|
131
|
+
step "Adoptando $NAME: $SKD -> $DEST (en su sitio original queda un enlace)"
|
|
132
|
+
run mkdir -p "$BK" "$AG/skills"
|
|
133
|
+
run cp -a "$SKD" "$BK/$NAME.orig"
|
|
134
|
+
run mv "$SKD" "$DEST"
|
|
135
|
+
run ln -s "$DEST" "$SKD"
|
|
136
|
+
case "$SKD" in "$CLAUDE_DIR"/skills/*) ;; *) has_agent claude && link "$DEST" "$CLAUDE_DIR/skills/$NAME" ;; esac
|
|
137
|
+
case "$SKD" in "$GEMINI_DIR"/*) ;; *) has_agent antigravity && link "$DEST" "$GEMINI_DIR/config/skills/$NAME" ;; esac
|
|
138
|
+
step "Hecho. Codex, Copilot y Cursor la leen desde $AG/skills. Si la skill se actualiza con su propio instalador, vuelve a adoptarla."
|
|
139
|
+
exit 0
|
|
140
|
+
fi
|
|
141
|
+
|
|
142
|
+
# ------------------------------------------------------------------ verify
|
|
143
|
+
if [ "$VERIFY" -eq 1 ]; then
|
|
144
|
+
bad=0
|
|
145
|
+
ok() { echo " OK $1"; }
|
|
146
|
+
fail() { echo " MAL $1"; bad=1; }
|
|
147
|
+
chk_link() { if [ -L "$2" ] && [ "$(readlink "$2")" = "$1" ]; then ok "$2 -> $1"; else fail "$2 no enlaza a $1"; fi; }
|
|
148
|
+
[ -f "$AG/AGENTS.md" ] && ok "$AG/AGENTS.md" || fail "$AG/AGENTS.md"
|
|
149
|
+
n=$(ls -1 "$AG/rules/lang"/*.md 2>/dev/null | wc -l | tr -d ' '); [ "$n" -ge 17 ] && ok "rules/lang: $n" || fail "rules/lang: $n (esperado 17)"
|
|
150
|
+
for s in $KIT_SKILLS; do [ -f "$AG/skills/$s/SKILL.md" ] || fail "skill $s"; done
|
|
151
|
+
[ -f "$AG/speckit-ext/orca/extension.yml" ] && ok "extension spec-kit orca" || fail "$AG/speckit-ext/orca"
|
|
152
|
+
for s in $OLD_SKILLS; do [ -e "$AG/skills/$s" ] && fail "skill retirada sigue instalada: $s"; done
|
|
153
|
+
if has_agent claude; then
|
|
154
|
+
grep -q '@~/.agents/AGENTS.md' "$CLAUDE_DIR/CLAUDE.md" 2>/dev/null && ok "CLAUDE.md importa AGENTS.md" || fail "CLAUDE.md sin import"
|
|
155
|
+
grep -Eq '<!-- (CSR|MAW):BEGIN' "$CLAUDE_DIR/CLAUDE.md" 2>/dev/null && fail "CLAUDE.md conserva bloques CSR/MAW antiguos" || true
|
|
156
|
+
for r in $OLD_RULES; do [ -e "$CLAUDE_DIR/rules/$r" ] && fail "copia divergente: $CLAUDE_DIR/rules/$r (Claude la carga SIEMPRE)"; done
|
|
157
|
+
for s in $KIT_SKILLS; do chk_link "$AG/skills/$s" "$CLAUDE_DIR/skills/$s"; done
|
|
158
|
+
fi
|
|
159
|
+
if has_agent antigravity; then
|
|
160
|
+
chk_link "$AG/AGENTS.md" "$GEMINI_DIR/GEMINI.md"
|
|
161
|
+
for r in $OLD_RULES; do [ -e "$GEMINI_DIR/rules/$r" ] && fail "copia divergente: $GEMINI_DIR/rules/$r"; done
|
|
162
|
+
[ -e "$GEMINI_DIR/config/plugins/claude-session-rules" ] && fail "plugin claude-session-rules sigue instalado (duplica csr-*)"
|
|
163
|
+
for s in $KIT_SKILLS; do chk_link "$AG/skills/$s" "$GEMINI_DIR/config/skills/$s"; done
|
|
164
|
+
fi
|
|
165
|
+
has_agent codex && chk_link "$AG/AGENTS.md" "$CODEX_DIR/AGENTS.md"
|
|
166
|
+
has_agent copilot && chk_link "$AG/AGENTS.md" "$COPILOT_DIR/copilot-instructions.md"
|
|
167
|
+
has_agent devin && chk_link "$AG/AGENTS.md" "$DEVIN_DIR/AGENTS.md"
|
|
168
|
+
has_agent cursor && echo " INFO cursor: lee ~/.agents/skills solo; reglas globales en Settings -> Rules (no hay fichero)"
|
|
169
|
+
[ "$bad" -eq 0 ] && { step "Verificacion: OK ($AGENTS)"; exit 0; }
|
|
170
|
+
step "Verificacion: con fallos"; exit 1
|
|
171
|
+
fi
|
|
172
|
+
|
|
173
|
+
# ------------------------------------------------------------------ global
|
|
174
|
+
if [ "$PROJECT_ONLY" -eq 0 ]; then
|
|
175
|
+
[ -n "$AGENTS" ] || { echo "No detecto ningun agente. Usa --agents." >&2; exit 1; }
|
|
176
|
+
step "Orca Multiagent Kit v$VERSION · agentes: $AGENTS"
|
|
177
|
+
step "Fuente unica: $AG · backup: $BK"
|
|
178
|
+
run mkdir -p "$BK"
|
|
179
|
+
|
|
180
|
+
# 1. Fuente canonica
|
|
181
|
+
[ -f "$AG/AGENTS.md" ] && snapshot "$AG/AGENTS.md"
|
|
182
|
+
run mkdir -p "$AG/rules" "$AG/skills" "$AG/templates" "$AG/output-styles"
|
|
183
|
+
run cp "$SRC/core/AGENTS.md" "$AG/AGENTS.md"
|
|
184
|
+
run cp -R "$SRC/rules/." "$AG/rules/"
|
|
185
|
+
for r in comunicacion-densa.md idioma-siempre.md; do [ -e "$AG/rules/$r" ] && stash "$AG/rules/$r"; done
|
|
186
|
+
for s in $KIT_SKILLS; do
|
|
187
|
+
[ -e "$AG/skills/$s" ] && run rm -rf "$AG/skills/$s"
|
|
188
|
+
run cp -R "$SRC/skills/$s" "$AG/skills/$s"
|
|
189
|
+
done
|
|
190
|
+
run cp -R "$SRC/templates/." "$AG/templates/"
|
|
191
|
+
run cp -R "$SRC/output-styles/." "$AG/output-styles/"
|
|
192
|
+
run cp "$SRC/VERSION" "$AG/AGENT_KIT_VERSION"
|
|
193
|
+
[ -d "$AG/maw" ] && stash "$AG/maw" # restos de MAW v1
|
|
194
|
+
for s in $OLD_SKILLS; do
|
|
195
|
+
stash "$AG/skills/$s"; stash "$CLAUDE_DIR/skills/$s"; stash "$GEMINI_DIR/config/skills/$s"
|
|
196
|
+
done
|
|
197
|
+
run mkdir -p "$AG/speckit-ext"
|
|
198
|
+
[ -e "$AG/speckit-ext/orca" ] && run rm -rf "$AG/speckit-ext/orca"
|
|
199
|
+
run cp -R "$SRC/speckit-extension/orca" "$AG/speckit-ext/orca"
|
|
200
|
+
|
|
201
|
+
# 2. Claude Code: import en CLAUDE.md; reglas fuera de ~/.claude/rules (Claude carga TODO lo que hay ahi)
|
|
202
|
+
if has_agent claude; then
|
|
203
|
+
step "Claude Code"
|
|
204
|
+
if [ -L "$CLAUDE_DIR/CLAUDE.md" ]; then stash "$CLAUDE_DIR/CLAUDE.md"; fi
|
|
205
|
+
[ -f "$CLAUDE_DIR/CLAUDE.md" ] && snapshot "$CLAUDE_DIR/CLAUDE.md"
|
|
206
|
+
TMP="$(mktemp)"; [ -f "$CLAUDE_DIR/CLAUDE.md" ] && strip_blocks "$CLAUDE_DIR/CLAUDE.md" > "$TMP"
|
|
207
|
+
{ printf '<!-- AGENTS:BEGIN v%s Orca Multiagent Kit -- reglas globales: edita ~/.agents/AGENTS.md, no este bloque -->\n@~/.agents/AGENTS.md\n<!-- AGENTS:END -->\n' "$VERSION"; [ -s "$TMP" ] && { printf '\n'; cat "$TMP"; }; true; } | write_file "$CLAUDE_DIR/CLAUDE.md"
|
|
208
|
+
rm -f "$TMP"
|
|
209
|
+
for r in $OLD_RULES; do stash "$CLAUDE_DIR/rules/$r"; done
|
|
210
|
+
for l in $OLD_LANGS; do stash "$CLAUDE_DIR/rules/lang/$l.md"; done
|
|
211
|
+
[ -d "$CLAUDE_DIR/rules/lang" ] && [ "$DRY" -eq 0 ] && rmdir "$CLAUDE_DIR/rules/lang" 2>/dev/null || true
|
|
212
|
+
for s in $KIT_SKILLS; do link "$AG/skills/$s" "$CLAUDE_DIR/skills/$s"; done
|
|
213
|
+
link "$AG/output-styles/csr-minimal.md" "$CLAUDE_DIR/output-styles/csr-minimal.md"
|
|
214
|
+
stash "$CLAUDE_DIR/templates/STACK.md"; stash "$CLAUDE_DIR/templates/project-CLAUDE.md"
|
|
215
|
+
warn "Claude Code: en sesiones de Cowork (app de escritorio) no se cargan imports de fuera de la carpeta de trabajo; en la CLI y el IDE, si."
|
|
216
|
+
fi
|
|
217
|
+
|
|
218
|
+
# 3. Antigravity: GEMINI.md pasa a ser un enlace a la fuente unica
|
|
219
|
+
if has_agent antigravity; then
|
|
220
|
+
step "Antigravity"
|
|
221
|
+
if [ -f "$GEMINI_DIR/GEMINI.md" ] && [ ! -L "$GEMINI_DIR/GEMINI.md" ]; then
|
|
222
|
+
EXTRA="$(strip_blocks "$GEMINI_DIR/GEMINI.md" | grep -v '^[[:space:]]*$' || true)"
|
|
223
|
+
if [ -n "$EXTRA" ]; then
|
|
224
|
+
warn "Antigravity: GEMINI.md tenia contenido fuera de los bloques (va al backup). Idioma y comunicacion ya estan en AGENTS.md; si habia algo mas tuyo, pasalo a ~/.agents/rules/personal.md"
|
|
225
|
+
fi
|
|
226
|
+
fi
|
|
227
|
+
link "$AG/AGENTS.md" "$GEMINI_DIR/GEMINI.md"
|
|
228
|
+
for r in $OLD_RULES; do stash "$GEMINI_DIR/rules/$r"; done
|
|
229
|
+
for l in $OLD_LANGS; do stash "$GEMINI_DIR/rules/lang/$l.md"; done
|
|
230
|
+
[ -d "$GEMINI_DIR/rules/lang" ] && [ "$DRY" -eq 0 ] && rmdir "$GEMINI_DIR/rules/lang" 2>/dev/null || true
|
|
231
|
+
stash "$GEMINI_DIR/templates/STACK.md"; stash "$GEMINI_DIR/templates/project-CLAUDE.md"
|
|
232
|
+
stash "$GEMINI_DIR/output-styles/csr-minimal.md"
|
|
233
|
+
if [ -e "$GEMINI_DIR/config/plugins/claude-session-rules" ]; then
|
|
234
|
+
stash "$GEMINI_DIR/config/plugins/claude-session-rules"
|
|
235
|
+
warn "Antigravity: plugin claude-session-rules retirado (sus csr-* y su estilo ya estan en la fuente unica). Si Antigravity se queja de un plugin ausente, desactivalo en su configuracion."
|
|
236
|
+
fi
|
|
237
|
+
for s in $KIT_SKILLS; do link "$AG/skills/$s" "$GEMINI_DIR/config/skills/$s"; done
|
|
238
|
+
[ -d "$GEMINI_DIR/config/plugins/user-workflows/skills/planificar" ] && warn "Antigravity: 'planificar' sigue activo; 'orca' (plan por sprints) lo sustituye. Desactivalo cuando lo hayas probado."
|
|
239
|
+
fi
|
|
240
|
+
|
|
241
|
+
# 4. Agentes que leen ~/.agents/skills de forma nativa: solo hay que enlazar las reglas globales
|
|
242
|
+
if has_agent codex; then step "Codex"; link "$AG/AGENTS.md" "$CODEX_DIR/AGENTS.md"; fi
|
|
243
|
+
if has_agent copilot; then step "Copilot CLI"; link "$AG/AGENTS.md" "$COPILOT_DIR/copilot-instructions.md"; fi
|
|
244
|
+
if has_agent devin; then step "Devin CLI"; link "$AG/AGENTS.md" "$DEVIN_DIR/AGENTS.md"
|
|
245
|
+
warn "Devin: tambien lee ~/.claude/CLAUDE.md; si ves reglas duplicadas, quita uno de los dos."; fi
|
|
246
|
+
if has_agent cursor; then step "Cursor (skills: nativo en ~/.agents/skills)"
|
|
247
|
+
warn "Cursor: sus reglas de usuario no estan en ficheros. Pega en Settings -> Rules -> User Rules: «Al empezar, lee y aplica ~/.agents/AGENTS.md y, bajo demanda, ~/.agents/rules/»."
|
|
248
|
+
has_agent claude && warn "Cursor: tambien lee ~/.claude/skills por compatibilidad; puede listar las skills dos veces (mismo contenido)."; fi
|
|
249
|
+
fi
|
|
250
|
+
|
|
251
|
+
# ------------------------------------------------------------------ proyecto
|
|
252
|
+
if [ -n "$PROJECT" ]; then
|
|
253
|
+
[ -d "$PROJECT" ] || { echo "No existe la ruta de proyecto: $PROJECT" >&2; exit 1; }
|
|
254
|
+
step "Proyecto: $PROJECT"
|
|
255
|
+
OV=""
|
|
256
|
+
for f in "$PROJECT/CLAUDE.md" "$PROJECT/AGENTS.md"; do [ -f "$f" ] && OV="$OV$(extract_overrides "$f")
|
|
257
|
+
"; done
|
|
258
|
+
OV="$(printf '%s' "$OV" | awk 'NF && !seen[$0]++')"
|
|
259
|
+
for f in AGENTS.md CLAUDE.md; do [ -f "$PROJECT/$f" ] && snapshot "$PROJECT/$f"; done
|
|
260
|
+
|
|
261
|
+
TMP="$(mktemp)"; [ -f "$PROJECT/AGENTS.md" ] && strip_blocks "$PROJECT/AGENTS.md" > "$TMP"
|
|
262
|
+
{ if [ -n "$OV" ]; then OV="$OV" awk '/^-$/ && !d {print ENVIRON["OV"]; d=1; next} {print}' "$SRC/templates/AGENTS.md"; else cat "$SRC/templates/AGENTS.md"; fi
|
|
263
|
+
[ -s "$TMP" ] && { printf '\n'; cat "$TMP"; }; true; } | write_file "$PROJECT/AGENTS.md"
|
|
264
|
+
REST="$(mktemp)"; [ -f "$PROJECT/CLAUDE.md" ] && strip_blocks "$PROJECT/CLAUDE.md" > "$REST"
|
|
265
|
+
{ cat "$SRC/templates/CLAUDE.md"; [ -s "$REST" ] && { printf '\n'; cat "$REST"; }; true; } | write_file "$PROJECT/CLAUDE.md"
|
|
266
|
+
grep -q '[^[:space:]]' "$REST" && warn "Proyecto: CLAUDE.md tiene reglas propias fuera del bloque; solo las ve Claude. Muevelas a AGENTS.md para que las vean todos."
|
|
267
|
+
rm -f "$TMP" "$REST"
|
|
268
|
+
[ -n "$OV" ] && step " overrides migrados a AGENTS.md"
|
|
269
|
+
for f in STACK.md ORCHESTRATION.md orca.yaml .worktreeinclude; do
|
|
270
|
+
if [ -e "$PROJECT/$f" ]; then step " $f ya existe: no se toca"; else run cp "$SRC/templates/$f" "$PROJECT/$f"; step " $f creado"; fi
|
|
271
|
+
done
|
|
272
|
+
if [ ! -e "$PROJECT/.claude/settings.json" ] && has_agent claude; then run mkdir -p "$PROJECT/.claude"; run cp "$SRC/templates/claude-settings.json" "$PROJECT/.claude/settings.json"; step " .claude/settings.json creado"; fi
|
|
273
|
+
if [ -d "$PROJECT/.specify" ]; then
|
|
274
|
+
EXT="$PROJECT/.specify/extensions.yml"
|
|
275
|
+
if grep -q 'speckit.orca.implement' "$EXT" 2>/dev/null; then step " spec-kit: hook orca ya activo"
|
|
276
|
+
elif command -v specify >/dev/null 2>&1; then
|
|
277
|
+
(cd "$PROJECT" && run specify extension add --dev "$AG/speckit-ext/orca") && step " spec-kit: extension orca instalada (hook before_implement)" \
|
|
278
|
+
|| warn "Proyecto: 'specify extension add' fallo; en el agente, «inicializa el proyecto» añadira el hook."
|
|
279
|
+
elif [ ! -e "$EXT" ]; then
|
|
280
|
+
# mismo formato que escribe 'specify extension add'
|
|
281
|
+
printf '%s\n' 'installed:' '- orca' 'settings:' ' auto_execute_hooks: true' 'hooks:' ' before_implement:' ' - extension: orca' \
|
|
282
|
+
' command: speckit.orca.implement' ' enabled: true' ' optional: false' ' priority: 10' \
|
|
283
|
+
' description: "Orquestacion multiagente: reparte las user stories si compensa"' | write_file "$EXT"
|
|
284
|
+
step " spec-kit: hook before_implement creado en .specify/extensions.yml"
|
|
285
|
+
else
|
|
286
|
+
warn "Proyecto: .specify/extensions.yml ya existe y no hay CLI 'specify'. En el agente, «inicializa el proyecto» añadira el hook sin romper lo que hay."
|
|
287
|
+
fi
|
|
288
|
+
fi
|
|
289
|
+
if ! grep -qxF '.work/' "$PROJECT/.gitignore" 2>/dev/null; then
|
|
290
|
+
if [ "$DRY" -eq 1 ]; then echo " (dry) añadir .work/ a .gitignore"; else printf '\n# Orca Multiagent Kit: briefs e informes de runs multiagente\n.work/\n' >> "$PROJECT/.gitignore"; fi
|
|
291
|
+
step " .work/ añadido a .gitignore"
|
|
292
|
+
fi
|
|
293
|
+
step " Siguiente: en el agente, «inicializa el proyecto» (kit-init: detecta el stack y prepara la orquestacion)."
|
|
294
|
+
fi
|
|
295
|
+
|
|
296
|
+
[ -n "$WARN" ] && { step "Avisos:"; printf '%s' "$WARN"; }
|
|
297
|
+
step "Hecho. Comprueba con: ./install.sh --verify · deshacer: ./install.sh --restore $STAMP"
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: CSR Minimal
|
|
3
|
+
description: Maximo rigor tecnico, minimo gasto en prosa. Resultado primero, sin narracion ni cortesia.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
Eres un ingeniero senior. Tu razonamiento y tu código son exhaustivos; tu prosa es mínima.
|
|
7
|
+
|
|
8
|
+
- Primera línea = resultado o estado. Sin preámbulo, sin narrar herramientas, sin cortesía, sin recapitulación.
|
|
9
|
+
- ≤4 líneas de prosa por turno. Código, diffs, tablas de gates y comandos no cuentan.
|
|
10
|
+
- El resto del protocolo (prefijos, excepciones, disparadores de detalle) está en `~/.agents/AGENTS.md` §2 y en `~/.agents/rules/10-communication.md`. Aplícalo; no lo repitas.
|
|
11
|
+
- El ahorro es solo de salida en prosa. No reduzcas análisis, lectura de código, tests ni auditoría de seguridad.
|
|
12
|
+
- Antes de declarar algo terminado: `~/.agents/rules/50-done-gate.md` y tabla de gates. Un comando no ejecutado se reporta `SKIPPED (motivo)`, nunca `PASS`.
|
|
13
|
+
|
|
14
|
+
Excepción: avisos de seguridad, acciones irreversibles y secuencias donde el orden importa se escriben completos y sin comprimir.
|
package/package.json
CHANGED
|
@@ -1,6 +1,25 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "orca-multiagent-kit",
|
|
3
|
-
"version": "
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "1.1.0",
|
|
4
|
+
"description": "Una sola fuente de reglas y skills (CSR + MAW) para Claude Code, Antigravity, Codex, Copilot y Cursor, con orquestación multiagente.",
|
|
5
|
+
"license": "MIT",
|
|
6
|
+
"author": "Fernando Baquero (https://github.com/FernandoBaqueroo)",
|
|
7
|
+
"contributors": ["Necro-Coder (https://github.com/Necro-Coder)"],
|
|
8
|
+
"homepage": "https://github.com/FernandoBaqueroo/orca-multiagent-kit#readme",
|
|
9
|
+
"repository": { "type": "git", "url": "git+https://github.com/FernandoBaqueroo/orca-multiagent-kit.git" },
|
|
10
|
+
"bugs": { "url": "https://github.com/FernandoBaqueroo/orca-multiagent-kit/issues" },
|
|
11
|
+
"bin": {
|
|
12
|
+
"omk": "bin/omk.js",
|
|
13
|
+
"orca-multiagent-kit": "bin/omk.js"
|
|
14
|
+
},
|
|
15
|
+
"files": [
|
|
16
|
+
"bin/", "speckit-extension/", "core/", "rules/", "skills/", "templates/", "output-styles/", "docs/",
|
|
17
|
+
"install.sh", "VERSION", "GUIA.html", "AI_INSTALL.md", "CHANGELOG.md", "LICENSE", "README.md"
|
|
18
|
+
],
|
|
19
|
+
"engines": { "node": ">=18" },
|
|
20
|
+
"os": ["darwin", "linux", "win32"],
|
|
21
|
+
"keywords": ["ai-agents", "claude-code", "antigravity", "gemini", "codex", "copilot", "cursor", "orca", "agent-skills", "multi-agent", "worktrees", "spec-kit", "agents-md"],
|
|
22
|
+
"scripts": {
|
|
23
|
+
"test": "bash scripts/check.sh && bash tests/test_install.sh && bash tests/test_cli.sh && bash tests/test_speckit.sh"
|
|
24
|
+
}
|
|
25
|
+
}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# 00 — Router de reglas CSR
|
|
2
|
+
|
|
3
|
+
Carga progresiva: el núcleo (`~/.agents/AGENTS.md`) está siempre en contexto; todo lo demás se lee **solo cuando el disparador se cumple**. Objetivo: máxima calidad por token.
|
|
4
|
+
|
|
5
|
+
| Fichero (`~/.agents/rules/`) | Disparador | Coste aprox. |
|
|
6
|
+
|---|---|---|
|
|
7
|
+
| `10-communication.md` | El usuario se queja del formato, pide verbosidad, o dudas de estilo | ~600 tok |
|
|
8
|
+
| `20-clean-code.md` | Escribir, revisar o refactorizar cualquier código | ~1.100 tok |
|
|
9
|
+
| `30-security.md` | Siempre que se escriba código de producción | ~1.300 tok |
|
|
10
|
+
| `31-security-audit.md` | Auditoría, pre-release, o código que toca I/O, auth, cripto, red, SQL, ficheros, procesos | ~2.000 tok |
|
|
11
|
+
| `40-testing.md` | Escribir/arreglar tests o definir cobertura | ~1.200 tok |
|
|
12
|
+
| `50-done-gate.md` | Antes de declarar una tarea terminada | ~1.100 tok |
|
|
13
|
+
| `60-git-workflow.md` | Commit, rama, PR, release | ~700 tok |
|
|
14
|
+
| `70-performance.md` | Queja de lentitud, bucles calientes, consultas, bundle, memoria | ~1.000 tok |
|
|
15
|
+
| `75-reliability.md` | Errores, reintentos, timeouts, logging, métricas, migraciones | ~900 tok |
|
|
16
|
+
| `80-supply-chain.md` | Añadir/actualizar dependencia, tocar CI/CD, publicar artefacto | ~900 tok |
|
|
17
|
+
| `90-docs-comments.md` | README, ADR, comentarios, changelog, API docs | ~700 tok |
|
|
18
|
+
| `95-multi-agent.md` | Repartir trabajo entre varios agentes, worktrees, Orca | ~1.200 tok |
|
|
19
|
+
| `lang/<x>.md` | Se edita un fichero de ese lenguaje | 400-900 tok c/u |
|
|
20
|
+
|
|
21
|
+
## Lenguajes disponibles (`~/.agents/rules/lang/`)
|
|
22
|
+
`rust` · `typescript` (TS+JS+Node) · `react` · `python` · `go` · `java` · `csharp` · `cpp` · `php` · `ruby` · `kotlin` · `swift` · `dart-flutter` · `sql` · `shell` (bash+PowerShell) · `web` (HTML/CSS/a11y) · `infra` (Docker/K8s/Terraform/YAML/CI)
|
|
23
|
+
|
|
24
|
+
## Regla de economía
|
|
25
|
+
1. `STACK.md` primero: dice qué módulos están activos en este repo.
|
|
26
|
+
2. Un módulo por necesidad real, no "por si acaso".
|
|
27
|
+
3. Si ya leíste un módulo en esta sesión, no lo releas.
|
|
28
|
+
4. Cita reglas por identificador (`30-security §Cripto`), no copiando el texto.
|