hs85-newbie/yt-faceless-ai

/yt-pipeline — 1 video largo → 3 short

El formato está definido (basado en docs/research/, ADR-002).

• Video largo: Inglés, 10–13 min, sin rostro, narración con Voicebox, una pregunta contraintuitiva sobre IA×Economía en un guion de 7 pasos.
• Visual: Gráficos en movimiento de HyperFrames (gráficos, tablas comparativas, capturas de artículos animadas, recortes 2D) + material de stock. 0% imágenes generadas por IA, 0% reedición de videos de terceros.
• Short: Selección de 2–3 segmentos de 20–55 s del video largo, renderizados en vertical. El mismo archivo para Shorts, Reels y TikTok. Objetivo: atraer tráfico al video largo.

Inicio y reanudación

/yt-pipeline                 # Nuevo episodio
/yt-pipeline 003             # Leer STATUS.md de 003 y continuar desde el paso detenido
/yt-pipeline 003 --from script

Si es un nuevo episodio, se crea episodes/NNN-slug/ (NNN = máximo existente + 1). El texto va en esta carpeta; el audio y video en output/NNN/ (excluido de git). Al finalizar cada paso, se actualiza la lista de verificación en episodes/NNN-slug/STATUS.md. La siguiente sesión solo leerá este archivo para continuar.

Pasos

#	Paso	Habilidades/Herramientas	Producto	Pausa
1	Descubrimiento de pregunta	Colección con yt-dlp → /yt-viral (ranking de canales del mismo nicho)	01_idea.md 3 candidatos de preguntas contraintuitivas	Puerta 1
2	Investigación	Búsqueda web, fuentes primarias; si es necesario, /watch 1–2 videos (solo estructura)	02_research.md
3	Guion	Guion de 7 pasos + puntuación de 5 hooks con /yt-script	03_script.md	Puerta 2
4	Empaquetado	/yt-package	04_package.md título, texto para miniatura
5	Voz	API REST de Voicebox (/generate)	output/NNN/voice.wav, transcript.srt
6	Visual y renderizado	/hyperframes, materiales con /media-use	output/NNN/long.mp4 (16:9)	Puerta 3
7	Capítulos y descripción	/yt-chapters → /yt-seo	07_seo.md
8	Short	/yt-shorts → /hyperframes renderizado vertical	output/NNN/short_1~3.mp4, 08_shorts.md
9	Subida	Scripts de subida (YouTube, Reels), TikTok manual	Registro de enlaces	Puerta 4
10	Medición	/yt-retention (48h y 7d), /yt-comment, cada 4 episodios /yt-audit, una vez al mes /yt-plan	10_metrics.md

No se usa /yt-edit. Esta habilidad recorta el exceso de grabaciones originales; como el canal usa voz sintética, no hay nada que recortar. Si en el futuro se graba narración humana, se inserta después del paso 5.

Reglas por paso

1. Descubrimiento de pregunta

• Una sola pregunta define todo el video. La diferencia entre videos de 70–100 mil vistas y los de 1–2.9 millones está en el ángulo de la pregunta.
• Características de una buena pregunta: existe una creencia común, y los números de fuentes primarias la contradicen. Ejemplo: "La IA se ha vuelto más cara que los humanos", "Centros de datos cancelados silenciosamente".
• Para cada candidato: una línea de pregunta, un número revelador con fuente, video de referencia (si existe, con su desempeño), una línea de contraargumento.
• Puerta 1: El usuario elige una.

2. Investigación

• Mínimo 3 fuentes primarias (resultados financieros, papers, comunicados oficiales, estadísticas gubernamentales), mínimo 10 números, cada uno con URL de origen.
• Separar claramente hechos de estimaciones/proyecciones. En el video, las estimaciones llevan la etiqueta "Proyección" en pantalla. (Debilidad señalada por Economy Media).
• Buscar obligatoriamente un contraargumento y su refutación.
• /watch solo para analizar la estructura de videos de referencia. No copiar frases del guion (política de autenticidad y derechos de autor).

