101 lines
2.7 KiB
Markdown
101 lines
2.7 KiB
Markdown
# 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*
|