From 4e443120febc46de30b5a84339a0e2321783e9e6 Mon Sep 17 00:00:00 2001
From: tzzrgit <git@tzr.systems>
Date: Mon, 22 Dec 2025 09:42:10 +0100
Subject: [PATCH] Update README with system documentation

---
 README.md | 50 ++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 48 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 22b67ce..53c77ab 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,49 @@
-# mason
+# MASON
 
-Espacio de enriquecimiento - Sistema TZZR
\ No newline at end of file
+**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*