Documentación inicial de Control de Misión

2026-03-27 18:18:52 +00:00
parent f1e9265bd2
commit bd4eab54ce
7 changed files with 575 additions and 2 deletions
--- a/docs/REQUISITOS.md
+++ b/docs/REQUISITOS.md
@@ -0,0 +1,154 @@
+# Control de Misión — Requisitos del Sistema
+
+## 1. Objetivo del Sistema
+
+Control de Misión es un sistema de coordinación de agentes que permite:
+- Definir misiones (objetivos) con claridad
+- Asignar tareas a agentes especializados según sus capacidades
+- Rastrear el progreso y mantener trazabilidad
+- Documentar decisiones y resultados automáticamente
+
+## 2. Funcionalidades Principales
+
+### 2.1 Gestión de Misiones
+- **Crear misión**: Título, descripción, prioridad,deadline
+- **Descomponer misión**: Erwin divide en subtareas
+- **Asignar subtareas**: Cada tarea va al agente apropiado
+- **Estado de misión**: Pendiente → En Progreso → Completada / Bloqueada
+- **Historial**: Todas las acciones quedan registradas
+
+### 2.2 Catálogo de Agentes
+Cada agente tiene perfil documentado con:
+- Rol y responsabilidades
+- Capacidades y limitaciones
+- Protocolos de comunicación preferidos
+- Métricas de rendimiento
+
+### 2.3 Protocolo de Comunicación
+- Formato estándar de mensajes entre agentes
+- Canales: Síncrono (chat directo) / Asíncrono (cola de tareas)
+- Reglas de escalamiento: Si un agente se bloquea, escala a Erwin
+- Timeouts y reintentos automáticos
+
+### 2.4 Workflows Predefinidos
+- **Workflow estándar**: Idea → Análisis → Diseño → Implementación → Revisión → Documentación
+- **Workflow rápido**: Para tareas simples de una sola paso
+- **Workflow de emergencia**: Prioridad máxima con revisión simplificada
+
+### 2.5 Dashboard de Estado
+- Misiones activas y su progreso
+- Agentes disponibles/ocupados
+- Tareas pendientes por agente
+- Alertas de bloqueos o demoras
+
+## 3. Estructura de Documentación Requerida
+
+```
+control-mision/
+├── docs/
+│   ├── agentes/           # Perfiles de cada agente
+│   │   ├── erwin.md
+│   │   ├── bulma.md
+│   │   ├── rocket.md
+│   │   ├── hiro.md
+│   │   ├── sherlock.md
+│   │   └── claudia.md
+│   ├── workflow/          # Flujos de trabajo
+│   │   ├── flujo-estandar.md
+│   │   ├── flujo-rapido.md
+│   │   └── flujo-emergencia.md
+│   ├── comunicacion/      # Protocolos
+│   │   ├── protocolo-mensajes.md
+│   │   ├── escalamiento.md
+│   │   └── formatos.md
+│   └── REQUISITOS.md      # Este documento
+├── proyectos/             # Misiones activas y completadas
+│   └── [proyecto-001]/...
+├── ejemplos/              # Casos de uso reales
+│   ├── ejemplo-001.md
+│   └── ejemplo-002.md
+└── README.md
+```
+
+## 4. Metadatos de Misión
+
+Cada misión debe tener:
+```yaml
+nombre: string
+descripcion: string
+prioridad: baja|media|alta|critica
+creada_por: agente
+creada_en: timestamp
+deadline: timestamp (opcional)
+estado: pendiente|en_progreso|completada|bloqueada
+subtareas:
+  - id: string
+    nombre: string
+    asignada_a: agente
+    estado: pendiente|en_progreso|completada
+    resultado: string (al completar)
+```
+
+## 5. Reglas de Coordinación
+
+### 5.1 Asignación por Defecto
+| Tipo de Tarea | Agente Asignado |
+|---------------|------------------|
+| Arquitectura, diseño de sistemas | Bulma |
+| Código, scripts, implementación | Rocket |
+| UI/UX, interfaces | Hiro |
+| Revisión, validación, testing | Sherlock |
+| Documentación, organización | Claudia |
+| Coordinación, decisión,拆分 de trabajo | Erwin |
+
+### 5.2 Reglas de Escalamiento
+1. Agente bloqueado → informa a Erwin con contexto
+2. Erwin reasigna o ajusta el plan
+3. Si se requiere cambio de arquitectura → consulta a Bulma
+4. Si hay conflicto de prioridades → Erwin decide
+
+### 5.3 Comunicación Entre Agentes
+- **Agente → Agente**: Formato libre para consulta/coordinación
+- **Agente → Erwin**: Formato estructurado con estado, bloqueo, solicitud
+- **Erwin → Agente**: Órdenes claras con contexto y expectativa
+
+## 6. Estados y Transiciones
+
+```
+                    ┌─────────────┐
+                    │   PENDIENTE  │ (Misión creada)
+                    └──────┬──────┘
+                           │ Erwin la approve y asigna
+                           ▼
+                    ┌─────────────┐
+              ┌─────│ EN PROGRESO │─────┐
+              │     └─────────────┘     │
+       Bloqueo                          │ Todas subtareas completadas
+              │                         │
+              ▼                         ▼
+       ┌──────────┐              ┌───────────┐
+       │ BLOQUEADA│              │ COMPLETADA│
+       └──────────┘              └───────────┘
+              │                         ▲
+       Erwin resuelve                  │
+              └─────────────────────────┘
+```
+
+## 7. Métricas del Sistema
+
+- Tiempo promedio de resolución por tipo de tarea
+- Tasa de bloqueo por agente
+- Carga de trabajo por agente (tareas activas)
+- Precisión de estimaciones vs tiempo real
+
+## 8. Integraciones Futuras (Opcional)
+
+- Bot de Telegram para crear/monitorear misiones
+- Hooks de Gitea para automatizar estados
+- API REST para herramientas externas
+- Dashboard web para visualización
+
+---
+
+*Documento creado como parte del proyecto Control de Misión*
+*Fecha: 2026-03-27*