Une fiche = un short : le format tip.json

Tout tient dans un fichier

Un short, c'est un fichier tip.json. JSON est un format de données en texte, lisible par un humain comme par un programme. Voici celui d'une vraie vidéo, raccourci pour la lecture. Elle montre qu'il vaut mieux écrire find() que filter()[0] pour trouver le premier élément d'un tableau.

{
  "id": "JS-TAB-03",
  "titre": ".find() — arrête le filter()[0]",
  "format": "x-vs-y",
  "chip": { "techno": "JS", "serie": "TABLEAUX · 03" },
  "cta": ["Tu connaissais ?", "Dis-le en commentaire."],
  "code": [
    { "id": "a", "text": "const ids = [4, 8, 15, 16, 23];" },
    { "id": "x", "text": "ids.filter(n => n > 10)[0];" },
    { "id": "y", "text": "ids.find(n => n > 10);" }
  ],
  "beats": [
    { "dur": 2.2, "title": ["Encore un", "*filter()[0] ?*"], "lines": ["a", "x"] },
    { "dur": 3.6, "title": ["Utilise", "*.find()*"], "lines": ["a", "y"], "type": true }
  ],
  "verif": {
    "code": "const ids = [4, 8, 15, 16, 23]; console.log(ids.filter(n => n > 10)[0]); console.log(ids.find(n => n > 10)); console.log(ids.find(n => n > 99));",
    "attendu": "15\n15\nundefined"
  }
}

Les trois parties

Le code, découpé en lignes nommées

Chaque ligne porte un identifiant (a, x, y). Le reste de la fiche ne recopie jamais le code : il désigne les lignes par leur nom pour les afficher, les barrer ou les souligner.

Une ligne ne dépasse pas 32 caractères. C'est ce qui tient en gros caractères sur un écran de téléphone. Et pas plus de 10 lignes à l'écran : si ça ne tient pas, on simplifie l'exemple, on ne réduit pas la police.

Les temps de l'écran

Chaque « beat » (un temps, en français) est un moment de la vidéo : sa durée, le titre affiché, les lignes visibles. Les étoiles autour d'un mot, comme *.find()*, le passent dans la couleur d'accent.

Le premier temps porte l'accroche. C'est l'image que le spectateur voit en premier dans son fil : elle n'est jamais vide, le code et le titre y sont déjà.

Une règle de confort de lecture s'applique partout. Une étape qui affiche du texte reste au moins deux secondes à l'écran, et une légende de deux lignes au moins 2,8 secondes. Le générateur fait ce calcul et refuse une fiche trop pressée.

La vérification

Avant tout rendu, le code de verif est exécuté pour de vrai, ici par Node.js, et sa sortie est comparée à attendu. Si elles diffèrent, la fabrication s'arrête sur le message « CODE NON VÉRIFIÉ ». Le public est fait de développeurs : une erreur à l'écran se paie en commentaires.

La question de fin

Le champ cta est la question affichée à la fin, pour appeler un commentaire. Deux lignes de 23 caractères au plus, la même question en fin de légende.

Un chiffre honnête : relevé le 24 septembre 2026, zéro commentaire sur tous mes posts de code, malgré « Tu connaissais ? » partout. Une question fermée se répond dans sa tête. Je teste maintenant des questions à choix, qui donnent envie d'écrire : « map ou forEach ici ? », « quelle version tu gardes, A ou B ? ». La fiche rend ce test facile : on change deux lignes, on relance.

Pourquoi du JSON et pas une interface ?

• Claude Code écrit et relit du JSON sans erreur de manipulation. Il n'a pas à cliquer dans une interface : il écrit un fichier, comme du code.
• Git garde l'historique de chaque changement, vidéo par vidéo.
• Les garde-fous deviennent des contrôles automatiques. Le générateur refuse une ligne de code trop longue, un choix de quiz qui déborde de sa case, une question finale sans ponctuation.

Ce dernier contrôle a une histoire. Un raccourci dans un script avait coupé sept questions en fin de vidéo, du genre « Tu écris ta grille comm ». Depuis, une question sans point d'interrogation ni point final est refusée : elle a sans doute été coupée.

À toi

Prends une astuce que tu connais bien, dans ton langage. Écris son titre (une seule idée), trois à cinq lignes de code de 32 caractères au plus, et la sortie attendue. Puis exécute ton code pour de vrai et compare. Tu viens d'écrire ta première fiche.

Pour du JavaScript, Node.js suffit (nodejs.org, version 22 ou plus récente). node -v affiche la version installée. Cette ligne marche telle quelle dans PowerShell comme dans un terminal macOS ou Linux, et doit afficher 15 :

node -e "const ids = [4, 8, 15, 16, 23]; console.log(ids.find(n => n > 10))"

{
  "id": "JS-MOI-01",
  "titre": "Une seule idée, dite simplement",
  "cta": ["Tu l'écris comment ?", "Dis-le en commentaire."],
  "code": [
    { "id": "a", "text": "ta première ligne" },
    { "id": "b", "text": "ta deuxième ligne" }
  ],
  "beats": [
    { "dur": 2.2, "title": ["Ton accroche", "*mot clé*"], "lines": ["a", "b"] }
  ],
  "verif": { "code": "le code exécuté", "attendu": "la sortie réelle" }
}

Ce que la suite t'apporte

Tu as vu le fichier. La suite montre la machine qui le transforme en vidéo, et tout ce qui l'entoure :

• le gabarit, ses limites chiffrées et les erreurs réelles qui ont fait naître chaque contrôle ;
• les fichiers que Claude Code relit à chaque session pour produire des séries de dix à douze fiches sans rien réexpliquer ;
• la voix clonée, la musique et le mixage pour les vidéos narrées ;
• la publication : hashtags vérifiés, et un tableau de bord où je valide chaque vidéo avant qu'elle parte.

Sources

• Node.js, page de téléchargement officielle : https://nodejs.org/en/download — vérifiée le 19 octobre 2026.
• HyperFrames, paquet npm hyperframes (Node.js 22 ou plus récent exigé) : https://github.com/heygen-com/hyperframes — vérifié le 19 octobre 2026.