155 lines
5.4 KiB
Markdown
155 lines
5.4 KiB
Markdown
# 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*
|