Qué es, en una imagen
ZORA conoce tu vida (salud, dinero, empresas, proyectos) y hace el trabajo de punta a punta. Solo te pregunta antes de lo que no tiene vuelta atrás. Hoy vive en tu Mac y en un servidor. ZORA 2.0 la convierte en una empresa: cada área tiene su departamento, y tú presides.
Lo discontinuo aún no existe. Todo lo que sale hacia el mundo pasa por la puerta de efectos, que aplica los 10 hard-stops.
Le das un objetivo y lo ejecuta entero: planifica, programa, prueba y te deja un PR listo, o te manda un informe. No pide permiso en cada paso.
Diez acciones (merge a main, deploy, borrar datos, gastar dinero, enviar en tu nombre…) siempre esperan tu sí. Es una lista cerrada.
Es autora de sus funciones y custodia de sus propias reglas: un cambio a su configuración solo lo propone, y lo aplicas tú.
02 · Qué es
Elige cuánto quieres saber. Cada nivel incluye al anterior.
En una frase
«ZORA es mi Jarvis: una IA que conoce mi vida y trabaja en ella por su cuenta, y solo me pide permiso para lo que no tiene vuelta atrás.»
Con departamentos: noticias, patrimonio, contenido, negocio, salud, formación y la fábrica que la construye.
No haces el trabajo. Decides lo importante, normalmente con un sí o un no desde el móvil.
El jefe es un agente que reparte el trabajo entre sus especialistas, cada uno con sus habilidades (skills).
Nada sale al mundo (un email, un post, un pago) sin pasar por la puerta, y lo grave te lo pregunta.
Por dónde le hablas: Claude Code en el Mac, la web o la app; Slack hoy; WhatsApp en la v2.1.
Entiende qué quieres y reparte el trabajo. Hoy: el orquestador del servidor y tu sesión de Claude Code. En 2.0: Dirección y un cerebro por área.
Lo que sabe de ti y de lo que ha pasado: conversaciones, episodios resumidos y reglas aprendidas.
Los 10 hard-stops: lo irreversible siempre espera tu sí. Parte lo frena un hook técnico y parte una regla de comportamiento.
Cómo toca el mundo: el bridge (Google, Whoop, Hevy, Apple Health), servidores MCP y APIs. Las credenciales nunca las ve el cerebro.
El departamento que construye a ZORA: de una idea a un plan, del plan a código por olas y del código a un PR verificado.
| Pieza | Dónde vive | Corre en | Qué hace |
|---|---|---|---|
| Orquestador | 01_ORCHESTRATOR/ | VPS · systemd · :8000 | FastAPI. Sesión e historial, router en dos niveles (reglas y luego Ollama), selección de modelo por trust_tier, subagentes del registro, cola de propuestas |
| Bridge | 03_BRIDGE/ | VPS · systemd · :8001 | Custodia los tokens OAuth cifrados (Fernet en SQLite) y habla con Google Calendar/Gmail, Whoop, Hevy y Apple Health |
| Bot de Slack | 04_CHANNELS/slack/ | VPS · systemd · métricas :9101 | Socket Mode (WSS saliente, sin webhook público). Traduce cada mensaje a POST /message |
| Registro de agentes | 01_ORCHESTRATOR/config/agents_registry.yaml | lo carga el orquestador | Subagentes conversacionales con task_class, clasificación de seguridad y complejidad |
| Claude Code | CLAUDE.md, .claude/ | tu Mac y claude.ai/code | La sesión donde trabajas: skills, hooks, worktrees y PRs. Es el motor de la Factoría |
| Perfiles de Factoría | 02_AGENTS/*.md | subagentes de Claude Code | PO, arquitecto, back, front, mobile, QA, seguridad, data, IA, infra… |
| MCP de memoria | 01_ORCHESTRATOR/mcp/memory_server.py | stdio local, consulta el VPS | Herramienta zora_memory_search para Claude Code. Hay otro para documentos (document_server.py) |
| Monitorización | monitoring/ | VPS · Docker | Prometheus, Grafana, Loki y Promtail detrás de nginx |
| Secretos | secrets/*.sops.env | se descifran en el deploy | SOPS + age; en el VPS quedan en /etc/openclaw/ |
| Deploy | .github/workflows/deploy.yml | GitHub Actions | Un push a main despliega en el VPS. Por eso el merge a main es hard-stop |
cerebro.yaml, jefe.md y sus skills. Piensa con Claude Code (CLI en el Mac, Agent SDK en el servidor). Los cerebros se avisan por el pulso (SQLite: eventos y entregas). Las cadenas largas van en LangGraph dentro del cerebro. Todo efecto externo pasa por el ejecutor de efectos. Detalle en ZORA 2.0.03 · Cómo accedo
Hoy hay dos ZORA que conviven: la de Claude Code, donde se construye y trabaja a fondo, y el bot de Slack del servidor, para el día a día desde el móvil. ZORA 2.0 las une.
La app de Claude (móvil, web o escritorio) como única pantalla. Escribes en un chat con ZORA conectada por MCP y responde ZORA: con sus cerebros, tus datos y sus credenciales, que nunca salen del servidor. Sustituiría a Slack y a cualquier app propia. Está diseñado y documentado; lo retomas cuando decidas.
Lo discontinuo aún no existe. La app solo reenvía tu pregunta y te enseña la respuesta; quien piensa es ZORA.
Un servicio pequeño en mcp.zoraia.dev que hace lo mismo que el bot de Slack: pasa tu texto al orquestador como un canal más y te devuelve la respuesta. Dos herramientas: zora_preguntar y zora_recoger. Si ZORA tarda más de 90 s, te deja un número para recoger.
Login propio de un solo usuario. Desde fuera, una lista cerrada de cosas permitidas y al principio nada que cambie datos. Los hard-stops se aprueban en ZORA, nunca dentro del chat. Patrimonio, cerrado salvo que lo abras.
Un Proyecto «ZORA» en la app con la instrucción de solo reenviar, y una firma en cada respuesta para saber si vino de ZORA o del modelo de la app. Con ZORA 2.0 cambia lo de detrás (zora-pm) sin tocar lo que ves.
04 · Cómo funciona
POST /message con su clave.~/Alex/ZORA-wt/ (una rama por tarea) o en claude.ai/code.AI_BEHAVIOUR.md, la rama y los issues bloqueantes././factoria-planificar genera Business Case, PRD, arquitectura, backlog de user stories y el bloque del ROADMAP. Es el contrato: autoriza la ejecución.
/factoria-ejecutar reparte las stories por perfil (back, front, QA…) y las ejecuta en olas, en paralelo, cada perfil en su rama y con TDD.
/factoria-release mergea, escribe el CHANGELOG, sube la versión y publica la release. Merge, tag y release son hard-stops.
/guardar lo hace desde Claude Code.AI_BEHAVIOUR.md. Un aprendizaje nuevo entra como propuesta.Ejemplo ilustrativo del funcionamiento previsto (v2.1 en adelante). Las horas y los textos son inventados.
05 · Piezas
Un VPS en Ciudad de México (Vultr, Ubuntu 24.04). Todo el tráfico entra por nginx; ningún servicio expone su puerto directamente.
| Nivel de confianza | Proveedores | Para qué |
|---|---|---|
| trusted | Anthropic, Ollama | Cualquier tema, también salud y holding. Siempre el último recurso |
| pendiente de revisión | OpenAI, Gemini | Solo agentes marcados como no sensibles |
| unvetted | Kimi (Moonshot) | Nunca nada sensible |
Un modelo barato solo se usa si el agente es a la vez no sensible y simple. En 2.0 lo sustituye una tabla «tipo de trabajo → motor».
06 · Frenos
Una vez aprobado el plan, ZORA lo ejecuta entero. La supervisión no es aprobar cada paso: son estos diez frenos y el resumen final.
🔒 = lo bloquea un hook técnico (.claude/hooks/pre_tool_use_hardstops.sh) aunque el modelo se equivoque. El resto depende de que el modelo se clasifique bien. En 2.0, el ejecutor de efectos los frena todos en el servidor.
Cifrados con SOPS + age en secrets/. Solo se descifran en el VPS durante el deploy. El orquestador nunca ve los tokens: los usa el bridge.
PDFs, webs o mensajes de otros sistemas son datos, no órdenes. Se envuelven y se marcan antes de que un modelo los lea.
Que ZORA esté segura no prueba que tenga razón. Distingue lo que sabe (anclado al contrato) de lo que supone, y lo segundo lo registra.
07 · ZORA 2.0
Cada área de tu vida es un cerebro con jefe y especialistas. Dirección (zora-pm) decide y orquesta. Los cerebros se avisan por el pulso y nada sale al mundo sin pasar por la puerta de efectos.
Todos los cerebros informan a Dirección. Salud solo te informa a ti. Las mejoras de ZORA que salen de Formación entran como propuestas: las aplicas tú.
Lo que cambia de un cerebro a otro son sus manos: sus MCP y sus APIs. Fuera o más adelante: Paperclip (se reevalúa en la v2.7), n8n dentro de los cerebros, Pydantic AI (solo para modelos de texto de otras empresas) y Codex o Gemini CLI.
agent_sdk en el adaptador.interes_radar).hilo_id en peticiones, aislamiento por cerebro, vigía partido, efectos como MCP.08 · Roadmap
Las versiones de ZORA 2.0 en el orden en que se van a hacer. Cada una deja algo funcionando. Para cambiar el orden se mueve una fila del índice del ROADMAP; el contenido de cada versión no se toca.
Las flechas llenas marcan qué va detrás de qué. Agencia y Patrimonio van a la vez. Formación entra justo tras el Radar. La discontinua es un atajo: el Analista de Atenea solo necesita la v2.0, así que puede adelantarse si quieres.
00_CONTEXT/ROADMAP.md. La era 1 (hasta la v1.15, la que está desplegada) está cerrada y archivada en ROADMAP-HISTORICO.md.09 · Formación · cerebro nuevo (v2.9, tras el Radar)
Un PDF, un documento, la URL de un vídeo o su transcripción, unas imágenes, o solo «quiero aprender algorítmica». Formación quita el ruido, se queda con los conceptos y te monta lo necesario para aprenderlo: plan de estudios, tutorial, infografías, vídeos explicativos y repaso. Lo que sirva para contenido se lo pasa a la Agencia, y lo que sirva para mejorar a ZORA entra como propuesta.
Una entrada, tres salidas. La principal es tu estudio. Lo discontinuo depende de otros cerebros: la Agencia para publicar, y tu OK para cualquier cambio en ZORA.
Le pasas algo concreto: un PDF, unos apuntes, la URL de una conferencia o su transcripción, fotos de una pizarra. Lo convierte en texto, lo trocea, lo limpia y lo destila. Cada concepto conserva de dónde sale (página o minuto), para que puedas ir al original.
«Quiero aprender algorítmica.» Te pregunta tu nivel y cuánto tiempo tienes, busca fuentes buenas (con el Radar y /investigar), y monta un temario por niveles con ejercicios. Cada semana te deja la siguiente lección y repasa lo que se te olvida.
Diez horas de charla son unas 90.000 palabras: no caben en una sola lectura útil. Por eso se trocea por charlas y se destila cada una antes de juntarlo.
Por cada material, una lista corta de ideas de reels con el minuto exacto de origen. Las publica siempre la Agencia y con tu sí. Si el material es de otra persona, se cita y se respetan sus derechos.
Si lo que estudias trae una técnica que ZORA debería usar (un patrón de agentes, una forma de evaluar, un prompt mejor), Formación redacta la propuesta con su fuente. Si toca sus reglas o skills, va a la cola y la aplicas tú (hard-stop 6). Si es una función nueva, va como idea a la Factoría.
El material que preparas para ti es la materia prima de los cursos que Negocio tiene apuntados para el final (B6).
/investigar cubre el «busca las mejores fuentes de un tema».10 · Para la IA
Esta sección es para Claude u otro agente que tenga que orientarse en ZORA. Es un resumen; ante duda, mandan los ficheros del repo.
CLAUDE.md: identidad, hard-stops, cuerpos.00_CONTEXT/AI_BEHAVIOUR.md (lo emite el hook de inicio) y reglas en 00_CONTEXT/behaviour/.00_CONTEXT/ROADMAP.md: versión, índice de ejecución, era 2.0.00_CONTEXT/ARCHITECTURE.md: cómo funciona de verdad, con archivo y línea..claude/contexts/ (VPS, Factoría, skills) solo si entras en ese dominio.CLAUDE.md, AI_BEHAVIOUR.md, .claude/**, rules.yaml, .github/**, deploy/**, secrets/**, monitoring/**, memoria L3) solo se propone.GH_TOKEN=$(gh auth token --user alejandrozorita), nunca gh auth switch.