Video guionizado
Un video aquí es un guión: un archivo que dice qué se habla, qué hay en pantalla y cuándo. Un motor pequeño (en starter/) lo convierte en imágenes en un navegador y en un .mp4 con sonido, subtítulos y capítulos. Debido a que el video es texto, puedes escribirlo, verificarlo, revisarlo línea por línea, mirar cada fotograma, traducirlo y corregir una palabra sin tener que reeditarlo todo.
El motor es la mitad fácil. Un video que enseña necesita una historia verdadera, contada en un orden que el espectador pueda seguir, con palabras que conozca, con imágenes que señalen lo que la voz nombra. La mayor parte de esta habilidad trata sobre esa mitad. Sigue las etapas en orden; cada una deja un archivo que la siguiente lee, para que el trabajo sobreviva a una sesión larga y un segundo agente pueda retomarlo.
Procura entregar un video que el solicitante no tenga que corregir. Su tiempo es el costo que estás ahorrando. Así que: decide lo que puedas decidir y anótalo; utiliza todos los servicios, claves y datos que ofrecieron; antes de entregar, mira el video como ellos lo harán (ver "Antes de entregar"). Lo primero que nota un solicitante casi nunca son infracciones de reglas que un verificador pueda encontrar. Son una suposición que el video nunca respondió, un tema sin nada real, y un video que suena inconcluso.
Tres principios se aplican a todo video sobre el mundo. Cada uno se enuncia aquí una vez; las etapas siguientes los aplican y references/research.md ofrece el método.
- Cuenta a profundidad central; investiga un nivel más profundo. El video que entregas es el núcleo: la narración más breve que cumple la promesa y es verdadera y justa: aproximadamente de 10 a 20 minutos para un tema con historias reales, menos para un mecanismo simple. La duración que el solicitante nombre es un límite y prevalece; la profundidad de la investigación se reduce con ella. La investigación va un nivel más allá, hasta la profundidad de un detalle (las personas, los días decisivos, los medios exactos, las cifras rivales, lo que encontraron las investigaciones), para que el núcleo se elija con conocimiento y para que surjan temas vecinos: un evento, una institución o una idea que toca el tema principal y tiene su propia historia. Cada uno se convierte en una fila de
research/next-videos.mdcon lo que ya se sabe, y no se investiga más. Por debajo de un detalle (la vida posterior de cada persona, cada documento completo, la historia completa de una institución) se encuentra la investigación de otro video: en un trabajo, ir allí hizo que el video se alargara a seis horas cuando el núcleo de 18 minutos era lo que el solicitante quería. Las versiones más largas solo se hacen a petición. - Cada ejemplo real muestra el tema principal en acción. Una historia real entra en el video solo si la cosa de la que trata el video realmente sucede en ella, según cuentan las fuentes: para un video sobre mercados de futuros, contratos de futuros negociados en una bolsa, margen exigido, un contrato liquidado. Una historia que solo está cerca (los mismos años, un nombre famoso, una apuesta que parece similar pero se hizo de otra manera) se queda fuera, por famosa que sea e incluso si el solicitante la sugirió. Verifica esto con las fuentes en la ronda 1, antes de invertir profundidad en ella. En un trabajo, la historia más famosa ofrecida para un video sobre futuros resultó ser una apuesta hecha mediante acuerdos privados con bancos; se eliminó después de que dos ediciones la hubieran contado. Pero breve no es superficial: en el núcleo, cada ejemplo real se cuenta con sus personas, su fecha, los medios exactos, las cantidades, cómo podría haber ido de otra manera, cómo terminó y qué muestra sobre el tema principal.
- La investigación tiene un límite y un final. Cada pista se prueba contra el tema principal antes de invertir una búsqueda en ella; una que falla se anota en una línea y se deja ("interesante" no la abre). Hay tres rondas planificadas (el esquema, el detalle y una doble verificación, en las fuentes, de todo lo que dirá el video) y una cuarta breve solo para elementos nombrados que el núcleo necesita. Más es decisión del solicitante.
Espectador por defecto: alguien que se encuentra con el tema por primera vez. Escribe para que un niño de 8 años pueda seguir, con un lenguaje profesional y tranquilo que un adulto no encuentre infantil. Sencillo no es lo mismo que infantil: frases cortas, palabras cotidianas, una idea a la vez, sin lenguaje de bebé. Cambia esto solo si el briefing nombra a un espectador diferente.
Configuración
Copia la carpeta starter/ de esta habilidad al proyecto del usuario (por ejemplo como video/), luego:
cd video
npm install # una dependencia pequeña; usa el Chrome que ya está en la máquina
node tools/check.mjs # el video de ejemplo debería pasar
Necesita: Node 18 o superior; Chrome, Edge o Chromium (para dibujar imágenes); ffmpeg (para grabar la voz y exportar). Si falta alguno, consulta references/troubleshooting.md. No trabajes dentro de la carpeta de la habilidad; trabaja en la copia.
La copia contiene un ejemplo, videos/hello.json: quince segundos en datos planos, con una traducción y un diseño vertical, utilizado para verificar que la configuración funciona. Lo que cada etapa debe producir está en los archivos que crea node tools/new.mjs: cada uno comienza con su propia lista de verificación. Elimina el ejemplo cuando el video del usuario esté en marcha.
Las etapas
Comienza cada video con node tools/new.mjs <id> "<Título>". Crea notes/<id>/ (los archivos nombrados a continuación, con sus listas de verificación) y un esqueleto de guión en videos/<id>.mjs.
| # | Etapa | Produces | Terminado cuando | Leer |
|---|---|---|---|---|
| 0 | Briefing | notes/<id>/brief.md | El espectador, la promesa ("después de verlo, el espectador puede..."), la duración, la forma y el idioma están escritos, con todo lo que el solicitante pidió por su nombre. | abajo |
| 1 | Método de investigación | research/00-how-to-research.md | Sabes cómo las personas que conocen este campo se informan y dónde se equivocan los principiantes. | references/research.md |
| 2 | Investigación, en tres rondas | research/NN-nombre.md, research/leads.md, research/next-videos.md, research/index.md | Cada pista en leads.md está cerrada (investigada, no encontrada, siguiente video, fuera de tema o abierta); cada ejemplo real pasa la prueba de ejemplo y se conoce hasta la profundidad de un detalle; se investigan otras opiniones y mitos; la ronda 3 ha releído en su fuente cada afirmación que se dirige al video, y cada una tiene una fuente y una etiqueta de confianza; lo que el solicitante recuerda tiene un veredicto. La lista completa: references/research.md, sección 11. | references/research.md |
| 3 | Mapa mental | mindmap.json | Cada idea investigada es core (en el video), support (investigada y verdadera, mantenida fuera del núcleo) o cut (no confirmada, injusta o fuera de tema); las ideas core por sí solas cumplen la promesa; node tools/mindmap.mjs <id> no reporta errores. | references/planning.md |
| 4 | Storyboard | storyboard.md, assets.md | Cada latido tiene una imagen, una esencia, un componente y un sonido (generalmente ninguno); las comprobaciones al final están marcadas. | references/planning.md |
| 5 | Guión | videos/<id>.mjs | node tools/check.mjs <id> no reporta errores y has leído cada advertencia. El guión tiene la duración del núcleo. | references/authoring-kit.md, references/components.md |
| 6 | Revisión de precisión | review/accuracy.md, research/index.md (review/coverage.md solo para un informe completo) | Cada fila de dump --claims tiene un veredicto y una fuente; para cada historia real, un verificador que no la escribió ha comparado el guión, las notas y las fuentes (o, sin un segundo agente, lo has hecho tú, y el archivo dice "no independiente"); la investigación se ha releído contra el guión, y lo que el núcleo necesitaba y le faltaba ahora está en él; las correcciones se escriben de nuevo en las notas. | references/script-review.md |
| 7 | Revisión de comprensión | review/WhatIHaveLearned.md, review/lost-points.md | El diario alcanza la promesa sin lagunas, y cada forma de perderse tiene una solución o una razón. | references/script-review.md |
| 8 | Revisión visual | review/visual.md | Has mirado cada imagen fija y nada está cortado, cubierto, vacío o ilegible. | references/visual-review.md |
| 9 | Voz y sonido | líneas grabadas en out/tts/, sonidos en assets/<id>/ | El guión ha pasado las etapas 6 a 8 y la voz está grabada; el tiempo ahora sigue la voz real. Los sonidos de eventos están configurados; la música, si la hay, se sitúa solo bajo las partes de la historia. | references/voice-and-assets.md |
| 10 | Exportación y visualización final | out/<id>.mp4, .srt, .vtt, .chapters.txt | Has mirado los fotogramas del archivo exportado y has comprobado su sonido. | references/export-and-publish.md |
| 11 | Otros idiomas y formatos (si se solicita) | videos/i18n/<id>.<lang>.json | Cada idioma pasa check, y sus imágenes fijas han sido revisadas. | references/localization.md |
| 12 | Kit de publicación | publish.md | Título, descripción, capítulos, subtítulos, miniatura, fuentes y créditos están listos. | references/export-and-publish.md |
| 13 | Entrega | el mensaje al solicitante | La pasada desde el punto de vista del solicitante está hecha; el mensaje dice qué se decidió, qué se corrigió y qué sigue abierto. | references/finishing-and-revising.md |
Las reglas de escritura que se aplican desde la etapa 4 en adelante están en references/writing-for-everyone.md (palabras y frases) y references/teaching-techniques.md (cómo hacer que una idea se asiente). references/visual-design.md cubre diseño, color y movimiento. Lee esos tres antes de escribir tu primer guión.
Etapa 0: el briefing
Completa brief.md a partir de lo que el usuario ha dicho. Para todo lo demás, escribe tu mejor suposición y márcala como "(supuesto)"; no te detengas a preguntar (ver "Decide, registra, continúa"). La línea que más importa es la promesa: una oración que comienza "Después de verlo, el espectador puede...". Cada decisión posterior (qué investigar, qué recortar, cuándo está terminado el video) se prueba contra ella. También registra lo que el espectador ya sabe, porque ahí es donde comienza el video.
Copia en el briefing, con las propias palabras del solicitante, todo lo que pidió por su nombre: un servicio a utilizar, una clave y dónde está, un ejemplo o evento a incluir, un dato que recuerda, una parte que encontró confusa, un límite ("la mayor parte sin música"). Cada uno de estos es una fila para marcar antes de entregar. Un servicio nombrado se verifica ahora, no en la etapa 9; un dato que recuerdan va a la investigación como algo a verificar, no como algo a repetir.
Decide aquí si se necesita investigación. Salta las etapas 1 y 2 solo cuando el contenido se proporciona completamente (el producto propio del usuario, un guión que escribieron, un proceso que describieron) y no agregas datos propios. Si agregas aunque sea un número, fecha, nombre o "porque", investiga.
Etapas 1 y 2: investigación
Antes de investigar el tema, investiga cómo investigarlo: dos o tres búsquedas sobre cómo las personas aprenden e investigan este campo, y un nivel por encima (para el mercado de bonos: "cómo entender el mercado de bonos", luego "cómo aprender sobre economía"). Te dicen qué fuentes cuentan, qué números importan y dónde se equivocan los principiantes. Luego tres rondas:
- El esquema. Una nota por tema, con un resumen al principio: datos con fuentes, eventos reales (cada uno sometido primero a la prueba de ejemplo), comparaciones cotidianas, y las opiniones opuestas y mitos más fuertes, investigados con tanto cuidado como la línea principal.
- El detalle. Enumera cada persona, lugar, fecha, número, término, mecanismo, causa y cita que las notas mencionan sin explicar, en
research/leads.md. Investiga aquellos que conciernen al tema principal, una vez, hasta la profundidad de un detalle. Los temas vecinos van anext-videos.md; el resto se marca como fuera de tema. - La doble verificación. Sin nuevos temas. Lee de nuevo, en su fuente, todo lo que el video dirá; encuentra una segunda fuente independiente para las afirmaciones sorprendentes, los números que dan la magnitud de la historia, las citas y cualquier cosa que refleje mal a una persona nombrada.
Planifica las búsquedas antes de comenzar y guarda una tercera para la ronda 3. Si puedes iniciar otros agentes, asigna cada evento real a su propio agente, y la doble verificación a uno que no haya escrito la nota.
Dos cosas que el video terminado debe poder aprovechar:
- Eventos reales, conocidos hasta la profundidad de un detalle. Una persona inventada hace que una idea sea fácil de seguir; un evento real hace que el espectador la crea y la recuerde. Para un tema con historia (un mercado, una tecnología, una institución) investiga al menos dos. Si uno muestra a alguien ganando, investiga cómo podría haber fallado, y encuentra uno donde alguien perdió: una victoria por sí sola enseña la lección equivocada. Para un mecanismo de la naturaleza o un método (por qué el cielo es azul, cómo hacer un nudo), una observación, medición o descubrimiento real es suficiente, o ninguno: escribe "ninguno, porque..." en el briefing.
- Lo que el solicitante recuerda, verificado. Es una pista, y a menudo parcialmente incorrecta. Verifica cada parte, usa lo que se sostiene, y diles qué corregiste y por qué; nunca repitas una afirmación porque "el solicitante lo dijo", y nunca la descartes en silencio.
Detalles: references/research.md.
Etapa 3: el mapa mental
mindmap.json es un árbol corto de cada idea que el video podría contener (los tipos de nodo se enumeran en references/planning.md sección 1; node tools/mindmap.mjs los nombra cuando uno es incorrecto). Cada nodo dice en pocas palabras cuál es la idea, dónde viven sus detalles en la investigación ("archivo.md#Título"), qué ideas necesita primero el espectador y a qué otras ideas se conecta en otro lugar. Cada idea es core (en el video: la promesa la necesita, una historia real no puede contarse sin ella, o la justicia la necesita), support (investigada y verdadera, mantenida fuera del núcleo: material para la descripción, una versión más larga si el solicitante la pide, o un siguiente video) o cut (no confirmada, no puede contarse de manera justa, o no concierne al tema principal; una historia real que falla la prueba de ejemplo es cut). La herramienta verifica que cada puntero lleve a algún lugar y que nada se enseñe antes de lo que necesita. Detalles: references/planning.md.
Etapa 4: el storyboard
Una tabla, una fila por latido: qué ve el espectador, la esencia de lo que dice la voz, qué componente lo dibuja, si llega una palabra nueva, y qué se oye además de la voz (para música, efectos de sonido y voz en off). Agrega una fila para la transición de entrada y otra para los créditos finales. Las primeras versiones pueden dejar las imágenes en blanco; completa los latidos clave primero. Detalles: references/planning.md.
Etapa 5: el guión
El archivo videos/<id>.mjs es código. Cada latido del storyboard se convierte en una llamada a la API de componentes (documentada en references/components.md), donde escribes lo que dice la voz, lo que se muestra y cómo se mueve. El motor lee esto y produce los fotogramas. La duración del guión debe coincidir con la duración del núcleo del briefing; si se excede, corta las ideas de support, no las core. Detalles: references/authoring-kit.md.
Etapas 6 a 13
Una vez que el guión está escrito y pasa check, las etapas restantes son de revisión. Cada una produce archivos en review/ con la verificación correspondiente. La etapa 10 exporta el video final. La etapa 13 entrega el mensaje al solicitante. No saltes ninguna revisión; la precisión, comprensión y calidad visual son responsabilidad del agente, no del usuario.