Instalação de plugins: Antes de comandos de configuração ou atualização, siga as regras de execução de plugins quando esta skill estiver dentro de um plugin HyperFrames. Instalações independentes mantêm as instruções de atualização abaixo.
Convenções do HyperFrames Studio
O Studio desenha uma linha na linha do tempo por elemento de nível superior. Um projeto que segue as regras abaixo abre como uma linha do tempo curta e legível; um que não segue abre como uma parede de linhas não rotuladas que o usuário não pode editar. Estas são convenções sobre o que construir. Para saber como alterar um clipe, siga /hyperframes-core references/creator-editing-recipes.md e nunca invente uma forma diferente da mesma edição.
0. Converse antes de construir
Leia a mensagem antes de abrir um arquivo. Decida o que ela pede:
| A pessoa | Você |
|---|---|
| nomeia uma mudança, mesmo que educadamente ("aumente o título", "pode cortar a terceira cena?") | Faça-a. |
| dá um comentário sobre o filme pronto ("a introdução parece brusca", "não dura o suficiente") | Encontre a causa, mude o aspecto mensurável, diga o que o comentário significava e o que mudou, e registre conforme /hyperframes-creative references/storyboard-recipe.md § 4. |
| faz uma pergunta e não nomeia mudança ("por que o título pula?") | Responda-a. Não mude nada. |
| diz para não mudar nada, espere, "só pensando", "vamos conversar" | Não altere nenhum arquivo, nem mesmo uma correção que você percebeu. Ofereça em palavras. |
| traz uma ideia para este filme sem mudança concreta ("quero que o final pareça maior") | Proponha a mudança e adicione-a ao plano (abaixo). Não altere nenhum arquivo de composição. |
| pede um novo filme | Planeje-o (§ 5). |
| aprova um plano ("construa", "vá em frente") | Construa o que foi aprovado. |
Uma mensagem que faz uma pergunta e nomeia uma mudança recebe a resposta e a mudança. Apenas quando você não conseguir distinguir se ela pede algo é que é uma conversa: uma resposta errada custa uma mensagem; uma construção errada custa uma longa execução e uma rodada de comentários.
Uma resposta de conversa:
- Responda primeiro, em palavras simples, em algumas frases.
- Faça apenas perguntas cuja resposta mude o filme, cada uma com uma resposta recomendada e sua compensação ("30 segundos cabem em um feed; 60 deixam espaço para a demo").
- Quando houver uma ideia a moldar: para um novo filme, direções conforme
/hyperframesreferences/pitch-round.md; para uma ideia sobre este filme, duas ou três opções para a parte nomeada. Recomende uma. - Termine com o próximo passo e a palavra que o inicia ("Diga construir e eu começo").
Mantenha o plano no projeto, não apenas no chat: a próxima mensagem pode iniciar uma nova sessão que não vê esta. Adicione-o ao STORYBOARD.md da forma como /hyperframes-creative references/storyboard-recipe.md § 4 registra uma rodada; nunca sobrescreva quadros travados. Se a pessoa pediu para não mudar nada, não escreva nada: coloque o plano na resposta e ofereça-se para salvá-lo.
1. Cada cena é uma subcomposição
A composição raiz contém apenas hosts temporizados, mídia e áudio. Qualquer cena com estrutura aninhada (uma div com filhos, um título com subtítulo, um gráfico) é seu próprio arquivo carregado com data-composition-src, conectando-se conforme /hyperframes-core references/sub-compositions.md.
Marcação aninhada deixada dentro da raiz não se torna uma linha própria. Ela se esconde dentro de uma linha opaca que não pode ser cortada ou movida parte por parte.
Autore como se um lint de estrutura rejeitasse qualquer violação.
2. Uma faixa de legendas
- Todas as legendas vivem em uma faixa: um único host de subcomposição (um
data-track-index) marcadodata-track-kind="captions"que carrega cada grupo de legendas em ordem. - Nunca uma linha por grupo de legendas, e nunca legendas misturadas em uma faixa com outro tipo.
- As regras de temporização de palavras permanecem inalteradas: veja
/embedded-captionse as regras de lintcaption_*.
3. Um tipo de elemento por faixa
Agrupe por tipo para que cada linha seja uma coisa que o usuário possa selecionar, silenciar ou arrastar como um conjunto.
| Tipo | data-track-kind |
|---|---|
| Vídeo base / A-roll | video (da tag) |
| Cenas, sobreposições, gráficos | graphics |
| Legendas | captions |
| Áudio (narração, música, efeitos sonoros) | audio (da tag) |
Coloque data-track-kind em hosts de subcomposição. Os tipos de vídeo e áudio vêm da tag, então <video> e <audio> não precisam de atributo. Dê a cada tipo seu próprio data-track-index; o número é apenas para exibição; nunca muda o que renderiza por cima. Use CSS para camadas.
4. Zonas seguras
Qualquer régua ou sobreposição de caixa segura vive no painel de visualização, nunca dentro da composição, portanto não adicione elementos guia ao HTML.
Ambas as proporções (larga e vertical) usam as mesmas duas caixas seguras, os padrões do Premiere. A alternância de visualização as desenha com uma marca no ponto médio de cada borda. Fonte:
ACTION_SAFE_PERCENT e TITLE_SAFE_PERCENT em packages/studio/src/utils/previewSafeMargins.ts.
| Caixa | Proporção do quadro | Recuo em cada borda |
|---|---|---|
| Action-safe | 90% | 5% |
| Title-safe | 80% | 10% |
- Margens seguras: tudo visível permanece dentro da caixa action-safe (90%), e legendas e conteúdo-chave permanecem dentro da caixa title-safe (80%).
- Layouts lado a lado e 50/50 mantêm o conteúdo de cada metade dentro da caixa title-safe.
5. Um novo filme: plano, storyboard, construção
Os filmes hyperframes-launches foram feitos nesta ordem. Cada etapa tem um dono; siga-o e não repita aqui.
| Etapa | Dono |
|---|---|
| 1. Brief | /hyperframes references/intent-interview.md. Dentro de um projeto existente, apenas uma continuação do mesmo filme permanece: uma nova versão ou uma versão reduzida, mesmo fluxo de trabalho e proporção. Faça suas perguntas obrigatórias, pule hyperframes init, nunca sobrescreva BRIEF.md ou STORYBOARD.md, adicione uma nova seção datada a cada um e diga isso na resposta. Um filme com fluxo de trabalho ou proporção diferente inicia um novo projeto, e a resposta diz isso. |
| 2. Direções | /hyperframes references/pitch-round.md |
| 3. Storyboard | /hyperframes-creative references/storyboard-recipe.md |
| 4. Construção | O fluxo de trabalho para o qual o brief direciona (/hyperframes § 2) e suas próprias referências |
| 5. Comentários | /hyperframes references/review-loop.md |
O que os filmes de lançamento adicionam, para um lançamento de produto. Quando o arco escolhido pelo fluxo de trabalho disser o contrário, o arco vence.
- Footage real para o produto lançado. Peça uma gravação de tela no brief, a menos que o fluxo de trabalho a capture por si só (um site a partir de sua URL), e mantenha seu espaço com um placeholder rotulado até que chegue. Nunca aproxime a UI do produto lançado. Uma ferramenta de terceiros mostrada como contexto (um app de chat, um editor) é reconstruída fielmente a partir de uma captura.
- Um mundo. A mesma janela ou tela continua entre os beats. Examine cada corte: o que persiste não deve pular.
- Cursores e conteúdo rolado. Um cursor, ou conteúdo que a própria janela rola para fora, sai pela borda da janela ou quadro, não desaparecendo no meio do quadro. Trocas de elementos e texto seguem o
cut-catalog.mddo fluxo de trabalho, quando existente. - Termine no comando ou no endereço, com o logo pousando em footage que ainda está em movimento.
- Informe o tempo de execução em cada versão. Exceder o tempo alvo é decisão da pessoa, não sua.
Verificando seu trabalho
Execute hyperframes check (que executa lint) e corrija cada achado. Em seguida, abra o projeto no Studio e verifique se a linha do tempo mostra uma linha base, uma linha por host de cena, uma linha de legendas e as linhas de áudio.