Documentación inicial de Control de Misión

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*

docs/agentes/PERFIL.md

@@ -0,0 +1,38 @@
+# Agente: [NOMBRE]
+
+## Identidad
+- **Rol**: [Rol principal]
+- **Reporta a**: [A quién reporta]
+- **Delegado por**: [Quién le delega]
+- **Emoji distintivo**: [Emoji]
+
+## Capacidades
+- [Capacidad 1]
+- [Capacidad 2]
+- [Capacidad N]
+
+## Limitaciones
+- [Limitación 1]
+- [Limitación 2]
+
+## Protocolo de Comunicación
+- **Recibe tareas de**: [Agente(s)]
+- **Envía resultados a**: [Agente(s)]
+- **Formato preferido**: [ markdown / structured / libre ]
+
+## Interacciones Típicas
+1. [Recibir tarea] → [Procesar] → [Entregar resultado]
+2. [Recibir consulta] → [Analizar] → [Responder]
+
+## Métricas
+- Tiempo promedio por tarea tipo: 
+- Tasa de bloqueo: 
+
+## Historial de Misiones
+| Fecha | Misión | Resultado | Tiempo |
+|-------|--------|-----------|--------|
+| - | - | - | - |
+
+---
+
+*Completar con datos reales del agente*

docs/comunicacion/proTOCOLO.md

@@ -0,0 +1,100 @@
+# Protocolo de Comunicación entre Agentes
+
+## 1. Principios Fundamentales
+
+1. **Claridad**: Cada mensaje debe tener intención clara (pedir, informar, decidir)
+2. **Contexto**: Incluir información relevante para que el receptor pueda actuar
+3. **Trazabilidad**: Guardar las comunicaciones importantes en documentación
+4. **Brevedad**: Ir al punto, evitar información innecesaria
+
+## 2. Formato de Mensajes
+
+### 2.1 Formato Estructurado (para reportes a Erwin)
+```
+## [TIPO] | De: [Agente] | Para: [Destinatario]
+
+**Asunto**: [Título claro]
+
+**Estado**: [OK / Bloqueado / Completado]
+**Contexto**: [Qué está pasando]
+**Acción requerida**: [Solo si necesita respuesta]
+**Próximo paso**: [Si hay seguimiento]
+
+---
+Timestamp: [YYYY-MM-DD HH:MM]
+```
+
+### 2.2 Formato Libre (entre agentes)
+```
+**De [Agente] → [Agente]**: [Mensaje directo]
+
+[Contenido]
+```
+
+## 3. Tipos de Comunicación
+
+| Tipo | De | Para | Ejemplo |
+|------|----|----|---------|
+| Asignación | Erwin | [Agente] | "Rocket: implementa feature X" |
+| Consulta | [Agente] | [Agente] | "Bulma: ¿正当 su arquitectura para Y?" |
+| Reporte | [Agente] | Erwin | "Completado: feature X" |
+| Escalamiento | [Agente] | Erwin | "Bloqueado: necesito decisión sobre Z" |
+| Revisión | Erwin | Sherlock | "Revisa la implementación de X" |
+
+## 4. Reglas de Respuesta
+
+- **Asignación**: Confirmar recibo + tiempo estimado (si no es obvio)
+- **Consulta**: Responder en mismo hilo, máximo 3 intercambios
+- **Reporte**: Erwin confirma recepción
+- **Escalamiento**: Erwin responde en prioridad
+
+## 5. Canales
+
+1. **Directo (OpenClaw)**: Para comunicación inmediata
+2. **Documentación (repo)**: Para decisiones y resultados formales
+3. **Cola de tareas**: Para asignaciones asíncronas
+
+## 6. Escalamiento
+
+```
+Agente detecta problema
+        │
+        ▼
+¿Puede resolverlo solo? ──Sí──→ Resuelve y documenta
+        │
+        No
+        │
+        ▼
+Informa a Erwin con:
+- Qué pasó
+- Qué intentó
+- Qué necesita para continuar
+        │
+        ▼
+Erwin decide:
+- Reasigna
+- Cambia enfoque
+- Provee recursos/decisión
+```
+
+## 7. Timeouts
+
+| Situación | Timeout | Acción |
+|-----------|---------|--------|
+| Asignación sin confirmación | 5 min | Reenviar |
+| Consulta sin respuesta | 15 min | Escalar a Erwin |
+| Tarea asignada sin progreso | 1h | Check-in con agente |
+| Bloqueo sin resolución | 30 min | Erwin interviene |
+
+## 8. Best Practices
+
+- ✅ Siempre confirmar cuando recibes una asignación
+- ✅ Informar a Erwin de bloqueos inmediatamente
+- ✅ Documentar decisiones importantes en el repo
+- ✅ Mantener los mensajes enfocados en una sola cosa
+- ❌ No dejar mensajes sin respuesta por más de 1h
+- ❌ No escalar sin antes intentar resolver
+
+---
+
+*Protocolo v1.0 — Control de Misión*

