Ir a la biblioteca

Orca

Caso real — Orca como cockpit multiagente

La evolución de un coordinador único a dirección, integración y paquetes separados, con auditoría cruzada y aceptación verificable.

Caso real

Situación inicial

Un proyecto de transformación digital combinaba integraciones, datos, APIs, seguridad y operación productiva. Una sola conversación podía conservar el contexto, pero se convertía en cuello de botella al abrir varios frentes en paralelo.

La alternativa de lanzar agentes sin estructura tampoco servía: aumentaba el riesgo de cambios superpuestos, decisiones contradictorias y pérdida de contexto al cambiar de sesión.

Modelo inicial adoptado

Agente coordinador

Un agente de mayor capacidad opera sobre el workspace principal. Su función es:

  • revisar el estado general;
  • mantener decisiones y restricciones vigentes;
  • preparar el plan;
  • dividir el trabajo en unidades verificables;
  • revisar implementaciones y auditorías;
  • decidir el siguiente frente.

El coordinador no existe para implementar todo. Existe para que cada tarea nazca con contexto suficiente y vuelva con evidencia comparable.

Implementadores y revisores

Las tareas acotadas se asignan según costo, disponibilidad y fortaleza del agente. Pueden convivir modelos y CLIs distintos sin cambiar la metodología.

Cada worker recibe:

  • su propio worktree y rama;
  • un alcance explícito;
  • restricciones operativas;
  • condiciones de finalización;
  • una forma esperada de entregar evidencia.

Los agentes de revisión se separan, cuando corresponde, de quienes realizaron la implementación.

Flujo operativo inicial

  1. El coordinador inspecciona el proyecto y prepara una tarea.
  2. Se crea un worktree desde una base conocida.
  3. El implementador trabaja dentro de su alcance.
  4. Entrega cambios, pruebas, riesgos y pendientes.
  5. Otro agente o el coordinador revisa el resultado.
  6. La integración y cualquier acción productiva permanecen detrás de un gate humano.

Evolución del caso: V4, octubre de 2026

La documentación V4, revisada el 12 de octubre de 2026, separa responsabilidades que antes se concentraban en un solo coordinador. El diseño anterior queda como historia del caso; la distribución vigente distingue tres niveles:

Nivel Asignación del entorno Responsabilidad
Dirección general Opus Conversación con la persona, prioridades y decisiones transversales
Integración Sol con esfuerzo low Reconstruir estado, ordenar dependencias e integrar evidencia de los paquetes
Coordinación de paquete Sol con esfuerzo medium Conducir una capacidad acotada hasta su aceptación

Son asignaciones de este proyecto, no una recomendación universal ni una equivalencia entre modelos. Para implementación LIVE se usa Luna con esfuerzo high o Sonnet; la auditoría cambia a la familia opuesta al implementador. Separar familias agrega diversidad de revisión, pero no garantiza detectar errores ni reemplaza las pruebas.

La unidad sigue siendo una capacidad, una tarea, una rama y un worktree. BUILD/LIVE y el gate de tres partes ya existían en V3: paridad con el comportamiento del CRM, recuperación preparada y auditoría. V4 modifica el reparto de autoridad y permite operaciones LIVE pequeñas dentro de un alcance previamente autorizado, con verificación y reversión automática acotada. Borrados y tombstones, las marcas de eliminación, requieren permiso humano explícito. Tener una regla en el repositorio no concede permisos en otra sesión o herramienta.

La dirección general recibe una bandeja de decisiones agrupadas por urgencia: incidentes, destrabes y asuntos sin apuro. El integrador reúne evidencia; no interrumpe a la persona por cada avance ni convierte una decisión pendiente en permiso implícito.

Del merge al resultado aceptado

El circuito vigente distingue listo local, aplicado y aceptado. Un PR integrado demuestra integración; un postflight inmediato demuestra el comportamiento que efectivamente midió. La aceptación natural requiere observar el ciclo real acordado. Si queda trabajo, el handoff conserva el remanente, su responsable y la evidencia que falta: entregar el problema a otra persona no equivale a resolverlo.

Al retomar, primero se reconstruyen PRs, ramas, workers y despliegues reales. Sólo después se abre trabajo nuevo. Esa comprobación evita duplicar una implementación que siguió avanzando mientras la conversación estaba cerrada.

Esta actualización resume documentación y registros del proyecto revisados el 12 de octubre, anonimizados. No constituye una nueva ejecución de sus pruebas ni una validación universal de sus controles. Los contratos de rol deben contrastarse con los permisos efectivos del runtime, como explica el entorno es la política.

Qué aportó Orca

Paralelismo comprensible

Los frentes dejaron de ser terminales anónimas. Cada uno quedó ligado a un proyecto, worktree, agente y estado visible.

Libertad de proveedor

Distintos CLIs convivieron en una misma superficie. El modelo pudo elegirse por tarea sin perder el mapa general del proyecto.

Aislamiento real

Las implementaciones no compitieron por el mismo checkout. Cada rama podía revisarse, compararse o descartarse sin contaminar el trabajo principal.

Continuidad

Separar interfaz, proceso, sesión, worktree y estado persistente permitió recuperar trabajo después de interrupciones sin asumir que todo seguía vivo ni tomar acciones destructivas por reflejo.

Operación remota

La interfaz funcionó como cockpit mientras repositorios y agentes permanecían en un entorno de ejecución central. Otros dispositivos podían actuar como ventanas hacia el mismo estado, sin crear copias divergentes.

Beneficios obtenidos

  • más frentes simultáneos sin compartir archivos de trabajo;
  • continuidad del contexto aunque cambiara el implementador;
  • selección de modelo por costo y tipo de tarea;
  • handoffs más claros y revisables;
  • menor dependencia de una sesión o interfaz concreta;
  • separación explícita entre planificación, implementación, auditoría y producción.

La lección transferible

La mejora no vino de “usar muchos modelos”. Vino de diseñar un sistema donde los modelos pueden reemplazarse, las tareas quedan aisladas y el contexto importante no depende de ninguno de ellos.

Orca volvió visible y operable esa arquitectura. La calidad del resultado siguió dependiendo de los contratos de trabajo, Git, las validaciones y la supervisión humana.

Caso basado en un entorno real. Se removieron nombres de empresa, repositorios, infraestructura, incidentes identificables y datos operativos.

Seguí por acá

← Volver a la biblioteca