Komandesk - Plan De Onboarding

Fecha: 2026-06-06

Objetivo

Preparar un onboarding que ayude a una persona nueva a entender Komandesk sin obligarla a leer toda la documentacion ni crear trabajo antes de saber que esta haciendo.

No es una nueva funcionalidad en esta fase. Es un contrato de experiencia para decidir despues que partes viven en documentacion, que partes viven en la UI y que partes puede guiar el asistente.

Principio

El onboarding debe ensenar el procedimiento real:

elegir workspace;
entender proyectos;
rellenar scope;
crear o revisar plan;
convertir plan en tareas solo cuando haya decision humana;
preparar flujos/recurrentes;
validar runner, targets y credenciales;
ejecutar con evidencia y revision.

Capas De Onboarding

1. Bienvenida Corta En Documentacion

Ubicacion recomendada: docs/how-to/getting-started.md y ayuda publica.

Contenido:

que es Komandesk;
que diferencia hay entre proyecto, scope, plan, tarea, flujo y recurrente;
que significa automatizacion supervisada;
que no debe hacerse al principio: crear muchas tareas, activar recurrentes o ejecutar runner sin preflight.

2. Primer Proyecto Guiado

Ubicacion recomendada: documentacion + checklist visible en Planificacion cuando falte scope.

Contrato:

completar ficha de scope;
crear documento estado-y-proximos-pasos;
revisar o crear plan en review;
mantener tareas como candidatas hasta aprobar el plan;
dejar riesgos y dudas abiertas.

3. Onboarding Operativo Por Roles

Rutas:

operador: proyectos, scope, planes, tareas, evidencias;
admin: workspaces, usuarios, credenciales, targets, tokens;
automatizacion: flujos, recurrentes, dispatch, runner local.

Cada rol necesita una pagina corta con:

que mirar primero;
que puede romper cosas;
que requiere confirmacion humana;
que evidencias debe dejar.

4. Asistente Como Guia, No Como Mago

El asistente debe poder responder:

"que debo hacer ahora en este proyecto";
"que falta para automatizarlo";
"que riesgos hay antes de crear tareas";
"que recurrentes estan listas y cuales no";
"por que no se puede ejecutar todavia".

El asistente no debe crear tareas durante onboarding salvo confirmacion explicita posterior.

5. Checklist De Preparacion Antes De Automatizar

Checklist minimo:

scope completo;
plan activo o en review;
documento de estado;
riesgos revisados;
target y credenciales claros si hay salida externa;
flujo con readiness ejecutable;
recurrente pausada si falta contexto;
preflight de runner si usa ejecucion local;
evidencia esperada antes de cerrar.

Plan De Implementacion Recomendado

Fase O1 - Documentacion Base

Reescribir getting-started con el flujo real de Komandesk.
Crear pagina "Primer proyecto controlado".
Crear pagina "Automatizacion supervisada: reglas y limites".
Enlazar desde ayuda y desde Mi cuenta.

Fase O2 - Checklist Ligero En UI

Mostrar checklist contextual en Planificacion cuando el scope este incompleto.
Mostrar "siguiente paso recomendado" sin crear tareas.
En proyectos ya poblados, enlazar al documento estado-y-proximos-pasos.

Fase O3 - Guia Del Asistente

Anadir prompts/acciones para explicar onboarding por proyecto.
Mantener todas las propuestas en modo lectura/plan hasta aprobacion.
Usar product_completion, readiness de flujos y recurrentes como fuentes.

Fase O4 - Validacion

Probar con un proyecto real controlado.
Revisar si una persona puede pasar de cero a "plan listo en review" sin ayuda externa.
Medir donde se atasca: lenguaje, navegacion, conceptos o permisos.

Copy Base

Komandesk no empieza creando tareas. Empieza aclarando el proyecto.

El orden recomendado es:

completa el scope;
revisa el estado y proximos pasos;
aprueba un plan;
convierte solo lo necesario en tareas;
automatiza cuando haya contrato, evidencia y rollback.

Criterio De Exito

Una persona nueva entiende en menos de 20 minutos:

donde esta cada proyecto;
que falta para avanzar;
por que no se ejecuta automaticamente sin preflight;
como pasar de documento a plan y de plan a tareas candidatas;
que necesita validar antes de automatizar.