Update README with system documentation

README.md

@@ -1,3 +1,57 @@
-# sentinel
+# SENTINEL
 
-Auditoria del sistema - Sistema TZZR
+**Auditoría del sistema - Sistema TZZR**
+
+## Rol
+
+Observador paralelo que audita todos los componentes del sistema.
+
+## Posición
+
+```
+┌─────────┐   ┌─────────┐   ┌─────────┐   ┌─────────┐   ┌─────────┐
+│ CLARA   │   │MARGARET │   │ALFRED/  │   │ MASON   │   │ FELDMAN │
+│         │   │         │   │JARED    │   │         │   │         │
+└────┬────┘   └────┬────┘   └────┬────┘   └────┬────┘   └────┬────┘
+     │             │             │             │             │
+     └─────────────┴─────────────┴─────────────┴─────────────┘
+                                 │
+                                 ▼
+                  ┌──────────────────────────────┐
+                  │          SENTINEL            │
+                  └──────────────────────────────┘
+```
+
+**SENTINEL no está en el flujo lineal. Observa TODO en paralelo.**
+
+## Tipos de Auditoría
+
+| Tipo | Cuándo | Coste |
+|------|--------|-------|
+| **Superficial** | Siempre | Bajo |
+| **Profunda** | Errores | Alto |
+| **Profunda** | Muestreo X% | Alto |
+
+## Por qué Muestreo
+
+Auditar todo en profundidad haría el sistema muy pesado. El muestreo:
+- Mantiene rendimiento
+- Detecta problemas sistémicos
+- Mide calidad de procesos
+
+## Alertas
+
+| Nivel | Acción |
+|-------|--------|
+| info | Log |
+| warning | Log + notificación |
+| error | Log + notificación urgente |
+| critical | Log + notificación + pausa |
+
+## Arquitectura
+
+Ver documentación completa en [contratos-comunes/architecture](https://git.tzzr.me/tzzr/contratos-comunes/src/branch/main/architecture/05-sentinel.md)
+
+---
+
+*Componente del sistema TZZR*