docs-mission-control/docs/comunicacion/proTOCOLO.md

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