sohamthebuilder/finance-story

Finance Story

Une idée financière racontée sous forme d'un court métrage animé. Un seul monde analogique mignon (par exemple une salle de classe dont le tableau d'affichage est le Sensex) porte toute l'explication. Un narrateur raconte l'histoire, et chaque temps fort tombe sur la parole. C'est le pipeline story-animator, donc lisez ~/.claude/skills/story-animator/SKILL.md et ses references/ en premier et suivez-les. Ce skill ajoute uniquement les préférences de l'utilisateur pour les vidéos financières par-dessus.

Consultez d'abord le guide de marque. Lisez /Users/sohambhattacharya/Documents/Personal/projects/story-animator/brand/BRAND.md avant d'écrire quoi que ce soit. Il définit la voix (simple, humaine, pas de tirets cadratins, pas de points-virgules, pas de formulation formelle), la formule narrative en 8 temps, la palette, les polices, les zones de sécurité, les formats de légende et les règles de sécurité SEBI (section 7). En cas de désaccord avec ce fichier, le guide prévaut. Les modèles de vidéo (couverture, carte d'accroche, ligne de texte, grand nombre, terme réel et carte de fin) se trouvent dans brand/studio/src/templates/reel.tsx. Copiez ou importez-les pour ces temps forts, et rendez la couverture de la vidéo avec le skill finance-social.

Le film de référence approuvé (2026-11-04, « c'était bon ») est examples/sensex-classroom/ (Film.tsx, story.ts, audio_cues.json). Lisez-le avant d'en construire un nouveau. Il montre le monde analogique, le tableau d'affichage, les personnages-haricots, le jeton, la caméra en 9:16 et la carte de fin.

Les préférences de l'utilisateur (issues des retours)

1. Pas de présentateur. Ne dessinez jamais d'hôte ou de personnage parlant en bas. L'utilisateur a abandonné l'ancien style « finance-reel » avec présentateur et toutes ses règles (voix Zara, hinglish, le look minimaliste d'un nombre par écran). Ne les ramenez pas sauf demande explicite.

2. Look story-animator. Un monde de dessin animé doux et plat, comme un livre d'images, avec des personnages mignons (corps de haricots ronds, grands yeux via Face), une seule source de lumière chaude, des mouvements de caméra doux, des sous-titres en Patrick Hand. La couleur raconte l'histoire : chaud pour les bons moments, gris-bleu pour « morose », chaud à nouveau au retournement.

3. Un seul monde analogique pour tout le film. Associez chaque concept à quelque chose dans ce monde :

   • L'indice est le tableau d'affichage ou le tableau noir au mur, montrant le chiffre réel ;
   • Les entreprises sont les élèves, et les plus grandes entreprises sont les plus grands élèves ;
   • L'argent étranger (FPI) sont des avions en papier qui sortent et rentrent par la fenêtre ;
   • Le pétrole est des barils sur les bureaux qui rétrécissent quand le pétrole devient moins cher. Gardez la structure narrative : mise en place → problème (quelque chose de morose) → retournement (« Puis… deux choses ont changé ») → aboutissement (le chiffre bondit) → une conclusion en une ligne. Choisissez un objet jeton qui part et revient (l'avion en papier).

4. Langue et voix : narration en anglais, voix Rameez | Documentary Narrator (RG0hCuGFvl2jxhd4LmtU, accent indien-anglais), modèle eleven_v4, 2 prises. Épelez les acronymes avec des points (F.P.I.s) et écrivez les nombres en toutes lettres (« twelve hundred and twenty-five »). Utilisez uniquement des balises légères : [excited], [curious], [warm, storytelling], [softly], [building], [brightly], [delighted], [warmly]. Transcrivez les deux prises avec --model medium et gardez celle qui dit chaque mot. Dans la vidéo n°1, la prise B a dit « industries » au lieu de « investors ».

5. Format et durée : 9:16, 60 s (durationFrames: 1800). Rameez parle à environ 2,7 mots/s : 132 mots donnaient 49,5 s. Écrivez donc environ 150–155 mots pour remplir 60 s avec la voix. Sinon, les dernières ~10 s sont un cheer + la carte de fin sur la musique, ce que l'utilisateur a accepté.

6. Chiffres honnêtes. Vérifiez chaque chiffre avec une recherche web (mode étendu pour les données de marché, deux sources ou plus). Affichez les chiffres réels (clôture de l'indice, les points gagnés) sur le tableau d'affichage, et n'affichez pas un chiffre sur lequel les sources divergent (dans la vidéo n°1, le prix du Brent). Listez les sources à l'utilisateur avec les liens. Les données de marché (Sensex, Nifty, cours des actions) peuvent être récentes ou anciennes, mais doivent être vérifiées avec deux sources ou plus et porter leur date exacte (règle modifiée par l'utilisateur, 2026-11-05). Les chiffres économiques (repo, CPI, PIB) utilisent le dernier chiffre officiel avec sa date. Enregistrez chaque nombre dans sources.md dans le dossier de la vidéo (BRAND.md 7.3).

7. Carte de fin (les dernières ~7 s) : le concept en une ligne (« Sensex : la moyenne de la classe des 30 plus grandes entreprises indiennes »), une ligne connexe, puis « For education only. Not investment advice. » et une ligne de chiffres/source avec la date. Pas de logos d'entreprises réelles.

8. Son : musique plus 3 effets subtiles (un léger bruit d'avion en papier, une légère cascade de pièces, un carillon doux et brillant), chacun placé juste après son mot-clé. Musique : eleven_music_v2_5, 1 prise, pizzicato et marimba enjoués, avec une courbe qui suit l'histoire (une baisse pour la partie morose, une montée au retournement, un élan joyeux à l'aboutissement). Mix avec musique gain_db à environ −3.5 et sfx_bus_db à −13. Cela a donné le fond à 16.8 dB sous Rameez ; à −9 c'était trop bas (22 dB).

9. Fin avec sauvegarde et partage (chaque vidéo). La dernière ligne du narrateur demande aux spectateurs de sauvegarder et de partager la vidéo s'ils l'ont trouvée utile, et mentionne finance.unboring. Adaptez-la au sujet, par ex. « Found this useful? Save it for the next time someone says 'the Sensex is up', and share it with a friend who still doesn't get it. Follow finance dot unboring for more. » Écrivez le handle comme « finance dot unboring » dans la narration pour qu'il soit prononcé correctement, et comme @finance.unboring sur la carte de fin, sous la ligne du concept et au-dessus de l'avertissement. Comptez cette ligne dans le budget d'environ 150 mots.

10. Couverture conçue (chaque vidéo, règle du 2026-11-07). Ne proposez jamais une image de la vidéo comme couverture. Les images étaient peu attrayantes dans le fil et ne donnaient aucune raison d'ouvrir. Chaque vidéo est livrée avec sa propre couverture 1080×1920 qui (a) énonce le sujet, (b) rend le spectateur curieux avec une question ou un vide auquel la vidéo répond vraiment, et (c) montre Mini en réaction, plus des graphiques dessinés pour ce sujet. Un mot en or, titre de 5 mots maximum, le tout dans la zone centrale 3:4 (BRAND.md 5.1).

Workflow : deux étapes, rien dépensé avant approbation

L'utilisateur donne les entrées : concept à enseigner, idée d'accroche, angle narratif (et éventuellement un fait d'actualité).

Première étape : proposition (un seul message, aucun crédit dépensé)

1. Vérifiez chaque chiffre (WebSearch étendu, deux sources ou plus).
2. Envoyez UN SEUL message avec quatre parties pour que l'utilisateur confirme :
   • Script : la colonne vertébrale en trois phrases, le jeton, et la narration complète (environ 150 mots). La narration se TERMINE par la ligne de sauvegarde et de partage (règle 9 ci-dessous).
   • Voix : la voix proposée (par défaut Rameez, RG0hCuGFvl2jxhd4LmtU) avec son preview_url gratuit depuis creative_list_voices, plus 1–2 alternatives avec des liens de prévisualisation si le sujet suggère une ambiance différente.
   • Storyboard : le tableau des temps forts (n° / ligne de narration / ce qu'on voit / caméra), y compris la carte de fin.
   • Couverture : l'étiquette du sujet, le titre de curiosité (mot en or marqué), et ce que Mini et l'art font. Listez également les sources et le coût (narration environ 1 800 crédits pour 2 prises, musique 900, effets environ 17 chacun, environ 2 750 au total).
3. Arrêtez-vous et attendez. Ne dépensez aucun crédit et ne rendez rien tant que l'utilisateur n'a pas confirmé les quatre éléments. S'il modifie quelque chose, renvoyez la partie révisée et attendez à nouveau.

Deuxième étape : production (après que l'utilisateur a confirmé)

1. Projet : cp -R ~/.claude/skills/story-animator/template ./<slug> à côté des autres projets, npm install, et réutilisez un venv faster-whisper existant (ln -s ../sensex-class-average/.venv .venv) ou créez-en un. Définissez SHAPES["9:16"].
2. Voix → timing → story.ts (SUBS, CUES, CAM), comme dans les étapes 4–5 du story-animator.
3. Dessin : commencez par examples/sensex-classroom/Film.tsx lorsque l'analogie convient, et réutilisez ses composants (Room, WindowPane, SunShaft, Board, Bean, Desk, Plane + arcAt, Confetti, Card). Sinon, construisez un nouveau monde dans le même style.
4. Planche contact à chaque temps fort, et corrigez :
   • En 9:16, gardez les sujets au-dessus des sous-titres. Le cy de la caméra du plan large était d'environ 560 pour des rangées situées à world y 478–790. À cy 520, les sous-titres reposaient sur la rangée avant.
   • Ne laissez jamais la moitié du cadre vide. Dans un gros plan sur le tableau, gardez les personnages visibles en dessous (ils sont toujours à l'écran et font un petit bond « bonjour » au moment de leur réplique plutôt que d'apparaître de nulle part).
   • Le monde visible en 9:16 est d'environ 607/z × 1080/z. Pour un moment « ils sont 50 », reculez à z ≈ 0,58.
5. Couverture : dessinez-la dans le monde et les personnages du projet de vidéo, ou étendez ReelCover dans brand/studio/src/templates/reel.tsx avec un nouvel art. Rendez-la dans out/cover.png. Vérifiez le recadrage 3:4 et une taille de petit écran de téléphone (environ 360 px de large) : le sujet et le titre doivent encore être lisibles.
6. Son → mixage → rendu → ffprobe (1080×1920, h264 + aac, 60 s). Envoyez la vidéo et la couverture. Signalez la voix, les crédits dépensés, ce qui a été mesuré et les sources. Demandez à l'utilisateur de regarder et d'écouter une fois.

Après la sortie : descriptions (toujours, dans le même message de livraison)

Les vidéos sont publiées à partir de @finance.unboring sur Instagram (Reels) et YouTube (Shorts). Avec chaque vidéo terminée, fournissez le texte prêt à coller dans des blocs de code :

• Légende Instagram : une ligne d'accroche ; 3 à 5 lignes courtes d'explication ; une ligne de sauvegarde et de partage + suivez @finance.unboring ; « Data: <source, date>. For education only. Not investment advice. » ; 3 à 5 hashtags incluant #financeunboring (Instagram limite les posts à 5). Suivez les modèles exacts dans BRAND.md section 6.
• Titre YouTube Shorts : moins de 70 caractères, se terminant par #Shorts.
• Description YouTube : 2 à 3 lignes d'explication, suivez @finance.unboring, les sources, l'avertissement et 4 à 6 hashtags.