control-calidad

Control de calidad

La persona tiene que ver el trabajo, no los errores de oficio. Todo lo que se puede medir se mide antes de enseñarlo. Lo que no se puede medir lo mira un supervisor con ojos frescos y con veto. Y cada corrección de la persona se apunta para que la próxima vez se cace sola.

• La herramienta automática de control es un módulo en preparación. Mientras, cada medida sale de ffmpeg y ffprobe: los comandos están en referencias/mediciones.md.
• La lista de errores que ya salieron, con su umbral y cómo se comprueba, está en referencias/lista-de-errores.md.
• El agente supervisor del paquete sigue esta skill.

1 · El flujo

1. Antes de renderizar, lee la ficha de la pieza (pieza.md): lo aprobado que no se toca y las notas por resolver.
2. Mide el render (§ 2). Los ✘ se corrigen antes de seguir; los ⚠ se deciden mirando el fotograma.
3. Mide el ritmo con referencia.py (§ 3).
4. Haz la hoja de control: de 6 a 24 fotogramas repartidos por la pieza, con las zonas seguras pintadas. Mira cada uno.
5. Si es una corrección, compárala con la versión anterior (§ 4).
6. El supervisor firma «aprobado» o «cambios» (§ 5).
7. Enséñale a la persona el mismo render y lo que dijo el supervisor, antes de rehacer nada.
8. Entrega con el informe (§ 9).

2 · Qué se mide

Medida	Umbral	Si no cumple
Formato	El pedido: 1080×1920 vertical, 1920×1080 horizontal, 1080×1350 feed. 4K solo si se pide	✘
Fotogramas por segundo	Los de la secuencia (±0,02) y constantes	✘ · ⚠ si son variables
Duración	Reel: 40 s como máximo. Exportado: el tramo entre marcas ±1 fotograma	⚠ · bloqueante en un reel de campaña
Escala	Ninguna banda negra en un borde durante 0,5 s o más	✘
Zonas seguras (1080×1920)	54 px a los lados; nada que leer sobre y 224 ni bajo y 1495; libre la columna de botones (desde x 897 e y 1228). Horizontal: 96 px a todo el contorno	✘ si dura 0,35 s o más · ⚠ si es un instante
Objetos enteros	En el alfa, nada toca el borde del cuadro durante 0,35 s o más	✘
Negros	El primer fotograma tiene imagen. Ni un negro suelto (1 fotograma) salvo un fundido a propósito	✘ al inicio · ⚠ a mitad
Congelado	Nada quieto 0,5 s o más donde debería moverse	⚠ · ✘ en broll o animación si dura 1 s o más o cae en el último segundo
Algo pasa	Ninguna ventana de 4 s sin corte ni movimiento	⚠
Último fotograma	Existe, no es negro, todo dentro de márgenes. Fotogramas contados = esperados; el audio no dura más que el vídeo	✘
Volumen	Reel en torno a −15 LUFS integrados (pasa entre −17 y −13)	✘
Picos	Pico real ≤ −1 dBTP; ninguna muestra a −0,1 dBFS o más (satura)	✘
Silencios	No arranca con más de 0,3 s mudo; ningún hueco de 0,5 s bajo −50 dB donde hay voz	⚠
Efectos de sonido	Suelto: pico ≈ −5,5 dB (techo −5). Bajo la voz: pico ≤ −9 dB y RMS ≤ −27 dB	✘
Siseo («chhh»)	Ningún ruido ancho sostenido: 150 ms en un efecto, 300 ms en la mezcla. En un efecto, como mucho el 20 % de la energía sobre 4 kHz	✘ en el efecto · ⚠ en la mezcla
Alfa real	Formato de píxel con alfa (yuva…, rgba…) y algo visible	✘
Color	Marcado bt709 y en rango TV. HLG o bt2020 en la entrega	✘
Exportación	H.264 y AAC 48 kHz estéreo; tasa de 30 Mbps o más (con destino 52 sale una media de 38–43)	⚠

3 · El ritmo, con referencia.py

La herramienta que desarma una referencia también mide tu propio render. Está en herramientas/referencia.py, en la raíz del paquete (dos carpetas por encima de esta skill):

python3 herramientas/referencia.py <render> --idioma es --salida control/<pieza>-vN-ritmo

Lee analisis.md y mira hoja.jpg y gancho.jpg:

