Update README with system documentation

README.md

@@ -1,3 +1,49 @@
-# mason
+# MASON
 
-Espacio de enriquecimiento - Sistema TZZR
+**Espacio de enriquecimiento - Sistema TZZR**
+
+## Rol
+
+Mesa de trabajo donde el usuario completa y corrige información antes de consolidar en FELDMAN.
+
+## Posición en el Flujo
+
+```
+CLARA/MARGARET ──┬──► MASON ──► FELDMAN
+                 │       ▲
+ALFRED/JARED ────┘       │
+  (si incidencia)        │
+                         │
+FELDMAN ─────────────────┘
+  (devolver para corregir)
+```
+
+## Funciones
+
+| Acción | Descripción |
+|--------|-------------|
+| Enriquecer | Añadir metadata, notas, contexto |
+| Corregir | Modificar datos incorrectos |
+| Re-etiquetar | Cambiar etiquetas de archivos |
+| Acelerar | Enviar a FELDMAN antes de 24h |
+| Retener | Mantener más tiempo en edición |
+
+## Tiempos
+
+- **Ventana default**: 24h (configurable)
+- **Si expira**: Auto-envío a FELDMAN
+
+## Perfiles de Usuario
+
+| Perfil | Uso de MASON |
+|--------|--------------|
+| Novato | Usa mucho este espacio |
+| Avanzado | Paso casi automático |
+
+## Arquitectura
+
+Ver documentación completa en [contratos-comunes/architecture](https://git.tzzr.me/tzzr/contratos-comunes/src/branch/main/architecture/03-mason.md)
+
+---
+
+*Componente del sistema TZZR*