Video explicativo
Trabaja desde la raíz del repositorio con uv run. README.md tiene los comandos y formatos de archivo; EDITORIAL.md es el estándar. Este es el orden de trabajo y dónde están los puntos de control del usuario.
0. La conversación, donde comienza un video
Los videos surgen de lo que el propietario piensa, puesto a prueba, no de una lista de temas. Antes de cualquier investigación, entrévalo.
- Una o dos preguntas a la vez, en conversación sencilla y breves: el propietario responde por dictado, y cinco a la vez eran demasiadas para responder o mantener claras. A lo largo de las rondas, mezcla los tipos: preguntas abiertas ("¿qué protege cada lado?"), cuestionarios que responden antes de buscar la respuesta ("¿qué porcentaje dirías?"), pruebas de acero ("presenta el caso del otro lado de manera que ellos lo firmarían"), y cebos: la objeción más fuerte a lo que acaban de decir, expuesta sin rodeos. Sigue la respuesta que te sorprendió, no la siguiente pregunta de una lista.
- Las suposiciones incorrectas del propietario pueden aparecer en pantalla: él ha aceptado eso. Pero un número es solo su suposición si lo ofreció como tal. Un número dentro de un ejemplo ("digamos que gastan el 70% en facturas...") es una ilustración: regístralo como tal, nunca lo puntúes ni lo muestres como suposición, y pregunta cuando no esté claro cuál era.
- Escucha la afirmación debajo de la respuesta: una tesis que podría ser errónea, una distinción que sigue haciendo, una historia propia. Esos son videos. Un tema ("aborto") no es una idea; "los dos lados están respondiendo preguntas diferentes" sí lo es.
- Conserva sus palabras. Guarda las respuestas textuales y con fecha en
notes/<tema>.md, que git ignora: las notas son crudas y privadas, y el guión es la forma publicada. Marca tus propios resúmenes como tuyos. - Clasifica lo que dijo según lo que necesitará el guión. Lo que se puede verificar se convierte en investigación, luego en compases de
fact,estimateoview. Lo que es suyo se convierte enopinionospeculation. Precisen las palabras cargadas antes de que avancen ("ingeniería": ¿por quién y cómo lo sabríamos?), y diles claramente cuando las fuentes no respalden algo que creen. - Detente cuando haya una tesis, tres o cuatro movimientos que la sostengan y la objeción más fuerte a ella. Reproduce eso en unas pocas líneas y obtén un sí antes de investigar.
El propietario quiere saber cómo funcionan las cosas ahora. De dónde viene algo es una breve digresión dentro de un video, no el video en sí.
1. Investigación, antes de cualquier guión
- Establece la pregunta que responde el video en una oración, y las tres o cuatro cosas que un espectador debería poder decir después.
- Construye una hoja de hechos: una afirmación por línea, cada una con una fuente que fue obtenida y leída en esta sesión y el pasaje que la respalda. Mantén las fuentes en
videos/NOMBRE/sources.tomldesde el primer día (una carpeta con solo ese archivo es un video en investigación o en pausa) y las afirmaciones ennotes/NOMBRE.md. Investigar en un subagente está bien, pero indícale que devuelva citas textuales y que marque lo que no pudo respaldar; nunca aceptes una URL que no haya abierto. - Para un tema controvertido, recopila el caso de cada lado desde sus defensores más fuertes y anota qué desacuerdos son sobre hechos y cuáles sobre valores.
- Escribe lo que las fuentes NO respaldan. Las versiones populares de una historia suelen ser más ordenadas que la evidencia.
2. Guión (punto de control: el usuario lo aprueba)
python -m explainers.new NOMBRE(rellena alrededor de unsources.tomlque ya existe), luegoscript.md.- Un video dura de 12 a 25 minutos: aproximadamente de 2,100 a 4,400 palabras al ritmo de lectura del propietario (unas 175 palabras por minuto con las pausas). Divídelo en secciones que el espectador pueda sentir cambiar, cada una con su propia pregunta.
- Una idea por compás, un compás por respiración: de 15 a 40 palabras. Escribe para el oído: oraciones cortas, la palabra importante al final, números redondeados a lo que un oyente pueda retener, sin corchetes ni abreviaturas.
- Comienza con la pregunta o la sorpresa, no con un saludo. Cada sección debe dejar al espectador queriendo la siguiente.
- Etiqueta según lo que promete la oración, no según lo seguro que te sientas. Divide un compás que mezcle tipos. Un guión que es principalmente
factyviewcon unos pocos compases claramente marcados comoopiniones el objetivo;checkimprime la división. - No escribas la
opiniondel canal sobre una pregunta controvertida tú mismo. Deja un espacio marcado, o redacta uno y di claramente que es un borrador para que el usuario lo acepte, cambie o elimine. - Pon una nota
>debajo de cada sección diciendo qué hay en pantalla. Cada compás necesita una imagen que cambie al menos cada cinco segundos más o menos. python -m explainers.check videos/NOMBRE --urlsdebe pasar. Muestra al usuario el guión con la división y la lista de fuentes.
3. Voz (punto de control: el usuario la graba)
- Borrador con la voz sintética:
python -m explainers.narrate videos/NOMBRE. Corrige las palabras que supuso ensay.txt. Añadepausea un compás cuando su imagen necesite tiempo para asentarse. Las imágenes se pueden construir y el guión se puede ajustar en este borrador. - Cuando la redacción esté establecida, el usuario la graba en su propia terminal:
python -m explainers.record videos/NOMBREmuestra cada compás, lo graba y verifica la toma por nivel y por las palabras del guión.--roomgraba la habitación vacía una vez, para los espacios. Luegonarratede nuevo: usa una toma donde haya una nueva. Las imágenes permanecen en sus palabras, ya que las señales se buscan por palabra, pero los compases cambian de longitud: ejecutasweepy mira una hoja de contactos antes de renderizar. - El usuario no tiene que leer palabra por palabra. Cuando una toma se desvía del guión,
recordmuestra la diferencia y, si la conserva, reescribe el compás en script.md con lo que dijo. Así que haz commit del guión antes de que grabe, y después lee elgit diffdel mismo: ordena la ortografía y puntuación de las nuevas palabras (eso no hace que una toma quede obsoleta), y por cadafact,estimateoviewcambiado, lee la cita de la fuente contra las nuevas palabras. Si ya no las respalda, dile al usuario: el compás se lee de nuevo o se reetiqueta, no se deja así. - Reformular tú mismo un compás grabado le cuesta al usuario una nueva lectura. Agrupa esos cambios y pregunta primero.
--audition VOICE ...compara voces sintéticas para el borrador; la líneavoice:del guión elige una.
4. Imágenes
- Comienza desde el
video.pyde la plantilla y reemplázalo escena por escena. Una escena por sección es el grano habitual; corta entre ellas contheme.scenes. - Un video ocurre en un set (
explainers/sets.py): hasta ahora un aula con una pantalla de proyector, que es lo que el propietario pidió. Dibuja un gráfico, una tarjeta o una figura como diapositiva, una imagen de 1920x1080, y entrégala al set: la misma diapositiva está en la pantalla en el plano general y llena el encuadre cuando la cámara se acerca (sets.shotspara los movimientos). Acércate cuando la diapositiva deba leerse, aléjate cuando el anfitrión tenga algo que hacer, y baja el proyector (on) cuando el anfitrión se adelante con una opinión. Pon el título de la sección en la pizarra (chalk), y dale a la etiqueta unplatepara que se lea sobre la sala. Las notas>de un guión dicen "Plano general" o "Proyector". Vendrán otros sets: mantén una diapositiva libre de la sala. - Cuelga cada movimiento de una señal:
N.at(compás, palabra). Nunca escribas un tiempo en segundos. - El anfitrión es pequeño y a un lado mientras se explica algo, y grande cuando habla por sí mismo (la apertura, una opinión, el cierre). Mira y señala lo que se está discutiendo.
- Los gráficos, diagramas y cualquier cosa matemática van en un manim
Insert. Todo lo demás es Skia. - Los lados de un argumento son
theme.SIDE_A/theme.SIDE_B. Un conjunto de datos que dibuja un gráfico se guarda en la carpetadata/del video con su origen y fecha. - Bucle:
previewuna sección, mira la hoja, arregla, repite;sweepantes de cada renderizado.
5. Renderizado y entrega (punto de control: el usuario lo ve)
python -m explainers.render videos/NOMBRE --fresh, luegopython -m explainers.describe videos/NOMBRE.- Informa qué está verificado y qué no, cualquier compás cuya etiqueta fue una decisión subjetiva, y cualquier cosa que la voz diga de manera extraña.