Video demo
Un video demo muestra el proceso de uso real de un servicio desde la perspectiva del consumidor. Menos de 5 minutos. Con solo decir "graba este proceso en video y añádele una explicación sencilla", se completa el video usando los valores predeterminados que se indican a continuación.
Valores predeterminados: grabación con Playwright (1280×720) · narración en subtítulos (SRT + incrustados), solo con audio si se solicita · resultado en mp4 + srt.
La forma de desplegar el servicio, las cuentas de prueba y el estilo del video siguen lo indicado en el archivo CLAUDE.md del proyecto.
Pasos
-
Dividir en escenas — Desglosar la solicitud en un flujo que el usuario experimentaría, de 3 a 6 escenas. Para cada escena, describir "lo que se ve" y "una o dos frases de explicación".
-
Grabar la ejecución real completa — Desplegar el servicio y usar Playwright
recordVideo(del mismo tamaño que el viewport) para realizar la operación de principio a fin. A velocidad humana (slowMoalrededor de 300 ms), esperar después de cada clic hasta que el resultado sea visible en pantalla. El archivo de video se completa solo al cerrar el contexto. Regrabar solo las escenas que fallaron. Anotar los tiempos de referencia de grabación (inicio, resultado visible, fin) para cada escena. -
Escribir subtítulos — Sin usar jerga interna ni nombres de código, explicar "qué mejora para el usuario". Una o dos frases por escena, dichas después de que el resultado sea visible.
- Malo: "Se genera un PR que cambia el hit policy de la regla DMN 3 a FIRST"
- Bueno: "Las reglas duplicadas se ordenan, así que un mismo pedido ya no recibe descuentos dobles".
-
Editar para que dure menos de 5 minutos — Recortar o acelerar las secciones de carga o espera. Mantener intactos los momentos de interacción y la lectura del resultado (2-3 segundos). Si aún excede el límite, fusionar escenas. No omitir los pasos clave mencionados en la solicitud.
-
Componer — Unir los segmentos con ffmpeg y recalcular los SRT según los tiempos del editado final para incrustarlos. En Windows, moverse a la carpeta de trabajo y usar rutas relativas (problema de escape de
:en la ruta). Fuente: en Windows,Malgun Gothic; en Linux, una fuente coreana instalada (ej.Noto Sans CJK KR).ffmpeg -i edited.mp4 -vf "subtitles=demo.srt:force_style='FontName=Malgun Gothic,FontSize=22'" -c:a copy demo.mp4 -
Verificar — Comprobar que la duración sea ≤ 300 segundos con
ffprobe -v error -show_entries format=duration -of csv=p=0 demo.mp4. Extraer fotogramas en varios tiempos de los subtítulos (ffmpeg -ss <segundos> -i demo.mp4 -frames:v 1 f_<segundos>.png) y abrirlos directamente para verificar que el texto del subtítulo coincida con lo que se muestra en pantalla y que el coreano no se vea corrupto.
Reglas a seguir
- No usar pantallas falsas, respuestas mock, inyección de valores en el DOM ni clics forzados para crear escenas. Si no se puede completar la grabación, informar que no es posible.
- Las operaciones difíciles de revertir, como fusionar PRs reales, modificar datos en producción, enviar mensajes o realizar pagos, solo deben hacerse en el entorno de pruebas definido por el proyecto. Si no existe ese entorno, preguntar al usuario justo antes de esa escena. Asegurarse de que contraseñas y tokens no sean visibles en la pantalla ni en los subtítulos.
- Informe: rutas de mp4 y srt, duración real, descripción de cada escena, fotogramas verificados visualmente y elementos no verificados. Publicar o enviar solo si se solicita explícitamente.