En el informe	Tiene que dar
«pasa algo cada»	4 s o menos
«el tramo más quieto dura»	Menos de 4 s. Si no, di qué tramo es y qué va a entrar ahí
«El plano más largo dura»	3 a 4 s. Más, solo si no hay otra forma de contarlo y puedes decir por qué
Duración (en «Ficha»)	40 s como máximo en un reel
gancho.jpg (0,1 a 3 s)	¿Pararías el dedo? Antes de 0,5 s pasa algo que no se espera y a los 3 s se entiende la historia
«Volumen integrado»	Lo mismo que midió § 2

• Que cambien los mensajes dentro de un plano o que la cámara se mueva despacio no cuenta como plano nuevo. Un corte a otra escala, otro ángulo u otra idea, sí.
• En una animación sin cortes, «1 plano» no es un error: su ritmo está en «cambios visuales».
• Si la pieza salió de una referencia, compara sus números con los del concepto aprobado.

4 · Comparar con la versión anterior

Una corrección no puede empeorar la versión que ya gustaba.

1. Antes de corregir, lee en pieza.md lo aprobado que no se toca.
2. Después, compara la versión nueva con la anterior, imagen y sonido (comandos en mediciones.md):
   • fuera de los tramos pedidos (con 0,25 s de margen) tiene que salir igual;
   • dentro, tiene que cambiar: si no cambió nada, la nota no está resuelta;
   • si cambió la duración, todo lo que va detrás puede salir corrido.
3. Lo que cambió fuera de lo pedido, o es a propósito y se explica en la entrega, o es una regresión y se arregla antes de enseñarlo.
4. Cada nota se comprueba en su fotograma de la versión nueva, y resuelta tal como la pidió, sin interpretarla.

La comparación de cuadro entero no ve cambios pequeños (un letrero que ocupa el 5 % del cuadro, una tapa de 110 px, un subtítulo corregido): mira esos sitios en recortes a tamaño real de las dos versiones. Lo que una corrección suele romper está en la lista de errores, § «Regresiones».

5 · El supervisor

El supervisor sabe lo mismo que quien hizo la pieza, pero la mira con ojos frescos: quien la hizo no ve sus propios fallos. No arregla nada: mira, mide y firma.

Recibe el render, su tipo (reel, broll, alfa, efecto, portada…), los fps de la secuencia y pieza.md. Si es una corrección, además la versión anterior, los tramos pedidos y las notas con su segundo exacto. Si falta algo, lo busca antes de firmar.

Cómo revisa:

1. Identifica la pieza por lo que dice, lo que muestra y lo que dura, no por el nombre del archivo.
2. Lee pieza.md, el archivo de correcciones (§ 6) y la lista de errores.
3. Mide (§ 2). Con un ✘, su veredicto es «cambios», sin más discusión.
4. Su primera pregunta es si la pieza atrapa, antes que si cumple (§ 3).
5. Mira la hoja y saca a tamaño completo los segundos dudosos, cada corte y el segundo de cada nota resuelta.
6. Si es una corrección, compara (§ 4).
7. Revisa datos y textos: ninguna cifra, nombre ni caso inventado.

Gravedad:

• Bloqueante: un ✘; un dato privado legible a velocidad normal; un error que la persona ya corrigió antes; un reel de más de 40 s; un gancho que no pararía el dedo; un plano de más de 3–4 s sin motivo.
• Aviso: lo demás, incluidas las cuestiones de criterio (un destello de 1 fotograma que solo se lee en pausa, una tapa de más). Esas las decide la persona.

Vueltas:

• Primera revisión: dice TODO lo que ve, de una vez, con su gravedad.
• Segunda: mira solo sus bloqueantes y la comparación con la anterior. Lo nuevo que ya estaba en la versión anterior es un fallo suyo de la primera: va como aviso.
• Tercera: firma «aprobado» con avisos si no queda ningún bloqueante.
• Nunca sube el listón entre versiones. Una re-revisión dura menos de 5 minutos.

Firma contra la lista vigente. Si la pieza es anterior a una regla, el fallo cuenta igual, marcado «posterior al render». Antes de llamar fallo a un negro o a un congelado, comprueba si es una entrada desde negro a propósito.

VEREDICTO: APROBADO | CAMBIOS
Cambios: 1) 0:04,2 · qué está mal · regla (ID) · bloqueante | aviso; 2) …
Mirado: medidas, ritmo, hoja (n fotogramas), fotogramas a tamaño completo en …, comparación con vN, notas resueltas …

La firma vale para ese render: si el archivo cambia, se mide y se firma otra vez.

6 · El archivo de correcciones

correcciones.md, en la carpeta de trabajo. El supervisor lo lee antes de cada revisión: así su listón es el de la persona.