docs/workflow/flujo-estandar.md

@@ -0,0 +1,95 @@
+# Workflow Estándar
+
+Flujo completo para misiones de complejidad media/alta.
+
+## Fases
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│  FASE 1: DEFINICIÓN (Erwin)                                         │
+├─────────────────────────────────────────────────────────────────────┤
+│  1.1 Recibir solicitud de misión                                    │
+│  1.2 Definir objetivo claro                                         │
+│  1.3 Identificar restricciones y contexto                           │
+│  1.4 Asignar ID de misión                                           │
+│  1.5 Crear documento de misión                                      │
+└──────────────────────────────┬──────────────────────────────────────┘
+                               ▼
+┌─────────────────────────────────────────────────────────────────────┐
+│  FASE 2: ANÁLISIS (Bulma)                                           │
+├─────────────────────────────────────────────────────────────────────┤
+│  2.1 Analizar requisitos técnicos                                   │
+│  2.2 Diseñar arquitectura/solución conceptual                       │
+│  2.3 Identificar riesgos técnicas                                   │
+│  2.4 Proponer descomposición en subtareas                           │
+│  2.5 Documentar decisión de diseño                                 │
+└──────────────────────────────┬──────────────────────────────────────┘
+                               ▼
+┌─────────────────────────────────────────────────────────────────────┐
+│  FASE 3: IMPLEMENTACIÓN (Rocket)                                    │
+├─────────────────────────────────────────────────────────────────────┤
+│  3.1 Recibir especificación de Bulma                                │
+│  3.2 Implementar código                                             │
+│  3.3 Tests unitarios básicos                                       │
+│  3.4 Documentar decisiones de implementación                       │
+│  3.5 Reportar a Erwin con resultado/link                            │
+└──────────────────────────────┬──────────────────────────────────────┘
+                               ▼
+┌─────────────────────────────────────────────────────────────────────┐
+│  FASE 4: UI/UX (Hiro) [opcional, si aplica]                         │
+├─────────────────────────────────────────────────────────────────────┤
+│  4.1 Diseñar interfaz según specs                                   │
+│  4.2 Obtener feedback de usuario (si disponible)                    │
+│  4.3 Ajustar diseño                                                 │
+│  4.4 Entregar specs a Rocket o documentación                        │
+└──────────────────────────────┬──────────────────────────────────────┘
+                               ▼
+┌─────────────────────────────────────────────────────────────────────┐
+│  FASE 5: REVISIÓN (Sherlock)                                        │
+├─────────────────────────────────────────────────────────────────────┤
+│  5.1 Recibir entregable                                             │
+│  5.2 Revisar código/documentación/diseño                            │
+│  5.3 Probar funcionalidad                                           │
+│  5.4 Documentar hallazgos                                            │
+│  5.5 Si hay problemas → volver a fase correspondiente               │
+│  5.6 Si está OK → aprobar                                           │
+└──────────────────────────────┬──────────────────────────────────────┘
+                               ▼
+┌─────────────────────────────────────────────────────────────────────┐
+│  FASE 6: DOCUMENTACIÓN (Claudia)                                    │
+├─────────────────────────────────────────────────────────────────────┤
+│  6.1 Recopilar toda la información de la misión                    │
+│  6.2 Estructurar documentación final                                │
+│  6.3 Actualizar índices del repo                                    │
+│  6.4 Archivar misión como completada                                │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+## Roles por Fase
+
+| Fase | Agente Principal | Support |
+|------|-----------------|---------|
+| Definición | Erwin | - |
+| Análisis | Bulma | Erwin, Sherlock (review técnico) |
+| Implementación | Rocket | Bulma (consultas) |
+| UI/UX | Hiro | Rocket (integración), Erwin (feedback) |
+| Revisión | Sherlock | Bulma, Rocket |
+| Documentación | Claudia | Todos |
+
+## Criterios de Avance
+
+- Para pasar de fase se requiere:
+  - Entregable completo según criterios definidos
+  - Aprobación del agente de fase (o de Erwin si hay conflicto)
+  - Documentación actualizada
+
+## Indicadores de Bloqueo
+
+- Fase sin progreso en >2h (en horario activo)
+- Agente reporta uncertainty
+- Conflicto entre dos agentes
+- Cambio de requisitos sin notificación
+
+---
+
+*Workflow v1.0 — Control de Misión*