UX de 21 Gramos
Un pase sobre flujos que ya existen. UX de 21 Gramos (el paquete UX de la familia 21 Gramos) no rediseña el producto ni añade un kit de UI. Recorre los flujos reales, encuentra dónde los productos creados con IA se rompen para las personas que los usan (callejones sin salida, estados faltantes, fallos silenciosos, acciones irreversibles, formularios que luchan contra el usuario) y los arregla a través de los componentes y patrones que el proyecto ya tiene.
UI de 21 Gramos maneja el aspecto. UX de 21 Gramos maneja si funciona. Cuando ambos están instalados, ejecuta UX primero: no tiene sentido pulir un paso que no debería existir.
Regla cero: usa los componentes propios del proyecto
Cada cambio se hace a través de lo que el proyecto ya utiliza. UX de 21 Gramos nunca construye un conjunto paralelo de componentes o un flujo paralelo.
- Haz un inventario antes de tocar nada. Anota el enrutador y el mapa de rutas, la biblioteca de componentes, la biblioteca de formularios y el enfoque de validación, los componentes de toast, diálogo y estado vacío, la capa de obtención de datos (de dónde vienen los estados de carga y error) y la capa de analítica o eventos si la hay.
- Arregla las cosas donde viven. Un estado de error faltante va al componente de datos o estado vacío compartido, no a una sola pantalla. Un patrón de confirmación va al diálogo del proyecto, no a uno aislado.
- Nunca añadas un componente o dependencia cuando ya exista uno para el trabajo. No hay nueva biblioteca de formularios, toasts o recorridos para obtener un efecto UX de 21 Gramos.
- Cuando una pieza realmente falta (sin componente de estado vacío, sin deshacer), constrúyela a partir de los primitivos existentes del proyecto, siguiendo su estructura de archivos y nomenclatura. Menciona esto en el informe.
- Las decisiones de producto siguen siendo del producto. UX de 21 Gramos no cambia lo que el producto hace, para quién es ni sus reglas de negocio. Cambia cómo se realizan las tareas existentes. Cualquier cosa que cambiaría el alcance va al informe como una pregunta, no como una corrección.
Precedencia: las palabras del usuario, luego los patrones establecidos del proyecto y las reglas del producto, luego las reglas internas de UX de 21 Gramos.
Qué contiene
- El paso de investigación UX. Antes de diseñar o rediseñar un flujo, analiza el producto actual y de tres a cinco ejemplos líderes de la industria, uno a la vez, utilizando una biblioteca de patrones como Mobbin si está conectada. El proceso completo está en
references/research.md. - Las leyes de UX. El conocimiento del que provienen las reglas, en
references/laws.md, citadas como A1, A2… por sección. La sección A son las leyes principales: de Hick, de Fitts, de Jakob, de Miller, el umbral de Doherty, de Tesler y de Postel. Cuando ninguna regla cubre un caso, razona a partir de las leyes. - Las reglas de UX. Reglas numeradas en
references/rules.md, cada una con la regla, cómo aplicarla y qué señalar, además de una lista de verificación rápida de auditoría. Escritas priorizando móvil y aplicadas también a la web (navegación principal para "pestaña inferior", popover para "hoja inferior" en escritorio). - Reglas de campo. Reglas aprendidas de sesiones de revisión reales en productos creados con IA y de investigación UX en productos líderes, en
references/field-rules.md, citadas como F1, F2…. Este archivo crece después de cada sesión (ver "Ampliando las reglas de campo"). - Reglas internas por área en
rules/, un archivo por área, cada uno enumerando las leyes, las reglas numeradas y las reglas de campo que le pertenecen:
| Archivo | Área |
|---|---|
navigation.md | Navegación y orientación |
forms.md | Formularios y entrada |
states.md | Estados vacío, carga, error y éxito |
feedback.md | Retroalimentación y estado del sistema |
onboarding.md | Incorporación y primer uso |
destructive.md | Acciones destructivas y recuperación |
accessibility.md | Accesibilidad y teclado |
flows.md | Flujos y duración de tareas |
choice.md | Elección y carga cognitiva |
Las reglas #1–5 están reservadas y se añadirán en una versión posterior. Hasta que un área tenga reglas, audítala con criterio general de usabilidad y menciónalo en el informe.
No negociables
- X cierra un modal o flujo. Una flecha izquierda retrocede una pantalla. (#6)
- Nunca una pantalla en blanco mientras se carga: esqueleto, spinner o barra de progreso. (#7)
- Volver a un feed restaura la posición de desplazamiento exacta. (#8)
- Tocar la pestaña activa vuelve al inicio. (#9)
- La página siguiente se carga antes de que las personas lleguen al final. (#10)
- Los me gusta, seguimientos y guardados son optimistas, con reversión y un mensaje en caso de fallo. (#11)
- Los borradores y la entrada no finalizada se guardan automáticamente. (#12)
- Los permisos se solicitan cuando se utiliza la función, nunca al iniciar. (#13)
- Las acciones rápidas se abren en una hoja inferior que se desliza hacia abajo para cerrar. (#14)
- Las notificaciones y los enlaces compartidos abren el contenido exacto. (#15)
- Pocas opciones por paso con un valor predeterminado recomendado; el resto se revela. (A1)
- La acción principal es grande y está al alcance; los objetivos táctiles son de 44×44. (A2)
- Las tareas comunes usan el patrón estándar. (A3)
- La información está agrupada; nada debe recordarse entre pasos. (A4)
- Cada entrada se reconoce de inmediato; las esperas más largas muestran progreso. (A5)
- El producto lleva la complejidad, no la persona. (A6)
- Acepta entrada desordenada y devuélvela limpia, pero nunca relajes la seguridad o la integridad de los datos. (A7)
- Un control por tarea. (F1)
- Acciones de pantalla agrupadas en la parte superior derecha, la principal en la esquina, nunca mezcladas con selectores. (F2)
- Detalle secundario bajo demanda, nunca perdido; nunca elimines la única ruta accesible hacia él. (F3, F5)
- Cada hecho se dice una vez; sin números de versión, notas de diseño o jerga interna en pantalla. (F6, F9)
- Cuando una interacción cambia, cada indicio que la describe también cambia. (F8)
- Nueva interfaz nunca afirma más que el alcance declarado del producto. (F10)
- Ningún paso que repite la elección que lo abrió; una opción significa simplemente hazlo. (F13, F17)
- Una selección, una barra de herramientas contextual, desaparece al hacer clic fuera. (F16)
- Todo lo que se puede añadir se puede eliminar, y un borrado muestra lo que eliminará. (F18, F19)
- Los atajos se muestran en tooltips y nunca usan teclas reservadas del navegador. (F20)
- Las propuestas de IA se ven provisionales, usan un único patrón de aceptar/rechazar y aceptan al instante. (F23)
- Incorporación: dos puertas iguales, una pregunta por pantalla con progreso, valor antes de la cuenta, recorridos omitibles. (F28, F29, F32, F36)
- El dinero es honesto: una ruta gratuita real, pruebas con fechas, actualizaciones en el límite. (F35)
- Leer y seleccionar ocurren en una columna estrecha centrada; solo el contexto y la acción del paso permanecen fijos. (F37, F38)
- Los datos faltantes dicen N/A, el texto está truncado y alineado, y cada lista se verifica con volúmenes reales. (F43, F44, F45)
- Los roles cambian el punto de inicio, no la aplicación; móvil y escritorio comparten los mismo patrones. (F47, F50)
Flujo de trabajo
- Haz el inventario (regla cero).
- Investiga (
references/research.md). Para un flujo nuevo, un rediseño o incorporación, comienza aquí: descubre qué se está diseñando y para quién, analiza el flujo actual, recomienda de tres a cinco ejemplos líderes de la industria, y revísalos uno a la vez con el usuario antes de cambiar cualquier cosa. Omítelo solo para correcciones pequeñas a un flujo existente. - Mapa los flujos. Enumera las tareas principales que una persona viene a hacer, y para cada una la ruta a través del producto: punto de entrada, cada paso, cada rama, el estado final. Anota de dónde vienen los datos de cada paso.
- Recorre cada flujo en el navegador, no solo el código. Prueba el camino feliz, luego los bordes: nada aún, red lenta, solicitud fallida, entrada inválida, retroceder, recargar a mitad del flujo, solo teclado, pantalla estrecha.
- Audita antes de cambiar cualquier cosa. Revisa las listas de verificación al final de
references/rules.md,references/laws.mdyreferences/field-rules.md, y los archivos de área. Enumera los hallazgos agrupados por área, número de regla y ley. Cada hallazgo obtiene el flujo y paso, el archivo y línea, qué sale mal para la persona, la corrección, y en qué componente o patrón existente va la corrección. Clasifícalos: bloquea la tarea, ralentiza la tarea, borde áspero. - Muestra la auditoría al usuario como una lista breve y pregunta antes de aplicar cambios amplios. Correcciones pequeñas y obvias dentro del alcance solicitado pueden aplicarse directamente.
- Aplica las correcciones en este orden: componentes y patrones compartidos → flujos → pantallas individuales. Mantén los diffs con alcance y dentro de las convenciones propias del proyecto.
- Verifica recorriendo los flujos de nuevo en el navegador, incluyendo los casos borde del paso 3. Captura antes y después para cada paso cambiado.
- Informa qué cambió por flujo y área, qué componentes se tocaron, y las preguntas abiertas que son decisiones de producto.
Ampliando las reglas de campo
UX de 21 Gramos aprende del trabajo real. Cuando el autor termina una sesión de revisión en un producto creado con IA y solicita que se añada:
- Lee la conversación de esa sesión y enumera cada cambio que el autor solicitó o aceptó.
- Conserva los cambios de UX (flujo, estructura, colocación, estados, retroalimentación, copia que guía a las personas, rutas de accesibilidad). Los cambios visuales (radio, color, tipo, iconos, movimiento) pertenecen a UI de 21 Gramos.
- Escribe cada uno como una regla general: la regla, cómo aplicarla a través de los componentes propios del proyecto, y qué señalar. Sin nombres de clientes, productos o contenido privado.
- Si una regla refina una existente, actualiza esa regla en lugar de añadir una nueva.
- Añade nuevas reglas a
references/field-rules.mdbajo un encabezado de sesión, continúa la numeración F, y enuméralas en los archivos de área correspondientes.