Saltar a contenido

Workspace - Roadmap Completo de Funcionalidades

Centro Neuralgico del Desarrollador + Sistema de Contexto Inteligente

Version: 6.0 (MULTI-AGENT COMPLETE) Fecha: 2026-01-30 Estado: ✅ Operativo - Listo para uso diario Rama: feature/misc-improvements

Este documento consolida y reemplaza: - WORKSPACE_MASTER_PLAN.md - Plan maestro de UI - FEATURE-workspace-productivity-improvements.md - Ideas de productividad - FEATURE-intelligent-context-orchestration.md - Sistema de contexto inteligente

Documentos relacionados: - FEATURE-clickup-integration.md (integración específica) - IDEAS-CURSOR-AI.md (ideas futuras basadas en Cursor)

Indice

  1. Vision y Principios
  2. Estado Actual - Auditoria 2026-01-30
  3. Arquitectura de Layout
  4. Roadmap de Implementacion
  5. Funcionalidades por Prioridad
  6. Especificaciones Tecnicas
  7. Metricas de Exito
  8. Apendices

1. Vision y Principios

1.1 Vision

Transformar el Workspace de Calmia Nexus en un centro neuralgico todo-en-uno para desarrolladores, donde puedan: - Gestionar su trabajo diario sin salir de la pantalla - Recibir contexto inteligente automatico (instrucciones, documentos, historial) - Capturar y procesar incidencias automaticamente con IA - Ejecutar acciones rapidas contextuales - Visualizar metricas y progreso en tiempo real - Colaborar con equipos de agentes especializados (Crews) - Mantener el flujo de trabajo sin interrupciones

1.2 Principio Fundamental

"EL CHAT ES EL REY" - Todo el diseño maximiza el area de conversacion mientras las herramientas permanecen accesibles pero no intrusivas.

2. Estado Actual - Auditoria 2026-01-30

2.1 Funcionalidades VERIFICADAS como Operativas

# Funcionalidad Archivo Principal Notas
1 Layout 3 paneles adaptativo Workspace.razor Flotantes < 1600px, docked >= 1600px
2 Barra de tabs de sesiones Workspace.razor:732-810 ARREGLADO - Ahora restaura todos los tabs
3 Crear nueva sesion (+) Workspace.razor:NewSession() OK
4 Cambiar entre sesiones Workspace.razor:ActivateSession() OK
5 Cerrar sesion/tab (X) Workspace.razor:CloseTab() OK
6 Renombrar sesion (doble click) workspace.js OK
7 Persistencia tabs localStorage workspace.js:113-148 ARREGLADO
8 Restaurar tabs al recargar Workspace.razor:RestoreOpenSessionsAsync() ARREGLADO
9 Indicador sesion activa CSS .workspace-tab.active OK
10 Indicador streaming en tab Puntos animados OK
11 Modo Focus (Ctrl+Shift+F) Workspace.razor:ToggleFocusMode() OK
12 Chat centrado en Focus max-width 900px, fuente 1.05rem OK
13 ESC para salir de Focus workspace.js OK
14-18 Paneles flotantes Backlog, Snippets, Contexto, Copilot OK
19 Badges con contador Workspace.razor:GetBacklogCount() OK
25-34 Area de chat completa Streaming SSE, UTF-8, 2h timeouts OK
35-40 CLI Output Panel GitHub style, coloreado, limites memoria OK
41-45 Quick Actions Configurable, reordenable OK
49 Selector de Proyecto ContextPanel.razor OK
53 Checkbox contexto proyecto ContextPanel.razor OK
54-58 Backlog Mini Panel Lista, filtro, refresh OK
60-64 Context Snippets CRUD completo OK
65-70 Status Bar Provider, tokens, tiempo, mensajes OK
72-74 Daily Stats Widget Metricas del dia con dialog OK
75-76 Wellness Widget Click para dialog OK
78 Calculo tiempo basado en actividad WorkTrackingService.CalculateActivityMinutes() OK
85-90 Copiloto Autonomo CopilotPanel.razor, CopilotService.cs ARREGLADO - Panel expandido
91-95 Keyboard Shortcuts Ctrl+Shift+F, Ctrl+B, Ctrl+J, Ctrl+N, ESC OK
96 Eye-Care Theme Colores #0B0E14, #9D50FF, #4DE8FF OK
97-100 Optimizaciones memoria MAX_STREAMING_CHARS=2MB, MAX_CLI_LINES=5000, etc. OK

2.2 Funcionalidades ARREGLADAS en esta sesion (2026-01-30)

