# 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*