general-video

Vídeo Geral

Antes de confiar neste fluxo de trabalho, execute:

npx hyperframes skills update general-video

Um no-op bem-sucedido significa que a skill está atualizada. Reporte uma falha de atualização em vez de continuar com base na memória.

1. Aplicar adaptadores de fonte transversais

• Mídia: Para qualquer necessidade de áudio, imagem, ícone, logotipo, locução, gradação, LUT, tratamento/efeito, legenda ou operação de mídia, carregue /media-use e siga ../media-use/references/resolve.md (resolver, adotar, reutilizar) e ../media-use/references/setup-providers.md (provedores, autenticação). Feedback vago de filmagem e estilos nomeados usam ../media-use/references/media-treatments.md antes da edição; não improvise efeitos de mídia suportados com CSS/SVG/opacidade. Antes da primeira ação autenticada do provedor, execute npx hyperframes auth status e repita sua saída literalmente. Se desconectado, aplique a barreira em ../hyperframes/references/brief-contract.md: colaborativo aguarda o login ou uma escolha offline explícita; autônomo informa o status e continua por meio de um provedor offline disponível. Reporte um bloqueio quando nenhum provedor offline puder satisfazer uma capacidade necessária. A adoção local por si só não requer barreira de autenticação.
• Figma: Se qualquer entrada for uma URL figma.com, execute /figma primeiro. Construa a partir de seus ativos exportados, tokens, componentes ou quadros de storyboard. Não use chamadas brutas do conector Figma porque elas ignoram a sanitização de SVG, a proveniência de mídia e a vinculação de token de marca.

Estes adaptadores não alteram o fluxo de trabalho selecionado por /hyperframes.

2. Iniciar a partir do estado do projeto

Aplique a primeira linha correspondente; não avalie linhas de estado inferiores:

Estado	Ação
Edição específica	Faça a edição, preserve as decisões existentes do projeto, então reexecute as verificações afetadas. Não reabra a descoberta.
BRIEF.md existe	Leia-o. Se workflow nomear outro fluxo de trabalho e flow não for companion, passe adiante. Não faça perguntas do brief.
Sem brief, mas hyperframes.json ou STORYBOARD.md existe	Retome dos arquivos e preferências registradas. Preencha BRIEF.md apenas com fatos conhecidos.
Criação nova	Execute /hyperframes e sua camada de intenção. Retorne aqui apenas para workflow: general-video ou flow: companion.

Para um novo projeto, escolha um nome de diretório em kebab-case a partir do brief e crie o esqueleto antes de escrever o brief:

npx hyperframes init "videos/<projeto>" --non-interactive --example=blank --skill=general-video

Em seguida, escreva BRIEF.md na raiz do projeto usando ../hyperframes/references/brief-format.md. Em um projeto existente, a raiz é o diretório que contém hyperframes.json. Registre apenas os campos com preferência confirmada nomeados pelo formato do brief, usando node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT>; nunca registre padrões inferidos. Aqui <MEDIA_DIR> é o diretório da skill /media-use instalada e <PROJECT_ROOT> é o diretório que contém hyperframes.json. Se a camada de intenção adotou uma receita, aplique-a agora com node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes <PROJECT_ROOT> --name <nome> e não pergunte novamente.

3. Interpretar a forma da execução

Use apenas os termos canônicos de ../hyperframes/references/brief-contract.md:

Campo	Significado	Efeito
flow	Quem dirige	automation: escolha e execute a rota. companion: cocrie em conversa.
storyboard	Planejar, esboçar e revisar antes de construir	yes: execute o plano e a revisão do esboço (storyboard.html). no: construa sem ele.
mode derivado	Como os portões de verificação se comportam	Siga o contrato do brief. Nunca peça ao usuário para nomear um modo.

Não invente sinônimos para esses estados. Um sinal contínuo de "apenas construa" é tratado pela camada de intenção e chega como flow: automation, storyboard: no.

• Para flow: automation, escolha a rota e declare-a em uma linha na primeira atualização de progresso.
• Para uma edição específica, faça a edição sem inventar uma nova rota.

Para um corte bruto, ajuste, emenda ou reordenamento de filmagem existente, duplique a mesma fonte de vídeo em vários elementos de clipe. Em cada cópia, defina o intervalo de origem com data-media-start mais data-duration, então defina o posicionamento/ordem autoral com data-start. Áudio autorado separadamente segue os intervalos e temporização idênticos do clipe em elementos <audio> correspondentes. /hyperframes-core é dono desta edição temporal; use /hyperframes-keyframes apenas para animação de propriedades visuais como zoom, perfuração, panorâmica, corte, máscara ou clip-path em um invólucro interno. Copie os contratos completos de ../hyperframes-core/references/creator-editing-recipes.md.

