mrvijaykr56/youtubeshorts

Polisseur de Script YouTube Shorts & Directeur de Storyboard

Cette compétence guide l'agent dans la création de scripts viraux à haute rétention pour YouTube Shorts et leur conversion en storyboard JSON structuré, compatible avec le pipeline de rendu YTShorts.

---

1. Principes Fondamentaux de la Rétention YouTube Shorts

1. La Règle de l'Accroche des 3 Secondes :

   • La première scène DOIT interrompre le défilement avec un fossé de curiosité, une question paradoxale, une déclaration contre-intuitive ou une révélation à fort enjeu.
   • Mauvais : "Aujourd'hui, nous allons parler du miel et de ses propriétés."
   • Viral : "Saviez-vous que le miel n'expire jamais ? 🍯 Des scientifiques ont mangé du miel vieux de 3 000 ans provenant de tombes égyptiennes !"

2. Rythme, Nombre de Mots & Norme des 2 Lignes par Scène 📜 :

   • Nombre de Scènes : 5 à 6 scènes.
   • Obligation des 2 Lignes par Scène : N'écrivez jamais une scène avec une seule ligne. Chaque scène DOIT avoir 2 lignes descriptives et engageantes (environ 18–22 mots par scène).
   • Durée Cible : 95–110 mots au total (~45–52 secondes). Les scènes d'une seule ligne se terminent trop vite (~25 s) et semblent incomplètes ; 2 lignes par scène permettent une profondeur de personnage, des détails sensoriels et une résolution émotionnelle de l'intrigue tout en restant dans la limite des 60 secondes des Shorts.
   • 1 scène = 2 lignes d'histoire = 1 image visuelle cohésive (maintenue pendant 8–10 secondes avec un mouvement Ken Burns dynamique).

3. Injection d'Emojis dans les Sous-titres :

   • Intégrez 1–2 emojis contextuellement pertinents dans la narration de chaque scène (ex. 🏛️, 👑, ⚡, 💀).
   • Ces emojis sont captés par le moteur de style des légendes (style TikTok/Karaoké) pour un attrait visuel.

4. Pureté Linguistique Stricte (Anglais Pur ou Hindi Pur Uniquement) 🎙️ :

   • La narration parlée doit être 100% anglais pur OU 100% hindi pur. Ne mélangez jamais de mots anglais ou hinglish dans des phrases de narration en hindi.
   • Pas d'Emojis Parlés : Les emojis sont réservés strictement à l'apparition visuelle des sous-titres. Le moteur TTS les supprime automatiquement du flux audio afin que les modèles vocaux ne lisent jamais les noms d'emojis (ex. "visage suppliant", "étincelles") à haute voix.

5. Normes de Légendes par Défaut & Configuration Bilingue 📺 :

   • Position : Toujours en Bas-Centré (Alignement 2, MarginV=240) pour que les légendes restent en toute sécurité dans le tiers inférieur sans obscurcir les visages des personnages.
   • Taille de Police : Taille de police réduite et compacte (50px de base) pour garder le canevas propre et lisible.
   • Shorts Bilingues (Voix Hindi + Légendes Anglaises) : Incluez toujours à la fois "narration_hi" (parlé en hindi 100% pur) et "narration" (affiché en sous-titres anglais).

