hs85-newbie/yt-faceless-ai

/yt-pipeline — Long-form 1 → Short-form 3

O formato é fixo (baseado em docs/research/, ADR-002).

• Long-form: inglês, 10-13 minutos, sem rosto, narração Voicebox, uma pergunta contraintuitiva sobre AI×Economia em 7 beats.
• Tela: motion graphics HyperFrames (gráficos, tabelas, capturas de artigos em movimento, recortes 2D) + stock. Zero vídeos gerados por IA, zero reedição de vídeos de terceiros.
• Short-form: seleciona 2-3 segmentos de 20-55s do long-form e renderiza novamente na vertical. Um único arquivo para Shorts, Reels e TikTok. Objetivo: atrair tráfego para o long-form.

Início e Retomada

/yt-pipeline                 # Novo episódio
/yt-pipeline 003             # Lê STATUS.md do episódio 003 e continua da etapa interrompida
/yt-pipeline 003 --from script

Se for um novo episódio, cria episodes/NNN-slug/ (NNN = maior existente + 1). Texto vai nesta pasta; áudio e vídeo em output/NNN/ (excluído do git). Ao final de cada etapa, atualiza a checklist em episodes/NNN-slug/STATUS.md. A próxima sessão retoma apenas com base neste arquivo.

Etapas

#	Etapa	Habilidades/Ferramentas	Produto	Pausa
1	Descoberta da pergunta	Coleta com yt-dlp → /yt-viral (ranking de canais do mesmo gênero)	01_idea.md: 3 candidatas a pergunta contraintuitiva	Gate 1
2	Pesquisa	Pesquisa na web, fontes primárias, se necessário /watch 1-2 vídeos (apenas estrutura)	02_research.md
3	Roteiro	7 beats + /yt-script (avalia 5 hooks)	03_script.md	Gate 2
4	Embalagem	/yt-package	04_package.md: título e texto da thumbnail
5	Áudio	Voicebox REST (/generate)	output/NNN/voice.wav, transcript.srt
6	Tela e Render	/hyperframes, materiais via /media-use	output/NNN/long.mp4 (16:9)	Gate 3
7	Capítulos e Descrição	/yt-chapters → /yt-seo	07_seo.md
8	Shorts	/yt-shorts → /hyperframes render vertical	output/NNN/short_1~3.mp4, 08_shorts.md
9	Upload	Scripts scripts/ (YouTube, Reels), TikTok manual	Registro de links	Gate 4
10	Métricas	/yt-retention (48h, 7d), /yt-comment, /yt-audit a cada 4 episódios, /yt-plan 1x/mês	10_metrics.md

/yt-edit não é usado. Esta skill serve para cortar excessos de gravações originais; como o canal usa voz sintética, não há o que cortar. Se a narração for humana, insere-se após a etapa 5.

Regras por Etapa

1. Descoberta da Pergunta

• Uma pergunta define o vídeo inteiro. A diferença entre 70-100k e 1-2,9M de views está no ângulo da pergunta.
• Critérios para uma boa pergunta: existe uma crença comum, e números de fontes primárias a contradizem. Ex: "IA ficou mais cara que humanos", "Datacenters sendo silenciosamente cancelados".
• Para cada candidata: uma linha de pergunta, um número que a contradiz com fonte, vídeos de referência (se houver, com múltiplo de views), e uma linha de contra-argumento.
• Gate 1: O usuário escolhe uma.

2. Pesquisa

• Mínimo 3 fontes primárias (relatórios financeiros, artigos científicos, comunicados oficiais, estatísticas governamentais); mínimo 10 números com URL de fonte.
• Separe fatos de estimativas/projeções. No vídeo, projeções devem ter "Projection" na tela. (Falha apontada por Economy Media).
• Encontre obrigatoriamente 1 contra-argumento e sua refutação.
• /watch é usado apenas para analisar a estrutura de vídeos de referência. Não copie frases (política de não-autenticidade e direitos autorais).

