edit-ad-promo
Convierte la oferta, el producto y el material de archivo de un cliente en un anuncio publicitario de pago en hebreo que expresa la oferta exactamente, comienza con un gancho clasificado, supera una revisión de cumplimiento normativo y una revisión de licencias, y se entrega como un lote de variantes de gancho sobre un mismo cuerpo. La oferta, las afirmaciones y las licencias se verifican antes de pulir los píxeles.
Reglas que prevalecen sobre el resto de este archivo
- Oferta, precio y CTA exactamente como se dan por escrito. Las cadenas y los números provienen de un libro contable que el cliente confirmó; no se inventa, redondea ni "mejora" nada; urgencia solo si es real. Sin oferta del cliente: proponer una de baja fricción y PREGUNTAR; nunca escribir una.
- La tabla de cumplimiento es bloqueante. Cada uno de sus 12 temas tiene un estado; una fila
failoblockeddetiene la presentación del borrador, independientemente de lo que diga la rúbrica. Una etiqueta (divulgación de IA, descargo de responsabilidad) nunca cura una afirmación engañosa. - Licencias:
License: unknown= no está en el trabajo del cliente ni en el anuncio (decisión por defecto P2: el "solo orgánico" más antiguo del propietario es una postura de riesgo para sus propias cuentas, no una licencia). Música y SFX solo si la fila del propio archivo permite anuncios para la ubicación y el territorio. Los sonidos y logotipos de marcas de terceros necesitan permiso ESCRITO de la marca para anuncios. Una coincidencia de canción no es una licencia; los sonidos de tendencias no están autorizados. - No hay ley universal de gancho. Ninguna fuente verifica un umbral de 3 segundos o un número fijo de retención; los ganchos se clasifican por razones indicadas y se prueban con los propios resultados del cliente.
- Las zonas seguras son el preset de casa v1 (fechado, no verificado en dispositivos; decisión por defecto P5), una aprobación necesita una superposición visualizada, no solo geometría.
- Gasto y privacidad: sin generación de pago sin
paid-generation-gate(una estimación y aprobación fechadas); tomas de IA solo como estado de ánimo o material de archivo faltante, divulgado; ningún material del cliente enviado a herramientas en la nube sin una decisión por cliente;snapshot --describe false. - PROMPT.md es aprobado por un humano antes de la primera línea de código de construcción, también en ejecuciones autónomas (decisión por defecto P6). Las habilidades son procedimiento, no permiso; las restricciones del usuario y del proyecto anulan este archivo. Nunca enviar mensajes a otras sesiones de Claude.
Entradas -> salidas
Entrada: la oferta por escrito (precio, términos, fecha límite, descargo de responsabilidad), canal CTA (botón, WhatsApp, código, dirección), plataformas y ruta (orgánico, anuncio de subasta, Spark), duraciones (por defecto 15 + 30 s), activos de producto y marca, material de archivo y consentimientos. Salida: líneas del libro contable hf/OFFER (en PROMPT.md), hf/ad_gates.json (superficies de oferta, ganchos, cumplimiento, activos), N variantes de gancho en un cuerpo + tarjeta final, tabla de cumplimiento, QA por archivo, nomenclatura <nombre>_<plataforma>_<gancho>_<aspecto>.mp4 con un manifiesto (multi-video-variants).
Procedimiento
| # | Hacer | Artefacto |
|---|---|---|
| 0 | Ingresar mediante video-intake: oferta + términos + fecha límite, canal CTA, plataformas/ruta, duraciones, relaciones de aspecto, ganchos (3), lista de verificación de activos del cliente (references/ad-blueprint-and-hooks.md), consentimientos; un anuncio de referencia -> reference-style-transfer primero; ls toda la carpeta fuente | BRIEF + libro contable |
| 1 | Libro contable de la oferta: una línea por cadena exacta (hebreo textual, símbolo de moneda, fecha límite, CTA) con las superficies en las que debe aparecer (voz, superposición, tarjeta final) | líneas del libro contable |
| 2 | Tabla de cumplimiento a partir del brief ANTES de escribir el guion (references/compliance-table.md): afirmaciones, términos de precio, antes/después, reseñas, ganchos de atributos personales, salud/finanzas, activos de marca, divulgación de IA, licencia de música, consentimiento de personas, UI falsa, política de plataforma | cumplimiento de ad_gates.json |
| 3 | Guion: tres ganchos clasificados con razones, hoja de ritmo por duración (gancho, problema, solución, prueba, oferta, CTA), oferta tres veces, cortes de 15 s y 30 s; voz en off transcrita para la edición en papel | SCRIPT.md |
| 4 | Fotogramas de estilo con la superposición de zona segura: gancho, etiqueta de precio, antes/después, tarjeta final; activos con una fila de licencia cada uno (references/sound-and-licences.md); generación de pago solo a través de paid-generation-gate | fotogramas de estilo, SOURCES.md |
| 5 | PROMPT.md + DESIGN.md (cada fotograma: qué, dónde en px, cuándo en fotogramas, easing, sonido) -> aprobación humana -> construcción: corte, gráficos (insignia de precio, UI reconstruida en código, nunca stock), subtítulos, color, mezcla | proyecto hf/ |
| 6 | Puertas mecánicas: python scripts/ad_gate_check.py hf/ad_gates.json y python scripts/safe_zone_check.py elements.json --aspect 9x16 --overlay-evidence <instantánea visualizada>; ambas salen con 0 | informes |
| 7 | Verificar: render-qa-deliver (QA de cada fotograma en el archivo final), rúbrica A1-A8 (references/rubric-and-benchmarks.md), prueba silenciosa, un crítico en todo el conjunto; UNA representación completa por ronda | evidencia de QA |
| 8 | Lote: variantes de gancho en la mezcla compartida, versiones nomusic / nocaps, otras relaciones de aspecto mediante multi-video-variants (manifest_check.py salida 0) | final/ + manifiesto |
| 9 | Presentar: archivos a la vez, cambios numerados, la tabla de cumplimiento, marcas del libro contable, brechas honestas (lo que no se probó en dispositivo) | mensaje |
Puertas
Los estados son pass | fail | blocked | n/a con una razón. Un tiempo de espera, muestra vacía o entrada faltante es blocked, nunca pass. Una llamada de herramienta exitosa es evidencia de ejecución; una representación visualizada es evidencia de apariencia.
| Puerta | Predicado | Evidencia | Si es falso | Propietario | Revisar cuando |
|---|---|---|---|---|---|
| G1 oferta exacta | cada cadena/número del libro contable aparece textualmente en cada superficie requerida; ningún precio o porcentaje en pantalla que no esté en el libro contable; existe un CTA | hallazgos de oferta de ad_gate_check.py claros (sin OFFER_NOT_EXACT, UNLEDGERED_AMOUNT, NO_CTA) | corregir el texto; nunca inventar o redondear una afirmación; preguntar al cliente | ad_gate_check.py + humano | cualquier edición de texto, precio o tarjeta |
| G2 cumplimiento | los 12 temas evaluados; ninguno fail/blocked; las filas pass llevan evidencia; las filas n/a llevan razones | la tabla en ad_gates.json; ad_gate_check.py salida 0 | eliminar o reemplazar la afirmación; proponer redacción conforme; no renderizar | esta habilidad (bloqueante) | cualquier nueva afirmación, activo o ubicación |
| G3 clasificación de ganchos | >= 3 ganchos clasificados con razones distintas; sin afirmación universal de 3 segundos; sin apertura prohibida | lista de ganchos en ad_gates.json | reclasificar; reescribir la razón como una justificación editorial | esta habilidad | cualquier edición de gancho |
| G4 zonas seguras | texto clave, CTA, precio, logotipo dentro de la zona de casa de cada aspecto; riel de subtítulos parte inferior <= y 1450 a 9:16 | safe_zone_check.py salida 0 CON una instantánea de superposición visualizada en gancho, oferta y tarjeta final | rediseñar el elemento; informar blocked si no se visualizó ninguna superposición | esta habilidad | cualquier cambio de diseño; un resultado de prueba en dispositivo |
| G5 licencias | cada música/SFX/material/logotipo tiene una fila que permite anuncios, cobertura de ubicación, atribución si CC-BY, permiso escrito para activos de marca de terceros; activos de IA divulgados | hallazgos de activos de ad_gate_check.py claros; SOURCES.md | cambiar a un activo con licencia; preguntar a la marca | esta habilidad + paid-generation-gate | cualquier cambio de activo o ubicación |
| G6 lote y tarjeta final | las variantes de gancho comparten una mezcla (solo los primeros segundos difieren); tarjeta final 2-3 s con logotipo, oferta, contacto, CTA, música hasta el final; un crítico revisa todo el conjunto | manifiesto check salida 0; fotograma de tarjeta final visualizado | deduplicar, remultiplexar, rerenderizar solo el archivo que falla | multi-video-variants | cualquier cambio de maestro o gancho |
| G7 rúbrica y prueba silenciosa | promedio >= 4.0, ninguna dimensión < 3, puertas A1/A2/A6 por encima de 2; oferta, marca y CTA entendidos en silencio; final -14 +/- 0.5 LUFS, TP <= -1 | informe del crítico con marcas de tiempo; qa delivery | corregir y revisar solo los rangos cambiados | crítico + esta habilidad | cada borrador |
Números (valores predeterminados de casa y medianas de mercado, con sus límites)
- Plano: gancho 0-2/0-3 s, oferta 7-9 s (corte de 15 s) / 19-22 s (corte de 30 s), tarjeta final 12.5-15 s / 27-30 s; la oferta más el CTA ocupan el 30-45 % de un anuncio de 30 s (mercado 31-42 %).
- Un cambio visual al menos cada 1.4 s; aproximadamente 36 cortes/min (mercado, 16:9) y 34.5 (propietario, 9:16); marca dentro de aproximadamente 1 s, producto dentro de aproximadamente 3 s; un pico de sonoridad, en el logotipo.
- Zona segura 9:16: superior 300 / inferior 672 (texto clave y <= 1248) / izquierda 140 / derecha 192, riel de subtítulos parte inferior <= y 1450: preset de casa v1, fechado 2026-10-02 (
references/safe-zone-presets.md). - Titular en la banda de gancho: máximo 6 palabras (recomendación de casa para 9:16 de pago con sonido apagado).
Reglas de decisión
| Si | Entonces |
|---|---|
| el brief no tiene oferta | pedirla por escrito o proponer una de baja fricción y preguntar; el verificador permanece INSUFICIENTE hasta que se responda |
| el cliente quiere una canción de tendencia o un clip de película | reemplazar con una pista con licencia; explicar que una coincidencia o tendencia no es una licencia; presupuestar el tiempo de reemplazo |
| un gancho "debe funcionar en los primeros 3 segundos" | reescribir la razón como una justificación editorial; no se verifica ningún umbral universal |
| una afirmación no tiene prueba ("el mejor", "100 % garantizado") | la fila de cumplimiento es blocked; proponer redacción documentada; no renderizar |
| solo existe un activo 16:9 para un anuncio 9:16 | rediseñar mediante multi-video-variants; nunca recortar o escalar el fotograma para que quepa en la zona |
| los cortes de Meta y TikTok difieren | un token de plataforma en el nombre del archivo y una fila de licencia por ubicación |
| el anuncio es mayormente tomas de IA | también cargar edit-ai-generated, divulgar por ruta, gastar solo a través de la puerta |
| el aspecto aprobado del cliente entra en conflicto con la firma de la habilidad | el aspecto del cliente gana; anotar la desviación de la rúbrica |
Estados bloqueados (informarlos, no sortearlos)
Una cadena de oferta que difiere del libro contable; un monto en pantalla que no está en el libro contable; cualquier fila de cumplimiento fail/blocked; un activo con unknown, NC o sin fila que permita anuncios; un activo de marca de terceros sin permiso escrito; una afirmación de zona segura sin superposición visualizada; manifest_check.py no LISTO. Cada uno es una razón para detenerse y decir qué lo desbloquea.
Errores que cuestan una ronda o una campaña
Un descuento enterrado a los 21.6 s de un anuncio de 30 s; el precio estilizado como subtítulo; "un descuento significativo" en lugar de un número; marca solo al final; una canción comercial o un clip de anime en el corte; una pista con licencia para TikTok utilizada en Meta; un sonido de pago de terceros en un anuncio de pago; un antes/después que fue mejorado por IA; picos verdaderos por encima de 0 dBTP; marca o dirección mal escritas; anuncios de 46-53 s cuando se pidieron 15 + 30 s; un gancho calificado como "mejor" sin razón; una variante de gancho que lleva silenciosamente una mezcla diferente.
Referencias (cargar cuando)
references/ad-blueprint-and-hooks.md- escritura de guion: plano, escalera de ganchos, oferta/CTA/tarjeta final, gramática visual, lista de verificación de activos del cliente.references/compliance-table.md- paso 2 y antes de presentar: los 12 temas, evidencia, redacción conforme, notas de la plataforma (fechadas).references/safe-zone-presets.md(+references/safe_zone_presets.json, leído por el script) - cualquier diseño; antes de decir "pasa" (preset fechado).references/sound-and-licences.md- elegir música/SFX, las filas de licencia, mezcla y niveles.references/rubric-and-benchmarks.md- antes de presentar; puntuar un borrador; la tabla de números.- Otras habilidades:
video-intake,reference-style-transfer,multi-video-variants,render-qa-deliver,revision-round,paid-generation-gate,edit-ai-generated(un anuncio hecho mayormente de tomas de IA). Datos de plataforma:agent-content/references/platform-specs.md(propiedad de otro lugar, fechado); rúbrica de referenciaagent-content/benchmarks/ad-promo.rubric.md(propiedad de otro lugar). - Scripts:
scripts/ad_gate_check.py,scripts/safe_zone_check.py(stdlib, cadena de documentación de uso,--self-check, salida 0 / 1 / 2).