# Flujos de Trabajo

## Reglas de Ejecución por Instancia

### Principio Fundamental

**Cada instancia Claude solo ejecuta comandos directamente en su propio servidor.**

| Instancia | Servidor | IP | Puede ejecutar en |
|-----------|----------|-----|-------------------|
| architect | ARCHITECT | 69.62.126.110 | Solo ARCHITECT |
| hst | HST | 72.62.2.84 | Solo HST |
| deck | DECK | 72.62.1.113 | Solo DECK |
| corp | CORP | 92.112.181.188 | Solo CORP |
| runpod | RunPod | Variable | Solo sus pods |
| locker | ARCHITECT | 69.62.126.110 | Solo su contexto |

### Delegación de Tareas

Cuando una instancia necesita que se ejecute algo en otro servidor:

1. **NO ejecutar directamente** via SSH al otro servidor
2. **Enviar mensaje** a la instancia correspondiente via PostgreSQL
3. **Documentar** la tarea solicitada
4. **Esperar** confirmación de la otra instancia

### Ejemplo de Delegación

```sql
-- architect necesita que deck ejecute algo
INSERT INTO mensajes_v2 (conversacion_id, role, contenido)
SELECT id, 'user', 'Ejecuta X en tu servidor'
FROM conversaciones
WHERE instancia_id = 'deck' AND activa = true;
```

### Excepciones

- **Consultas de solo lectura**: Se permiten consultas SSH para verificar estado
- **Emergencias**: En caso de caída de una instancia, otra puede intervenir temporalmente

---

## Comunicación Entre Instancias

### Canal Principal: PostgreSQL

Tabla `mensajes_v2` con estructura de chat por conversación.

```
conversaciones (instancia_id) --> mensajes_v2 (conversacion_id)
```

### Flujo de Mensaje

1. Instancia origen inserta mensaje con role='user'
2. Windmill detecta mensaje pendiente
3. Windmill invoca Claude de la instancia destino
4. Respuesta se guarda con role='assistant'

---

## Windmill

### Triggers

| Trigger | Frecuencia | Función |
|---------|------------|---------|
| Mensaje nuevo | 30s | Procesar mensajes pendientes |
| Retry queue | 5m | Reintentar envíos fallidos |
| Heartbeat | 1h | Verificar estado de instancias |

### Endpoint

```
URL: https://flows.tzzr.me
Workspace: admins
```

---

*Actualizado: 2025-12-21*