# Funcionalidad Problema Solucion Archivo
A1 Restaurar tabs Solo cargaba 1 tab si habia GUID en URL Siempre restaurar, controlar navegacion Workspace.razor:1188-1249
A2 Persistencia instrucciones sesion Se capturaban pero no se guardaban Conectar callback a PUT /api/instructions/session/{id} Workspace.razor:OnContextChanged()
A3 "Trabajar en esto" -> Chat Solo vinculaba, no insertaba prompt Usar workResult.SuggestedPrompt con InsertText() Workspace.razor:OnWorkOnBacklogItem()
A4 WorkSession heartbeat Nunca se creaba WorkSession Auto-iniciar WorkSession en primer heartbeat Workspace.razor:SendHeartbeat()
A5 CopilotPanel expandido Se abria minimizado ForceExpanded="true" + logica corregida CopilotPanel.razor:782, Workspace.razor:885

2.3 NUEVA Funcionalidad: Pantalla Debug de Prompts

Shortcut: Ctrl+Shift+D Archivo: PromptDebugDialog.razor

Pantalla secreta para desarrolladores que muestra exactamente que se envia al LLM:

┌──────────────────────────────────────────────────────────────┐
│ 🔍 Debug de Prompt                              [Ctrl+Shift+D] │
├──────────────────────────────────────────────────────────────┤
│ [System Prompt] [Instrucciones] [Documentos] [Historial] [Msg] │
├──────────────────────────────────────────────────────────────┤
│ Prompt del Sistema Combinado                    ~2,340 tokens │
│                                                         [📋]  │
├──────────────────────────────────────────────────────────────┤
│ === INSTRUCCIONES DEL PROYECTO ===                           │
│ Este proyecto usa Clean Architecture...                       │
│                                                               │
│ === INSTRUCCIONES DE SESION ===                              │
│ Trabajamos en modo debug, sé detallado...                    │
│                                                               │
│ === DOCUMENTOS RELEVANTES ===                                │
│ --- docs/architecture.md (reference) ---                     │
│ La arquitectura del sistema consiste en...                   │
├──────────────────────────────────────────────────────────────┤
│                                    [🔄 Actualizar]  [Cerrar] │
└──────────────────────────────────────────────────────────────┘

5 Pestañas: 1. System Prompt - Prompt combinado completo con estimacion de tokens 2. Instrucciones - Proyecto y sesion por separado 3. Documentos - Documentos relevantes vinculados con preview 4. Historial - Resumen del historial si existe 5. Ultimo Mensaje - El ultimo mensaje enviado

Endpoint usado: POST /api/instructions/session/{sessionId}/build-context

2.4 Funcionalidades VERIFICADAS - Estado Final

Nota: Todas las migraciones han sido ejecutadas correctamente. Las funcionalidades que parecian "no implementadas" estan implementadas - solo faltaba documentacion.

# Funcionalidad Estado Como Usarla
46-48 Session Modes (Templates) ✅ OPERATIVO Migraciones ejecutadas. Selector visible en area de chat
59 Info IA en Backlog ✅ OPERATIVO Se muestra AICategory y AISummary si existen en el item. Ver BacklogMiniPanel.razor:61-81
71 Estado Remote Agent ✅ OPERATIVO Solo visible si la sesion tiene un Remote Agent asignado. Diseño correcto
77 Registro pausas ✅ OPERATIVO Ver seccion 2.6 abajo
80 Heartbeat ✅ ARREGLADO Auto-inicia WorkSession en primer heartbeat
83-84 Enriquecimiento IA (Brain) ✅ OPERATIVO Ver seccion 2.6 abajo

2.5 Funcionalidades ELIMINADAS (obsoletas)

# Funcionalidad Razon
50 Selector de Agente Reemplazado por SessionModes y Brain
51 Selector de Plugin Reemplazado por SessionModes y Brain
52 Selector de Skills Reemplazado por SessionModes y Brain

2.6 GUIA RAPIDA: Como usar funcionalidades "ocultas"

Enriquecimiento IA (Brain) - El Poder Oculto

El boton "Brain" analiza tu mensaje y sugiere mejoras automaticamente:

Como acceder: 1. Shift+Enter con mensaje escrito en el chat 2. Click en icono varita (AutoAwesome) junto al boton enviar

Que ofrece: - Agente sugerido (con % de confianza) - Plugin sugerido - Skills relevantes - Prompt mejorado - Documentos relacionados - Tareas del backlog relacionadas - Procedimientos aplicables

