edit-ad-promo
Transforma a oferta, produto e filmagens de um cliente em um anúncio pago em redes sociais em hebraico que declara a oferta exatamente, abre com um hook ranqueado, passa por revisão de conformidade e revisão de licenças, e é entregue como um lote de variantes de hook em um único corpo. A oferta, as alegações e as licenças são verificadas antes que os pixels sejam refinados.
Regras que se sobrepõem ao restante deste arquivo
- Oferta, preço e CTA exatamente como fornecidos por escrito. Strings e números vêm de um ledger que o cliente confirmou; nada é inventado, arredondado ou "melhorado"; urgência apenas se for verdade. Sem oferta do cliente: proponha uma de baixo atrito e PERGUNTE; nunca escreva uma.
- A tabela de conformidade é bloqueante. Cada um dos seus 12 tópicos tem um status; uma linha
failoublockedimpede que o rascunho seja apresentado, independentemente do que a rubrica diga. Um rótulo (divulgação de IA, aviso legal) nunca cura uma alegação enganosa. - Licenças:
License: unknown= não está no cliente ou no trabalho de anúncio (decisão padrão Q2: o "orgânico apenas" mais antigo do proprietário é uma postura de risco para suas próprias contas, não uma licença). Música e SFX apenas se a própria linha do arquivo permitir anúncios para o canal e território. Sons e logotipos de marcas de terceiros precisam de permissão ESCRITA da marca para anúncios. Uma correspondência de música não é uma licença; sons populares não são liberados. - Nenhuma lei universal de hook. Nenhuma fonte verifica um limiar de 3 segundos ou um número fixo de retenção; os hooks são ranqueados por razões declaradas e testados pelos próprios resultados do cliente.
- Zonas seguras são o preset da casa v1 (datado, não verificado em dispositivos; decisão padrão Q5), uma aprovação precisa de uma sobreposição visualizada, não apenas geometria.
- Gastos e privacidade: nenhuma geração paga sem
paid-generation-gate(uma estimativa e aprovação datadas); tomadas de IA apenas como clima ou B-roll faltante, divulgadas; nenhuma filmagem do cliente para ferramentas em nuvem sem uma decisão por cliente;snapshot --describe false. - PROMPT.md é aprovado por um humano antes da primeira linha de código de construção, também em execuções autônomas (decisão padrão Q6). Skills são procedimento, não permissão; restrições de usuário e projeto substituem este arquivo. Nunca mensage outras sessões do Claude.
Entradas -> saídas
Entrada: a oferta por escrito (preço, termos, prazo, aviso legal), canal CTA (botão, WhatsApp, código, endereço), plataformas e rota (orgânico, leilão de anúncio, Spark), durações (padrão 15 + 30 s), ativos de produto e marca, filmagens e consentimentos. Saída: linhas do ledger hf/OFFER (no PROMPT.md), hf/ad_gates.json (superfícies de oferta, hooks, conformidade, ativos), N variantes de hook em um corpo + cartão final, tabela de conformidade, QA por arquivo, nomenclatura <nome>_<plataforma>_<hook>_<aspecto>.mp4 com um manifesto (multi-video-variants).
Procedimento
| # | Faça | Artefato |
|---|---|---|
| 0 | Intake via video-intake: oferta + termos + prazo, canal CTA, plataformas/rota, durações, proporções, hooks (3), lista de verificação de ativos do cliente (references/ad-blueprint-and-hooks.md), consentimentos; um anúncio de referência -> reference-style-transfer primeiro; ls toda a pasta fonte | BRIEF + ledger |
| 1 | Ledger de oferta: uma linha por string exata (hebraico literal, símbolo de moeda, prazo, CTA) com as superfícies em que deve aparecer (voz, super, cartão final) | linhas do ledger |
| 2 | Tabela de conformidade do brief ANTES da escrita do roteiro (references/compliance-table.md): alegações, termos de preço, antes/depois, avaliações, hooks de atributo pessoal, saúde/finanças, ativos de marca, divulgação de IA, licença de música, consentimento de pessoas, UI falsa, política da plataforma | ad_gates.json conformidade |
| 3 | Roteiro: três hooks ranqueados com razões, folha de batidas por duração (hook, problema, solução, prova, oferta, CTA), oferta três vezes, cortes de 15 s e 30 s; narração transcrita para a edição em papel | SCRIPT.md |
| 4 | Quadros de estilo com a sobreposição da zona segura: hook, etiqueta de preço, antes/depois, cartão final; ativos com uma linha de licença cada (references/sound-and-licences.md); geração paga apenas através de paid-generation-gate | quadros de estilo, SOURCES.md |
| 5 | PROMPT.md + DESIGN.md (cada quadro: o quê, onde em px, quando em quadros, easing, som) -> aprovação humana -> construção: corte, gráficos (insígnia de preço, UI reconstruída em código, nunca estoque), legendas, cor, mix | projeto hf/ |
| 6 | Portões mecânicos: python scripts/ad_gate_check.py hf/ad_gates.json e python scripts/safe_zone_check.py elements.json --aspect 9x16 --overlay-evidence <captura de tela visualizada>; ambos saem 0 | relatórios |
| 7 | Verificar: render-qa-deliver (QA de cada quadro no arquivo final), rubrica A1-A8 (references/rubric-and-benchmarks.md), teste mudo, um crítico em todo o conjunto; UMA renderização completa por rodada | evidências de QA |
| 8 | Lote: variantes de hook no mix compartilhado, versões nomusic / nocaps, outras proporções via multi-video-variants (manifest_check.py saída 0) | final/ + manifesto |
| 9 | Apresentar: arquivos de uma vez, alterações numeradas, a tabela de conformidade, ticks do ledger, lacunas honestas (o que não foi testado em dispositivo) | mensagem |
Portões
Os estados são pass | fail | blocked | n/a com uma razão. Um timeout, amostra vazia ou entrada faltante é blocked, nunca pass. Uma chamada de ferramenta bem-sucedida é evidência de execução; uma renderização visualizada é evidência de aparência.
| Portão | Predicado | Evidência | Se falso | Proprietário | Reaverificar quando |
|---|---|---|---|---|---|
| G1 oferta exata | toda string/número do ledger aparece literalmente em cada superfície necessária; nenhum preço ou porcentagem na tela que não esteja no ledger; um CTA existe | descobertas de oferta do ad_gate_check.py claras (sem OFFER_NOT_EXACT, UNLEDGERED_AMOUNT, NO_CTA) | corrija o texto; nunca invente ou arredonde uma alegação; pergunte ao cliente | ad_gate_check.py + humano | qualquer edição de texto, preço ou cartão |
| G2 conformidade | todos os 12 tópicos avaliados; nenhum fail/blocked; linhas pass carregam evidências; linhas n/a carregam razões | a tabela em ad_gates.json; ad_gate_check.py saída 0 | remova ou substitua a alegação; proponha redação conforme; não renderize | esta skill (bloqueante) | qualquer nova alegação, ativo ou canal |
| G3 ranking de hook | >= 3 hooks ranqueados com razões distintas; nenhuma alegação universal de 3 segundos; nenhum abridor proibido | lista de hooks em ad_gates.json | re-ranqueie; reescreva a razão como uma justificativa editorial | esta skill | qualquer edição de hook |
| G4 zonas seguras | texto-chave, CTA, preço, logotipo dentro da zona da casa de cada aspecto; trilho de legenda inferior <= y 1450 em 9:16 | safe_zone_check.py saída 0 COM uma captura de tela de sobreposição visualizada no hook, oferta e cartão final | re-layout do elemento; reporte blocked se nenhuma sobreposição foi visualizada | esta skill | qualquer alteração de layout; um resultado de teste em dispositivo |
| G5 licenças | cada música/SFX/filmagem/logotipo tem uma linha permitida para anúncios, cobertura de canal, atribuição se CC-BY, permissão por escrito para ativos de marca de terceiros; ativos de IA divulgados | descobertas de ativos do ad_gate_check.py claras; SOURCES.md | troque por um ativo licenciado; pergunte à marca | esta skill + paid-generation-gate | qualquer alteração de ativo ou canal |
| G6 lote e cartão final | variantes de hook compartilham um mix (apenas os primeiros segundos diferem); cartão final 2-3 s com logotipo, oferta, contato, CTA, música até o fim; um crítico revisa todo o conjunto | manifesto check saída 0; quadro do cartão final visualizado | deduplique, re-muxe, re-renderize apenas o arquivo com falha | multi-video-variants | qualquer alteração no mestre ou hook |
| G7 rubrica e teste mudo | média >= 4,0, nenhuma dimensão < 3, portões A1/A2/A6 acima de 2; oferta, marca e CTA compreendidos no mudo; final -14 +/- 0,5 LUFS, TP <= -1 | relatório do crítico com timecodes; qa delivery | corrija e re-revise apenas os intervalos alterados | crítico + esta skill | cada rascunho |
Números (padrões da casa e medianas de mercado, com seus limites)
- Modelo: hook 0-2/0-3 s, oferta 7-9 s (corte de 15 s) / 19-22 s (corte de 30 s), cartão final 12,5-15 s / 27-30 s; a oferta mais CTA ocupam 30-45 % de um anúncio de 30 s (mercado 31-42 %).
- Uma mudança visual a cada 1,4 s no mínimo; cerca de 36 cortes/min (mercado, 16:9) e 34,5 (proprietário, 9:16); marca dentro de cerca de 1 s, produto dentro de cerca de 3 s; um pico de intensidade sonora, no logotipo.
- Zona segura 9:16: topo 300 / fundo 672 (texto-chave y <= 1248) / esquerda 140 / direita 192, trilho de legenda inferior <= y 1450: preset da casa v1, datado de 2026-10-02 (
references/safe-zone-presets.md). - Título na faixa de hook: no máximo 6 palavras (recomendação da casa para 9:16 pago com som desligado).
Regras de decisão
| Se | Então |
|---|---|
| o brief não tem oferta | peça por escrito ou proponha uma de baixo atrito e pergunte; o verificador permanece INSUFFICIENT até ser respondido |
| o cliente quer uma música popular ou um clipe de filme | substitua por uma faixa licenciada; explique que uma correspondência ou tendência não é uma licença; orce o tempo de substituição |
| um hook "deve funcionar nos primeiros 3 segundos" | reescreva a razão como uma justificativa editorial; nenhum limiar universal é verificado |
| uma alegação não tem prova ("o melhor", "100 % garantido") | a linha de conformidade é blocked; proponha redação documentada; não renderize |
| existe apenas um ativo 16:9 para um anúncio 9:16 | re-layout através de multi-video-variants; nunca corte ou reduza o quadro para caber na zona |
| os cortes do Meta e do TikTok diferem | um token de plataforma no nome do arquivo e uma linha de licença por canal |
| o anúncio é principalmente tomadas de IA | também carregue edit-ai-generated, divulgue por rota, gaste apenas através do portão |
| o visual aprovado do cliente conflita com a assinatura da skill | o visual do cliente vence; anote o desvio da rubrica |
Estados bloqueados (reporte-os, não os contorne)
Uma string de oferta que difere do ledger; um valor na tela que não está no ledger; qualquer linha de conformidade fail/blocked; um ativo com unknown, NC ou sem linha permitida para anúncios; um ativo de marca de terceiros sem permissão por escrito; uma alegação de zona segura sem sobreposição visualizada; manifest_check.py não READY. Cada um é uma razão para parar e dizer o que o desbloqueia.
Armadilhas que custam uma rodada ou uma campanha
Um desconto enterrado aos 21,6 s de um anúncio de 30 s; o preço estilizado como legenda; "um desconto significativo" no lugar de um número; marca apenas no final; uma música comercial ou clipe de anime no corte; uma faixa licenciada para TikTok usada no Meta; um som de pagamento de terceiros em um anúncio pago; um antes/depois que foi melhorado por IA; picos verdadeiros acima de 0 dBTP; marca ou endereço com erro ortográfico; anúncios de 46-53 s quando 15 + 30 s foram solicitados; um hook avaliado como "melhor" sem razão; uma variante de hook que silenciosamente carrega um mix diferente.
Referências (carregar quando)
references/ad-blueprint-and-hooks.md- roteiro: modelo, escada de hooks, oferta/CTA/cartão final, gramática visual, lista de verificação de ativos do cliente.references/compliance-table.md- etapa 2 e antes de apresentar: os 12 tópicos, evidências, redação conforme, notas da plataforma (datadas).references/safe-zone-presets.md(+references/safe_zone_presets.json, lido pelo script) - qualquer layout; antes de dizer "passa" (preset datado).references/sound-and-licences.md- escolher música/SFX, as linhas de licença, mixagem e níveis.references/rubric-and-benchmarks.md- antes de apresentar; pontuar um rascunho; a tabela de números.- Outras skills:
video-intake,reference-style-transfer,multi-video-variants,render-qa-deliver,revision-round,paid-generation-gate,edit-ai-generated(um anúncio feito principalmente de tomadas de IA). Fatos da plataforma:agent-content/references/platform-specs.md(de propriedade de outro lugar, datado); rubrica de benchmarkagent-content/benchmarks/ad-promo.rubric.md(de propriedade de outro lugar). - Scripts:
scripts/ad_gate_check.py,scripts/safe_zone_check.py(stdlib, docstring de uso,--self-check, saída 0 / 1 / 2).