Documentación inicial de Control de Misión

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*