docs-mission-control/docs/REQUISITOS.md

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:

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