Video corto
Haz una película que su espectador previsto pueda seguir y quiera ver, empezando por la audiencia, el propósito, el material y lo que la persona ya ha elegido. Este paquete se destiló de una producción de varios días de películas promocionales para una aplicación de debate, dirigida por una persona que respondía rápidamente; las semillas lo llaman la producción fuente.
Cómo leer este paquete
Obligación (clase) te vincula. Sus cinco clases: (requisito explícito), lo que la persona pidió o prohibió, dentro de su alcance; (permiso), lo que la persona no ha autorizado, no lo haces; (hecho técnico), lo que se cumple independientemente del gusto; (veracidad), tus afirmaciones sobre tu trabajo, comprobaciones, percepción y la película coinciden con lo que sucedió; (privacidad), credenciales y datos personales.
Hipótesis marca todo lo demás, incluido cada método: su mecanismo, las condiciones bajo las que pareció funcionar, lo que no está establecido y cómo falla. Evalúa cada hipótesis frente al objetivo y las circunstancias actuales, y mejórala; registra lo que cambiaste y por qué en el registro de decisiones en project.md. Las obligaciones y las compuertas de requisitos son fijas; las semillas y las compuertas de hipótesis son valores predeterminados sólidos, que puedes omitir o ajustar con dicha entrada.
Los ejemplos en las semillas provienen de la producción fuente. Genera premisas y dispositivos a partir del material de este proyecto, y marca cualquier propuesta que coincida con un ejemplo de semilla.
Si local.md existe junto a este archivo, léelo antes que cualquier otra cosa. Sus entradas son las instrucciones permanentes de la persona: cada una lleva la clase (requisito explícito) o (permiso) dentro de su alcance declarado, anula cualquier hipótesis o valor predeterminado de semilla, y cede a una instrucción posterior en el proyecto actual. local.example.md muestra su forma.
Primeros pasos
Inicia la bandeja de entrada textual, messages.md (seeds/gates.md), con el primer mensaje de la persona, para que ninguna instrucción quede sin registrar. Examina el material e inspecciona los clips, borradores, líneas de tiempo, activos y scripts auxiliares existentes antes de hacer reemplazos. Luego escribe la forma corta de project.md (seeds/project-file.md) y las filas de environment.md (seeds/environment.md) que el primer artefacto necesita. Registra en project.md el nivel (a continuación) y la disponibilidad de la persona tal como ella la describió.
Hipótesis: el primer artefacto que la persona ve (una lista numerada de premisas, un arreglo a nivel de citas o una costura básica) debería llegar poco después de ese primer vistazo, porque una reacción a algo concreto responde preguntas que un mensaje de entrada no puede. Envía las preguntas de entrada junto con él. Construye tools/show antes de la primera exhibición y tools/spend antes de la primera llamada paga, y los scripts de compuerta restantes antes del primer renderizado. En la producción fuente, las preguntas que podrían haber ido en una entrada llegaron más tarde como correcciones de una persona que respondía rápidamente. Esta secuenciación está razonada, no observada. Falla cuando el primer artefacto se basa en una premisa que una respuesta habría derribado, como si las personas mostradas consienten; haz esas preguntas bloqueantes antes de crearlo.
Obtención de medios. reference/media-index.md enumera los tipos de medios que puede contener una película y las formas en que se crea cada uno; no nombra proveedores. Cuando el tratamiento requiera un tipo que no puedas crear a partir del material disponible, haz tres cosas antes de elegir una ruta. Investiga el estado del arte para crear y editar ese tipo, ya que las rutas nombradas en la tabla de entorno son ejemplos con fecha, no la respuesta. Verifica qué usa ya la persona: claves en el entorno, herramientas en la máquina, notas y proyectos anteriores en su contexto local, local.md. Luego, si la persona es accesible y quiere dirigir, ofrece dos o tres rutas con precio, calidad y costo de configuración y pregunta cuál tomar; si pidió trabajo de una sola toma o no está disponible, elige tú mismo la mejor ruta y pide solo lo que no puedas obtener solo: una clave API, créditos, una cuenta, dinero. Hipótesis: asume que la persona pagará por los medios que se ganen su lugar en la película, así que propón la ruta paga cuando sea claramente mejor y di lo que cuesta; la persona de la producción fuente aprobó la voz paga sin dudar cuando se le mostró el número. No gastes nada hasta que diga que sí (G2, seeds/project-file.md sección 6). Falla cuando la persona ha dicho que la película no debe costar nada; entonces la ruta gratuita es la respuesta y la paga una nota al pie.
Semillas, en el orden en que un proyecto suele alcanzarlas
Una secuencia de ejemplo, no un pipeline:
- En paralelo:
seeds/footage-index.mdpara grabaciones (índice de metraje, librería de clips, mapa de estructura); tokens de marca (seeds/coded-scenes.md) y notas de investigación (seeds/treatment.md) para un producto. seeds/treatment.md: tratamiento y storyboard.seeds/assembly.md: guion de ensamblaje, costura básica, decisión de estructura; luego la revisión independiente (seeds/audit.md).- Según sea necesario:
seeds/cut-and-build.md(archivo de corte, constructor) cada vez que se corte o se reajuste el metraje grabado;seeds/edit-room.mdcuando una persona dirige los cortes;seeds/coded-scenes.md(composición, imágenes fijas);seeds/sound-and-voice.md(voz, hoja de referencia, música, informe de mezcla, maestro);seeds/helpers.md(resúmenes, registro de ayudantes) cuando los ayudantes toman trabajo. - Antes de cada exhibición, un paquete de check-in que indique el estado de auditoría del archivo (
seeds/show-the-human.md), generalmente después de un informe de auditoría (seeds/audit.md). - Revisión en la semilla donde reside el problema, a partir de una reformulación cuando la retroalimentación es ambigua.
- Auditoría final y carpeta de entrega (
seeds/audit.md).
reference/technical-facts.md contiene hechos sobre sincronización, imagen y sonoridad; las autopruebas del constructor que los verifican están en seeds/cut-and-build.md. reference/media-index.md enumera los tipos de medios y las formas en que se crea cada uno. reference/ui-design.md contiene la dirección de interfaz que la persona dio durante la producción fuente, generalizada, con una verificación para cada regla que se puede ejecutar en una imagen fija.
Hipótesis: establecer la estructura antes del pulido, porque una costura básica permite juzgar el orden antes de pagar el acabado. Las mayores pérdidas evitables de la producción fuente fueron borradores pulidos en un orden después descartado. Falla cuando el efecto depende del acabado, como con un tratamiento de sonido; entonces termina solo la muestra que el juicio necesita (seeds/assembly.md).
Niveles
| Material y trabajo | Semillas que suelen importar (añadidas a la primera fila) | Compuertas de hipótesis que suelen rendir |
|---|---|---|
| Un cambio pequeño en una película o clip existente, como un recorte (no leas nada más) | project-file (forma corta), environment (fila FFmpeg), gates, verificaciones de auditoría para lo que cambió, show-the-human | G1a, G8 |
| Una grabación larga (demo, charla, stream) condensada a un corte corto | footage-index (sección de pantalla), treatment (forma corta), assembly, cut-and-build, sound-and-voice (subtítulos, música, niveles), auditoría completa | G1a, G10, G11 |
| Un producto o idea explicado en escenas codificadas | treatment, assembly, coded-scenes, sound-and-voice | G1a, G8 a G11 |
| Una conversación grabada editada en una película | treatment, footage-index, assembly, cut-and-build, sound-and-voice, y edit-room cuando una persona dirige los cortes | G1a, G8 a G11 |
| Grabaciones combinadas con escenas de producto codificadas | todas las semillas, helpers, un tablero en vivo | G1a, G8 a G11 |
Una grabación cuenta como metraje cuando sus clips pueden aparecer en la película; una utilizada solo como fuente para el guion alimenta las notas de investigación.
Compuertas
Una compuerta es una condición que un paso debe cumplir antes de ejecutarse. Las compuertas de requisitos mantienen todo lo que las hace cumplir; instala las siete en cada proyecto, ya que cada una permanece en silencio hasta que ocurre su paso. Hipótesis: verificar cada condición dentro de un script que debas ejecutar para realizar el paso se cumple donde falla una regla escrita, porque una verificación dentro de un comando no necesita memoria; esto no se ha probado como un todo (seeds/gates.md), así que vigila las señales de falla listadas allí. Falla cuando omites un script llamando a una herramienta de medios, abriendo un archivo o pagando un servicio directamente. Un gancho de arnés que bloquee comandos de medios directos o envíe hace cumplir una condición sin tu cooperación; agrega uno solo con el permiso de la persona.
- Las compuertas de requisitos hacen cumplir una Obligación: G1 mostrar (cada paquete nombra el archivo exacto y el hash mostrado y declara su estado de auditoría: el id del informe de auditoría, o no auditado); G2 gastar; G3 bloqueo de renderizado; G4 retención; G5 consentimiento y derechos; G6 entrega; G7 editor listo (la verificación del editor antes de que llames lista la sala de edición).
- Las compuertas de hipótesis pueden omitirse con una razón registrada: G1a auditoría antes de mostrar; G8 reingreso de estado; G9 directivas contabilizadas, en cada paquete; G10 estructura primero, antes del pulido; G11 lector independiente, antes de un renderizado completo o entrega.
Cada script de compuerta imprime el bloque de estado: la línea del bosque (objetivo, premisa y etapa actual en una línea), directivas abiertas, id del borrador actual, renderizados retenidos y presupuesto restante.
La persona
La disponibilidad cambia quién decide, con qué frecuencia muestras el trabajo y qué superficies de revisión vale la pena construir; no cambia las Obligaciones, las compuertas de requisitos o los artefactos que registran decisiones. Evalúa lo que la persona sabe que tú no puedes descubrir (gusto, consentimiento, intención), el costo de interrumpirla y qué tan reversible es la elección: el dinero gastado o una afirmación publicada no se pueden deshacer con un borrador posterior.
Hipótesis: los artefactos tempranos baratos revelan preferencias antes del pulido costoso, porque una persona puede juzgar una lista de premisas o una vista previa corta exacta en una palabra. Esto pareció útil cuando la persona respondía rápidamente, con check-ins después del tratamiento, el ensamblaje y el primer borrador completo mientras el trabajo continuaba; cuándo se generaliza no está establecido. Los borradores toscos pueden oscurecer una idea cuyo efecto depende de la ejecución; muestra dicha idea terminada. Para una persona ausente por períodos, consulta los borradores enviados y el paquete de puesta al día en seeds/show-the-human.md.
- Obligación (requisito explícito): cuando la persona ha dicho que no la involucren, por ejemplo pidiendo la mejor película sin discusión, no preguntes nada; tus mensajes entonces no llevan preguntas ni opciones. Elige según el objetivo, registra cada elección como tuya con su subcampeón, y deja que la revisión independiente sustituya parte de su verificación de coherencia.
- El gasto, incluyendo si tus propias llamadas de modelo cuentan, sigue la Obligación de presupuesto en
seeds/project-file.md. - Obligación (veracidad): nunca simules la aprobación de la persona ni presentes una reacción imaginada como medida. Cuando el consentimiento, un hecho del producto o los derechos sigan sin estar resueltos, usa una representación que no afirme nada no respaldado, como un mockup etiquetado, y márcalo en la nota de verdad. La lista de verdad en
project.mdmarca cada elemento de la película grabado, creado o generado y cada afirmación del producto verificada o asumida; la nota de verdad endeliver/la informa a quien comparte la película (seeds/audit.md).
Hipótesis: detente cuando sea poco probable que otra pasada cambie lo que el espectador obtiene y puedas nombrar lo que no pudiste verificar, porque cada pasada adicional gasta tiempo y la atención de la persona. En la producción fuente, la persona, no el agente, encontró los defectos restantes; cuándo otra pasada deja de rendir no está establecido. Falla por autoconfianza, cuando te detienes en un borrador que crees limpio; la revisión independiente protege contra eso.
Hablar con la persona
Esto rige cada mensaje, no solo los paquetes de check-in.
Obligación (requisito explícito): responde cada pregunta que la persona hizo, porque una pregunta es una solicitud de su respuesta. Cuando te pidan tu opinión, dala; cuando te pregunten qué debería ir a algún lado, propón algo en lugar de preguntar de vuelta.
Hipótesis: un mensaje que responde las preguntas de la persona en su orden, lidera con tu recomendación, ofrece opciones numeradas que una palabra puede responder, cita cualquier línea que mencione con sus líneas vecinas y hablantes, dice con qué estás de acuerdo cuando estás de acuerdo, usa palabras llanas y cabe en una pantalla de teléfono permite que una persona decida de un vistazo sin reabrir archivos. En la producción fuente, la persona dirigía muchos agentes a la vez y pidió exactamente esto. Si otras personas quieren la misma forma no está establecido. Una persona que quiere primero el razonamiento encuentra abrupta la forma de recomendación primero; registra su preferencia en project.md y síguela.
A lo largo
Hipótesis: construye una idea prometedora antes de que puedas explicar su valor, tuyo o de la persona, porque algunas ideas muestran su valor solo una vez construidas; un clip real tópico que la persona propuso reorganizó la película fuente antes de que cualquiera pudiera decir por qué. Con qué frecuencia un agente encuentra dicha idea sin ayuda no está establecido. Falla como licencia para perseguir novedades contra un resumen claro.
Hipótesis: una solicitud de cambio es una solicitud para que toda la película funcione después del cambio. Un corte más corto aún necesita su configuración, sonido y acabado de interfaz, porque el espectador juzga la película, no el cambio; el agente fuente, al que se le pidió algo más corto, eliminó los tres. Falla cuando expande el alcance más allá del formato en project.md.
Ayudantes y la máquina
Hipótesis: un ayudante mantiene una decisión solo si su resumen escrito la lleva, así que pega las entradas del registro en vigor en cada resumen; un integrador posee el archivo de corte y la construcción, para que no colisionen dos escritores. seeds/helpers.md contiene la hipótesis completa y crea el resumen y el registro de ayudantes.
Hipótesis: detén cada servidor, vigilante y trabajador que iniciaste cuando su trabajo termine, y enumera los que están en ejecución en el bloque de estado, porque los procesos olvidados retienen memoria y puertos que la persona necesita. Falla cuando la persona aún usa una página que un proceso sirve; mantén ese proceso en ejecución hasta que el trabajo de la persona con la página termine.
- Obligación (hecho técnico): nada escribe en las entradas de renderizado mientras se ejecuta un renderizado (la compuerta de bloqueo de renderizado).
- Obligación (privacidad): usa credenciales solo de variables de entorno o archivos que la persona nombre; nunca busques, imprimas o registres claves.