SCROLLUCK/dark-channel-studio-public

shorts-from-picos

Ordem das ferramentas

1. search_videos(query, n, shorts) — pesquisa no YouTube, classifica resultados (visualizações, viralidade) e os armazena com seus principais picos. list_sources mostra o que já está armazenado. Prefira fontes oficiais ou permitidas.
2. get_peaks(video_id) — picos do heatmap de uma fonte armazenada. Sem heatmap = informe; proponha outra fonte ou uma janela manual, nunca invente picos.
3. create_clip_project(video_id, peak_rank=1, hook_text) — rascunho do editor a partir de um pico, ou passe start/end segundos para uma janela manual (executa diretamente).
4. render_project(video_id, hook_text, custom_script) — renderiza o rascunho em segundo plano (executa diretamente); consulte get_job(job_id). Seu checks_failed lista as verificações de transformação que falharam.
5. Corrija as verificações com falha e peça para adicioná-lo à fila com queue_add(project_id) (requer confirmação). ui_open("editor", video_id) mostra ao usuário.

• Sem heatmap, ou um upload/link longo que o usuário possui: autoclip_source(url, length, max_clips, prompt, create_drafts) encontra os melhores momentos a partir da transcrição e retorna clipes classificados (consulte get_job); com create_drafts=true eles vão para o editor.

Leitura dos picos

• Os valores são normalizados 0-1. Um pico é um máximo local >= 0,8; picos com menos de 10 s de distância se fundem em um.
• Ignore um pico nos primeiros 5% do vídeo (artefato de introdução). Mantenha os 3 primeiros por valor.
• Relate cada pico como início-fim, valor_do_pico, classificação da ferramenta, com o título e URL do vídeo.

Janela de corte

• Duração total de 15 a 30 s (máximo rígido de 30 s: a porta de transformação rejeita mais longos).
• Início 3-5 s antes do pico para que o espectador pegue o contexto; fim 2-4 s após o payoff. Corte no limite de uma frase ou ação.
• Limitar à duração do vídeo. Nunca use mais de 50% do tempo de execução de um único clipe de terceiros: adicione B-roll, imagens ou cartões de dados.
• Um momento por Short. Dois picos apenas se forem o mesmo batida da história.

Gancho (primeiros 3 segundos)

• Uma pergunta, uma aposta ou uma afirmação surpreendente lida sobre o primeiro quadro, mais um grande título na tela (máx. 6 palavras).
• Use apenas fatos presentes no título, descrição ou transcrição; rotule rumores como "RUMOR".
• Narração: frases <= 8 palavras, cerca de 2,5 palavras/s, gancho -> contexto -> payoff no pico -> breve CTA. O áudio original da fonte fica baixo ou desligado; o narrador lidera.

Verificações de transformação (todas as cinco devem passar; veja docs/LEGAL.md)

• narration: narração original presente.
• visual_layers: pelo menos 2 camadas adicionadas (texto, imagens/adesivos, B-roll, cartão de dados).
• text_overlay: gancho ou texto na tela.
• duration: 30 s ou menos.
• source_credit: fonte creditada em toda legenda da plataforma. Se uma falhar, corrija o projeto e re-renderize; re-renderizar invalida qualquer aprovação anterior.

Legendas e texto

• Legendas palavra por palavra, 2-4 palavras por grupo, fonte sem serifa em negrito, branca com contorno preto, palavra ativa destacada.
• Mantenha as legendas fora dos ~12% inferiores e ~6% laterais (UI da plataforma). Emojis apenas se o estilo do canal os usar.

Título, legenda, hashtags

• Título/primeira linha = o gancho, com menos de 80 caracteres. Uma frase de contexto.
• 3-5 hashtags: 1 nicho, 1-2 tópico, 1 ampla. Sem tags proibidas ou enganosas.
• Sempre inclua Fonte: <canal> - <URL>.
• Modelo: references/clip-brief.md.

Divulgação de IA

Narração sintética (TTS) ou visuais de IA exigem a flag de divulgação de IA por postagem antes da aprovação, mais o rótulo de IA da própria plataforma no upload. Lembre o usuário no cartão de confirmação.

Não faça

• Publique um clipe bruto, um clipe com mais de 30 s ou um clipe sem narração.
• Use uma fonte que o usuário marcou como bloqueada ou que seja privada/somente para membros/somente com login.
• Adicione à fila, agende ou exclua sem a confirmação do usuário.