Fluxo companion

Quando flow: companion:

• Leia BRIEF.md e reconcilie os ## Assets e ## Customizations aceitos com os artefatos do projeto. Complete o trabalho aceito que ainda está pendente; deixe o trabalho concluído em paz; não ofereça uma capacidade aceita novamente como se fosse nova.
• Chegue como o diretor, não o empreiteiro. Um usuário que escolheu companion escolheu envolvimento e qualidade; a resposta honesta é a melhor versão que você pode projetar, não a menor que você pode defender. O primeiro plano é o tratamento teto: o arco da história (pegue emprestada a lente de gênero mais próxima — menu § Lentes de gênero), a especificação de design, o tratamento de movimento de cada cena citado pelo nome (§ 5 da disciplina do plano), as transições, a identidade de áudio — música e marcas sonoras, ou silêncio deliberado — o material do usuário colocado, e uma abertura e fechamento projetados. Diga o que cada camada adiciona em uma linha; sinalize as caras (tempo de renderização, login, cobrança) ao nomeá-las. O usuário reduz um tratamento; eles nunca devem ter que montar um, aprovação por aprovação.
• O teto pertence ao conceito, não à caixa de ferramentas. Cada camada deve servir à mensagem do brief — um tratamento que vestiria qualquer vídeo da mesma forma é decoração. O trabalho artesanal sobe ao teto; o conteúdo nunca cresce além do que foi solicitado (§ 6).
• Entre os pontos de verificação, ../hyperframes/references/capability-menu.md funciona de duas maneiras. Como lista de gatilho: ofereça uma capacidade relevante quando o usuário mencionar sua entrada ou a construção atingir sua necessidade. Como canal de atualização de cada passagem: um plano, esboço ou ponto de verificação de construção pode carregar uma ou duas ofertas rastreadas apontadas para o material que o usuário está olhando ("o stat da cena 3 quer o tratamento de contagem"). Leia antes de oferecer; nunca despeje o catálogo completo.
• Após o usuário aceitar uma capacidade, produza seu artefato e registre a decisão na seção correspondente do corpo de BRIEF.md imediatamente. Reescreva um campo de frontmatter e registre a preferência confirmada apenas quando o usuário a alterar explicitamente.
• Mantenha os mesmos portões de storyboard, validação, pré-visualização final e aprovação de renderização. Companion muda quem dirige, não o que a qualidade exige.

4. Carregar conhecimento necessário antes de cada etapa

Estas leituras são obrigatórias quando sua condição corresponder:

Condição	Leia antes de agir
Qualquer HTML de composição ou layout de cena	/hyperframes-core; use references/determinism-rules.md para seu contrato de layout
Qualquer criação ou tratamento visual não trivial	/hyperframes-creative → references/house-style.md e references/video-composition.md
Qualquer movimento, animação ou transição de cena	/hyperframes-animation; siga seu roteamento para as regras, adaptadores, blueprints ou referências de transição correspondentes
storyboard: yes	../hyperframes/references/storyboard-format.md e ../hyperframes/references/review-loop.md
Qualquer ativo ou operação de mídia, incluindo narração, BGM, SFX, legendas, gradação ou transformações	/media-use; para reprodução e posicionamento do framework, leia também /hyperframes-core → references/variables-and-media.md
Montagem de múltiplas cenas	../hyperframes/references/production-loop.md
flow: companion, antes do primeiro plano	/hyperframes-creative → references/story-spine.md e references/house-style.md; a lente de gênero mais próxima e o ../hyperframes/references/capability-menu.md completo — o tratamento teto é projetado a partir destes, não lembrado
Uma oferta de capacidade companion, captura, grade de batidas, vídeo generativo, mapa, publicação ou capacidade de fluxo de trabalho cruzado	../hyperframes/references/capability-menu.md
Uma especificação de design existe, antes da aprovação final	/hyperframes-creative → references/design-adherence.md

Não substitua estas leituras por lembrança. A divulgação progressiva economiza contexto apenas quando a referência correspondente é realmente carregada.

5. Executar a composição

Use esta ordem de dependência. Pule uma etapa apenas quando sua entrada estiver ausente.

