MUX 1.2 — Roustix User Experience Guide

MUX 1.2 · Cultura de desarrollo

Las UX Laws
no son decorativas.

Cada funcionalidad cumple las cinco leyes antes de producción. Una sola violación → rediseñar antes del merge.

UX Laws DEC COPY MEASURE RESEARCH

Toda la operación.Una sola plataforma.

MTX-UX-DEC

Decision Matrix

Situación	Decisión
Más de 8 campos	Dividir en pasos
Acción irreversible	Solicitar confirmación
Error del usuario	Explicar y sugerir solución
Proceso largo	Mostrar progreso
Sin información	Empty State + CTA

decision-matrix.md — 15 reglas · sin discusiones en review

MTX-UX-COPY

Una sola voz en producto

✅ Correcto	❌ Incorrecto
Guardar cambios	Aceptar
Crear orden de trabajo	Enviar
No encontramos resultados.	Error.

copy.md

MTX-UX-MEASURE

Objetivos medibles

< 3 minTTFAV

< 2 minTTCOT

< 15 sTTFFI

measure.md →

MTX-UX-RESEARCH

Evolución con evidencia

¿Cómo hacemos pruebas con usuarios? → Protocolo en research.md
¿Cada cuánto revisamos UX? → Cada PR, sprint, release, trimestre
¿Cómo priorizamos? → Impacto × evidencia × North Star
¿Feedback de clientes? → Plantilla `ux-feedback`

research.md

MUX · Personas ilustradas

Ocho códigos.
Cinco vivos hoy.

MTX-UX-PER-001

Laura

42 años · Gerente

Goal: Tomar decisiones

Anti-Goal: Aprender un ERP

MTX-UX-PER-002

Carlos

35 años · Técnico

Goal: Registrar rápido

Anti-Goal: Llenar formularios

MTX-UX-PER-003

Valentina

28 años · Vendedora

Goal: Vender

Anti-Goal: Buscar inventario

MTX-UX-PER-004

Roberto

45 años · Bodeguero

Goal: Trazabilidad

Anti-Goal: Contar dos veces

MTX-UX-PER-005

Andrea

38 años · Administradora

Goal: Dejar operando

Anti-Goal: Ser IT de todos

Códigos reservados

No hoy. Pero previsto.

📋 MTX-UX-PER-006

Auditor

ISO · Checklists · Cumplimiento

🚚 MTX-UX-PER-007

Proveedor

Portal · Cotizaciones · Compras

🤝 MTX-UX-PER-008

Cliente

CRM · Portal · Autoservicio

User Journey · Carlos

👨‍🔧 Del login al dashboard actualizado

Inicia sesión

Ve OTs asignadas

Abre OT

Consulta activo

Registra trabajo

Adjunta fotos

Cierra OT

Dashboard de Laura actualizado

journeys/tecnico.md · Todos los journeys

Goals · Anti-Goals

Cambia el diseño

Gerente

Goal: Decidir
Anti: Aprender ERP

Técnico

Goal: Registrar
Anti: Formularios

Vendedor

Goal: Vender
Anti: Buscar stock

goals.md completo →

North Star × 3

NS1TTFAV
Primera acción útil

NS2TTCOT
Cerrar una OT

NS3TTFFI
Encontrar información

north-star.md — métricas y objetivos por perfil

Roustix UX Laws

No principios. Leyes.

MTX-UX-LAW-001

Nunca mostrar una pantalla vacía.

MTX-UX-LAW-002

Toda acción debe tener retroalimentación.

MTX-UX-LAW-003

Nunca hacer perder información al usuario.

MTX-UX-LAW-004

Siempre explicar el siguiente paso.

MTX-UX-LAW-005

La acción principal siempre es evidente.

laws.md · checklist pre-merge

MTX-UX-A11Y

Accesibilidad

A11Y-001	Contraste WCAG AA
A11Y-002	Navegación teclado
A11Y-003	Focus visible
A11Y-004	Lectores de pantalla
A11Y-005	Targets 44×44 px
A11Y-006	Alt text

accessibility.md →

Roustix Documentation Suite

Nomenclatura M*

Código	Nombre completo
MBB	Roustix Brand Book
MDL	Roustix Design Language
MUX	Roustix User Experience Guide
MRL	Roustix Report Language
MCM	Roustix Commercial Manual
MAG	Roustix API Guide
MADR	Roustix Architecture Decision Records

Sprint 5: MCM — cómo vender Roustix.

docs/README.md · MCM →