Auditoría de UX de video + línea de tiempo
La idea: unos segundos a unos minutos de uso real ya contienen la mayor parte de lo que está mal. Los problemas pasan desapercibidos porque nadie ve todo a la vez: lo que la persona intentó, lo que mostró la pantalla, lo que registró el código y lo que hizo la red. Este método graba todo en un solo reloj, para que cada fotograma pueda ser explicado por sus eventos y cada evento pueda verse en su fotograma. Luego, una IA lee la imagen completa en una sola pasada.
Salidas
| Archivo | Qué es |
|---|---|
audit.mp4 | La sesión, con subtítulos incrustados: negro para la intención, rojo para cada problema |
events.json | Cada acción, subtítulo, mensaje de consola, excepción, solicitud (estado, ms, bytes, fallos), tarea larga y cambio de diseño, con marca de tiempo en el reloj del video |
timeline.md | La línea de tiempo fusionada, más señales detectadas automáticamente, cada una vinculada al fotograma donde ocurrió |
ai-pack/ | Fotogramas clave nombrados por el tiempo del video, timeline.md y PROMPT.md, listos para que cualquier LLM multimodal los revise en una sola pasada |
findings.md | La lista final clasificada: problemas, brechas y oportunidades, cada uno con evidencia, una solución de UX y una solución de rendimiento |
0. Seguridad
- Usa cuentas de prueba y datos de prueba, y escribe solo en un entorno aislado. Los datos reales de usuarios son de solo lectura.
- Nunca publiques nombres, correos electrónicos, números de teléfono, identificadores o tokens. Limpia
events.json(URLs, texto de consola) antes de compartir. - Usa un perfil de navegador desechable y ciérralo al final.
1. Enmarca la sesión (2 minutos)
- Nombra de uno a tres trabajos para los que viene un usuario real, en sus propias palabras. Por ejemplo: "encontrar el pedido", "responder al cliente", "cambiar mi plan".
- Elige la duración adecuada para la IU: 10–60 s para una pantalla, 2–5 min para un flujo completo. Las sesiones cortas y enfocadas superan a las largas.
2. Actúa como una persona real y no técnica
- Di lo que pretendes hacer antes de cada movimiento (un subtítulo
say). - Usa solo lo que está visible. Sin URLs escritas, sin herramientas de desarrollador, sin atajos ocultos.
- Prueba primero el camino obvio. Cuando falla, eso es un hallazgo, incluso si otra ruta funciona.
- Después de cada acción, verifica que todo concuerde: lista, contadores, encabezado, otros paneles y la vista de la otra parte.
- Somete a prueba el estado. Recarga, retrocede, abre en una nueva pestaña, usa una red lenta y usa el ancho de un teléfono (390×844).
- Anota las esperas. Si esperas, el usuario espera.
Hay dos formas de dirigir:
- Guionizada. Un
scenario.jsoncon pasos. Es repetible, y el mismo archivo se convierte en la prueba de regresión después de la corrección. - Libre.
{"url": "...", "freeSeconds": 90}. Una persona o un agente conduce el navegador manualmente mientras todo se graba. Úsalo para exploración.
3. Grabar (web: Protocolo Chrome DevTools, sin dependencias)
chrome --remote-debugging-port=9222 --user-data-dir=/tmp/vua # perfil desechable
node scripts/record.mjs scenario.json --port 9222 --out ./audit-out
bash scripts/encode.sh ./audit-out # → audit.mp4
node scripts/timeline.mjs ./audit-out # → timeline.md, signals.json, ai-pack/
node scripts/report.mjs ./audit-out --title "X" # → findings.md (hallazgos subtitulados)
Pasos del guion: goto (ir a), say (decir), click (selector CSS, con un puntero visible), type (escribir, a velocidad humana), press (presionar), scroll (desplazar), wait (esperar) y problem (problema, un subtítulo rojo, una captura de pantalla y un hallazgo).
Otros entornos usan el mismo método con una captura diferente. Sea cual sea la plataforma, graba la pantalla más los registros de la plataforma y las transmisiones de red, ponlos todos en un mismo reloj y pásalos a timeline.mjs como events.json:
| Plataforma | Pantalla | Registros y red |
|---|---|---|
| iOS | xcrun simctl io booted recordVideo | log stream; un proxy (mitmproxy) para la red |
| Android | adb shell screenrecord | adb logcat; un proxy para la red |
| Escritorio / Electron | Captura de pantalla del SO | el puerto CDP, como para la web |
| Terminal / CLI | asciinema | stderr, con marcas de tiempo |
4. Señales automáticas (encontradas por ti, verifica cada una contra su fotograma)
| Señal | Significado típico |
|---|---|
| js-exception (excepción JS), console-error (error de consola) | Funcionalidad rota, a menudo silenciosa para el usuario |
| request-failed (solicitud fallida), http-5xx, http-4xx | Datos faltantes, estado incorrecto, permisos incorrectos |
| slow-request (solicitud lenta) (≥ 1 s; P1 a ≥ 3 s) | Una espera que el usuario siente; candidato a caché, precarga o índice |
| heavy-payload (carga pesada) (≥ 500 KB) | Lento en móvil; paginar, comprimir o recortar campos |
| duplicate-request (solicitud duplicada) (misma llamada en 2 s) | Trabajo desperdiciado; deduplicar o almacenar en caché |
| never-finished (nunca terminó) | Solicitud colgada, falta de tiempo de espera, spinner infinito |
| long-task (tarea larga) (≥ 200 ms; P1 a ≥ 500 ms) | IU congelada; dividir el trabajo, virtualizar, mover a un worker |
| layout-shift (cambio de diseño) (≥ 0.05, sin entrada) | El contenido salta; reservar espacio |
Los umbrales se pueden cambiar con --slow y --big.
5. Revisión por IA en una sola pasada
Entrega a la IA ai-pack/ (los fotogramas clave, timeline.md y PROMPT.md). Devuelve, en una sola pasada:
- Problemas, cada uno con gravedad y evidencia: un fotograma y las líneas de la línea de tiempo que lo explican.
- Brechas: callejones sin salida, falta de retroalimentación, estados poco claros, falta de affordances y dos pantallas que no concuerdan.
- Oportunidades: solicitudes que eliminar, almacenar en caché o precargar; pasos que fusionar; valores predeterminados que establecer; qué hace mejor un competidor principal.
- Una clasificación de todo por impacto ÷ esfuerzo del usuario.
Regla: sin evidencia, no hay fila. Cada afirmación cita un fotograma o un evento.
6. Gravedad
- P0: pérdida de datos, destinatario incorrecto, fuga de privacidad o seguridad, o el trabajo principal es imposible.
- P1: el trabajo principal está roto o es engañoso, una acción tarda más de 1 s o una vista más de 3 s, una excepción JS se encuentra en la ruta principal, o dos superficies no concuerdan.
- P2: fricción, redacción confusa, un problema cosmético o solicitudes desperdiciadas.
7. Cerrar el ciclo
- Corrige primero los P0, luego los P1, con un pequeño cambio por hallazgo.
- Vuelve a ejecutar el mismo escenario después de cada corrección. Su nueva línea de tiempo es la prueba: la señal ha desaparecido y el tiempo es mejor. Adjunta el antes y el después.
- Conserva los escenarios como una biblioteca. Volver a ejecutarlos después de cada lanzamiento detecta regresiones en segundos.