1. Plano. Declare o arco do espectador, estrutura, ritmo e driver de duração. Use um arquivo para uma cena única curta; use subcomposições para três ou mais cortes bruscos de cena ou qualquer cena reutilizada. Leia /hyperframes-creative → references/story-spine.md para arcos narrados, references/beat-direction.md para ritmo e /hyperframes-core → references/composition-patterns.md para estrutura. Para um brief de múltiplas cenas aberto, expanda o prompt através de /hyperframes-creative → references/prompt-expansion.md. Um plano de múltiplas cenas cita a forma de cada cena: um id de blueprint de /hyperframes-animation → blueprints-index.md quando um se encaixa, ou as regras nomeadas que ele compõe de rules-index.md quando nenhum se encaixa — nomes de movimento vêm desses índices, nunca inventados. A verdade da história decide quais cenas existem; a citação as veste. Pesquise o catálogo ativo antes de planejar construir qualquer visual nomeado você mesmo: para cada visual, efeito, tratamento ou transição que o brief nomeia — "scanlines CRT", "glitch", "grão de filme", "varredura cintilante", "explosão de confete" — execute npx hyperframes catalog --query "<o visual, em português claro>" --json e leia os principais resultados antes que o plano nomeie como esse visual será construído. A pesquisa não precisa de nada instalado: nenhum projeto, nenhum add anterior, nenhuma conta. Ela classifica todo o registro hospedado (~400 blocos e componentes) de qualquer diretório, portanto, também se aplica a um visual que o usuário solicita no meio da construção. Blocos que o plano nomeia são instalados na etapa 3; crie um visual manualmente apenas depois que uma pesquisa por ele não retornar nada que se encaixe. Um plano de múltiplas cenas também é registrado como o artefato de despacho: um bloco ## Quadro N por cena em STORYBOARD.md — status: outline, um src: declarado, a citação de blueprint/regras e o texto da batida — mesmo quando storyboard: no. O bloco é a unidade de despacho; a folha de storyboard é apenas a superfície de revisão.
2. Revisar o plano quando solicitado. Para storyboard: yes, execute o loop de revisão compartilhada sobre esses blocos. Para storyboard: no, continue sem pausa de plano ou folha de esboço. Quando uma pausa de plano acontece de qualquer forma, dobre a concessão de delegação de subagente (necessária pelo codex para o despacho da etapa 4) nessa pausa, em vez de parar novamente mais tarde.
3. Resolver dependências. Instale blocos do registro antes do trabalho paralelo. Prepare ativos do usuário, adote ativos existentes e resolva provedores offline primeiro. Após a instalação, execute a verificação de integridade.
4. Despachar construção paralela. Emita cada bloco de cena como uma chamada de ferramenta para o dispatcher de composição. O dispatcher cria subcomposições, aplica regras de movimento e transições, e monta o quadro de cena final. Após a conclusão, carregue a saída e execute a verificação de qualidade.
5. Revisão visual. Para storyboard: yes, apresente o storyboard renderizado para aprovação do usuário. Para flow: companion, o usuário pode solicitar alterações neste ponto. Para flow: automation, prossiga sem aprovação.
6. Montagem final. Concatene todas as cenas, aplique transições globais, mistura de áudio e legendas. Execute a verificação de exportação final.
7. Renderização e entrega. Renderize o vídeo final no formato e codec especificados. Carregue para o destino configurado ou deixe o artefato no caminho de saída do projeto.

6. Verificações de qualidade e aderência

Cada verificação deve ser executada após sua condição de gatilho. A falha de qualquer verificação bloqueia a progressão até que o teste passe novamente.

Verificação	Condição de gatilho	Ação de sanção
Aderência ao design	especificação de design existe	Corresponder a saída renderizada contra a especificação de design com references/design-adherence.md
Consistência da história	Plano de múltiplas cenas	Verificar cada cena contra seu status: e src:
Aderência à marca	Logotipos ou ativos de marca carregados	Verificar posicionamento, escala e variantes de cor
Qualidade de áudio	Faixas de áudio presentes	Verificar níveis, clipe, ruído de fundo
Legibilidade de legendas	Legendas codificadas	Verificar tempo, contraste, comprimento de linha

7. Diretrizes do modo companion

• Sempre enquadre a resposta do agente como um diretor colaborativo: "Aqui está o que a história pede..." vs. "Aqui está o que eu fiz."
• Nunca recue para uma resposta mínima ou defensiva. O teto é o design que melhor serve à mensagem, não o mais fácil de implementar.
• Documente cada decisão de design aceita na seção ## Customizations de BRIEF.md para manter a consistência entre as execuções.
• Se o usuário rejeitar um tratamento, registre o motivo e a preferência, e ofereça uma alternativa que mantenha a integridade do design geral.

8. Tratamento de erros e fallback

• Se um provedor de mídia autenticado falhar, faça fallback para um provedor offline se disponível. Se nenhum provedor offline puder satisfazer, relate um bloqueio claro.
• Se uma etapa de composição falhar (ex: dispatcher excede tempo limite), carregue a saída parcial e continue se a falha for isolada; caso contrário, reporte o erro e ofereça um plano de correção.
• Se a pesquisa de catálogo (npx hyperframes catalog ...) não retornar resultados, apenas então prossiga com a criação manual do efeito. Isto mantém a eficiência e evita reinventar a roda.