6. Formule de Titre Viral à Fort CTR 💥 :

   • Structurez chaque titre avec une accroche hindi de grande curiosité, un sous-titre anglais percutant et des tags de classement : [Accroche Hindi Émotionnelle + Emoji] | [Sous-titre Anglais Percutant] | [Tags de Niche #Shorts]
   • Exemple : लालिची बंदर को मिली जादुई सीख! 🐒✨ Never Be Greedy | Hindi Kahaniya #Shorts
   • Exemple : आसमान से गिरा एक जादुई तारा! 🐿️⭐ Cheeku's Magic Wish | Hindi Kids Story #Shorts

7. Boucle Fluide & Fin Inspirante Complète (Visant >100% APV) 🔄 :

   • Construisez des fins propres, grammaticalement complètes et inspirantes.
   • 🚫 INTERDICTION STRICTE DE "EXACTEMENT COMME…" / "ठीक जैसे…" : Ne terminez JAMAIS la narration avec des amorces de comparaison telles que "exactement comme…", "just like…", "जैसे…", ou "ठीक जैसे…". Chaque phrase de fin DOIT être entièrement résolue, percutante et autonome.
   • Exemple d'ouverture : "क्या आप जानते हैं कि एक जादुई बत्तख पूरे गांव को कैसे बदल सकती है ? 🪺✨"
   • Exemple de fin : "हमेशा याद रखें, सब्र और संतोष ही जीवन का सबसे बड़ा खजाना है! 🌟" (Message inspirant complet).

8. Charge Utile de Métadonnées d'Audience et de Croissance 📈 :

   • Incluez toujours dans le storyboard JSON :
     • story_moral : Morale émotionnelle en hindi (शिक्षा) pour le partage parental.
     • pinned_comment_question : Question hindi qui suscite la réflexion pour générer une forte vélocité de commentaires.
     • self_declared_made_for_kids : false (Tout Public / Familial pour débloquer les commentaires et les cloches de notification).

9. Architecture SEO des 10 Principaux Concurrents (Étalonnée par Rapport à Koo Koo TV, Infobells, PunToon Kids) 🏆 :

   • Hashtags Principaux : Placez un nuage de hashtags à haute vélocité tout en haut de la description (ex. #Shorts #HindiKahaniya #MoralStories #Panchatantra #KidsAnimation #3DAnimation #HindiCartoon #BalKahani).
   • Nuage de Tags à 3 Niveaux (25-28 Tags) :
     • Niveau 1 (Histoire/Personnage) : Noms exacts des personnages, titres d'histoires, anglais + hindi translittéré (ex. sone ka anda, golden goose story, lalchi kisan).
     • Niveau 2 (Parapluie de Niche à Fort Trafic) : jadui kahaniya, hindi animated tales, hindi stories for kids, hindi story cartoon, moral stories in hindi, panchatantra stories, stories for kids, bedtime stories in hindi.
     • Niveau 3 (Devanagari Bilingue) : हिंदी कहानियां, पंचतंत्र की कहानियां, नैतिक कहानियां, हिंदी कार्टून, बाल कहानियां.
   • Catégorie : Appliquez toujours Catégorie 1 (Film et Animation).

---

2. Cadre de Cohérence de l'ADN du Personnage et du Monde ️🌍

Pour garantir que l'imagerie de chaque scène semble appartenir au même film exact :

1. Ancre ADN du Personnage : Lorsqu'une histoire implique des personnages, définissez une Ancre Personnage immuable avec 5 traits fixes :

   • Nom et Âge/Physique : ex. "Maya, 26 ans, femme athlétique"
   • Cheveux et Yeux : ex. "cheveux de corbeau foncés et bouclés en queue de cheval lâche, yeux noisette perçants"
   • Trait Facial Distinctif : ex. "légères taches de rousseur sur le nez, expression déterminée"
   • Tenue Signature : ex. "chemise de safari en lin olive usée, collier boussole en laiton, ceinture en cuir marron"
   • N'Utilisez Jamais de Pronoms Nus : N'écrivez JAMAIS "elle regarde l'artefact" ou "une fille court". Écrivez toujours : "Maya (26 ans, femme à queue de cheval bouclée foncée en chemise de safari olive) examine l'artefact doré…"

2. Ancre du Monde et de l'Environnement : Définissez une Ancre Monde immuable avec le décor, l'éclairage et la palette :

   • Exemple : "Tombeau de grès souterrain ancien, lumière de torche ambrée vacillante, ombres cobalt profondes, particules de poussière atmosphérique flottantes, grain de film 35 mm."
   • Chaque prompt de scène DOIT hériter de cette ancre monde afin que l'éclairage, la température de couleur et l'architecture restent 100% unifiés.

3. Progression des Plans & Règle Anti-Duplication (Pas de Visuels Redondants) 🚫🔄 :

   • Ne répétez jamais les prompts : Des scènes consécutives NE doivent JAMAIS partager un cadrage, une action ou des angles de caméra identiques.
   • Appliquez une Progression Dynamique des Plans :
     • Scène 1 : Plan Large d'Établissement / Échelle Épique (Accroche le spectateur avec l'environnement grandiose)
     • Scène 2 : Action Moyenne / Découverte (Focus sur le sujet ou le personnage effectuant une action)
     • Scène 3 : Gros Plan Extrême Macro (Révèle une texture complexe, des détails lumineux ou une micro-vue scientifique)
     • Scène 4 : Par-dessus l'Épaule / Angle de Haute Tension (Climax, réaction ou révélation)
     • Scène 5+ : Contre-Plongée Héroïque / Climax Cinématographique (Résolution et appel à l'action)

---

3. Types et Formats de Storyboard

Format A : Histoire Narrée par un Personnage (Avec Ancres)

{
  "character_anchor": "Maya, 26 ans, femme archéologue, cheveux de corbeau foncés et bouclés en queue de cheval, chemise de safari en lin olive, collier boussole en laiton",
  "world_anchor": "Tombeau de grès souterrain de l'Égypte ancienne, lumière de torche ambrée vacillante, ombres cobalt profondes, particules de poussière dorée flottantes",
  "scenes": [
    {
      "scene_number": 1,
      "narration": "Au plus profond du désert égyptien, Maya a découvert un tombeau scellé depuis 3 000 ans ! 🏛️",
      "visual": "Maya (26 ans, femme archéologue, queue de cheval bouclée foncée, chemise en lin olive) tenant une torche en bronze vacillante, regardant avec admiration une porte en pierre imposante couverte de hiéroglyphes lumineux, plan cinématographique en contre-plongée, lumière de torche ambrée chaude, éclairage dramatique en contre-jour, cadrage vertical 9:16, résolution 8k"
    },
    {
      "scene_number": 2,
      "narration": "À l'intérieur, trois jarres d'albâtre intactes brillaient sous la lumière de la torche. 🍯",
      "visual": "Maya (26 ans, femme archéologue, queue de cheval bouclée foncée, chemise en lin olive) agenouillée à côté d'un autel en pierre ancien, inspectant trois jarres de miel doré translucides, macro gros plan extrême, lueur ambrée chaude illuminant son visage, éclairage volumétrique, vertical 9:16"
    }
  ]
}

Format B : Fait Viral / Récit (Par Défaut)

Court métrage narratif standard ou fait époustouflant.

[
  {
    "scene_number": 1,
    "narration": "Et si votre cerveau pouvait prédire l'avenir avant que vous ne cligniez des yeux ? ⚡",
    "visual": "Gros plan extrême d'un œil humain lumineux, synapses neuronales pulsant d'éclairs cyan électriques et magenta dans l'iris, macrophotographie cinématographique, faible profondeur de champ, cadrage vertical 9:16, photoréaliste 8k, éclairage dramatique en contre-jour"
  },
  {
    "scene_number": 2,
    "narration": "Les scientifiques ont découvert que votre subconscient prend des décisions 7 secondes avant que vous ne le réalisiez ! 🧠",
    "visual": "Un scanner IRM de laboratoire futuriste visualisant un cerveau humain holographique lumineux avec des voies neuronales orange ardent, esthétique sombre et mystérieuse, éclairage volumétrique, résolution 8k"
  }
]

Format B : Court Métrage Dialogué à 2 Personnages

Conversation alternée entre deux personnages (idéal pour les interviews, débats ou comédies).

[
  {
    "scene_number": 1,
    "speaker": "Hôte",
    "narration": "Vous avez dépensé 50 000 $ dans de l'immobilier virtuel ?! 🤯",
    "visual": "Studio de podcast moderne, rétroéclairage néon violet vif, jeune hôte expressif regardant la caméra avec choc, faible profondeur de champ, éclairage cinématographique"
  },
  {
    "scene_number": 2,
    "speaker": "Invité",
    "narration": "Et je viens de le vendre hier pour un demi-million de dollars ! 📈💰",
    "visual": "Jeune entrepreneur confiant souriant dans un bureau penthouse moderne avec vue sur les gratte-ciel au coucher du soleil, éclairage cinématographique chaud"
  }
]

Format C : Tutoriel Éducatif Pas à Pas

Utilisé pour les tutoriels basés sur des diapositives avec titres et puces.

[
  {
    "scene_number": 1,
    "step_title": "Introduction",
    "slide_title": "Maîtrisez les Listes Python",
    "bullets": [
      "Collection ordonnée d'éléments",
      "Définie avec des crochets []",
      "Entièrement mutable et dynamique"
    ],
    "code_snippet": "fruits = ['apple', 'mango']",
    "narration": "Voici 3 astuces essentielles pour maîtriser les listes Python en moins de 30 secondes ! 🐍",
    "visual": "Poste de travail développeur 3D élégant, code Python lumineux sur moniteur, esthétique de studio minimaliste en mode sombre"
  }
]

---

3. Ingénierie de Prompt Visuel pour le Générateur d'Images IA

Le champ "visual" de chaque scène DOIT être conçu comme un prompt autonome et haute-fidélité :

1. Type de Plan et Angle : Macro gros plan extrême, Contre-plongée héroïque plan large, Portrait cinématographique à hauteur d'œil, Vue aérienne atmosphérique.
2. Sujet et Action : Objets physiques précis, gestes des personnages, expressions faciales.
3. Éclairage et Atmosphère : Rayons divins volumétriques, Clair-obscur dramatique, Éclairage néon cyber sombre en contre-jour, Lueur chaude de l'heure dorée.
4. Composition et Qualité : Cadrage vertical 9:16, Profondeur de champ / bokeh, Photoréaliste 8k, Plan cinématographique étalonné en couleur.
5. Règles Négatives : N'écrivez jamais "cool", "joli", "texte à l'écran", "filigrane" ou des termes génériques non visuels.

---

4. Vérification du Validateur Pré-Vol (Garantie Zéro Gaspillage de Tokens) 🛡️

Pour éviter le gaspillage de tokens, les exécutions interrompues ou les erreurs de rendu vidéo, chaque storyboard DOIT passer la validation avant la remise à l'utilisateur et la génération d'images.

Vous pouvez exécuter le validateur intégré directement :

.\backend\venv\Scripts\python.exe backend\scripts\storyboard_validator.py --json "chemin/vers/script.json"

Ensemble de Règles du Validateur :

1. Nombre de Scènes : 4 à 9 scènes (Idéal : 5–8 scènes). Le dépassement de 10 scènes est bloqué.
2. Durée et Limite de la Narration : Le nombre total de mots doit être compris entre 45 et 130 mots (~20 s à 55 s). Le dépassement de 130 mots est bloqué car il dépasse le plafond de 60 secondes des Shorts YouTube.
3. Rythme par Scène : 8 à 16 mots par scène. Évite le retour à la ligne des légendes et le rognage sur écran mobile.
4. Intégrité du Formatage TTS : Supprime les artefacts markdown imprononçables (**gras**, _italique_, [notes SFX], # en-têtes) afin que le TTS ne lise jamais les jetons de code littéraux.
5. Emojis de Sous-titres : Vérifie qu'au moins 1–2 emojis sont injectés pour des sous-titres dynamiques de style TikTok/Karaoké.
6. Sécurité et Précision du Prompt Visuel :
   • Filtre de Jetons Interdits : Signale les mots comme texte, lettres, sous-titres, mots, filigrane, police, logo qui amènent Imagen à produire des artefacts de texte déformés.
   • Signaux de Composition : Exige des angles de caméra explicites (macro gros plan, plan large, portrait cinématographique, etc.).
   • Signaux d'Éclairage : Exige des indices d'illumination explicites (rayons volumétriques, clair-obscur, heure dorée, lumière de torche, etc.).

---

5. Passerelle d'Approbation Humaine Obligatoire 🛑

RÈGLE CRITIQUE : Ne générez jamais automatiquement des images sans l'approbation explicite de l'utilisateur.

1. Une fois que le storyboard a passé le Validateur Pré-Vol avec 0 erreur bloquante, présentez le storyboard propre et le rapport de validation à l'utilisateur.
2. Demandez l'approbation de l'utilisateur :

   "Le storyboard a passé toutes les vérifications pré-vol (durée : ~Xs, scènes : N, sécurité des jetons : 100%). Approuvez-vous ces scènes et ces directions visuelles, ou souhaitez-vous des ajustements avant que je génère les images ?"

3. Attendez la confirmation de l'utilisateur avant d'appeler tout outil de génération d'images.

---

6. Métadonnées et Architecture SEO des 10 Principaux Concurrents 🏆

Chaque Short généré doit inclure des métadonnées étalonnées par rapport aux concurrents, apprises directement de Koo Koo TV (4,88 M d'abonnés), Infobells Hindi (72,8 M d'abonnés) et PunToon Kids (3,94 M d'abonnés) :

1. Formulation du Titre (Strictement $\le 95$ Caractères)

YouTube rejette les titres $\ge 100$ caractères. Utilisez la formule éprouvée à fort CTR : [Accroche Émotionnelle / Question Intrigante en Hindi + 1-2 Emojis] [Nom Anglais] | 3D Hindi Kahaniya #Shorts

• Exemple : कुल्हाड़ी नदी में गिरी, जलपरी ने क्या दिया ? 🪓✨ Honest Woodcutter | 3D Hindi Kahaniya #Shorts (92 car.)
• Exemple : रोज एक सोने का अंडा ! पर लालच ने क्या किया ? 🪺✨ Goose of Gold | 3D Hindi Kahaniya #Shorts (90 car.)

2. Infobells L