┌─────────────────────────────────────────────────┐
│ 🧠 Sugerencias de IA                            │
├─────────────────────────────────────────────────┤
│ 🤖 AGENTE RECOMENDADO                          │
│   [✓] Backend Architect (87% match)            │
│                                                 │
│ 🔌 PLUGIN SUGERIDO                             │
│   [✓] API Testing (75% match)                  │
│                                                 │
│ ✨ PROMPT MEJORADO                              │
│   "Implementar endpoint REST para autenticacion│
│    con validacion JWT y manejo de errores..."  │
│                                                 │
│ 📚 CONTEXTO ADICIONAL                          │
│   [✓] docs/api-guidelines.md                   │
│   [ ] Previous similar task BC-123             │
├─────────────────────────────────────────────────┤
│           [Sin enriquecer]  [Enviar mejorado]  │
└─────────────────────────────────────────────────┘

Sistema de Wellness - Cuida tu Salud

Como registrar pausas: 1. Click en icono corazon (❤️) en la barra de estado inferior 2. Si ShouldTakeBreak=true, aparecen botones: - "Descanso 5min" - "Descanso 15min" 3. Click en uno para registrar la pausa

Que muestra el dialog: - Score de bienestar del dia (0-100) - Minutos trabajados / descansados - Pausas tomadas - Minutos desde ultima pausa - Tendencias semanales - Configuracion (nueva pestaña): - Intensidad de recordatorios (off/gentle/normal/strict) - Intervalos de trabajo (estilo Pomodoro) - Tipos de alerta (descanso, visual, postura, hidratacion)

Debug de Prompts - Para Desarrolladores

Shortcut: Ctrl+Shift+D

Muestra exactamente que se envia al LLM: - System prompt combinado completo - Instrucciones del proyecto - Instrucciones de la sesion - Documentos relevantes vinculados - Resumen del historial - Ultimo mensaje enviado - Estimacion de tokens

Session Modes - Templates de Trabajo

Los 5 modos predeterminados del sistema:

Modo Icono Proposito
Normal ViewDashboard Trabajo estandar con todos los paneles
Focus CenterFocusStrong Solo chat, sin distracciones
Debugging BugReport Optimizado para depuracion con logs
Code Review RateReview Para revision de codigo
Planning Assignment Planificacion con backlog visible

Cada modo configura automaticamente: - Que paneles mostrar/ocultar - Prompt de sistema personalizado - Si cargar backlog activo - Si cargar documentos relacionados

2.5 Funcionalidades ELIMINADAS (obsoletas)

# Funcionalidad Razon
50 Selector de Agente Ya no tiene sentido con nuevo flujo
51 Selector de Plugin Ya no tiene sentido con nuevo flujo
52 Selector de Skills Ya no tiene sentido con nuevo flujo

3. Arquitectura de Layout

3.1 Wireframe - Modo Normal

+-------------------------------------------------------------------------------------+
| Calmia Nexus                                              [Notif] [User] [Theme]    |
+------+----------------------------------------------------------------------+-------+
|      | +- Tabs de Sesion -------------------------------------------------+ |       |
| Menu | | [* Session 1] [o Fix login bug] [o +Nueva]     [Backlog] [Debug] | | Stats |
|      | +------------------------------------------------------------------+ |       |
| Coll | +- Quick Actions (colapsable) ------------------------------------+ | Panel |
|      | | [Git Status] [Build] [Test] [Deploy] [...]                       | |       |
+------+ +==================================================================+ +-------+
       | ||                                                                || |       |
       | ||                     AREA DE CHAT                               || |       |
       | ||                                                                || |       |
       | ||  Conversacion con asistente IA                                 || |       |
       | ||                                                                || |       |
       | |+================================================================+| |       |
       | || +- CLI Output (colapsable) ----------------------------------+ || |       |
       | || | $ npm test                                                 | || |       |
       | || +------------------------------------------------------------+ || |       |
       | |+================================================================+| |       |
       | || +------------------------------------------------------------+ || |       |
       | || | [Attach] Escribe tu mensaje...              [Brain] [Send] | || |       |
       | || +------------------------------------------------------------+ || |       |
       | +==================================================================+ |       |
       | +- Status Bar -----------------------------------------------------+ |       |
       | | [*] Claude | 1.2k tokens | 45min | 12 msgs | [Wellness: OK]     | |       |
       | +------------------------------------------------------------------+ |       |
+------+----------------------------------------------------------------------+-------+

3.2 Nuevos Shortcuts de Teclado

Shortcut Accion Archivo
Ctrl+Shift+F Modo Focus workspace.js
Ctrl+Shift+D Debug de Prompts (NUEVO) workspace.js
Ctrl+B Toggle Backlog workspace.js
Ctrl+J Toggle Contexto workspace.js
Ctrl+N Nueva sesion workspace.js
Shift+Enter Enriquecimiento IA MessageInput.razor
ESC Cerrar paneles/salir focus workspace.js

