Usar el Asistente para Crear y Revisar Proyectos

Objetivo

Usar el asistente de Komandesk como ayuda de planificacion y gestion de proyecto sin confundirlo con ejecucion automatica libre.

El asistente puede leer contexto del proyecto, proponer acciones, preparar planes, sugerir tareas y actualizar memoria. Las acciones sensibles no se aplican hasta que una persona las confirma.

Que puede hacer hoy

El asistente puede:

resumir una tarea;
preparar cierre de tarea con tiempo y nota;
registrar tiempo o comentarios tras confirmacion;
bloquear o desbloquear una tarea;
auditar el proyecto actual;
preparar un proyecto nuevo en modo preview;
proponer un plan de proyecto en estado review;
proponer tareas con estimacion, criterios y contrato de ejecucion;
guardar hilos de conversacion del proyecto;
proponer actualizaciones de memoria viva;
explicar que fuentes de contexto ha usado.

No debe decir que ha ejecutado cambios si solo ha propuesto acciones. Si propone algo, debe quedar como propuesta confirmable.

Que requiere confirmacion

Requiere confirmacion humana:

crear tareas;
cambiar estado de una tarea;
cerrar tareas;
registrar tiempo;
bloquear o desbloquear;
enviar una tarea a dispatch;
crear planes;
crear proyectos;
actualizar memoria del proyecto.

La confirmacion queda trazada en assistant_runs y en auditoria. Esto protege el sistema de cambios silenciosos y evita autonomia falsa.

Abrir el asistente

Abre Komandesk.
Selecciona el workspace correcto en la barra superior.
Abre el proyecto con el que vas a trabajar.
Pulsa el boton flotante AI.
Comprueba la linea de contexto del panel: debe mostrar el proyecto activo, sesiones y memoria resumida.

Si el panel muestra Sin proyecto activo, el asistente puede responder preguntas generales, pero no deberia crear planes ni memoria de proyecto.

Auditar un proyecto

Usa el boton Auditar proyecto o escribe:


audita proyecto actual

El asistente debe devolver:

estado general;
riesgos;
bloqueos;
cobertura de specs;
tareas sin spec;
tareas candidatas para worker local;
siguiente accion recomendada.

El backend entrega al modelo una foto operativa del proyecto: resumen de tareas, horas registradas, bloqueos, planes activos o en review, tareas abiertas y deuda de specs. El asistente no deberia mezclar tareas de otro proyecto.

Crear un proyecto con preview

Usa el boton Nuevo proyecto o escribe:


nuevo proyecto asistido: nombre Komandesk Docs, departamento Producto, objetivo ordenar la documentacion del asistente

Para poder proponer acciones necesita:

nombre del proyecto;
departamento o department_id;
objetivo;
alcance inicial;
restricciones o no objetivos;
tipo de ejecucion esperado: humano, asistido, worker local o mixto.

Si faltan datos, debe preguntar antes de proponer acciones.

Cuando hay datos suficientes, debe preparar propuestas:

project.create para crear el proyecto;
project_plan.create para crear un plan en review;
task.create para crear tareas iniciales con estimacion y criterios.

Estas propuestas no se ejecutan solas. Debes aceptar cada una desde el panel.

Crear un buen plan desde el asistente

Pide el plan con estructura, no solo con una idea suelta:


prepara un plan para el proyecto actual: objetivo, fases, tareas, criterios de aceptacion, riesgos, decisiones humanas y tiempos estimados

Un buen resultado debe incluir:

objetivo verificable;
fases pequenas;
tareas ejecutables;
estimacion de minutos;
criterio de salida por fase;
que puede hacer un worker;
que necesita revision humana;
que evidencia debe quedar al cierre.

Si el asistente propone project_plan.create, el plan se crea en review. No debe generar una cola ejecutable sin revision.

Crear buenas tareas desde el asistente

Una tarea ejecutable debe tener:

titulo claro;
descripcion concreta;
proyecto correcto;
estado inicial razonable, normalmente next o inbox;
estimacion;
criterios de aceptacion;
scope incluido y excluido;
dependencias;
contrato de ejecucion si puede ir a worker;
criterio de bloqueo si falta decision humana.

Ejemplo de peticion:


crea tareas para la fase 1 del plan: cada tarea debe tener spec, aceptacion, tiempo estimado y no debe entrar en dispatch hasta que yo revise

Si el asistente no sabe estimar, debe poner una estimacion conservadora y dejar la duda como pregunta.

Guardar hilos y memoria

El asistente guarda los turnos importantes en conversaciones de proyecto.

Usa:


historial proyecto

nuevo hilo

memoria proyecto

Cuando el modelo devuelve una memory_update, Komandesk la convierte en propuesta project_memory.update. Al aceptarla, la memoria se fusiona con la memoria existente:

resumen;
decisiones;
preguntas abiertas;
riesgos;
enlaces.

La fusion evita pisar decisiones anteriores. Aun asi, revisa la propuesta antes de aceptarla.

Limites honestos

El asistente no es un agente autonomo total.

Limitaciones actuales:

no debe ejecutar cambios sensibles sin confirmacion;
no reemplaza la revision humana de planes, tareas ni memoria;
no garantiza que un worker local tenga permisos o credenciales;
no deberia crear tareas de otro proyecto si no hay contexto claro;
no sustituye specs completas cuando el trabajo es grande;
no debe inventar datos comerciales, decisiones o resultados de ejecucion.

Si una respuesta es demasiado generica, pide:


vuelve a responder usando solo tareas abiertas, specs, bloqueos y planes del proyecto actual

Flujo recomendado

Abre el proyecto correcto.
Pulsa AI.
Ejecuta audita proyecto actual.
Revisa riesgos, bloqueos y tareas sin spec.
Pide un plan o tareas solo para la siguiente fase.
Acepta propuestas una a una.
Guarda memoria si hay decision nueva.
Deja tareas en review o next antes de enviarlas a worker.
Registra tiempo al cerrar cada bloque.

Senales de buena respuesta

Una respuesta buena:

usa el nombre del proyecto correcto;
menciona fuentes de contexto;
diferencia propuesta de ejecucion;
incluye tiempos;
incluye criterios de aceptacion;
dice que falta si no puede decidir;
no promete autonomia sin guardrails.

Una respuesta mala:

crea un plan sin objetivo medible;
recomienda dispatch sin credenciales verificadas;
ignora tareas bloqueadas;
mezcla proyectos;
propone cerrar tareas sin evidencia;
no registra tiempo.

Ejemplos rapidos


audita proyecto actual


nuevo proyecto asistido: nombre FlowKit QA, departamento Flowtitude, objetivo probar FDS y variables Bricks sin tocar produccion


prepara tareas para revisar este proyecto: una fase de inventario, una de correccion, una de QA y una de documentacion


resume tarea 1574


cierra tarea 1574 45 min nota: documentacion publicada y verificada

Resultado esperado

El asistente debe ayudarte a trabajar con menos ruido:

encontrar el siguiente paso;
crear estructura antes de ejecutar;
mantener memoria por proyecto;
dejar propuestas auditables;
convertir decisiones en tareas claras.

Si el asistente aumenta el ruido, no sigas aceptando propuestas. Pide una auditoria compacta y vuelve al proyecto, plan y tareas reales.