ComandeskHelp Inicio

Comandesk: simplificacion operativa

Fecha: 2026-05-11.

Este documento recoge la simplificacion pendiente para que Comandesk mantenga toda la potencia interna sin obligar al usuario a ver la complejidad tecnica.

Principio

La interfaz humana debe estar organizada por decisiones y tareas, no por tablas internas.

  • Si el usuario quiere trabajar, entra por cola, proyectos o alertas.
  • Si quiere configurar automatizacion, entra por perfiles/subagentes, skills, credenciales y despliegues.
  • Si quiere gestionar SaaS, entra por empresas, workspaces, usuarios y auditoria.
  • Slugs, IDs, runtimes y metadata deben quedar en detalle avanzado, no en la lista principal.

Organizacion Recomendada

Trabajo

  • Cola activa: ejecucion diaria.
  • Completadas: historial filtrable.
  • Alertas: incidencias vivas.
  • Recurrentes: plantillas y automatismos de tarea.

Automatizacion

  • Subagentes/perfiles: entidad principal visible para humanos.
  • Skills: conocimiento reusable, categorizado y activable.
  • Credenciales: secretos y proveedores, con referencias seguras.
  • Despliegues: targets y runners.
  • Runtimes/agentes tecnicos: zona avanzada, no protagonista del uso normal.

Producto

  • Plan actual.
  • Specs y PRD.
  • Flujos.
  • Documentacion viva del proyecto.

Gestion

  • Empresas.
  • Workspaces.
  • Usuarios.
  • Auditoria.
  • Configuracion SaaS.

Estado Actual Revisado

Agentes tecnicos

Los agentes tienen active, listado con include_inactive=true, actualizacion via PATCH /api/agents/:id y borrado logico cuando no estan en uso. Se pueden activar y desactivar sin borrarlos.

Subagentes / perfiles

Los perfiles son por workspace, tienen active, filtros por estado, categoria y runtime, y se pueden activar/desactivar sin borrarlos. Esta es la entidad que debe dominar el catalogo visible.

Skills

Las skills ya estan aisladas por workspace y tienen borrado logico con deleted_at, pero no tienen campo active. Ahora mismo no se pueden pausar sin retirarlas del uso normal. Cambio recomendado:

  • migracion: skills.active boolean not null default true;
  • API: GET /api/skills?include_inactive=true;
  • UI: filtro Activas, Inactivas, Todas;
  • contexto de ejecucion: usar solo skills activas salvo peticion explicita.

Categorias

Los perfiles ya soportan category dentro de metadata. Las skills usan tags, pero conviene normalizar una categoria primaria para lectura humana:

  • Frontend y UI.
  • Backend y datos.
  • DevOps y despliegue.
  • Producto y PRD.
  • QA y revision.
  • Marketing y contenido.
  • Seguridad.
  • Operaciones internas.

Exportar, Importar Y Clonar Configuracion

No hay todavia un flujo completo de export/import/clone de configuracion de workspace. Existen importadores puntuales para agentes/skills, pero no un paquete funcional para un cliente.

Propuesta de paquete:


{

  "version": 1,

  "account_id": 1,

  "source_workspace_id": 2,

  "profiles": [],

  "skills": [],

  "task_templates": [],

  "deployment_targets": [],

  "credential_refs": []

}

Reglas:

  • Solo clonar dentro del mismo cliente/cuenta por defecto.
  • Exportar secretos nunca; solo referencias y metadata segura.
  • En clonacion dentro de la misma cuenta, permitir reutilizar referencias de credenciales si el usuario lo confirma.
  • Importar siempre con previsualizacion: nuevos, modificados, omitidos y conflictos.
  • Permitir modo merge y modo replace, pero hacer replace solo con confirmacion explicita.

Flujo SaaS Simplificado

Empresas debe ser una lista limpia con accion principal Nueva empresa y detalle aparte.

  • Lista: nombre, plan, uso, estado y accion de detalle.
  • Crear empresa: modal.
  • Detalle de empresa: workspaces, usuarios, proyectos agregados, limites y auditoria.
  • Workspaces: se gestionan dentro de la empresa seleccionada.
  • Proyectos: pertenecen a un workspace, pero deben poder moverse a otro workspace del mismo cliente.
  • Tareas: se mueven indirectamente al mover el proyecto.
  • Credenciales y targets: no se duplican por defecto; se reasignan o se referencian con confirmacion.

UI

Reglas para evitar interfaces amontonadas:

  • Lista primero, detalle despues.
  • Accion principal visible y con estilo primario.
  • Estadisticas importantes: numero grande, fino, etiqueta debajo.
  • Badges semanticos: linea o acento del color de estado.
  • Marcos solo cuando separan bloques reales.
  • Modales para crear/editar cuando evitan ruido permanente.
  • Secciones invertidas solo para chuletas operativas o flujos criticos.

Proximos Cambios Recomendados

  1. Anadir active a skills con API y UI.
  2. Crear export/import/clone de configuracion de workspace dentro de la misma cuenta.
  3. Redisenar Automatizacion como catalogo de subagentes/perfiles con detalle.
  4. Redisenar Skills como biblioteca categorizada, con activar/desactivar y detalle limpio.
  5. Mantener Runtimes/agentes tecnicos como vista avanzada.
  6. Completar extraccion i18n para que ninguna pantalla nueva hardcodee cadenas visibles.