# 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*