orca-multiagent-kit 1.2.0 → 1.4.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 +5 -2
- package/CHANGELOG.md +53 -1
- package/GUIA.html +34 -9
- package/README.md +13 -2
- package/VERSION +1 -1
- package/bin/omk.js +15 -9
- package/core/AGENTS.md +34 -31
- package/docs/CSR.md +95 -0
- package/docs/INSTALADOR-ORCA-WINDOWS.md +101 -0
- package/docs/MANUAL.md +15 -9
- package/docs/OLIMPO.md +409 -0
- package/docs/ORQUESTADOR.md +123 -0
- package/docs/PLUGIN-ORCA.md +103 -0
- package/install.sh +138 -20
- package/orca-plugin/.gitattributes +1 -0
- package/orca-plugin/README.md +12 -0
- package/orca-plugin/orca-plugin.json +80 -0
- package/orca-plugin/src/kit.test.ts +185 -0
- package/orca-plugin/src/kit.ts +141 -0
- package/orca-plugin/src/worker.test.ts +155 -0
- package/orca-plugin/src/worker.ts +182 -0
- package/orca-plugin/tsconfig.json +6 -0
- package/package.json +2 -2
- package/rules/00-router.md +2 -1
- package/rules/10-communication.md +11 -12
- package/rules/20-clean-code.md +7 -3
- package/rules/30-security.md +1 -1
- package/rules/31-security-audit.md +6 -2
- package/rules/32-ai-security.md +59 -0
- package/rules/40-testing.md +7 -0
- package/rules/50-done-gate.md +20 -17
- package/rules/60-git-workflow.md +1 -1
- package/rules/75-reliability.md +3 -3
- package/rules/80-supply-chain.md +18 -11
- package/rules/95-multi-agent.md +48 -19
- package/rules/lang/cpp.md +1 -1
- package/rules/lang/csharp.md +4 -4
- package/rules/lang/dart-flutter.md +1 -1
- package/rules/lang/infra.md +3 -4
- package/rules/lang/kotlin.md +1 -1
- package/rules/lang/php.md +1 -1
- package/rules/lang/shell.md +17 -1
- package/skills/csr-audit/SKILL.md +6 -5
- package/skills/csr-gate/SKILL.md +12 -8
- package/skills/csr-stack/SKILL.md +6 -3
- package/skills/kit-init/SKILL.md +4 -2
- package/skills/orca/SKILL.md +60 -24
- package/skills/orca/references/adapters/artifact.md +1 -1
- package/skills/orca/references/adapters/chat.md +1 -1
- package/skills/orca/references/adapters/native-plan.md +1 -1
- package/skills/orca/references/adapters/plan-file.md +1 -1
- package/skills/orca/references/adapters/speckit.md +3 -1
- package/skills/orca/references/engine-manual.md +10 -12
- package/skills/orca/references/engine-orca.md +69 -23
- package/skills/orca/references/engine-subagents.md +16 -4
- package/skills/orca/references/integrate.md +66 -15
- package/skills/orca/references/ledger.md +59 -0
- package/skills/orca/references/olimpo.md +92 -0
- package/skills/orca/references/race.md +1 -0
- package/skills/orca/references/setup.md +14 -7
- package/skills/orca/references/units.md +13 -1
- package/skills/orca/references/worker-contract.md +28 -11
- package/skills/speckit-orca-implement/SKILL.md +2 -0
- package/speckit-extension/orca/commands/implement.md +2 -0
- package/templates/.worktreeinclude +7 -3
- package/templates/ORCHESTRATION.md +31 -18
- package/templates/STACK.md +2 -2
- package/templates/models.md +29 -0
- package/templates/orca.yaml +10 -2
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
# Instalador en la app Orca y en Windows
|
|
2
|
+
|
|
3
|
+
Este documento explica qué fallaba al instalar el kit desde una terminal de Orca o desde Git Bash en Windows, qué cambia y cómo instalarlo ahora.
|
|
4
|
+
|
|
5
|
+
## Resumen
|
|
6
|
+
|
|
7
|
+
| Antes | Ahora |
|
|
8
|
+
|:--|:--|
|
|
9
|
+
| Dentro de Orca, el instalador escribía en el perfil de Claude que gestiona Orca | Detecta el perfil, instala en `~/.claude` (que el perfil importa) y no toca el perfil |
|
|
10
|
+
| Las rutas `C:\…` rompían los backups (`backups/<fecha>/C:/Users/…`) | Se normalizan a formato POSIX antes de usarlas |
|
|
11
|
+
| Git Bash copiaba en vez de enlazar, en silencio | Crea enlaces nativos de Windows o se para antes de tocar nada |
|
|
12
|
+
| Un backup de una ruta fuera de `$HOME` se restauraba dentro de `$HOME` | Se guarda bajo `_abs/` y vuelve a su sitio |
|
|
13
|
+
| `--restore` borraba cualquier enlace que encontrara en la ruta (también los tuyos) | Solo quita enlaces que apuntan a `~/.agents` |
|
|
14
|
+
| `--verify` decía «no enlaza» también cuando había una copia | Dice «es una copia» o «skills copiadas en vez de enlazadas», que es lo que hay que arreglar |
|
|
15
|
+
| `omk` podía usar el `bash` de WSL e instalar en Linux | Solo usa Git Bash (o el que indiques en `OMK_BASH`) |
|
|
16
|
+
| Las pruebas escribían en la configuración real si Orca había definido `CLAUDE_CONFIG_DIR` | Aíslan esas variables antes de empezar |
|
|
17
|
+
|
|
18
|
+
## El problema
|
|
19
|
+
|
|
20
|
+
### 1. Orca lanza Claude con un perfil propio
|
|
21
|
+
|
|
22
|
+
La app Orca arranca Claude Code con estas variables:
|
|
23
|
+
|
|
24
|
+
```
|
|
25
|
+
CLAUDE_CONFIG_DIR=C:\Users\<tú>\AppData\Roaming\orca\claude-profiles\<id>\home
|
|
26
|
+
ORCA_CLAUDE_INJECTED_CONFIG_DIR=<la misma ruta>
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
Ese directorio es de Orca. Su `CLAUDE.md` contiene una sola línea, `@~/.claude/CLAUDE.md`, y `skills/`, `rules/`, `output-styles/`… son enlaces a `~/.claude`. Es decir, el perfil **ya hereda** lo que haya en `~/.claude`.
|
|
30
|
+
|
|
31
|
+
El instalador usaba `CLAUDE_CONFIG_DIR` tal cual, así que desde una terminal de Orca:
|
|
32
|
+
- escribía el bloque `AGENTS` en el `CLAUDE.md` del perfil, que Orca puede regenerar;
|
|
33
|
+
- movía las reglas de CSR v1 a través de los enlaces del perfil (o sea, las de `~/.claude/rules`), con rutas de backup rotas (siguiente punto).
|
|
34
|
+
|
|
35
|
+
### 2. Rutas de Windows
|
|
36
|
+
|
|
37
|
+
`CLAUDE_CONFIG_DIR` llega como `C:\Users\…`, mientras que en Git Bash `$HOME` es `/c/Users/…`. El backup calculaba la ruta relativa con `${p#$HOME/}`, que no recortaba nada, y guardaba en `backups/<fecha>/C:/Users/…`. Después, `--restore` lo devolvía a `$HOME/C:/Users/…`, que no existe.
|
|
38
|
+
|
|
39
|
+
Lo mismo pasaba con cualquier ruta fuera de `$HOME` (`CLAUDE_CONFIG_DIR=/opt/claude`, `CODEX_HOME` en otro disco…).
|
|
40
|
+
|
|
41
|
+
### 3. `ln -s` en Git Bash copia
|
|
42
|
+
|
|
43
|
+
Por defecto, MSYS (Git Bash) no crea enlaces simbólicos: copia el fichero o la carpeta. El kit dejaba copias en `~/.claude/skills`, `~/.gemini/GEMINI.md`, etc. Funcionaba el primer día y divergía en cuanto actualizabas `~/.agents`, que es justo lo que el kit existe para evitar.
|
|
44
|
+
|
|
45
|
+
### 4. Las pruebas no estaban aisladas
|
|
46
|
+
|
|
47
|
+
`tests/test_install.sh` cambiaba `HOME` a una carpeta desechable, pero heredaba `CLAUDE_CONFIG_DIR`. Al ejecutarlo dentro de Orca, instalaba sobre la configuración real de Claude (perfil de Orca y, a través de sus enlaces, `~/.claude`). Esto pasó al preparar este cambio; se restauró desde el backup que había dejado el propio instalador.
|
|
48
|
+
|
|
49
|
+
## Qué cambia
|
|
50
|
+
|
|
51
|
+
`install.sh`:
|
|
52
|
+
- `to_posix()` normaliza `AGENT_KIT_HOME`, `CLAUDE_CONFIG_DIR`, `GEMINI_DIR`, `CODEX_HOME`, `--project` y `--adopt`. Usa `cygpath` (Git Bash, Cygwin) o `wslpath` (WSL) y, si no hay ninguno, una conversión mínima (`C:\a\b` → `/c/a/b`).
|
|
53
|
+
- **Perfil de Orca**: si `CLAUDE_CONFIG_DIR` está bajo `…/orca/claude-profiles/…` o coincide con `ORCA_CLAUDE_INJECTED_CONFIG_DIR`:
|
|
54
|
+
- si su `CLAUDE.md` importa `@~/.claude/CLAUDE.md`, instala en `~/.claude` y lo dice en una línea;
|
|
55
|
+
- si no lo importa, no toca Claude (el resto de agentes sí se instala), avisa y `--verify` lo marca `MAL`.
|
|
56
|
+
- **Enlaces en Windows**: en MSYS/Cygwin exporta `winsymlinks:nativestrict`. Antes de mover nada comprueba que puede crear un enlace; si no puede, se para con instrucciones. Si un enlace falla a mitad, el mensaje incluye el comando `--restore` de ese backup.
|
|
57
|
+
- **Backups**: las rutas de `$HOME` siguen igual (`backups/<fecha>/<ruta relativa>`), así que los backups antiguos se restauran como antes. Las de fuera van a `backups/<fecha>/_abs/<ruta absoluta>`.
|
|
58
|
+
- **`--restore`**: solo elimina directorios padre que sean enlaces a `~/.agents` (los que creó el kit). Si tu `~/.claude` es un enlace a tus dotfiles, se respeta.
|
|
59
|
+
- **`--verify`**: «… es una copia, no un enlace» (ficheros de reglas globales) y «skills copiadas en vez de enlazadas: …» (skills), separadas de las que faltan.
|
|
60
|
+
|
|
61
|
+
`bin/omk.js`: en Windows busca Git Bash en `%ProgramFiles%`, `%ProgramFiles(x86)%` y `%LOCALAPPDATA%\Programs` (instalación por usuario). Solo acepta el `bash` del `PATH` si `uname -s` es MINGW/MSYS/CYGWIN. El de WSL tiene otro `$HOME` y no entiende rutas `C:\`. `OMK_BASH` sigue mandando sobre todo.
|
|
62
|
+
|
|
63
|
+
`tests/`: las dos suites hacen `unset` de `CLAUDE_CONFIG_DIR CODEX_HOME GEMINI_DIR AGENT_KIT_HOME ORCA_CLAUDE_INJECTED_CONFIG_DIR`. Hay casos nuevos: perfil de Orca con y sin import, detección por `ORCA_CLAUDE_INJECTED_CONFIG_DIR`, ruta `C:\…` (solo si hay `cygpath`), backup y restauración fuera de `$HOME`, y copia detectada por `--verify`. `test_cli.sh` funciona también en Windows (binario de npm en `<prefix>/omk` y `$HOME` de Node en `USERPROFILE`).
|
|
64
|
+
|
|
65
|
+
## Cómo instalar ahora
|
|
66
|
+
|
|
67
|
+
**macOS, Linux, WSL**: sin cambios.
|
|
68
|
+
|
|
69
|
+
**Windows con Git Bash**, también desde una terminal de Orca:
|
|
70
|
+
|
|
71
|
+
1. Activa el *Modo de desarrollador* (Configuración → Sistema → Para programadores), o abre Git Bash como administrador. Solo hace falta para crear enlaces.
|
|
72
|
+
2. Instala:
|
|
73
|
+
```bash
|
|
74
|
+
./install.sh --dry-run # dentro de Orca, en «Para tu información»: «perfil de Orca detectado (…); se instala en ~/.claude»
|
|
75
|
+
./install.sh
|
|
76
|
+
./install.sh --verify
|
|
77
|
+
```
|
|
78
|
+
O con Node: `npx orca-multiagent-kit install`.
|
|
79
|
+
3. Abre una sesión nueva de Claude en Orca. El perfil importa `~/.claude/CLAUDE.md`, que a su vez importa `~/.agents/AGENTS.md`.
|
|
80
|
+
|
|
81
|
+
Si en el paso 2 sale «Este Windows no deja crear enlaces simbólicos», no se ha tocado nada: haz el paso 1 y repite.
|
|
82
|
+
|
|
83
|
+
## Cómo probarlo
|
|
84
|
+
|
|
85
|
+
```bash
|
|
86
|
+
bash scripts/check.sh
|
|
87
|
+
bash tests/test_install.sh # las secciones 10 a 13 son las nuevas
|
|
88
|
+
bash tests/test_cli.sh
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
A mano, dentro de Orca, sin riesgo (`--dry-run` no escribe):
|
|
92
|
+
```bash
|
|
93
|
+
./install.sh --dry-run | grep "perfil de Orca"
|
|
94
|
+
cat "$CLAUDE_CONFIG_DIR/CLAUDE.md" # debe seguir siendo @~/.claude/CLAUDE.md
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
## Riesgos y límites
|
|
98
|
+
|
|
99
|
+
- La detección del perfil se basa en la ruta `orca/claude-profiles` y en `ORCA_CLAUDE_INJECTED_CONFIG_DIR`. Si Orca cambia ese esquema, el instalador volvería a tratar el perfil como un `CLAUDE_CONFIG_DIR` normal. En ese caso, define `CLAUDE_CONFIG_DIR="$HOME/.claude"` antes de instalar.
|
|
100
|
+
- Si un enlace falla a mitad (por ejemplo, el disco destino no admite enlaces), lo ya movido está en el backup y el mensaje da el `--restore` exacto.
|
|
101
|
+
- La CI solo corre en Linux y macOS. Los casos de Windows (secciones 11 y 13 con enlaces nativos, `test_cli.sh` con el binario de npm en Windows) se han probado en Windows 11 con Git Bash, pero no en CI.
|
package/docs/MANUAL.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# Orca Multiagent Kit
|
|
1
|
+
# Orca Multiagent Kit — Una sola fuente de reglas y skills para todos tus agentes
|
|
2
2
|
|
|
3
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
4
|
|
|
@@ -62,7 +62,7 @@ orca-multiagent-kit/
|
|
|
62
62
|
├── speckit-extension/orca/ hook before_implement de spec-kit
|
|
63
63
|
├── output-styles/csr-minimal.md (estilo de salida de Claude Code)
|
|
64
64
|
└── templates/ AGENTS.md · CLAUDE.md · STACK.md · ORCHESTRATION.md · orca.yaml ·
|
|
65
|
-
.worktreeinclude · claude-settings.json
|
|
65
|
+
.worktreeinclude · claude-settings.json · models.md
|
|
66
66
|
```
|
|
67
67
|
|
|
68
68
|
---
|
|
@@ -91,12 +91,12 @@ Más opciones:
|
|
|
91
91
|
|
|
92
92
|
### Qué hace exactamente
|
|
93
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.
|
|
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. Crea `~/.agents/models.md` (qué modelo usa cada nivel en cada proveedor) solo si no existe; si ya lo tienes, tampoco lo toca.
|
|
95
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
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
97
|
5. **Codex / Copilot / Devin**: enlazan su fichero global de instrucciones al núcleo. Sus skills ya las leen desde `~/.agents/skills/`.
|
|
98
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`.
|
|
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`. Si un `.env` del proyecto parece de producción, lo desactiva en el `.worktreeinclude` nuevo y te lo deja como pendiente.
|
|
100
100
|
|
|
101
101
|
Reinstalar es idempotente: sirve también para actualizar después de editar el kit.
|
|
102
102
|
|
|
@@ -107,8 +107,8 @@ Reinstalar es idempotente: sirve también para actualizar después de editar el
|
|
|
107
107
|
Abre el agente en el repo y escribe **«inicializa el proyecto»** (skill `kit-init`). No hace falta terminal ni el instalador:
|
|
108
108
|
1. Crea o migra `AGENTS.md` (con tus overrides del CSR antiguo) y deja `CLAUDE.md` como `@AGENTS.md`.
|
|
109
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` (
|
|
111
|
-
4. Te hace como máximo 4 preguntas en una tanda (lo que no se puede deducir: nivel ASVS,
|
|
110
|
+
3. Prepara la orquestación: `ORCHESTRATION.md` (nivel de autonomía, proveedores activos, dominios sensibles y el setup real de cada worktree), `orca.yaml`, `.worktreeinclude`, `.work/` en `.gitignore` y, si hay spec-kit, el hook `before_implement`. Si a `~/.agents/models.md` le falta un proveedor activo, clasifica sus modelos en niveles y lo rellena.
|
|
111
|
+
4. Te hace como máximo 4 preguntas en una tanda (lo que no se puede deducir: nivel ASVS, proveedores activos…) y propone el commit.
|
|
112
112
|
|
|
113
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
114
|
|
|
@@ -129,7 +129,9 @@ Igual que antes; lo único que cambia es dónde vive cada cosa.
|
|
|
129
129
|
| Cerrar una tarea | «pasa los gates» (`csr-gate`) |
|
|
130
130
|
| Antes de publicar o tocar algo sensible | «audita la seguridad» (`csr-audit`) |
|
|
131
131
|
|
|
132
|
-
**Autonomía** (`ORCHESTRATION.md` §0): `semi` por defecto. Confirmas el plan de rondas (autoriza los commits del run en ramas de trabajo)
|
|
132
|
+
**Autonomía** (`ORCHESTRATION.md` §0): `semi` por defecto. Confirmas el plan de rondas (autoriza los commits del run en ramas de trabajo), el merge final y la limpieza de worktrees y ramas; en medio solo te interrumpe por decisiones de producto. `manual` confirma cada ronda; `auto`, solo el merge final y la limpieza. Nunca hay merge a la rama por defecto, push ni borrado de worktrees o ramas sin confirmación.
|
|
133
|
+
|
|
134
|
+
**Roles y modelos** ([`OLIMPO.md`](OLIMPO.md)): cada unidad lleva un rol y un nivel de modelo (`alto`, `medio`, `bajo`). El modelo concreto de cada nivel y proveedor está en `~/.agents/models.md`, que es tuyo: el instalador lo crea si falta y no lo sobrescribe. Para cambiar qué modelo usa un nivel, edita ese fichero; no hay que reinstalar.
|
|
133
135
|
|
|
134
136
|
El detalle está en `skills/orca/SKILL.md` y sus `references/`, y en `rules/95-multi-agent.md`.
|
|
135
137
|
|
|
@@ -141,6 +143,7 @@ El detalle está en `skills/orca/SKILL.md` y sus `references/`, y en `rules/95-m
|
|
|
141
143
|
|---|---|---|
|
|
142
144
|
| Una regla global (todos los agentes) | `~/Documents/orca-multiagent-kit/core/AGENTS.md` o `rules/…` | `./install.sh` |
|
|
143
145
|
| Una regla solo tuya que el kit no debe pisar | `~/.agents/rules/personal.md` | nada: el núcleo lo lee |
|
|
146
|
+
| Qué modelo usa cada nivel en cada proveedor | `~/.agents/models.md` | nada: `orca` lo lee en cada run |
|
|
144
147
|
| Una skill | `~/Documents/orca-multiagent-kit/skills/<skill>/` | `./install.sh` |
|
|
145
148
|
| Reglas de un proyecto | `AGENTS.md` del proyecto, sección *Overrides* | nada |
|
|
146
149
|
|
|
@@ -171,7 +174,10 @@ Puedes editar directamente en `~/.agents/`, pero la próxima reinstalación lo s
|
|
|
171
174
|
- **Devin** lee también `~/.claude/CLAUDE.md`. Por eso es opcional.
|
|
172
175
|
- **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
176
|
- **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
|
-
- **
|
|
177
|
+
- **Windows (Git Bash)**: el kit necesita enlaces simbólicos nativos. Activa el *Modo de desarrollador* (Configuración → Sistema → Para programadores) o abre Git Bash como administrador. Si no se pueden crear, el instalador se para antes de tocar nada; nunca deja copias. Detalle en [`INSTALADOR-ORCA-WINDOWS.md`](INSTALADOR-ORCA-WINDOWS.md).
|
|
178
|
+
- **Claude dentro de la app Orca**: Orca lanza Claude con un perfil propio (`CLAUDE_CONFIG_DIR=…/orca/claude-profiles/<id>/home`) que importa `~/.claude/CLAUDE.md`. El instalador lo detecta, instala en `~/.claude` y no toca el perfil, así que puedes ejecutarlo desde una terminal de Orca.
|
|
179
|
+
- **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. Las copias se borran con el worktree, en la limpieza que el coordinador te pide confirmar al cerrar cada run.
|
|
180
|
+
- **Worktrees de runs antiguos**: si quedan worktrees o ramas de un run que no se limpió, di «limpia el run». El agente enseña el inventario y borra solo lo integrado y sin cambios pendientes, tras tu «sí».
|
|
175
181
|
|
|
176
182
|
---
|
|
177
183
|
|
|
@@ -192,7 +198,7 @@ Puedes editar directamente en `~/.agents/`, pero la próxima reinstalación lo s
|
|
|
192
198
|
|
|
193
199
|
```bash
|
|
194
200
|
./install.sh --restore <fecha-del-primer-backup> # vuelve al estado anterior
|
|
195
|
-
rm -rf ~/.agents/AGENTS.md ~/.agents/rules ~/.agents/templates ~/.agents/output-styles
|
|
201
|
+
rm -rf ~/.agents/AGENTS.md ~/.agents/rules ~/.agents/templates ~/.agents/output-styles ~/.agents/models.md
|
|
196
202
|
rm -rf ~/.agents/skills/csr-* ~/.agents/skills/orca ~/.agents/skills/kit-init ~/.agents/skills/speckit-orca-implement ~/.agents/speckit-ext
|
|
197
203
|
```
|
|
198
204
|
|
package/docs/OLIMPO.md
ADDED
|
@@ -0,0 +1,409 @@
|
|
|
1
|
+
# Olimpo: roles, modelos y worktrees en la orquestación
|
|
2
|
+
|
|
3
|
+
Este documento explica qué añade Olimpo a la skill `orca` y de dónde sale. Tiene dos partes: **cómo lo usa el kit** (lo que cambia en tu día a día) y **el equipo de origen** (las 24 fichas que inspiran los roles). Los agentes no leen este fichero: su versión operativa es `skills/orca/references/olimpo.md`.
|
|
4
|
+
|
|
5
|
+
## Cómo lo usa el kit
|
|
6
|
+
|
|
7
|
+
### Una sola cadena de decisión
|
|
8
|
+
|
|
9
|
+
```text
|
|
10
|
+
unidad ──► rol ──► nivel (alto | medio | bajo) ──► modelo del proveedor
|
|
11
|
+
olimpo.md ~/.agents/models.md
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
| Quién decide | Qué decide | Dónde |
|
|
15
|
+
|---|---|---|
|
|
16
|
+
| El kit | Qué rol hace cada tipo de trabajo, qué nivel exige y quién lo revisa | `skills/orca/references/olimpo.md` |
|
|
17
|
+
| Tú, una vez por máquina | Qué modelo es cada nivel en cada proveedor | `~/.agents/models.md` |
|
|
18
|
+
| Cada proyecto | Proveedores activos, dominios sensibles y excepciones | `ORCHESTRATION.md` §1 |
|
|
19
|
+
|
|
20
|
+
Ningún fichero del kit ni del proyecto nombra un modelo, así que no hay nada que actualizar cuando sale uno nuevo.
|
|
21
|
+
|
|
22
|
+
### Niveles de modelo
|
|
23
|
+
|
|
24
|
+
| Nivel | Trabajo | Ejemplo con Claude |
|
|
25
|
+
|---|---|---|
|
|
26
|
+
| `alto` | Arquitectura estructural, seguridad, normativa, revisiones críticas y código de dinero, fiscal, tenancy y auth | `opus` |
|
|
27
|
+
| `medio` | Implementación general, ADR técnicos, investigación técnica, tests e infraestructura | `sonnet` |
|
|
28
|
+
| `bajo` | Tareas mecánicas: tableros, índices, plantillas, formateo, enlaces y extracción | `haiku` |
|
|
29
|
+
|
|
30
|
+
Claude usa alias, que apuntan solos al modelo vigente. Para un proveedor sin alias (Antigravity, con `agy models`), la skill consulta su lista de modelos al empezar cada run:
|
|
31
|
+
|
|
32
|
+
- Si la lista no ha cambiado, usa la asignación guardada sin preguntar.
|
|
33
|
+
- Si aparece una versión nueva de una familia que ya tiene nivel, entra sola.
|
|
34
|
+
- Si aparece una familia nueva, el coordinador la clasifica él mismo con evidencia (los alias de nivel y el changelog del proveedor, documentación pública) y comprueba que tu cuenta puede usarla. Te lo dice en una línea del plan de rondas; no te lo pregunta. Si no encuentra evidencia, la deja en `medio`.
|
|
35
|
+
- Si desaparece el modelo de un nivel, avisa y lanza esas unidades con el modelo por defecto del proveedor. Las de nivel `alto` van a otro proveedor.
|
|
36
|
+
|
|
37
|
+
### De las 24 fichas a los roles
|
|
38
|
+
|
|
39
|
+
Doce fichas son roles de agente. Cinco se funden en otro rol porque el trabajo es el mismo. Siete no son agentes: representan decisiones que te corresponden a ti.
|
|
40
|
+
|
|
41
|
+
| Destino | Fichas |
|
|
42
|
+
|---|---|
|
|
43
|
+
| Rol propio | Hefesto (coordinación), Dédalo (arquitectura), Casandra (seguridad), Temis (normativa), Ariadna (código sensible), Perséfone (datos), Proteo (implementación), Narciso (interfaz), Ícaro (integraciones), Argos (verificación), Atlas (plataforma), Clío (mecánico) |
|
|
44
|
+
| Fundida en otro rol | Iris y Afrodita → Narciso · Prometeo → Atlas · Mnemósine → Perséfone · Penélope → Clío |
|
|
45
|
+
| Decisión del usuario | Atenea, Hermes, Apolo, Hestia, Odiseo, Asclepio, Néstor |
|
|
46
|
+
|
|
47
|
+
Las carencias de cada ficha no se interpretan: se convierten en un guardarraíl. Ícaro va deprisa y se salta casos límite, así que nunca toca código sensible y Argos repite su verificación. A Casandra se la ignora, así que sus hallazgos altos bloquean el merge. Hefesto acapara lo difícil, así que el coordinador está obligado a delegar las unidades medianas.
|
|
48
|
+
|
|
49
|
+
Si tu proyecto necesita un rol que el kit no trae (por ejemplo, separar a Iris de Narciso, o una Temis con la normativa fiscal concreta), añádelo en `ORCHESTRATION.md` §1.
|
|
50
|
+
|
|
51
|
+
### Qué recurso usa cada unidad
|
|
52
|
+
|
|
53
|
+
El recurso se decide unidad a unidad, y un run puede mezclar varios.
|
|
54
|
+
|
|
55
|
+
| La unidad… | Recurso |
|
|
56
|
+
|---|---|
|
|
57
|
+
| Es pequeña o es la única | El propio coordinador |
|
|
58
|
+
| No escribe (investigar, auditar, revisar) | Subagente de solo lectura, sin worktree |
|
|
59
|
+
| La hace otro proveedor o es una revisión cruzada | Worker de Orca, con worktree propio |
|
|
60
|
+
| Escribe y la hace el mismo proveedor que coordina | Subagente con worktree propio |
|
|
61
|
+
| No hay Orca ni subagentes | Worktree a mano y un brief para que abras tú el agente |
|
|
62
|
+
|
|
63
|
+
El plan de rondas enseña el rol, el nivel, el modelo y el recurso de cada unidad antes de que digas «sí».
|
|
64
|
+
|
|
65
|
+
### Ciclo de vida de un worktree
|
|
66
|
+
|
|
67
|
+
1. **Base fresca.** Antes de planificar, `git fetch` y comparación de la rama padre con `origin`. Si la local va por detrás, se parte de `origin`; si tiene commits sin subir, se te pregunta. La comprobación se repite antes del merge final.
|
|
68
|
+
2. **Entorno listo.** Cada worktree recibe sus dependencias y los `.env` de desarrollo de `.worktreeinclude`. El worker comprueba que el entorno arranca antes de editar; si no, se para con `BLOCKED: entorno`.
|
|
69
|
+
3. **Limpieza con permiso.** Tras el merge final, el coordinador enseña qué worktrees, ramas y copias de `.env` han quedado, y los borra solo con tu «sí». Lo que no está integrado o tiene cambios sin guardar no entra en ese «sí». Si dices que no, lo recuerda en el siguiente run.
|
|
70
|
+
|
|
71
|
+
## El equipo de origen: Olimpia Software
|
|
72
|
+
|
|
73
|
+
Lo que sigue es el documento original del equipo, sin cambios. Es un equipo ficticio de un ERP; sus nombres, relaciones y tensiones son la fuente de los roles y guardarraíles de arriba.
|
|
74
|
+
|
|
75
|
+
## La empresa y el equipo
|
|
76
|
+
|
|
77
|
+
Olimpia Software es una empresa ficticia de 140 empleados que desarrolla **Égida**, un ERP en la nube para pymes: facturación, contabilidad, inventario, RRHH y CRM. Este documento recoge a 24 personas: la dirección de producto y tecnología, el equipo de producto de Facturación y Contabilidad al completo, y los perfiles transversales que trabajan con él.
|
|
78
|
+
|
|
79
|
+
Todos los nombres vienen de la mitología griega y no son casuales: cada ficha explica por qué le pega.
|
|
80
|
+
|
|
81
|
+
| Nombre | Rol | Grupo | Reporta a |
|
|
82
|
+
| --- | --- | --- | --- |
|
|
83
|
+
| Atenea | CTO | Dirección | CEO |
|
|
84
|
+
| Hermes | Head of Product | Dirección | CEO |
|
|
85
|
+
| Apolo | Head of Design | Dirección | Hermes |
|
|
86
|
+
| Hestia | Engineering Manager | Facturación | Atenea |
|
|
87
|
+
| Odiseo | Product Manager | Facturación | Hermes |
|
|
88
|
+
| Afrodita | Diseñadora UX/UI | Facturación | Apolo |
|
|
89
|
+
| Hefesto | Tech Lead | Facturación | Hestia |
|
|
90
|
+
| Ariadna | Backend senior | Facturación | Hestia |
|
|
91
|
+
| Perséfone | Backend | Facturación | Hestia |
|
|
92
|
+
| Ícaro | Backend junior | Facturación | Hestia |
|
|
93
|
+
| Narciso | Frontend senior | Facturación | Hestia |
|
|
94
|
+
| Iris | Frontend | Facturación | Hestia |
|
|
95
|
+
| Proteo | Full-stack | Facturación | Hestia |
|
|
96
|
+
| Argos | QA / SDET | Facturación | Hestia |
|
|
97
|
+
| Dédalo | Principal Engineer / Arquitecto | Transversal | Atenea |
|
|
98
|
+
| Atlas | SRE | Plataforma | Atenea |
|
|
99
|
+
| Prometeo | Ingeniero de plataforma / DevOps | Plataforma | Atenea |
|
|
100
|
+
| Casandra | Ingeniera de seguridad | Transversal | Atenea |
|
|
101
|
+
| Mnemósine | Ingeniera de datos | Transversal | Atenea |
|
|
102
|
+
| Temis | Experta de dominio fiscal y legal | Transversal | Hermes |
|
|
103
|
+
| Penélope | Agile Coach / Delivery Manager | Transversal | Atenea |
|
|
104
|
+
| Clío | Redactora técnica | Transversal | Hermes |
|
|
105
|
+
| Asclepio | Soporte técnico nivel 3 | Soporte | Director de Soporte |
|
|
106
|
+
| Néstor | Customer Success Manager | Negocio | Director Comercial |
|
|
107
|
+
|
|
108
|
+
## Dirección
|
|
109
|
+
|
|
110
|
+
### Atenea · CTO
|
|
111
|
+
|
|
112
|
+
- **Edad y antigüedad:** 47 años, en Olimpia desde la fundación (9 años).
|
|
113
|
+
- **Trayectoria:** Ingeniera informática. Doce años en una gran consultora haciendo implantaciones de SAP, harta de ver ERP imposibles de usar. Cofundó la empresa y escribió la primera versión de Égida casi sola.
|
|
114
|
+
- **Fortalezas:** Visión estratégica clara y calmada. Sabe traducir decisiones técnicas a lenguaje de negocio delante del consejo. Contrata muy bien.
|
|
115
|
+
- **Carencias:** Le cuesta soltar el producto que creó: a veces entra en decisiones técnicas de detalle que ya no le tocan. Poco paciente con quien no prepara las reuniones.
|
|
116
|
+
- **Fuera de su ámbito:** Entiende las finanzas de la empresa casi como el director financiero. Es una negociadora excelente con proveedores de nube.
|
|
117
|
+
- **Cómo trabaja:** Agenda bloqueada por las mañanas para pensar. Decide con documentos escritos, no con presentaciones.
|
|
118
|
+
- **Relaciones:** Confianza total en Dédalo, que fue su primer fichaje. Discute a menudo con Hermes sobre prioridades, pero se respetan.
|
|
119
|
+
- **Por qué Atenea:** Diosa de la sabiduría y la estrategia. Nació ya armada de la cabeza de Zeus, como Égida nació de la suya.
|
|
120
|
+
|
|
121
|
+
### Hermes · Head of Product
|
|
122
|
+
|
|
123
|
+
- **Edad y antigüedad:** 39 años, 5 años en la empresa.
|
|
124
|
+
- **Trayectoria:** Empezó en ventas de software B2B, pasó a gestión de producto en una fintech y llegó a Olimpia como primer PM. Ahora dirige a cinco product managers.
|
|
125
|
+
- **Fortalezas:** Comunicador brillante: convence a clientes, inversores y equipos. Conoce el mercado y a la competencia al detalle.
|
|
126
|
+
- **Carencias:** Promete fechas antes de consultarlas con ingeniería. Cambia de prioridad demasiado rápido cuando un cliente grande presiona.
|
|
127
|
+
- **Fuera de su ámbito:** Cierra ventas mejor que muchos comerciales; el equipo comercial le llama para las demos difíciles. Habla inglés, francés y portugués.
|
|
128
|
+
- **Cómo trabaja:** Siempre en movimiento, entre reuniones y viajes. Responde mensajes a cualquier hora, lo que genera expectativas poco sanas.
|
|
129
|
+
- **Relaciones:** Mentor de Odiseo. Tensión habitual con Atenea y Hestia por los compromisos de fechas.
|
|
130
|
+
- **Por qué Hermes:** Mensajero de los dioses y patrón del comercio. También de los que hablan rápido.
|
|
131
|
+
|
|
132
|
+
### Apolo · Head of Design
|
|
133
|
+
|
|
134
|
+
- **Edad y antigüedad:** 42 años, 4 años en la empresa.
|
|
135
|
+
- **Trayectoria:** Bellas Artes y después diseño de interacción. Trabajó en agencias y en una empresa de software de gestión hospitalaria. Creó el sistema de diseño de Égida desde cero.
|
|
136
|
+
- **Fortalezas:** Criterio estético impecable y defensa firme de la investigación con usuarios. Ha subido el nivel de diseño de toda la empresa.
|
|
137
|
+
- **Carencias:** Algo elitista: le cuesta aceptar diseños “suficientemente buenos”. Poco interesado en las métricas de negocio.
|
|
138
|
+
- **Fuera de su ámbito:** Escribe muy bien y da charlas en conferencias; es la cara pública de la empresa en eventos de diseño. Toca el piano.
|
|
139
|
+
- **Cómo trabaja:** Revisiones de diseño semanales muy exigentes y muy formativas.
|
|
140
|
+
- **Relaciones:** Protector con Afrodita, a quien contrató. Choca con Narciso, que cree saber de diseño tanto como él.
|
|
141
|
+
- **Por qué Apolo:** Dios de las artes, la armonía y la belleza ordenada.
|
|
142
|
+
|
|
143
|
+
## Equipo de Facturación y Contabilidad
|
|
144
|
+
|
|
145
|
+
Es el equipo más crítico de Égida: si una factura sale mal, el cliente tiene un problema con Hacienda. Once personas, todas a tiempo completo en este dominio.
|
|
146
|
+
|
|
147
|
+
### Hestia · Engineering Manager
|
|
148
|
+
|
|
149
|
+
- **Edad y antigüedad:** 41 años, 6 años en la empresa.
|
|
150
|
+
- **Trayectoria:** Ocho años como desarrolladora backend, los tres últimos aquí. Pasó a gestión cuando el equipo creció y nadie quería el puesto.
|
|
151
|
+
- **Fortalezas:** Escucha de verdad y detecta antes que nadie a quien está quemado. Protege al equipo de interrupciones de dirección. Muy buena contratando.
|
|
152
|
+
- **Carencias:** Suaviza tanto el feedback negativo que a veces no llega. Lleva tres años sin programar y sus estimaciones se han vuelto optimistas.
|
|
153
|
+
- **Fuera de su ámbito:** Mediadora natural; otros managers le piden ayuda con conflictos. Organiza las cenas y nunca olvida un cumpleaños.
|
|
154
|
+
- **Cómo trabaja:** Reuniones 1:1 semanales sagradas. Prefiere resolver en persona antes que por mensaje.
|
|
155
|
+
- **Relaciones:** Alianza fuerte con Penélope. Le preocupa la dependencia del equipo de Hefesto.
|
|
156
|
+
- **Por qué Hestia:** Diosa del hogar y del fuego que lo mantiene vivo. Cuida la casa y no busca protagonismo.
|
|
157
|
+
|
|
158
|
+
### Odiseo · Product Manager
|
|
159
|
+
|
|
160
|
+
- **Edad y antigüedad:** 35 años, 3 años en la empresa.
|
|
161
|
+
- **Trayectoria:** Consultoría de procesos financieros y luego analista de negocio. Hermes lo fichó y lo formó como PM.
|
|
162
|
+
- **Fortalezas:** Ingenioso para encontrar soluciones intermedias que contentan a todos. Habla con clientes cada semana y trae datos reales. Sabe decir no a ventas sin crear enemigos.
|
|
163
|
+
- **Carencias:** Se enamora de las ideas grandes y escribe historias de usuario vagas que hay que perseguir para concretar. Sus planes suelen tardar el doble de lo previsto.
|
|
164
|
+
- **Fuera de su ámbito:** Maneja Excel y SQL mejor que algunos desarrolladores. Presenta de maravilla delante de dirección.
|
|
165
|
+
- **Cómo trabaja:** Documentos de producto largos y narrativos. Muchas llamadas con clientes, pocas reuniones internas.
|
|
166
|
+
- **Relaciones:** Tándem estrecho con Temis. Afrodita le pide más tiempo para investigar y él no siempre se lo da.
|
|
167
|
+
- **Por qué Odiseo:** El astuto, el de las mil tretas. Y sus viajes siempre duran más de lo planeado.
|
|
168
|
+
|
|
169
|
+
### Afrodita · Diseñadora UX/UI
|
|
170
|
+
|
|
171
|
+
- **Edad y antigüedad:** 29 años, 2 años en la empresa.
|
|
172
|
+
- **Trayectoria:** Grado en Diseño y máster en UX. Trabajó en una app de banca móvil antes de llegar aquí.
|
|
173
|
+
- **Fortalezas:** Obsesionada con la eficiencia: rediseñó la creación de facturas y redujo los clics a la mitad. Prueba con usuarios reales, no con suposiciones. Interfaces que la gente disfruta usando.
|
|
174
|
+
- **Carencias:** Diseña cosas técnicamente carísimas sin consultar antes, y le frustra cuando se recortan. Le cuesta aceptar críticas en público.
|
|
175
|
+
- **Fuera de su ámbito:** Sabe HTML y CSS y a veces corrige detalles visuales en el código. Escribe muy bien: los textos de la interfaz son suyos.
|
|
176
|
+
- **Cómo trabaja:** Prototipos rápidos en Figma, muchas iteraciones, entrevistas grabadas con usuarios.
|
|
177
|
+
- **Relaciones:** Buena sintonía con Iris. Choques frecuentes con Narciso por los detalles visuales.
|
|
178
|
+
- **Por qué Afrodita:** Diosa de la belleza y del deseo: hace que la gente quiera usar un software de contabilidad.
|
|
179
|
+
|
|
180
|
+
### Hefesto · Tech Lead
|
|
181
|
+
|
|
182
|
+
- **Edad y antigüedad:** 38 años, 7 años en la empresa.
|
|
183
|
+
- **Trayectoria:** FP de Informática, autodidacta en todo lo demás. Lleva aquí desde la primera versión del módulo de facturación.
|
|
184
|
+
- **Fortalezas:** Conoce el sistema entero, incluido el código heredado que nadie quiere tocar. Sus revisiones de código son exigentes pero enseñan. Construye cosas que duran.
|
|
185
|
+
- **Carencias:** Acapara las tareas difíciles porque las hace más rápido, lo que frena a los demás. Mal delegador. Poco hábil en reuniones con dirección.
|
|
186
|
+
- **Fuera de su ámbito:** Entiende de infraestructura mejor que algunos de plataforma; Atlas le consulta. Toca la batería en un grupo los fines de semana.
|
|
187
|
+
- **Cómo trabaja:** Silencioso, con cascos, horas de concentración. Responde tarde a los mensajes pero bien.
|
|
188
|
+
- **Relaciones:** Mentor de Ícaro y Ariadna. Discusiones técnicas largas con Dédalo.
|
|
189
|
+
- **Por qué Hefesto:** El herrero de los dioses, que forjaba en su taller las armas del Olimpo. Poco dado a los banquetes.
|
|
190
|
+
|
|
191
|
+
### Ariadna · Desarrolladora backend senior
|
|
192
|
+
|
|
193
|
+
- **Edad y antigüedad:** 33 años, 4 años en la empresa.
|
|
194
|
+
- **Trayectoria:** Estudió ADE, trabajó dos años en una gestoría y se pasó a la programación con un máster.
|
|
195
|
+
- **Fortalezas:** La más rigurosa con los cálculos: redondeos, impuestos, divisas. Sus tests cubren casos que nadie imagina. Capaz de seguir el hilo de cualquier error hasta su origen.
|
|
196
|
+
- **Carencias:** Perfeccionista: le cuesta dar algo por terminado y a veces sobrediseña. Poco visible; no vende su trabajo.
|
|
197
|
+
- **Fuera de su ámbito:** Entiende la contabilidad casi como Temis. Redacta la mejor documentación técnica del equipo.
|
|
198
|
+
- **Cómo trabaja:** Metódica, con notas detalladas de cada investigación. Pide tiempo para hacer las cosas bien.
|
|
199
|
+
- **Relaciones:** Candidata natural a Tech Lead si Hefesto se va, aunque ella no lo busca. Paciente con Ícaro.
|
|
200
|
+
- **Por qué Ariadna:** Le dio a Teseo el hilo para salir del laberinto. Ella encuentra la salida de cualquier bug.
|
|
201
|
+
|
|
202
|
+
### Perséfone · Desarrolladora backend
|
|
203
|
+
|
|
204
|
+
- **Edad y antigüedad:** 31 años, 3 años en la empresa.
|
|
205
|
+
- **Trayectoria:** Ingeniería informática. Antes trabajó en una empresa de logística manteniendo sistemas antiguos.
|
|
206
|
+
- **Fortalezas:** Especialista en migraciones y en el código legado. Paciencia infinita con sistemas viejos. Fiable con los procesos de cierre contable.
|
|
207
|
+
- **Carencias:** Poco entusiasta con tecnologías nuevas. Divide su energía: muy productiva en temporadas y apagada en otras.
|
|
208
|
+
- **Fuera de su ámbito:** Gran conocimiento de bases de datos; hace las veces de DBA del equipo. Cultiva un huerto y reparte tomates en verano.
|
|
209
|
+
- **Cómo trabaja:** Prefiere tareas largas y profundas a muchas pequeñas.
|
|
210
|
+
- **Relaciones:** Colabora mucho con Mnemósine. Se lleva bien con todos sin ser el centro de nada.
|
|
211
|
+
- **Por qué Perséfone:** Reina del inframundo la mitad del año: ella vive en las profundidades del código antiguo, y su ritmo va por estaciones.
|
|
212
|
+
|
|
213
|
+
### Ícaro · Desarrollador backend junior
|
|
214
|
+
|
|
215
|
+
- **Edad y antigüedad:** 24 años, 1 año en la empresa.
|
|
216
|
+
- **Trayectoria:** Ciclo de DAW y un año en una startup que cerró. Muchos proyectos personales.
|
|
217
|
+
- **Fortalezas:** Rapidísimo y con ganas de todo. Siempre se ofrece para las integraciones con bancos y APIs externas. Automatiza tareas repetitivas con scripts.
|
|
218
|
+
- **Carencias:** Va tan deprisa que se salta casos límite. Subestima las tareas y se resiste a pedir ayuda. Ya ha provocado una incidencia en producción.
|
|
219
|
+
- **Fuera de su ámbito:** Sabe algo de frontend, móvil y despliegues. Es el que explica a los demás las novedades de herramientas de IA.
|
|
220
|
+
- **Cómo trabaja:** Muchos commits pequeños, a cualquier hora. Le aburren las reuniones.
|
|
221
|
+
- **Relaciones:** Tensión constante con Argos. Hefesto le corrige mucho y él lo vive como freno.
|
|
222
|
+
- **Por qué Ícaro:** Voló demasiado cerca del sol con alas de cera. El talento está; falta medir la altura.
|
|
223
|
+
|
|
224
|
+
### Narciso · Desarrollador frontend senior
|
|
225
|
+
|
|
226
|
+
- **Edad y antigüedad:** 36 años, 5 años en la empresa.
|
|
227
|
+
- **Trayectoria:** Ingeniería de telecomunicaciones, después frontend en un medio digital grande.
|
|
228
|
+
- **Fortalezas:** Experto en interfaces con muchos datos: tablas enormes, filtros, rendimiento. Muy cuidadoso con la accesibilidad. Código impecable.
|
|
229
|
+
- **Carencias:** Muy seguro de su criterio y poco abierto a otras opiniones. Desconfía de cada librería nueva. Le cuesta colaborar con diseño.
|
|
230
|
+
- **Fuera de su ámbito:** Fotógrafo aficionado con buen ojo visual; detecta fallos de diseño antes que la propia diseñadora, lo que genera tensión.
|
|
231
|
+
- **Cómo trabaja:** Revisa su propio código una y otra vez antes de enviarlo. Pocas entregas, todas pulidas.
|
|
232
|
+
- **Relaciones:** Mentor exigente de Iris. Fricciones con Afrodita y con Apolo.
|
|
233
|
+
- **Por qué Narciso:** Enamorado de su propio reflejo. En su caso, del de su código.
|
|
234
|
+
|
|
235
|
+
### Iris · Desarrolladora frontend
|
|
236
|
+
|
|
237
|
+
- **Edad y antigüedad:** 27 años, 2 años en la empresa.
|
|
238
|
+
- **Trayectoria:** Grado en Multimedia. Empezó como diseñadora web y se pasó al desarrollo.
|
|
239
|
+
- **Fortalezas:** Puente entre diseño y desarrollo: entiende a Afrodita y a Narciso. Domina el sistema de diseño y los componentes visuales. Muy colaboradora.
|
|
240
|
+
- **Carencias:** Insegura con la lógica compleja del frontend. Evita el conflicto aunque tenga razón.
|
|
241
|
+
- **Fuera de su ámbito:** Hace ilustraciones e iconos; varios de los de Égida son suyos. Muy buena con animaciones sutiles.
|
|
242
|
+
- **Cómo trabaja:** Pregunta mucho, comparte avances pronto, trabaja bien en pareja.
|
|
243
|
+
- **Relaciones:** Mediadora involuntaria entre Afrodita y Narciso.
|
|
244
|
+
- **Por qué Iris:** Diosa del arcoíris y mensajera entre el cielo y la tierra. Ella traduce entre diseño y código.
|
|
245
|
+
|
|
246
|
+
### Proteo · Desarrollador full-stack
|
|
247
|
+
|
|
248
|
+
- **Edad y antigüedad:** 30 años, 3 años en la empresa.
|
|
249
|
+
- **Trayectoria:** Ingeniería informática y cuatro años en consultoras saltando de proyecto en proyecto.
|
|
250
|
+
- **Fortalezas:** Cubre backend o frontend según haga falta. Entiende el problema de negocio antes de programar. Se adapta a cualquier tarea.
|
|
251
|
+
- **Carencias:** No destaca en nada concreto y a veces siente que no tiene especialidad. Se dispersa con demasiadas tareas a la vez.
|
|
252
|
+
- **Fuera de su ámbito:** Explica temas técnicos a gente no técnica mejor que nadie; Odiseo lo lleva a reuniones con clientes.
|
|
253
|
+
- **Cómo trabaja:** Coge lo que nadie coge. Suele tener tres tareas abiertas a la vez.
|
|
254
|
+
- **Relaciones:** Buen amigo de Ícaro, al que frena un poco. Todo el equipo le pide favores.
|
|
255
|
+
- **Por qué Proteo:** Dios marino que cambiaba de forma a voluntad.
|
|
256
|
+
|
|
257
|
+
### Argos · QA / SDET
|
|
258
|
+
|
|
259
|
+
- **Edad y antigüedad:** 32 años, 4 años en la empresa.
|
|
260
|
+
- **Trayectoria:** Empezó haciendo pruebas manuales en una empresa de videojuegos y aprendió a automatizar por su cuenta.
|
|
261
|
+
- **Fortalezas:** Montó la batería de tests automáticos que evita errores en las facturas. Piensa como un usuario despistado y encuentra fallos absurdos. Nada se le escapa.
|
|
262
|
+
- **Carencias:** Le cuesta priorizar: todo error le parece urgente. Puede bloquear entregas por detalles menores.
|
|
263
|
+
- **Fuera de su ámbito:** Programa bastante bien; podría pasar a desarrollo cuando quisiera. Mantiene la documentación de los flujos de negocio más al día que nadie.
|
|
264
|
+
- **Cómo trabaja:** Listas de comprobación para todo. Revisa cada pase a producción.
|
|
265
|
+
- **Relaciones:** Alianza con Ariadna y Casandra. Tensión permanente con Ícaro.
|
|
266
|
+
- **Por qué Argos:** El gigante de los cien ojos que nunca dormía del todo.
|
|
267
|
+
|
|
268
|
+
## Perfiles transversales
|
|
269
|
+
|
|
270
|
+
Trabajan con Facturación pero también con los otros cuatro equipos de producto, así que su tiempo siempre está en disputa.
|
|
271
|
+
|
|
272
|
+
### Dédalo · Principal Engineer / Arquitecto
|
|
273
|
+
|
|
274
|
+
- **Edad y antigüedad:** 50 años, 8 años en la empresa.
|
|
275
|
+
- **Trayectoria:** Treinta años programando: banca, telecomunicaciones y sistemas de reservas. Primer fichaje de Atenea.
|
|
276
|
+
- **Fortalezas:** Diseña arquitecturas elegantes que aguantan años. Visión de conjunto que nadie más tiene. Excelente mentor de seniors.
|
|
277
|
+
- **Carencias:** Sus diseños a veces son tan ingeniosos que solo él los entiende. Le cuesta aceptar soluciones pragmáticas “feas”.
|
|
278
|
+
- **Fuera de su ámbito:** Carpintero en sus ratos libres; construye muebles a mano. Gran conocedor de historia de la informática.
|
|
279
|
+
- **Cómo trabaja:** Escribe documentos de decisiones de arquitectura (ADR) para todo. Revisa los diseños de todos los equipos.
|
|
280
|
+
- **Relaciones:** Debates eternos con Hefesto. Protege a Ícaro más de lo que admite, quizá porque le recuerda a sí mismo de joven.
|
|
281
|
+
- **Por qué Dédalo:** El arquitecto del laberinto de Creta. Y padre de Ícaro.
|
|
282
|
+
|
|
283
|
+
### Atlas · SRE
|
|
284
|
+
|
|
285
|
+
- **Edad y antigüedad:** 34 años, 4 años en la empresa.
|
|
286
|
+
- **Trayectoria:** Administrador de sistemas en un proveedor de hosting y después SRE en un e-commerce con picos de tráfico brutales.
|
|
287
|
+
- **Fortalezas:** Mantiene el sistema estable en los cierres de mes y trimestre, cuando la carga se dispara. Muy calmado en las incidencias.
|
|
288
|
+
- **Carencias:** Reparte su tiempo entre cinco equipos y siempre va saturado. Responde tarde a lo que no es urgente. Cuesta que se tome vacaciones.
|
|
289
|
+
- **Fuera de su ámbito:** Sabe mucho de redes y de costes de nube; ha ahorrado a la empresa miles de euros al mes.
|
|
290
|
+
- **Cómo trabaja:** Paneles de monitorización siempre abiertos. Postmortems sin culpables tras cada incidencia.
|
|
291
|
+
- **Relaciones:** Hefesto es su apoyo informal. Equipo de dos con Prometeo.
|
|
292
|
+
- **Por qué Atlas:** Condenado a sostener el cielo sobre sus hombros. Él sostiene la plataforma.
|
|
293
|
+
|
|
294
|
+
### Prometeo · Ingeniero de plataforma / DevOps
|
|
295
|
+
|
|
296
|
+
- **Edad y antigüedad:** 29 años, 2 años en la empresa.
|
|
297
|
+
- **Trayectoria:** Desarrollador backend que se fue especializando en herramientas internas y automatización.
|
|
298
|
+
- **Fortalezas:** Crea herramientas que hacen más productivos a los demás: despliegues en minutos, entornos de prueba automáticos. Generoso con su conocimiento.
|
|
299
|
+
- **Carencias:** Cambia herramientas sin avisar con suficiente antelación. Algo rebelde con los procesos de aprobación.
|
|
300
|
+
- **Fuera de su ámbito:** Da talleres internos sobre productividad y herramientas. Muy activo en proyectos de código abierto.
|
|
301
|
+
- **Cómo trabaja:** Prueba primero, pide permiso después. Documenta todo en la wiki interna.
|
|
302
|
+
- **Relaciones:** Casandra le ha frenado más de un cambio arriesgado. Muy querido por los desarrolladores.
|
|
303
|
+
- **Por qué Prometeo:** Robó el fuego a los dioses para dárselo a los humanos. Él da herramientas a los equipos, a veces sin pedir permiso.
|
|
304
|
+
|
|
305
|
+
### Casandra · Ingeniera de seguridad
|
|
306
|
+
|
|
307
|
+
- **Edad y antigüedad:** 37 años, 3 años en la empresa.
|
|
308
|
+
- **Trayectoria:** Pentester en una consultora de ciberseguridad. Certificaciones OSCP y CISSP.
|
|
309
|
+
- **Fortalezas:** Detecta vulnerabilidades antes de que existan. Lleva el cumplimiento de RGPD e ISO 27001. Muy técnica.
|
|
310
|
+
- **Carencias:** Suena alarmista y la gente ha aprendido a ignorarla. Explica mal por qué algo importa en términos de negocio.
|
|
311
|
+
- **Fuera de su ámbito:** Sabe bastante de derecho digital. Escribe novelas de intriga que todavía no ha publicado.
|
|
312
|
+
- **Cómo trabaja:** Revisiones de seguridad en cada diseño importante. Formaciones trimestrales obligatorias que nadie quiere hacer.
|
|
313
|
+
- **Relaciones:** Argos es su gran aliado. Fricción con Prometeo y con Hermes, que ve la seguridad como freno.
|
|
314
|
+
- **Por qué Casandra:** Profetizó la caída de Troya y nadie la creyó. Siempre tenía razón.
|
|
315
|
+
|
|
316
|
+
### Mnemósine · Ingeniera de datos
|
|
317
|
+
|
|
318
|
+
- **Edad y antigüedad:** 35 años, 3 años en la empresa.
|
|
319
|
+
- **Trayectoria:** Matemáticas y estadística. Analista de datos en una aseguradora antes de pasar a ingeniería de datos.
|
|
320
|
+
- **Fortalezas:** Construyó el almacén de datos y los informes que ven los clientes. Recuerda dónde está cada dato y cómo ha cambiado. Muy fiable.
|
|
321
|
+
- **Carencias:** Poco comunicativa: nadie sabe en qué trabaja hasta que lo entrega. Le cuesta decir no a peticiones de informes.
|
|
322
|
+
- **Fuera de su ámbito:** Hace análisis de producto que deberían hacer los PM. Juega al ajedrez a nivel federado.
|
|
323
|
+
- **Cómo trabaja:** Trabajo largo y silencioso, entregas muy completas.
|
|
324
|
+
- **Relaciones:** Colabora mucho con Perséfone. Odiseo y Hermes dependen de sus datos.
|
|
325
|
+
- **Por qué Mnemósine:** Titánide de la memoria y madre de las musas. Guarda la memoria de la empresa.
|
|
326
|
+
|
|
327
|
+
### Temis · Experta de dominio fiscal y legal
|
|
328
|
+
|
|
329
|
+
- **Edad y antigüedad:** 52 años, 3 años en la empresa.
|
|
330
|
+
- **Trayectoria:** Veinte años como asesora fiscal y contable en un despacho propio. Lo vendió y se incorporó a Olimpia.
|
|
331
|
+
- **Fortalezas:** Traduce la normativa en requisitos claros. Anticipa cambios legales con meses de margen. Su palabra es ley en temas fiscales.
|
|
332
|
+
- **Carencias:** No entiende cómo funciona el desarrollo y pide cambios “pequeños” que suponen semanas. Le frustra el lenguaje técnico.
|
|
333
|
+
- **Fuera de su ámbito:** Red enorme de contactos en asesorías que sirve para probar funcionalidades con clientes reales. Excelente formadora.
|
|
334
|
+
- **Cómo trabaja:** Documentos de requisitos con referencias a la normativa. Revisa cada funcionalidad fiscal antes de salir.
|
|
335
|
+
- **Relaciones:** Tándem con Odiseo. Ariadna es la desarrolladora con quien mejor se entiende.
|
|
336
|
+
- **Por qué Temis:** Diosa de la ley y el orden justo, con su balanza.
|
|
337
|
+
|
|
338
|
+
### Penélope · Agile Coach / Delivery Manager
|
|
339
|
+
|
|
340
|
+
- **Edad y antigüedad:** 44 años, 5 años en la empresa.
|
|
341
|
+
- **Trayectoria:** Gestión de proyectos tradicional en una constructora, después Scrum Master y coach ágil.
|
|
342
|
+
- **Fortalezas:** Paciencia infinita. Hace visibles los bloqueos entre equipos y los desatasca. Retrospectivas que de verdad cambian cosas.
|
|
343
|
+
- **Carencias:** Rehace los procesos demasiado a menudo; el equipo se cansa de cambiar de método. Poco técnica.
|
|
344
|
+
- **Fuera de su ámbito:** Facilitadora de talleres excelente; dirección la usa para las reuniones estratégicas. Teje y hace ganchillo en las reuniones largas.
|
|
345
|
+
- **Cómo trabaja:** Tableros visuales, métricas de flujo, conversaciones uno a uno con cada miembro.
|
|
346
|
+
- **Relaciones:** Alianza con Hestia. Hermes es el que más le rompe los planes.
|
|
347
|
+
- **Por qué Penélope:** Tejía de día y destejía de noche, esperando con paciencia. Ella hace y deshace procesos.
|
|
348
|
+
|
|
349
|
+
### Clío · Redactora técnica
|
|
350
|
+
|
|
351
|
+
- **Edad y antigüedad:** 33 años, 2 años en la empresa.
|
|
352
|
+
- **Trayectoria:** Filología Hispánica, correctora editorial y después redactora de documentación de software.
|
|
353
|
+
- **Fortalezas:** Convierte funcionalidades complejas en guías claras. Mantiene las notas de versión y la documentación de la API. Excelente memoria de qué cambió y cuándo.
|
|
354
|
+
- **Carencias:** Se entera tarde de los cambios y persigue a los equipos para documentar. Poco asertiva para exigirlo.
|
|
355
|
+
- **Fuera de su ámbito:** Revisa los textos de la interfaz y los correos a clientes. Sabe algo de programación y lee código para entender lo que documenta.
|
|
356
|
+
- **Cómo trabaja:** Entrevistas cortas con desarrolladores; primeros borradores rápidos.
|
|
357
|
+
- **Relaciones:** Afrodita y Argos son sus mejores fuentes. Ariadna le pasa documentación casi lista.
|
|
358
|
+
- **Por qué Clío:** Musa de la historia: registra lo que pasa para que no se olvide.
|
|
359
|
+
|
|
360
|
+
### Asclepio · Soporte técnico nivel 3
|
|
361
|
+
|
|
362
|
+
- **Edad y antigüedad:** 40 años, 6 años en la empresa.
|
|
363
|
+
- **Trayectoria:** Empezó en soporte de nivel 1 en la propia Olimpia y fue subiendo. Aprendió SQL y a leer código por su cuenta.
|
|
364
|
+
- **Fortalezas:** Diagnostica problemas de clientes con una precisión asombrosa. Conoce los casos raros mejor que los propios desarrolladores. Calma a los clientes enfadados.
|
|
365
|
+
- **Carencias:** Aplica arreglos manuales en datos que deberían corregirse en el código. Le cuesta escalar a tiempo.
|
|
366
|
+
- **Fuera de su ámbito:** Forma a todos los nuevos de soporte. Conoce a muchos clientes por su nombre.
|
|
367
|
+
- **Cómo trabaja:** Registro detallado de cada incidencia. Llamadas con el cliente para ver el problema en directo.
|
|
368
|
+
- **Relaciones:** Néstor y él son el frente con los clientes. Argos usa sus casos para crear nuevos tests.
|
|
369
|
+
- **Por qué Asclepio:** Dios de la medicina, que curaba incluso lo que parecía incurable.
|
|
370
|
+
|
|
371
|
+
### Néstor · Customer Success Manager
|
|
372
|
+
|
|
373
|
+
- **Edad y antigüedad:** 55 años, 4 años en la empresa.
|
|
374
|
+
- **Trayectoria:** Treinta años vendiendo y acompañando a clientes de software de gestión. El veterano de la casa.
|
|
375
|
+
- **Fortalezas:** Relaciones de confianza con los clientes grandes. Sabe qué cliente está a punto de irse antes de que lo diga. Consejero sensato.
|
|
376
|
+
- **Carencias:** Cuenta muchas batallitas en las reuniones. Algo reacio a las herramientas nuevas de CRM.
|
|
377
|
+
- **Fuera de su ámbito:** Ha sido mentor informal de varios managers jóvenes. Conoce el sector de las pymes como nadie.
|
|
378
|
+
- **Cómo trabaja:** Visitas presenciales y llamadas largas. Notas en una libreta de papel.
|
|
379
|
+
- **Relaciones:** Hermes le escucha mucho. Lleva a Odiseo y a Afrodita a visitar clientes.
|
|
380
|
+
- **Por qué Néstor:** El anciano sabio de la guerra de Troya, cuyos consejos todos escuchaban. También contaba muchas historias.
|
|
381
|
+
|
|
382
|
+
## Dinámicas, tensiones y riesgos
|
|
383
|
+
|
|
384
|
+
El mayor riesgo del equipo es que el conocimiento crítico vive en tres cabezas: Hefesto, Ariadna y Temis. Si cualquiera de ellos se va, el módulo de facturación queda cojo durante meses.
|
|
385
|
+
|
|
386
|
+
**Alianzas que funcionan**
|
|
387
|
+
|
|
388
|
+
- **Odiseo y Temis:** juntos entienden al cliente y la ley mejor que nadie; el riesgo es que prometen más de lo que el equipo puede entregar.
|
|
389
|
+
- **Hestia y Penélope:** cuidan de las personas y del proceso, y son el freno a las prisas de Hermes.
|
|
390
|
+
- **Argos, Ariadna y Casandra:** el bloque de la calidad. Rara vez se les escapa nada, aunque a veces ralentizan.
|
|
391
|
+
- **Asclepio y Néstor:** traen la voz del cliente real a cada discusión.
|
|
392
|
+
|
|
393
|
+
**Tensiones abiertas**
|
|
394
|
+
|
|
395
|
+
- **Ícaro contra Argos:** velocidad frente a calidad. Es una tensión sana si Hestia la gestiona en vez de evitarla.
|
|
396
|
+
- **Narciso contra Afrodita y Apolo:** quién tiene la última palabra sobre lo visual. Iris hace de puente, pero no es su trabajo.
|
|
397
|
+
- **Hermes contra Atenea y Hestia:** las fechas que se prometen a clientes sin consultar a ingeniería.
|
|
398
|
+
- **Prometeo contra Casandra:** innovar rápido frente a no abrir agujeros de seguridad.
|
|
399
|
+
- **Hefesto contra Dédalo:** pragmatismo frente a elegancia arquitectónica. Discusiones largas que suelen acabar en mejores soluciones.
|
|
400
|
+
|
|
401
|
+
**Riesgos y lo que haría falta**
|
|
402
|
+
|
|
403
|
+
- **Dependencia de Hefesto:** debe delegar y preparar a Ariadna como posible sucesora.
|
|
404
|
+
- **Atlas saturado:** la plataforma necesita al menos un SRE más antes del próximo cierre fiscal.
|
|
405
|
+
- **Casandra ignorada:** hay que darle un canal directo con dirección y ayudarla a hablar en términos de riesgo de negocio.
|
|
406
|
+
- **Ícaro sin red:** necesita revisiones obligatorias en todo lo que toque dinero y un mentor fijo.
|
|
407
|
+
- **Temis no escala:** una sola experta fiscal para cinco equipos es un cuello de botella; conviene formar a Ariadna y a Odiseo o contratar a otra persona.
|
|
408
|
+
|
|
409
|
+
El equipo es bueno porque sus defectos se compensan entre sí: la prisa de Ícaro choca con los cien ojos de Argos, el perfeccionismo de Ariadna con el pragmatismo de Proteo. Funciona mientras Hestia mantenga el fuego encendido.
|