Caminos por rol

La documentación está organizada por modo Diátaxis — tutoriales, how-to, referencia, explicación — porque así es como los docs se mantienen usables. Pero la gente llega con un rol, no con un modo. Estos son los cinco caminos a través de las mismas páginas, en orden de lectura.

Ingeniería de plataforma — instalarlo, operarlo

Tú posees el despliegue: uptime, backups, actualizaciones, capacidad.

1. Verlo funcionar: el quickstart (cinco minutos), luego el tutorial zero-to-graph si quieres la versión guiada.
2. Instalar de verdad, por escenario: nodo único (systemd) · Docker Compose · Kubernetes/Helm con HA · air-gapped.
3. Cablear señales: conectar una fuente, luego las guías por conector (pgAudit, CloudTrail, eBPF/Tetragon).
4. Operar: monitorización y SLOs · backup y restauración · troubleshooting.

Referencia en la que vivirás: configuración, CLI, conectores y tiers.

Ingeniería de seguridad — gobernarlo, contenerlo

Tú posees el least privilege, la aplicación y la respuesta a incidentes para el estate de agentes.

1. El modelo primero: qué es el access map y honestidad y límites — qué afirmará el producto y qué no.
2. Gobernar: gobernar y aprobar (RBAC, el PDP restrict-only, decisiones registradas), luego las recetas: políticas deny-closed · aprobaciones HITL · triage de drift.
3. Aplicar en la superficie del agente: hooks de Claude Code y el PEP · gobierno de MCP · presupuestos como guardrails.
4. Contener: el drill del kill-switch, y endurecer el despliegue.

Trasfondo en profundidad: el modelo de seguridad y el threat model.

Cumplimiento — evidencia, auditoría, residencia

Tú respondes ante auditores y reguladores; necesitas registros que se prueben a sí mismos.

1. Qué es la evidencia: la garantía de decisiones registradas en gobernar y aprobar — el ledger append-only y firmado bajo cada decisión.
2. Sacarla: empújala a tu SIEM, o hazle pull/tail para archivado WORM — y verifícala offline (troubleshooting § ledger).
3. Mantenerla superviviente: backup y restauración — bundles seguros para la continuidad, la regla de la clave fuera de la caja, el drill de restauración.
4. Residencia y procedencia: operación air-gapped · verificar una release · open core y licenciamiento.

La línea base honesta que citar en evaluaciones: Honestidad y límites — qué corre, qué es bajo demanda, qué está en fase de diseño.

Ejecutarlo por tu cuenta — una máquina, una persona

Sin equipo de plataforma ni oficina de cumplimiento: un homelab, un servidor doméstico, una instalación para autónomos o pequeñas empresas en la que quien lo instala también es quien lo usa. Aquí nada es un producto reducido: es el mismo binario único, leído en el orden que permite sacar partido a una máquina lo antes posible.

Desplegar con Docker Un archivo Compose, un contenedor, tu propia máquina. El camino más corto desde cero hasta un plano de control en funcionamiento.

Inicio rápido Primera ejecución, primer agente, primera sesión gobernada: los diez minutos posteriores al arranque.

Costes y presupuestos Lo que te cuestan tus modelos, por agente y por sesión, con presupuestos que responden antes de que lo haga la factura.

Copias de seguridad y restauración El hábito operativo que merece la pena adoptar desde el primer día, sea quien sea el dueño de la máquina.

Builders — extenderlo

Estás escribiendo un conector o conduciendo la API.

Construir y distribuir un conector Scaffold, implementar, firmar, distribuir — con admisión firmada deny-closed.

Usar los SDKs de cliente Clientes Go, Java, Python y TypeScript sobre el contrato REST publicado.

Gestionar como código El provider de Terraform/OpenTofu sobre la API gobernada.

Referencia de API y eventos La superficie REST renderizada por OpenAPI y el bus de eventos AsyncAPI.