4. Roadmap de Implementacion

FASE 1-5: COMPLETADAS

Ver historial de versiones anteriores del documento.

FASE 6: Orquestacion Multi-Agente (✅ COMPLETADA)

Estado: IMPLEMENTADO (2026-01-30) Prioridad: COMPLETADA

Funcionalidades implementadas: 1. Smart Suggestions - Autocompletado inteligente en chat (/api/dev-sessions/suggestions) 2. Memory System - Auto-deteccion de preferencias (MemoryService.cs, MemoriesPanel.razor) 3. Background Agents - Indicador de agentes en paralelo (BackgroundAgentsIndicator.razor) 4. Multi-Agent Orchestration - 4 modos: Sequential, Parallel, Debate, Consultation (MultiAgentOrchestrator.cs)

6.1 Smart Suggestions

  • Endpoint: GET /api/dev-sessions/suggestions
  • Frontend: Dropdown en MessageInput.razor con debounce 150ms
  • Fuentes: Backlog items, historial de mensajes, patrones comunes

6.2 Memory System

  • Tabla: UserMemories con auto-deteccion
  • Servicio: MemoryService.cs
  • Panel UI: MemoriesPanel.razor en Workspace
  • Categories: preference, fact, workflow, style

6.3 Background Agents Indicator

  • Archivo: BackgroundAgentsIndicator.razor
  • Funcion: Muestra agentes del copiloto ejecutandose en paralelo
  • SignalR: Eventos CopilotStateChanged, CopilotStepStarted, CopilotStepCompleted

6.4 Multi-Agent Orchestration

  • Servicio: MultiAgentOrchestrator.cs
  • Endpoint: POST /api/copilot/orchestrate
  • Modos disponibles:
  • Sequential - Pasos uno tras otro (comportamiento clasico)
  • Parallel - Divide tarea en sub-tareas paralelas
  • Debate - Dos agentes argumentan, un arbitro decide
  • Consultation - Consulta a especialistas (Security, Performance, etc.)

FASE 7: Productividad Avanzada (PENDIENTE)

Estado: No iniciado Prioridad: BAJA

Funcionalidades planificadas: - Smart Action Detection - Scheduled Artifacts - Panel Errores Sentry - Daily Summary Automatico

5. Funcionalidades PENDIENTES por Prioridad

✅ PRIORIDAD ALTA - COMPLETADA (2026-01-30)

# Funcionalidad Estado Verificado
1 Ejecutar migracion SessionModes ✅ HECHO RunAllMissingMigrations confirma 5 registros
2 Documentar como usar Brain/Enrichment ✅ HECHO Ver seccion 2.6
3 Documentar como registrar pausas ✅ HECHO Ver seccion 2.6
4 Arreglar persistencia instrucciones ✅ HECHO OnContextChanged() -> SaveSessionInstructions()
5 Arreglar "Trabajar en esto" -> Chat ✅ HECHO OnWorkOnBacklogItem() -> InsertText()
6 Arreglar restauracion de tabs ✅ HECHO RestoreOpenSessionsAsync() siempre ejecuta
7 Crear pantalla Debug de Prompts ✅ HECHO Ctrl+Shift+D

✅ PRIORIDAD MEDIA - COMPLETADA (2026-01-30)

# Funcionalidad Estado Archivos Principales
1 Smart Suggestions ✅ HECHO SuggestionsService.cs, MessageInput.razor
2 Memory System ✅ HECHO MemoryService.cs, MemoriesPanel.razor, UserMemory.cs
3 Background Agents ✅ HECHO BackgroundAgentsIndicator.razor, CopilotService.cs
4 Multi-Agent Orchestration ✅ HECHO MultiAgentOrchestrator.cs, CopilotController.cs

🟢 PRIORIDAD BAJA (Nice to have) - FUTURO

# Funcionalidad Esfuerzo Dependencia Descripcion
5 Shadow Workspace 1-2 semanas Remote Agent Sandbox donde la IA prueba codigo antes de mostrarlo
6 Bugbot (auto review) 1 semana Copilot Code review automatico al terminar tarea
7 Supermemory MCP 3-5 dias MCP framework Busqueda semantica en historial de sesiones
8 Daily Summary 2-3 dias Haiku Resumen automatico al final del dia
9 Smart Action Detection 1 semana Nuevo Detectar acciones desde mensajes ("haz commit")
10 Panel Errores Sentry 2-3 dias Sentry API Ver errores recientes del proyecto en panel

6. Especificaciones Tecnicas

6.1 Archivos Clave del Workspace

