Files
gart/.claude/skills/editar-por-voz/criterios/07-ritmo.md
T
João HenriqueandClaude Opus 5 cbd9297751 docs(skill): alinhar editar-por-voz com a revisão humana da etapa 5
A skill decidia a edição sem saber que o JSON dela agora passa por uma tela
de revisão antes de virar FCPXML. Isso não é detalhe de fluxo: a etapa 5
traduz cada ação para o vocabulário dela, e sem conhecer essa tradução a
intenção da IA se perde no caminho — que é exatamente como uma decisão vira
"arbitrária" aos olhos de quem revisa.

Novo criterios/10-revisao-humana.md, com o que o app faz com cada ação:

- cut cobrindo >=60% da frase remove a linha; tocando só uma borda vira trim
  encaixado na fronteira de palavra. Corte de meia frase é ambíguo — passa
  do limiar e apaga a linha toda quando a intenção era aparar a hesitação.
- zoom ou text sobre uma frase marca ênfase, e ênfase significa DUAS coisas:
  zoom mais legenda dinâmica; as demais frases ficam com legenda comum. A
  escala vira o nível (1.15→leve, 1.3→média, 1.5→forte).
- sem ação, o nível é derivado do peak_emphasis; a decisão da IA sempre ganha.
- reason é exibido ao lado da frase na tela — é o que o editor lê antes de
  manter ou desfazer. Deixou de ser campo de log.

Consequência prática que faltava em 05-zoom.md: não espalhar zoom "por
segurança", porque cada um promove a frase em duas dimensões ao mesmo tempo.
Na dúvida, deixar sem — promover custa uma tecla, despromover custa mais.

Cada arquivo de critério ganhou cabeçalho de escopo (o que cobre, em que
fase), no mesmo padrão dos docs do Engine, para ler só o necessário.

Todas as afirmações numéricas do novo critério foram verificadas contra
fcpxml/phrase_review.py rodando, não assumidas.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-19 22:54:51 -04:00

41 lines
1.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 07 — Ritmo
> **Escopo:** Quantos efeitos cabem: os tetos e como escolher o que fica.
> **Quando:** Fase 7 — ver a ordem de trabalho em `../SKILL.md`.
**O erro mais comum é efeito demais.** Cansa mais que efeito de menos, e
denuncia edição automática.
## Limites
| Regra | Valor |
|---|---|
| Distância mínima entre dois zooms | **8–10 segundos** |
| Zooms por minuto de vídeo | **2 a 4** (teto) |
| Zoom + texto no mesmo instante | só com motivo claro |
Se dois picos estiverem colados, **escolha o mais forte e abra mão do
outro**. Não tente encaixar os dois.
## Candidatos ≠ obrigações
`suggest_zoom_windows` devolve uma lista de candidatos. Normalmente você usa
uma **fração** dela.
Caso real: num corte de 47,6s a ferramenta sugeriu **5** janelas. O certo
foram **3** — 5 violaria o teto de 2–4 por minuto. Ficaram a abertura, o
termo central e o fecho; as duas descartadas eram frases de apoio.
O mesmo vale para `peak_moments` no `summary`: é lista de candidatos.
## Como escolher quais manter
Quando precisar cortar a lista, priorize por **função narrativa**, não por
nota:
1. **A abertura** — prende o espectador.
2. **O conceito central** — o termo que o vídeo existe para explicar.
3. **O fecho** — a frase que fica.
Só depois disso, as frases de apoio, por ordem de ênfase.