docs: add Spanish README

README.es-ES.md

@@ -0,0 +1,83 @@
+
+
+# Fable-agents
+
+**English** · [简体中文](README.zh-CN.md)
+
+Instalador portátil para una configuración de enrutamiento de modelos de tres capas en Claude Code: un orquestador **Fable 5** que solo planifica, delega y sintetiza, junto con tres subagentes (**deep-reasoner** en Opus, **fast-worker** en Sonnet y **gatekeeper** en Opus como control de aceptación y publicación) y **Codex** como ingeniero colaborador independiente.
+
+## Por qué enrutrar
+
+Una suscripción Max (20x), un día de trabajo intensivo multiagente (2026-07-05): **902M tokens** en **4,911 solicitudes** con una **tasa de aciertos en caché del 96.1 %** — **$731** en uso equivalente a API.
+
+![Daily usage: 902,494,882 tokens, 4,911 requests, 96.1% cache-hit rate, $731.38 API-equivalent](docs/images/daily-usage-overview.png)
+
+La división de solicitudes es el contrato de enrutamiento en acción: Fable respondió solo a **492 solicitudes (10 %)** — pura orquestación: planificar, delegar, juzgar, sintetizar. Sonnet se encargó de **2,924 solicitudes de ejecución**; Opus asumió **705** ejecuciones de juicio y control.
+
+![Per-model split: claude-sonnet-5 2,924 requests, claude-fable-5 492, claude-opus-4-8 705](docs/images/per-model-request-split.png)
+
+Fable se factura contra su propio lote semanal, separado del lote de todos los modelos. Con Fable haciendo solo orquestación, los dos lotes se agotan al mismo ritmo: **32 % Fable frente a 26 % todos los modelos** a mitad de semana. El uso semanal de un solo modelo se mantiene al ritmo del resto de la suscripción combinada, en lugar de que el lote de Fable se agote con el trabajo de ejecución mientras el lote compartido permanece inactivo.
+
+![Claude Max weekly limits: Fable pool 32% used, all-models pool 26% used](docs/images/weekly-limits-fable-vs-all-models.png)
+
+## Instalación
+
+### Opción A: clonar y ejecutar
+
+```bash
+git clone https://github.com/Ancienttwo/Fable-agents.git
+cd Fable-agents
+bash scripts/install.sh
+```
+
+Los agentes y la sección de enrutamiento se instalan una sola vez, de forma global: cada proyecto en la máquina los adopta. `--project` limita la prueba de humo no interactiva a un directorio de proyecto específico (predeterminado: cwd); no cambia dónde se instala nada. El script es idempotente: es seguro volver a ejecutarlo.
+
+Opciones:
+- `--project <dir>` — proyecto desde el cual ejecutar la prueba de humo (predeterminado: cwd)
+- `--skip-plugin` — omitir la instalación/verificación del plugin de Codex
+- `--skip-smoke` — omitir la prueba de humo del agente no interactiva (usar en entornos aislados sin credenciales de API)
+
+### Opción B: enviar a tu Claude
+
+Pega esto en cualquier Claude que pueda ejecutar comandos en tu máquina (Claude Code CLI, aplicación de escritorio o extensión de IDE):
+
+> Instala la configuración de enrutamiento de modelos desde https://github.com/Ancienttwo/Fable-agents — clona el repositorio, ejecuta `bash scripts/install.sh` y luego informa los resultados por capa (`[new]`/`[ok]`/`[conflict]`/`[warn]`). Nunca sobrescribas nada ante un `[conflict]`.
+
+## Qué instala
+
+1. `agents/fast-worker.md`, `agents/deep-reasoner.md` y `agents/gatekeeper.md` en tu directorio global de Claude (`$CLAUDE_CONFIG_DIR/agents`, predeterminado `~/.claude/agents`) — disponibles en cada proyecto
+2. La sección `## Model Routing Hierarchy` en tu `CLAUDE.md` global (`$CLAUDE_CONFIG_DIR/CLAUDE.md`, predeterminado `~/.claude/CLAUDE.md`)
+3. El plugin `codex@openai-codex` (marketplace `openai/codex-plugin-cc`), con una verificación de preparación
+4. Una prueba de humo no interactiva que confirma que los tres agentes responden
+
+El instalador nunca sobrescribe un archivo que difiera de la versión incluida: en su lugar, informa `[conflict]` y sale con código `3`, para que puedas compararlo y decidir.
+
+## El modelo de enrutamiento
+
+- **Fable 5 (bucle principal) = orquestador.** Planifica, delega, sintetiza. Nunca realiza trabajo de ejecución en línea.
+- **Los subagentes siempre especifican un modelo/tipo explícito.** Ninguna instanciación — herramienta de Agente o Flujo de trabajo — puede heredar Fable de forma silenciosa.
+- **`deep-reasoner`** (Opus, `effort: max`) — investigación de arquitectura, razonamiento complejo, decisiones de alto riesgo. Recomienda; el orquestador confirma el marco final. Devuelve `RECOMMENDATION: <una-línea> — confidence: HIGH/MEDIUM/LOW`.
+- **`fast-worker`** (Sonnet, `effort: max`) — implementación, pruebas, refactorización, documentación, ejecución mecánica. Devuelve `RESULT: DONE/PARTIAL/BLOCKED` con salida de verificación.
+- **`gatekeeper`** (Opus, `effort: max`) — última puerta de control después de que los subagentes de ejecución entregan: revisa las diferencias contra el objetivo, ejecuta la verificación real del proyecto y devuelve una recomendación de publicación `PASS`/`FAIL`/`BLOCKED`. Asesora, nunca decide: las acciones de publicación se ejecutan solo bajo la orden explícita del orquestador; nunca corrige código.
+- **Codex** — ingeniero colaborador independiente, no un revisor obligatorio. Se invoca mediante los comandos `/codex:*` del plugin `codex` o `codex exec`.
+- **Las decisiones de alto riesgo siguen un doble carril:** deep-reasoner y Codex producen una solución cada uno de forma independiente; el orquestador compara y sintetiza en lugar de elegir una.
+
+## Estructura
+
+```
+SKILL.md                          Claude Code skill manifest (usable as a skill if this repo
+                                   is placed/symlinked under ~/.claude/skills/)
+assets/deep-reasoner.md           Agent definition installed into ~/.claude/agents (global)
+assets/fast-worker.md             Agent definition installed into ~/.claude/agents (global)
+assets/gatekeeper.md              Agent definition installed into ~/.claude/agents (global)
+assets/model-routing-hierarchy.md Source of the CLAUDE.md section the installer appends
+scripts/install.sh                Idempotent installer (see flags above)
+```
+
+## Requisitos previos
+
+- Claude Code CLI (`claude`) en PATH para la fase de plugin y las pruebas de humo
+- `node` para la verificación de preparación de Codex
+- `codex` CLI + `codex login` para una capa de Codex completamente verificada (opcional: se informa como `[warn]` si falta, no es un error fatal)
+
+Una sesión interactiva de Claude Code ya en ejecución carga los tipos de agente al inicio, por lo que no verá los agentes recién instalados hasta que se reinicie o se ejecute `/reload-plugins`.