3. Roteiro (inglês, 1.400-1.900 palavras, 150 ppm → 10-13 min)

• Roteiro em 7 beats: ① 0-15s: premissa com a qual todos concordam ② 45s-2min: pergunta que contradiz a premissa + título ③ 4 pilares de 1-1,5 min cada, com 1-2 números por pilar ④ 75-85%: reconhece contra-argumento, depois amplia e refuta ⑤ Um gráfico como punchline ⑥ Termina com a pergunta ou conecta ao próximo episódio, sem pedir inscrição.
• /yt-script gera 5 hooks, que são avaliados por hookscore.py; mostra os 2 melhores.
• Cada parágrafo inclui instruções de tela à direita: [CHART: ...], [ARTICLE: url + destaque], [CUTOUT: ...], [STOCK: ...]. A tela deve mudar a cada 2-4 segundos.
• Todos os números devem vir exclusivamente de 02_research.md. Não invente números.
• Gate 2: O usuário aprova o roteiro.

5. Áudio

• O app Voicebox deve estar rodando (http://127.0.0.1:17493). Se não estiver, peça ao usuário para iniciá-lo e pause.
• POST /generate por parágrafo (language: "en", profile_id fixo) → concatena em voice.wav.
• Gera timestamps via ditado (POST /transcribe ou hyperframes transcribe) → transcript.srt. Usado nas etapas 7 e 8.
• Perfil de voz: no primeiro episódio, o usuário ouve 3 amostras e escolhe. Fixo a partir daí.

6. Tela e Render

• Use /hyperframes. Antes de criar gráficos, tabelas, linhas do tempo ou capturas animadas de artigos, procure primeiro em /hyperframes-registry.
• Stock, BGM e efeitos sonoros via /media-use. Não use clipes de notícias, filmes ou vídeos de terceiros.
• Cores e fontes não mudam por episódio (identidade do canal). A composição das cenas deve variar a cada episódio (política de não-repetição de templates).
• Gate 3: O usuário assiste long.mp4.

8. Shorts

• /yt-shorts seleciona 2-3 segmentos de 20-55s do transcript.srt. Prioridade: cena do hook paradoxal, gráfico punchline, número mais contraintuitivo.
• Renderiza a mesma cena em 9:16 (não crop). Deixe 440px inferiores e 150px à direita vazios (área de botões Shorts/Reels).
• Legendas: apenas números e palavras-chave em destaque. Conecte a última cena com a primeira para incentivar replay.
• Na descrição do Short e em "Vídeos relacionados", coloque o link do long-form. Este é o propósito do short.

9. Upload — Gate 4

• Antes de publicar, resuma: o que (arquivo, título), para onde (YouTube, Instagram, TikTok), visibilidade, se é reversível.
• Publique apenas após aprovação do usuário no chat. Primeiro upload como privado; após confirmação, torne público.
• Rótulo de conteúdo sintético factual do YouTube: como o canal não usa vídeos gerados por IA, não se aplica. Narração sintética deve ser explicitada na descrição como "AI narration".

10. Métricas

• Após 48h e 7 dias, baixe o CSV de retenção do YouTube Studio e use /yt-retention. Identifique em qual parágrafo do roteiro (via transcript.srt) ocorreu a queda.
• /yt-comment gera apenas rascunhos de respostas. A publicação é feita pelo usuário.
• Critérios de aprovação (8 semanas, 12 episódios): retenção média ≥35%, e pelo menos 1 dos 12 episódios atinge 5x a mediana do canal.

O que não fazer

• Gerar vídeos com IA (Hicksfield etc.) — ADR-002, reavaliar se necessário.
• Reeditare vídeos de terceiros, copiar roteiros.
• Pular gates. Mesmo que o usuário diga "faz tudo sozinho", Gate 4 (upload) nunca é pulado.