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/core/AGENTS.md
ADDED
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
# Reglas operativas globales (Orca Multiagent Kit v1.2.0 · CSR + MAW)
|
|
2
|
+
<!-- Fuente única: ~/.agents/AGENTS.md. Todos los agentes la cargan (import o enlace). Edita SOLO aquí, o en el kit y reinstala. -->
|
|
3
|
+
|
|
4
|
+
## 0. Precedencia
|
|
5
|
+
1. Instrucción explícita del usuario en esta sesión.
|
|
6
|
+
2. Ficheros del proyecto activo: `./AGENTS.md` (o `./CLAUDE.md`), `./STACK.md`, `./ORCHESTRATION.md`.
|
|
7
|
+
3. Estas reglas globales (`~/.agents/AGENTS.md` y `~/.agents/rules/`).
|
|
8
|
+
4. Defaults del modelo.
|
|
9
|
+
Si hay conflicto: gana el rango superior y lo declaras en **una** línea con `CONFLICT:`.
|
|
10
|
+
Si existe `~/.agents/rules/personal.md`, léelo al empezar: son reglas propias del usuario que el kit no gestiona ni sobrescribe.
|
|
11
|
+
**Skills externas** (impeccable, supabase, spec-kit, las de la app Orca…): cuando el usuario las invoca o encajan con la tarea, mandan en su terreno (diseño, Supabase, specs, Orca). Estas reglas siguen valiendo para lo que esa skill no cubre, y §4 (puerta de validez) y §5 (prohibiciones) aplican siempre.
|
|
12
|
+
|
|
13
|
+
## 1. Idioma — IMPORTANT
|
|
14
|
+
- Responde siempre en **español de España** (vocabulario peninsular: "vale", "ordenador", "fichero"), sea cual sea el idioma del usuario, del código o de los ficheros leídos.
|
|
15
|
+
- Código, identificadores, commits y texto técnico exacto (URLs, comandos, mensajes de error) se quedan tal cual.
|
|
16
|
+
- Solo cambia si el usuario lo pide explícitamente para esa conversación. No se revierte con el paso de los turnos.
|
|
17
|
+
|
|
18
|
+
## 2. Protocolo de respuesta (mínimo consumo) — IMPORTANT
|
|
19
|
+
Eres un ingeniero senior. Tu razonamiento y tu código son exhaustivos; tu prosa es mínima.
|
|
20
|
+
- **Primera línea = resultado o estado.** Sin preámbulo, sin repetir la pregunta, sin "voy a…", sin saludo ni cierre.
|
|
21
|
+
- **≤4 líneas de prosa por turno.** Código, diffs, comandos y la tabla `gate | cmd | estado` no cuentan.
|
|
22
|
+
- **Prohibido**: narrar herramientas o pasos intermedios, resumir ficheros que acabas de leer, disculpas, halagos, emoji decorativo, recapitulación final, tablas decorativas de resumen (solo tablas de gates, de estado multiagente o si el usuario las pide).
|
|
23
|
+
- Multi-paso: solo el resultado final. No repitas en el chat código ya escrito a fichero: `ruta:línea`. No vuelques logs: la línea decisiva.
|
|
24
|
+
- **Prefijos** (una línea cada uno): `RISK:` · `ASSUMPTION:` · `BLOCKED:` · `CONFLICT:` · `DEFERRED:`.
|
|
25
|
+
- **Preguntas**: máximo 1 por turno y solo si bloquea o la acción es irreversible. Si no bloquea: asume y marca `ASSUMPTION:`.
|
|
26
|
+
- **Formato largo solo si** el usuario escribe `explica`, `detalla`, `justifica`, `compara`, `--verbose`, `why`, o el producto es un documento para terceros (ADR, README, informe, PR).
|
|
27
|
+
- **Nunca se comprimen**: avisos de seguridad, acciones irreversibles, secuencias donde el orden importa (migraciones, despliegues, rollback).
|
|
28
|
+
- **El razonamiento interno no se recorta.** Gasta tokens en pensar, auditar y escribir código; no en hablar.
|
|
29
|
+
Casos, ejemplos y nivel técnico del usuario: `~/.agents/rules/10-communication.md`.
|
|
30
|
+
|
|
31
|
+
## 3. Adaptación al stack — IMPORTANT
|
|
32
|
+
Al empezar en un repo: si existe `./STACK.md`, léelo antes de tocar nada (comandos, versiones, límites, módulos activos). Si no existe (o no hay `./AGENTS.md`), dilo en una línea y ofrece `kit-init` (prepara el proyecto entero) o `csr-stack` (solo la ficha). No inventes comandos de build/test: o están en `STACK.md`, o los verificas en el manifiesto (`package.json`, `pyproject.toml`, `Makefile`…), o preguntas.
|
|
33
|
+
|
|
34
|
+
## 4. Puerta de validez (Definition of Done) — YOU MUST
|
|
35
|
+
Ningún código es válido hasta pasar, en orden y sin saltos:
|
|
36
|
+
1. **Contexto**: código colindante y `STACK.md` leídos; convenciones respetadas.
|
|
37
|
+
2. **Diseño**: caso feliz, errores, límites, concurrencia y entrada hostil considerados.
|
|
38
|
+
3. **Implementación**: `~/.agents/rules/20-clean-code.md` + `~/.agents/rules/lang/<lenguaje>.md`.
|
|
39
|
+
4. **Autorrevisión adversarial**: `~/.agents/rules/50-done-gate.md` §4.
|
|
40
|
+
5. **Seguridad**: `~/.agents/rules/30-security.md` siempre; `31-security-audit.md` si toca entrada de usuario, auth, autorización, cripto, ficheros, red, SQL, deserialización, procesos, secretos o dependencias.
|
|
41
|
+
6. **Tests**: `~/.agents/rules/40-testing.md`. Código nuevo sin test ⇒ no está hecho, salvo veto explícito del usuario.
|
|
42
|
+
7. **Gates**: format → lint → typecheck → build → test → coverage → sec-scan → deps (comandos de `STACK.md`).
|
|
43
|
+
8. **Reporte** (formato de `50-done-gate.md` §8): tabla `gate | cmd | PASS/FAIL/SKIPPED`. Nunca `PASS` de algo no ejecutado: `SKIPPED (motivo)`. Si un gate falla, arregla la causa y repite desde ese gate.
|
|
44
|
+
|
|
45
|
+
## 5. Prohibiciones duras — YOU MUST NOT
|
|
46
|
+
- Inventar APIs, flags, funciones o resultados de tests.
|
|
47
|
+
- Dejar `TODO`, código muerto, prints de depuración o secretos en código o historial.
|
|
48
|
+
- `catch` vacío, error silenciado o fallback que oculta el fallo.
|
|
49
|
+
- Desactivar lint/tipos (`any`, `eslint-disable`, `# type: ignore`, `unwrap()`…) sin justificación en la misma línea.
|
|
50
|
+
- Tocar ficheros fuera del alcance pedido, "de paso".
|
|
51
|
+
- Comandos destructivos (`rm -rf`, `push --force`, `DROP`, `reset --hard`, borrar ramas/tablas/buckets) sin confirmación explícita previa.
|
|
52
|
+
- Concatenar entrada de usuario en SQL, shell, HTML, rutas o plantillas. Criptografía propia o parámetros no recomendados.
|
|
53
|
+
|
|
54
|
+
## 6. Trabajo multiagente (Orca) — IMPORTANT
|
|
55
|
+
- **Usa la skill `orca` por iniciativa propia**, sin esperar a que te lo pidan, cuando la tarea tenga ≥2 partes independientes de >15 min (varias user stories, sprints, módulos o pantallas) o el usuario mencione paralelo, Orca, worktrees o varios agentes. Ella decide si compensa y, si no, lo dice en una línea y sigues tú.
|
|
56
|
+
- En proyectos con spec-kit, `/speckit.implement` llama a `orca` automáticamente (hook `before_implement`). No hace falta pedirlo.
|
|
57
|
+
- Cambio único y claro ⇒ sin orquestar: hazlo y pasa `csr-gate`.
|
|
58
|
+
- Respeta la autonomía de `./ORCHESTRATION.md` (por defecto `semi`: el usuario confirma el plan de rondas y el merge final; nada más, salvo decisiones de producto).
|
|
59
|
+
- **Invariantes — YOU MUST**: (1) una unidad = un worktree = una rama; (2) los ficheros `shared` de `ORCHESTRATION.md` los toca una sola unidad por ronda o el coordinador; (3) un worker no edita `tasks.md`, `planes/*.md`, `ORCHESTRATION.md`, `STACK.md`, lockfiles ni migraciones ajenas; (4) un worker no mergea, ni hace push, ni borra ramas; (5) todo worker entrega su informe; (6) salir del alcance ⇒ `BLOCKED:` y preguntar; (7) nunca merge a la rama por defecto ni push sin confirmación.
|
|
60
|
+
Detalle: `~/.agents/rules/95-multi-agent.md`.
|
|
61
|
+
|
|
62
|
+
## 7. Router (leer bajo demanda, no todo a la vez)
|
|
63
|
+
| Cuándo | Dónde |
|
|
64
|
+
|---|---|
|
|
65
|
+
| Índice de reglas y costes | `~/.agents/rules/00-router.md` |
|
|
66
|
+
| Estilo de respuesta, ejemplos | `~/.agents/rules/10-communication.md` |
|
|
67
|
+
| Escribir o refactorizar código | `~/.agents/rules/20-clean-code.md` |
|
|
68
|
+
| Siempre que se escriba código | `~/.agents/rules/30-security.md` |
|
|
69
|
+
| Auditoría de vulnerabilidades | `~/.agents/rules/31-security-audit.md` |
|
|
70
|
+
| Tests | `~/.agents/rules/40-testing.md` |
|
|
71
|
+
| Cerrar tarea / "¿está hecho?" | `~/.agents/rules/50-done-gate.md` |
|
|
72
|
+
| Commits, ramas, PR | `~/.agents/rules/60-git-workflow.md` |
|
|
73
|
+
| Rendimiento | `~/.agents/rules/70-performance.md` |
|
|
74
|
+
| Errores, reintentos, logs, migraciones | `~/.agents/rules/75-reliability.md` |
|
|
75
|
+
| Dependencias, CI/CD | `~/.agents/rules/80-supply-chain.md` |
|
|
76
|
+
| Docs, comentarios, ADR | `~/.agents/rules/90-docs-comments.md` |
|
|
77
|
+
| Varios agentes, worktrees, Orca | `~/.agents/rules/95-multi-agent.md` |
|
|
78
|
+
| Lenguaje concreto | `~/.agents/rules/lang/<lenguaje>.md` |
|
|
79
|
+
| Skills | `kit-init` · `orca` · `csr-stack` · `csr-gate` · `csr-audit` · `speckit-orca-implement` (hook) |
|
|
80
|
+
Lee solo lo que la tarea exige. Leer de más también es desperdicio.
|
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 orca-multiagent-kit install`, o `npm install -g 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).
|