shorts-from-peaks

¿Qué hace shorts-from-peaks?

Orden de las herramientas

1. search_videos(query, n, shorts) - Busca en YouTube, clasifica resultados (vistas, viralidad) y los almacena con sus picos principales. list_sources muestra lo que ya está almacenado. Prefiere fuentes oficiales o permitidas.
2. get_peaks(video_id) - Picos del mapa de calor de una fuente almacenada. Sin mapa de calor = indícalo; propón otra fuente o una ventana manual, nunca inventes picos.
3. create_clip_project(video_id, peak_rank=1, hook_text) - Borrador del editor a partir de un pico, o pasa start/end segundos para una ventana manual (se ejecuta directamente).
4. render_project(video_id, hook_text, custom_script) - Renderiza el borrador en segundo plano (se ejecuta directamente); consulta get_job(job_id). Su checks_failed enumera las verificaciones de transformación fallidas.
5. Corrige las verificaciones fallidas, luego pide añadirlo a la cola con queue_add(project_id) (necesita confirmación). ui_open("editor", video_id) lo muestra al usuario.

• Sin mapa de calor, o una subida/enlace largo que el usuario posee: autoclip_source(url, length, max_clips, prompt, create_drafts) encuentra los mejores momentos de la transcripción y devuelve clips clasificados (consulta get_job); con create_drafts=true llegan al editor.

Lectura de picos

• Los valores están normalizados de 0 a 1. Un pico es un máximo local >= 0.8; los picos a menos de 10 segundos se fusionan en uno solo.
• Ignora un pico en el primer 5% del video (artefacto de introducción). Conserva los 3 principales por valor.
• Reporta cada pico como inicio-fin, peak_value, rango de la herramienta, con el título del video y la URL.

Ventana de corte

• Longitud total de 15 a 30 segundos (máximo estricto de 30 s: la puerta de transformación rechaza los más largos).
• Inicia de 3 a 5 segundos antes del pico para que el espectador vea la preparación; termina de 2 a 4 segundos después del remate. Corta en un límite de oración o acción.
• Ajusta a la duración del video. Nunca uses más del 50% del tiempo de ejecución de un clip de terceros: añade B-roll, imágenes o tarjetas de datos.
• Un momento por Short. Dos picos solo si son el mismo latido narrativo.

Gancho (primeros 3 segundos)

• Una pregunta, una apuesta o una afirmación sorprendente leída sobre el primer fotograma, más un gran titular en pantalla (máximo 6 palabras).
• Usa solo hechos presentes en el título, la descripción o la transcripción; etiqueta los rumores como "RUMOR".
• Narración: oraciones de <= 8 palabras, aproximadamente 2.5 palabras/s, gancho -> contexto -> remate en el pico -> breve CTA. El audio original de la fuente permanece bajo o apagado; el narrador lidera.

Verificaciones de transformación (las cinco deben pasar; consulta docs/LEGAL.md)

• narration: narración original presente.
• visual_layers: al menos 2 capas añadidas (texto, imágenes/pegatinas, B-roll, tarjeta de datos).
• text_overlay: gancho o texto en pantalla.
• duration: 30 segundos o menos.
• source_credit: fuente acreditada en cada título de plataforma. Si una falla, corrige el proyecto y vuelve a renderizar; re-renderizar invalida cualquier aprobación anterior.

Subtítulos y texto

• Subtítulos palabra por palabra, de 2 a 4 palabras por grupo, fuente sans serif negrita, blanco con contorno negro, palabra activa resaltada.
• Mantén los subtítulos fuera del ~12% inferior y ~6% laterales (UI de la plataforma). Emojis solo si el estilo del canal los usa.

Título, subtítulo, hashtags

• Título/primera línea = el gancho, menos de 80 caracteres. Una oración de contexto.
• 3-5 hashtags: 1 de nicho, 1-2 de tema, 1 amplio. Sin etiquetas prohibidas o engañosas.
• Incluye siempre Fuente: <canal> - <URL>.
• Plantilla: references/clip-brief.md.

Divulgación de IA

La narración sintética (TTS) o los visuales de IA requieren la bandera de divulgación de IA por publicación antes de la aprobación, más la etiqueta de IA de la propia plataforma al subir. Recuérdalo al usuario en la tarjeta de confirmación.

No hacer

• Publicar un clip en bruto, un clip de más de 30 segundos o un clip sin narración.
• Usar una fuente que el usuario haya marcado como bloqueada o que sea privada/solo para miembros/solo con inicio de sesión.
• Añadir a la cola, programar o eliminar sin la confirmación del usuario.