Orchestrator/src/Orchestrator.Admin/Components/Pages/Workspace/
├── Workspace.razor              # Componente principal (~3000 lineas)
├── ContextPanel.razor           # Panel de contexto (proyecto, instrucciones)
├── CopilotPanel.razor           # Panel del copiloto autonomo
├── PromptDebugDialog.razor      # NUEVO - Dialog de debug de prompts
├── WellnessDetailDialog.razor   # Dialog de bienestar
├── WorkspaceStatusBar.razor     # Barra de estado inferior
├── SessionModeSelector.razor    # Selector de modos de sesion
└── ...

Orchestrator/src/Orchestrator.Admin/wwwroot/js/
└── workspace.js                 # Shortcuts, localStorage, interop JS

6.2 Servicios Backend Relacionados

Shared/Shared.Admin/Services/
├── CopilotService.cs            # Copiloto autonomo
├── CopilotPlanGenerator.cs      # Generador de planes (Haiku)
├── CopilotResponseEvaluator.cs  # Evaluador de respuestas
├── DevSessionService.cs         # Sesiones de desarrollo
├── InstructionsManagerService.cs # Instrucciones jerarquicas
├── DocumentContextService.cs    # Documentos contextuales
├── WorkTrackingService.cs       # Tracking de trabajo
├── WellnessService.cs           # Sistema de bienestar
└── ...

6.3 Optimizaciones de Memoria (Implementadas)

// Workspace.razor:899-908
private const int MAX_STREAMING_CHARS = 2_000_000;  // 2MB maximo streaming
private const int MAX_CLI_LINES = 5000;             // Maximo 5000 lineas CLI
private const int MAX_LINE_LENGTH = 50_000;         // Maximo 50KB por linea
private const int MAX_OPEN_SESSIONS = 15;           // Maximo 15 tabs abiertos
private const int SIGNALR_UPDATE_THROTTLE_MS = 100; // Throttling UI updates

7. Metricas de Exito

Metrica Objetivo Estado Actual
Tiempo en Workspace +30% Midiendo
Uso de Quick Actions 5+ por dia Implementado
Tareas desde Backlog 80% Implementado
Tokens por request -50% Implementado con IHistoryManagerService.GetOptimizedHistoryAsync()
Descansos tomados >80% sugeridos Implementado

Apendices

Apendice A: Ejemplos de Instrucciones de Proyecto

Ver seccion A.1-A.2 del documento anterior.

Apendice B: Estrategia de Optimizacion de Contexto

Ver seccion B.1-B.9 del documento anterior.

Apendice C: Ideas de Cursor AI

Ver documento separado: docs/features/IDEAS-CURSOR-AI.md

Historial de Cambios

Fecha Version Cambios
2026-01-30 5.0 Verificacion completa: TODAS las prioridades ALTAS completadas. Guia de uso añadida
2026-01-30 4.0 Auditoria completa, arreglos de bugs, nueva pantalla debug prompts
2026-01-30 3.2 Fase 6.5 Copiloto Autonomo completada
2026-01-29 3.1 Apendice B: Estrategia optimizacion contexto Claude CLI
2026-01-29 3.0 Documento consolidado de 3 fuentes
2026-01-25 2.0 WORKSPACE_MASTER_PLAN fusionado

Resumen Ejecutivo - Estado Actual del Workspace

✅ COMPLETADO (100 funcionalidades operativas)

  • Layout adaptativo 3 paneles
  • Sistema de tabs con persistencia
  • Modo Focus (Ctrl+Shift+F)
  • Paneles flotantes (Backlog, Snippets, Contexto, Copilot)
  • Area de chat con streaming SSE, UTF-8, timeouts 2h
  • CLI Output con estilo GitHub
  • Quick Actions configurables
  • Session Modes (5 templates predeterminados)
  • Context Panel con instrucciones de proyecto y sesion
  • Backlog Mini Panel con info IA
  • Status Bar con metricas
  • Daily Stats Widget
  • Wellness System completo (pausas, recordatorios, configuracion)
  • Copiloto Autonomo
  • Debug de Prompts (Ctrl+Shift+D)
  • Enriquecimiento IA (Brain) - Shift+Enter
  • Optimizaciones de memoria (2MB streaming, 5000 CLI lines, 15 tabs)

🎯 PROXIMO: Orquestacion Multi-Agente

Ver docs/features/IDEAS-CURSOR-AI.md para el plan detallado de: 1. Background Agents Paralelos 2. Memory System 3. Smart Suggestions

Documento actualizado - 30 Enero 2026 (v5.0) Estado: Workspace FEATURE-COMPLETE para uso diario