3. Guion (inglés, 1,400–1,900 palabras, 10–13 min a 150 palabras/min)

• Guion de 7 pasos: ① 0–15 s: premisa con la que todos están de acuerdo ② 45 s–2 min: pregunta que contradice la premisa + título ③ 4 pilares, cada uno de 1–1.5 min, con 1–2 números cada uno ④ 75–85%: reconocer contraargumento y luego refutar ampliando el contexto ⑤ Un gráfico como golpe final ⑥ Terminar con una pregunta o enlazar al siguiente episodio, sin pedir suscripción.
• Generar 5 hooks con /yt-script, puntuarlos con hookscore.py, mostrar los 2 mejores.
• Cada párrafo lleva una instrucción visual a la derecha: [GRÁFICO: ...], [ARTÍCULO: url + resaltado], [RECORTE: ...], [STOCK: ...]. La pantalla debe cambiar cada 2–4 segundos.
• Todos los números deben provenir de 02_research.md. No inventar números.
• Puerta 2: El usuario aprueba el guion.

5. Voz

• La app de Voicebox debe estar activa (http://127.0.0.1:17493). Si está apagada, pedir al usuario que la encienda y detenerse.
• Enviar cada párrafo a POST /generate (language: "en", profile_id fijo) → concatenar en voice.wav.
• Generar transcripción con marcas de tiempo (POST /transcribe o hyperframes transcribe) → transcript.srt. Los pasos 7 y 8 lo usarán.
• En el primer episodio, el usuario escucha 3 muestras de perfil de voz y elige uno. Luego se fija.

6. Visual y renderizado

• Entrar a /hyperframes. Antes de crear gráficos, tablas, líneas de tiempo o capturas de artículos animadas, buscar primero en /hyperframes-registry.
• Stock, BGM y efectos de sonido a través de /media-use. No usar clips de noticias, películas ni videos de terceros.
• Los colores y tipografías no cambian entre episodios (identidad de canal). La composición de escenas debe variar en cada episodio (política contra plantillas repetitivas).
• Puerta 3: El usuario visualiza long.mp4.

8. Short

• Con /yt-shorts, seleccionar 2–3 segmentos de 20–55 s desde transcript.srt. Prioridad: escena del hook paradójico, gráfico de golpe final, el número más contraintuitivo.
• Renderizar la misma escena en 9:16 (no recortar). Dejar 440 px en la parte inferior y 150 px a la derecha (zona de botones de Shorts/Reels).
• Los subtítulos solo muestran números y palabras clave en grande. Si la última escena enlaza visualmente con la primera, se incrementa la reproducción en bucle.
• En la descripción del Short y en "Videos relacionados" poner enlace al video largo. Este es el propósito de los Shorts.

9. Subida — Puerta 4

• Antes de subir, resumir: qué (archivo, título), dónde (YouTube, Instagram, TikTok), visibilidad, si es reversible.
• El usuario debe aprobar por chat para subir. La primera subida se hace en privado, y tras verificación se cambia a público.
• Etiqueta de contenido sintético realista en YouTube: este canal no usa imágenes generadas por IA, por lo que no aplica. La voz sintética se indica en la descripción como "AI narration".

10. Medición

• A las 48 h y 7 días, descargar el CSV de retención desde YouTube Studio → /yt-retention. Identificar qué párrafo del guion corresponde a la zona de abandono usando transcript.srt.
• Los comentarios se responden solo con borradores de /yt-comment. La publicación la hace el usuario.
• Criterio de aprobación (8 semanas, 12 episodios): retención promedio ≥35%, al menos 1 de 12 episodios alcanza 5 veces la mediana del canal.

Lo que no se hace

• Generación de imágenes con IA tipo Hixfield (ADR-002; se reevaluará si es necesario).
• Reedición de videos de terceros, copia de guiones.
• Saltar puertas. Incluso si el usuario dice "hazlo todo solo", la puerta 4 (subida) no se omite.