• Mientras la persona revisa, apunta cada corrección en el momento: tiempo · qué cambia · por qué · qué se queda. Lee primero lo que se queda.
• Ese mismo día, cada corrección que sea un error repetible se convierte en regla, con su número y cómo se verifica: COR-12 · AAAA-MM-DD · Un plano dura 4 s como máximo · medir: «El plano más largo» de referencia.py · origen: «me parece mucho que un clip dure 8 s», reel X v3
• Si contradice una regla anterior, manda la nueva: corrige la vieja, no dejes las dos.
• Apunta también lo que aprobó a la primera y lo que dijo que se puede ver o dejar: tampoco se veta.
• Si la persona caza algo que el supervisor no vio, el supervisor propone añadirlo.
• El supervisor no inventa gustos. Si algo está claramente mal y no figura en la lista, pide el cambio y dice por qué: así la lista crece.

7 · Lo que no se rompe

• Los ✘ se corrigen, no se discuten. Un fallo medido que llega a la persona le hace perder su revisión en errores de oficio.
• Medir bien no es aprobar. Una versión aprobada con solo avisos volvió por «muy larga» (52 s) y «aburrida» (31 s seguidos del mismo celular).
• Una corrección toca solo lo pedido. Rehacer de paso perdió trabajo hecho a mano y empeoró lo que gustaba.
• Si piden cambiar una propiedad, se cambia solo esa. «Baja la opacidad del negro» se leyó como «quita la columna», y no lo era.
• Lo que la persona aprobó o eligió no se rehace por un detalle del supervisor: se le pregunta en una línea. Tres vetos sobre algo que ya le convencía costaron dinero y tiempo.
• Si la persona está en la computadora, supervisa ella. El agente entra cuando no está.
• La persona ve lo mismo que el supervisor, y su opinión, antes de rehacer: qué veta, en qué segundo y qué propone. Puede que el veto no le importe, y cada vuelta cuesta un render. Lo que ella ya pidió se hace sin preguntar.
• Máximo 2 o 3 versiones por pieza. Al segundo veto del mismo tipo, o ante una cuestión de criterio, se para y se le pregunta con opciones. Hubo 8 versiones en una noche con un supervisor que subía el listón.
• Cada versión rehace solo los trozos que cambian. Se llegó a renderizar entero un vídeo de 45 min por un cambio local.
• Una re-revisión mira solo lo vetado. Una vuelta entera tardaba de 12 a 17 minutos y gastaba de 300 a 400 mil tokens.
• «Haz este último cambio y queda» = se arregla eso, se mide, se enseña y se acabó. Sin otra ronda de veto.
• Un comentario de pasada no es una orden. Por un «no me gusta tanto» se cambió una persona aprobada y se rechazó el render: se arregla lo pedido y lo demás se queda; como mucho se ofrece una vez. Si la persona cierra un tema, no se reabre.
• Lo generado se rehace desde lo aprobado. Se parte de la imagen que gustó y se cambia solo lo pedido. Tras dos rechazos seguidos sin dirección, no se gasta una tercera a ciegas: se dice qué se entendió y se pide una imagen o una frase. Si cambia de opinión, manda lo último que dijo.
• Si dices que algo está abierto o en pantalla, compruébalo. Se anunciaron cuatro bocetos abiertos que no estaban.

8 · Trampas técnicas

• nb_frames miente en ProRes: cuenta paquetes (-count_packets).
• Pegar el audio con -shortest se come de 1 a 4 fotogramas: usa la duración exacta (-t).
• La etiqueta «4444» no garantiza alfa: el formato de píxel tiene que empezar por yuva.
• ffmpeg -ss t da el primer fotograma que empieza en t: para el fotograma f, usa t = (f − 0,25) / fps.
• QuickTime y la vista rápida lavan el color: compara con el fotograma del editor, no a ojo.
• Las zonas seguras se miden en la banda del texto: el metraje claro falsea la medida del cuadro entero.
• La transcripción pega la primera palabra a 0,0 y mete pausas largas dentro de la palabra siguiente: lo que va justo después de una pausa se mide por energía.
• El editor guarda en caché la duración y el audio de un archivo sobrescrito: cada versión, con nombre nuevo.
• La lectura de texto a 4 fotogramas por segundo se salta destellos: para privacidad, 10.

9 · Qué se entrega y qué se verifica

• El informe de entrega: ruta, duración, tramo, tasa media real, qué se midió (con los números), el ritmo, el veredicto del supervisor, la comparación con la versión anterior y lo que queda pendiente.
• En pieza.md, apartado «Control»: vN · medidas (fallos y avisos) · supervisor (veredicto y por qué).
• Cada versión con nombre nuevo (v2, v3…): la anterior sigue intacta para poder compararla.
• Nada se publica ni se manda a nadie sin que la persona lo pida.