Onboarding por modo de ejecucion
Fecha: 2026-05-28
Objetivo
Un cliente piloto debe entender donde se ejecuta el trabajo antes de activar automatismos.
Komandesk vende coordinacion, trazabilidad y ejecucion verificable. No vende magia: el SaaS no lee el disco local sin runner autorizado.
Modos
SaaS worker
Usar cuando el trabajo puede ejecutarse con contexto, APIs, credenciales de workspace/account, targets remotos o repos accesibles.
Requisitos:
- agente o perfil activo;
- credencial BYOK automatizable;
- tarea pequeña de primera ejecucion;
- evidencia y tiempo al cierre.
Limite:
- no accede al disco del usuario;
- no usa sesiones personales del usuario desde el servidor SaaS.
Runner local
Usar cuando el trabajo necesita archivos locales, repos privados en la maquina del usuario, CLIs autenticados, modelos locales o sesiones BYOS.
Requisitos:
- runner vinculado al workspace/proyecto;
- heartbeat fresco;
- rutas permitidas;
- preflight de runtime/modelo;
- tarea inicial pequeña y reversible.
Limite:
- la ejecucion ocurre en la maquina autorizada;
- el SaaS solo coordina y audita.
Repo/remoto
Usar cuando el repo es la frontera de ejecucion y revision.
Requisitos:
- repo o target remoto vinculado;
- branch o estrategia PR;
- credencial de deploy si aplica;
- commit, diff, PR o rollback como evidencia.
Limite:
- no sustituye tests ni revision;
- no debe mezclar proyectos en el mismo repo sin scope claro.
Flujo piloto
- Abrir el proyecto.
- Revisar
Readiness de ejecucion.
- Elegir
SaaS worker, Runner local o Repo remoto.
- Pulsar
Preflight o Preparar.
- OPS crea una tarea
Onboarding piloto.
- Ejecutar una tarea pequena o dejarla bloqueada con motivo claro.
- Cerrar con evidencia, tiempo y siguiente paso.
Criterio De Exito
- El usuario sabe donde se ejecutara la primera tarea.
- El sistema muestra que falta antes de automatizar.
- La primera ejecucion deja evidencia y tiempo.
- Si falla, queda alerta o tarea accionable, no silencio.
Criterio De Venta
Promesa aceptable:
> Conecta tu proyecto, elige modo de ejecucion y Komandesk coordinara el trabajo con trazabilidad.
Promesas prohibidas:
- "El SaaS entra en tu ordenador."
- "Usamos tu suscripcion personal desde nuestro servidor."
- "El agente arregla proyectos sin scope, permisos ni evidencia."