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

  1. Abrir el proyecto.
  2. Revisar Readiness de ejecucion.
  3. Elegir SaaS worker, Runner local o Repo remoto.
  4. Pulsar Preflight o Preparar.
  5. OPS crea una tarea Onboarding piloto.
  6. Ejecutar una tarea pequena o dejarla bloqueada con motivo claro.
  7. 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."