Orca: coordine agentes sin perder la identidad del trabajo
Proyecto: un registro de tareas Orca de solo lectura
Identifique host, worktree y evidencia de aceptación sin automatizar merges ni borrar trabajo pendiente.
Qué aprenderás
- Identidad antes de progreso
- Observaciones incompletas
- Aceptación del ejercicio
Antes de empezar
- Lectura básica de comandos y configuración
- Entorno de ensayo desechable y autorizado
Identifique host, worktree y evidencia de aceptación sin automatizar merges ni borrar trabajo pendiente.
Conclusiones clave
- La ruta necesita identidad de host.
- Aceptar requiere más que el estado del agente.
- El primer registro debe ser de solo lectura.
Identidad antes de progreso
Asigne identificador a cada tarea ficticia y registre host, ruta, rama y resultado esperado. Una ruta sola es ambigua cuando equipos locales y remotos usan nombres similares.
Separe finalización declarada por el agente de aceptación humana. Añada referencia saneada al diff y resultado de pruebas antes de aceptar. Un estado verde no equivale a código integrado.
Observaciones incompletas
Represente desconexión, espera de revisión y desconocido. Perder conexión no demuestra éxito ni fallo del cambio. Conserve cuándo se observó por última vez para explicar lo que falta.
Empiece con Git de solo lectura o fixtures. No permita merges, eliminación de worktrees ni reinicios remotos. Esas acciones necesitan autorización y diseño de recuperación adicionales.
Aceptación del ejercicio
Pruebe hosts con rutas iguales, cambios sin commit, comprobaciones fallidas y sesiones desconectadas. La interfaz debe localizar exactamente el trabajo y mostrar qué evidencia sigue pendiente.
Bastan una tabla y un pequeño grafo de hosts. Este esquema es una propuesta de aprendizaje independiente, no una función verificada de Orca ni una promesa de sus mantenedores.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Registre host, worktree y resultado esperado.
- 2
Separe finalización y aceptación.
- 3
Pruebe rutas ambiguas y datos ausentes.
Ejemplo para copiar
{
"proposal": true,
"readOnly": true,
"host": "demo-host",
"worktree": "demo-path",
"agentComplete": false,
"humanAccepted": false,
"lastObservedAt": null
}Preguntas frecuentes
¿Puede hacer merge automático?
Queda fuera de este ejercicio de solo lectura.
¿Es un esquema oficial?
No. Es una propuesta independiente.
Fuentes
- Orca / README.mdFuente verificada 2026-09-18
- Orca / docs/reference/headless-linux-server.mdFuente verificada 2026-09-18