gonzalezpazmonica Skill: savia-dual
Soberanía de inferencia dual. Cuando la nube va bien, calidad máxima. Cuando la nube falla, Savia sigue funcionando en local.
Prerequisitos (gate de arranque del failover)
Doble opt-in (SPEC-186): → si no: ❌ ABORT
bash scripts/savia-double-optin-check.sh \
--skill savia-dual --confirm-autonomous
Requiere AMBOS: SAVIA_DUAL_FAILOVER_ENABLED=true Y flag explicito.
Cuándo se activa
Esta skill se activa cuando el usuario necesita:
- Trabajar sin conexión estable (viajes, zonas rurales, cortes)
- Protegerse de incidentes de Anthropic (outages, latencia alta)
- Asegurar continuidad ante agotamiento de cuota de tokens
- Experimentar con modelos locales sin renunciar a la calidad cloud
Componentes
- Proxy —
scripts/savia-dual-proxy.py - Installer Linux/macOS —
scripts/setup-savia-dual.sh - Installer Windows —
scripts/setup-savia-dual.ps1 - Regla —
docs/rules/domain/savia-dual.md - Comando —
/savia-dual {install|start|stop|status|test} - Docs —
docs/savia-dual.md
Flujo de instalación
./scripts/setup-savia-dual.sh # Linux/macOS
pwsh .\scripts\setup-savia-dual.ps1 # Windows
El installer:
- Instala o actualiza Ollama
- Detecta RAM y VRAM del equipo (datos locales, no se persisten)
- Elige la variante de gemma4 más adecuada
- Descarga el modelo
- Escribe
~/.savia/dual/config.jsony~/.savia/dual/env - Deja instrucciones para arrancar el proxy
Flujo de uso diario
# Terminal 1: arrancar proxy
python3 scripts/savia-dual-proxy.py
# Terminal 2: cargar env y arrancar Claude Code
source ~/.savia/dual/env
claude
A partir de ese momento, Claude Code envía peticiones al proxy, que las
enruta según configuración. El usuario NO percibe la diferencia cuando
la nube responde bien. Cuando hay fallback, puede ver el motivo en
~/.savia/dual/events.jsonl.
Reglas operativas
- Cloud first, local fallback: nunca al revés. La calidad prima.
- Transparencia total: cada routing decision se registra con motivo.
- Sin bypass: el proxy no expone ningún modo para forzar fallback
manualmente; la única forma de usar local es parar el proxy o
desactivar
ANTHROPIC_BASE_URL. - Circuit breaker: 3 fallos consecutivos → 60s solo local → reintenta Anthropic. Evita martillear el upstream caído.
Límites honestos
gemma4 local NO es equivalente a Opus/Sonnet. Usar con expectativas:
| Tarea | Cloud | Local gemma4 |
|---|---|---|
| Lectura de memoria, /help, /sprint-status | ✅ | ✅ aceptable |
| Conversación operativa | ✅ | 🟡 usable, más lento |
| Specs SDD, code review | ✅ | ❌ calidad insuficiente |
| Orquestación multi-agente | ✅ | ❌ pierde contexto |
Para uso ofimático de Savia (status, memoria, comandos simples) el modo fallback es perfectamente viable. Para trabajo profundo de ingeniería, reconectar a la nube antes de continuar.
Relación con otras skills
- data-sovereignty (skill existente): soberanía de datos sensibles → esta skill añade soberanía de inferencia sobre el razonamiento
- emergency-mode: modo emergencia manual → Savia Dual es el modo automático y transparente equivalente, sin intervención del usuario