edit-ad-promo
Transforme l'offre, le produit et les rushes d'un client en une publicité sociale payante en hébreu qui énonce exactement l'offre, s'ouvre sur un hook classé, survit à une revue de conformité et une revue de licence, et est livrée comme un lot de variantes de hook sur un seul corps. L'offre, les affirmations et les licences sont vérifiées avant que les pixels ne soient peaufinés.
Règles qui priment sur le reste de ce fichier
- Offre, prix et CTA exactement comme donnés par écrit. Les chaînes et les chiffres proviennent d'un registre confirmé par le client ; rien n'est inventé, arrondi ou "amélioré" ; l'urgence seulement si elle est vraie. Pas d'offre du client : proposer une offre à faible friction et DEMANDER ; ne jamais en écrire une.
- Le tableau de conformité est bloquant. Chacun de ses 12 sujets a un statut ; une ligne
failoublockedempêche la présentation du brouillon, quoi que dise la grille. Un label (divulgation IA, avertissement) ne guérit jamais une affirmation trompeuse. - Licences :
License: unknown= pas dans le travail client ou publicitaire (décision par défaut Q2 : le "organique uniquement" plus ancien du propriétaire est une posture de risque pour ses propres comptes, pas une licence). Musique et SFX uniquement si la ligne propre du fichier autorise les publicités pour l'emplacement et le territoire. Les sons et logos de marque tiers nécessitent une autorisation écrite de la marque pour les publicités. Une correspondance de chanson n'est pas une licence ; les sons tendance ne sont pas autorisés. - Pas de loi universelle sur les hooks. Aucune source ne vérifie un seuil de 3 secondes ou un nombre de rétention fixe ; les hooks sont classés par raisons énoncées et testés par les propres résultats du client.
- Les zones de sécurité sont le préréglage maison v1 (daté, non vérifié sur les appareils ; décision par défaut Q5), une réussite nécessite une superposition visualisée, pas seulement la géométrie.
- Dépenses et confidentialité : pas de génération payante sans
paid-generation-gate(une estimation et une approbation datées) ; les plans IA uniquement comme ambiance ou plans de coupe manquants, divulgués ; pas de rushes client vers des outils cloud sans une décision par client ;snapshot --describe false. - PROMPT.md est approuvé par un humain avant la première ligne de code de construction, également dans les exécutions autonomes (décision par défaut Q6). Les skills sont des procédures, pas des permissions ; les restrictions utilisateur et projet prévalent sur ce fichier. Ne jamais envoyer de message à d'autres sessions Claude.
Entrées -> sorties
Entrée : l'offre par écrit (prix, conditions, délai, avertissement), canal CTA (bouton, WhatsApp, code, adresse), plateformes et route (organique, enchères publicitaires, Spark), durées (par défaut 15 + 30 s), actifs du produit et de la marque, rushes et consentements. Sortie : lignes de registre hf/OFFER (dans PROMPT.md), hf/ad_gates.json (surfaces d'offre, hooks, conformité, actifs), N variantes de hook sur un seul corps + carte de fin, tableau de conformité, QA par fichier, nommage <nom>_<plateforme>_<hook>_<format>.mp4 avec un manifeste (multi-video-variants).
Procédure
| # | Faire | Artefact |
|---|---|---|
| 0 | Réception via video-intake : offre + conditions + délai, canal CTA, plateformes/route, durées, ratios, hooks (3), liste de vérification des actifs client (references/ad-blueprint-and-hooks.md), consentements ; une publicité de référence -> reference-style-transfer d'abord ; ls tout le dossier source | BRIEF + registre |
| 1 | Registre d'offre : une ligne par chaîne exacte (hébreu textuel, symbole monétaire, délai, CTA) avec les surfaces sur lesquelles elle doit apparaître (voix, superposition, carte de fin) | lignes de registre |
| 2 | Tableau de conformité à partir du brief AVANT la scénarisation (references/compliance-table.md) : affirmations, conditions de prix, avant/après, avis, hooks sur attributs personnels, santé/finances, actifs de marque, divulgation IA, licence musicale, consentement des personnes, fausse interface utilisateur, politique de la plateforme | ad_gates.json conformité |
| 3 | Script : trois hooks classés avec raisons, feuille de beats par durée (hook, problème, solution, preuve, offre, CTA), offre trois fois, versions 15 s et 30 s ; voix off transcrite pour le montage papier | SCRIPT.md |
| 4 | Plans de style avec la superposition de zone de sécurité : hook, étiquette de prix, avant/après, carte de fin ; actifs avec une ligne de licence chacun (references/sound-and-licences.md) ; génération payante uniquement via paid-generation-gate | plans de style, SOURCES.md |
| 5 | PROMPT.md + DESIGN.md (chaque image : quoi, où en px, quand en images, easing, son) -> approbation humaine -> construction : coupe, graphiques (badge de prix, UI reconstruite en code, jamais d'images libres de droits), sous-titres, couleur, mixage | projet hf/ |
| 6 | Passerelles mécaniques : python scripts/ad_gate_check.py hf/ad_gates.json et python scripts/safe_zone_check.py elements.json --aspect 9x16 --overlay-evidence <instantané visualisé> ; les deux sortent avec 0 | rapports |
| 7 | Vérification : render-qa-deliver (QA de chaque image sur le fichier final), grille A1-A8 (references/rubric-and-benchmarks.md), test muet, un critique sur l'ensemble ; UN rendu complet par tour | preuves QA |
| 8 | Lot : variantes de hook sur le mixage partagé, versions nomusic / nocaps, autres ratios via multi-video-variants (manifest_check.py sortie 0) | final/ + manifeste |
| 9 | Présentation : fichiers en une fois, modifications numérotées, tableau de conformité, coches de registre, lacunes honnêtes (ce qui n'a pas été testé sur appareil) | message |
Passerelles
Les états sont pass | fail | blocked | n/a avec une raison. Un délai d'attente, un échantillon vide ou une entrée manquante est blocked, jamais pass. Un appel d'outil réussi est une preuve d'exécution ; un rendu visualisé est une preuve d'apparence.
| Passerelle | Prédicat | Preuve | Si faux | Propriétaire | Re-vérifier quand |
|---|---|---|---|---|---|
| G1 offre exacte | chaque chaîne/chiffre du registre apparaît textuellement sur chaque surface requise ; aucun prix ou pourcentage à l'écran qui n'est pas dans le registre ; un CTA existe | les résultats d'offre de ad_gate_check.py sont clairs (pas de OFFER_NOT_EXACT, UNLEDGERED_AMOUNT, NO_CTA) | corriger le texte ; ne jamais inventer ou arrondir une affirmation ; demander au client | ad_gate_check.py + humain | toute modification de texte, prix ou carte |
| G2 conformité | les 12 sujets évalués ; aucun fail/blocked ; les lignes pass portent des preuves ; les lignes n/a portent des raisons | le tableau dans ad_gates.json ; ad_gate_check.py sortie 0 | supprimer ou remplacer l'affirmation ; proposer un libellé conforme ; ne pas rendre | ce skill (bloquant) | toute nouvelle affirmation, actif ou emplacement |
| G3 classement des hooks | >= 3 hooks classés avec des raisons distinctes ; pas d'affirmation universelle de 3 secondes ; pas d'ouverture interdite | liste des hooks dans ad_gates.json | reclasser ; réécrire la raison comme une justification éditoriale | ce skill | toute modification de hook |
| G4 zones de sécurité | texte clé, CTA, prix, logo à l'intérieur de la zone maison de chaque format ; rail de sous-titres en bas <= y 1450 en 9:16 | safe_zone_check.py sortie 0 AVEC un instantané de superposition visualisé au hook, à l'offre et à la carte de fin | réagencer l'élément ; signaler blocked si aucune superposition n'a été visualisée | ce skill | tout changement de disposition ; un résultat de test sur appareil |
| G5 licences | chaque musique/SFX/russe/logo a une ligne autorisant les publicités, couverture d'emplacement, attribution si CC-BY, autorisation écrite pour les actifs de marque tiers ; actifs IA divulgués | les résultats d'actifs de ad_gate_check.py sont clairs ; SOURCES.md | remplacer par un actif sous licence ; demander à la marque | ce skill + paid-generation-gate | tout changement d'actif ou d'emplacement |
| G6 lot et carte de fin | les variantes de hook partagent un seul mixage (seules les premières secondes diffèrent) ; carte de fin 2-3 s avec logo, offre, contact, CTA, musique jusqu'à la fin ; un critique examine l'ensemble | le manifeste check sortie 0 ; image de carte de fin visualisée | dédupliquer, remuxer, re-rendre uniquement le fichier défaillant | multi-video-variants | tout changement de maître ou de hook |
| G7 grille et test muet | moyenne >= 4,0, aucune dimension < 3, passerelles A1/A2/A6 au-dessus de 2 ; offre, marque et CTA compris en mode muet ; final -14 +/- 0,5 LUFS, TP <= -1 | rapport critique avec codes temporels ; qa delivery | corriger et réviser uniquement les plages modifiées | critique + ce skill | chaque brouillon |
Chiffres (valeurs par défaut maison et médianes du marché, avec leurs limites)
- Plan directeur : hook 0-2/0-3 s, offre 7-9 s (version 15 s) / 19-22 s (version 30 s), carte de fin 12,5-15 s / 27-30 s ; l'offre plus le CTA prennent 30-45 % d'une publicité de 30 s (marché 31-42 %).
- Un changement visuel au moins toutes les 1,4 s ; environ 36 coupes/min (marché, 16:9) et 34,5 (propriétaire, 9:16) ; marque dans environ 1 s, produit dans environ 3 s ; un pic de volume sonore, sur le logo.
- Zone de sécurité 9:16 : haut 300 / bas 672 (texte clé y <= 1248) / gauche 140 / droite 192, rail de sous-titres bas <= y 1450 : préréglage maison v1, daté 2026-10-02 (
references/safe-zone-presets.md). - Titre dans la bande de hook : au maximum 6 mots (recommandation maison pour le payant en mode muet 9:16).
Règles de décision
| Si | Alors |
|---|---|
| le brief n'a pas d'offre | la demander par écrit ou en proposer une à faible friction et demander ; le vérificateur reste INSUFFISANT jusqu'à réponse |
| le client veut une chanson tendance ou un clip de film | remplacer par un titre sous licence ; expliquer qu'une correspondance ou une tendance n'est pas une licence ; budgéter le temps de remplacement |
| un hook "doit fonctionner dans les 3 premières secondes" | réécrire la raison comme une justification éditoriale ; aucun seuil universel n'est vérifié |
| une affirmation n'a pas de preuve ("le meilleur", "garanti à 100 %") | la ligne de conformité est blocked ; proposer un libellé documenté ; ne pas rendre |
| seul un actif 16:9 existe pour une publicité 9:16 | réagencer via multi-video-variants ; ne jamais recadrer ou réduire l'image pour l'adapter à la zone |
| les versions Meta et TikTok diffèrent | un jeton de plateforme dans le nom de fichier et une ligne de licence par emplacement |
| la publicité est principalement des plans IA | charger également edit-ai-generated, divulguer par route, dépenser uniquement via la passerelle |
| le look approuvé du client entre en conflit avec la signature du skill | le look du client gagne ; noter la déviation de la grille |
États bloqués (les signaler, ne pas les contourner)
Une chaîne d'offre qui diffère du registre ; un montant à l'écran qui n'est pas dans le registre ; toute ligne de conformité fail/blocked ; un actif avec unknown, NC ou aucune ligne autorisant les publicités ; un actif de marque tiers sans autorisation écrite ; une affirmation de zone de sécurité sans superposition visualisée ; manifest_check.py pas PRÊT. Chacun est une raison de s'arrêter et de dire ce qui le débloque.
Pièges qui coûtent chacun un tour ou une campagne
Une remise enterrée à 21,6 s d'une publicité de 30 s ; le prix stylisé comme un sous-titre ; "une remise significative" à la place d'un nombre ; la marque seulement à la fin ; une chanson commerciale ou un clip d'anime dans le montage ; un titre sous licence pour TikTok utilisé sur Meta ; un son de paiement tiers dans une publicité payante ; un avant/après qui a été amélioré par IA ; des pics vrais au-dessus de 0 dBTP ; une marque ou une adresse mal orthographiée ; des publicités de 46-53 s alors que 15 + 30 s étaient demandées ; un hook noté "meilleur" sans raison ; une variante de hook portant silencieusement un mixage différent.
Références (charger quand)
references/ad-blueprint-and-hooks.md- scénarisation : plan directeur, échelle de hooks, offre/CTA/carte de fin, grammaire visuelle, liste de vérification des actifs client.references/compliance-table.md- étape 2 et avant de présenter : les 12 sujets, preuves, libellé conforme, notes de plateforme (datées).references/safe-zone-presets.md(+references/safe_zone_presets.json, lu par le script) - toute disposition ; avant de dire "réussi" (préréglage daté).references/sound-and-licences.md- choix de la musique/SFX, les lignes de licence, mixage et niveaux.references/rubric-and-benchmarks.md- avant de présenter ; notation d'un brouillon ; le tableau des chiffres.- Autres skills :
video-intake,reference-style-transfer,multi-video-variants,render-qa-deliver,revision-round,paid-generation-gate,edit-ai-generated(une publicité faite principalement de plans IA). Faits de plateforme :agent-content/references/platform-specs.md(propriété ailleurs, daté) ; grille de référenceagent-content/benchmarks/ad-promo.rubric.md(propriété ailleurs). - Scripts :
scripts/ad_gate_check.py,scripts/safe_zone_check.py(stdlib, docstring d'utilisation,--self-check, sortie 0 / 1 / 2).