# CLAUDE.md

Projet de réels verticaux générés avec Remotion + HyperFrames.
Tu es responsable du code d'animation, du montage et du mix.
Je reste responsable du sujet, du script et de la décision finale.

## Format

- Vertical 1080 x 1920, 30 fps.
- Durée cible : 30 à 60 secondes. Si le script dépasse, dis-le moi
  avant de monter, ne coupe pas de toi-même.
- Zone sûre : rien d'essentiel dans les 180 px du haut ni les 320 px du bas.

## Structure du projet

```
/src          composants Remotion
/assets/audio voix, nappe, effets
/assets/video vignettes et extraits insérés
/script.md    le texte dit, et uniquement ce qui est dit
/README.md    l'état d'avancement de la vidéo en cours
```

Un dossier par vidéo. Ne mélange jamais les assets de deux vidéos.

## Charte

- Fond : #141111
- Texte : #f2f2f2
- Accent : #ff5527
- Gris secondaire : #9da2b3
- Pas d'autre couleur. L'accent ne sert qu'à UNE chose par écran :
  soit le bandeau d'étape, soit le mot clé du sous-titre, jamais les deux.

## Typographie

- Titres de bandeau : sans-serif, graisse 700, majuscules, interlignage serré.
- Étiquettes d'outils : sans-serif, graisse 500, taille réduite, fond clair,
  coins arrondis.
- Pas d'emoji dans les textes à l'écran.

## Sous-titres

- 3 à 5 mots par ligne, deux lignes maximum.
- Un mot clé par phrase passe en accent, pas plus.
- Les sous-titres sont calés sur la piste voix, pas sur une durée fixe.
- Jamais de sous-titre qui reste à l'écran après la fin de la phrase.

## Bandeaux d'étape

- Les bandeaux s'empilent en haut et restent visibles jusqu'au changement
  de section.
- Chaque bandeau porte un numéro d'étape (ETAPE n/N) et un titre de 1 à 3 mots.
- Les étiquettes d'outils apparaissent sous le bandeau, une par une,
  décalées de 0,2 à 0,3 s.

## Rythme

- Rien n'apparaît en même temps. Toujours un décalage entre deux éléments.
- Une apparition se cale sur le mot prononcé correspondant.
- Toute animation d'entrée est terminée avant la fin de la phrase.

## Son

- Voix en avant, toujours.
- Nappe de fond continue, elle descend sous la voix.
- Un effet court sur chaque apparition de bandeau, aucun effet entre.
- Tous les sons viennent d'Openverse. Note la licence de chaque fichier
  dans /assets/audio/LICENCES.md.

## Façon de travailler

- Avant de monter, montre-moi le découpage écran par écran en texte.
  J'approuve, ensuite tu codes.
- Rends une preview après chaque lot de modifications.
- Ne traite pas plus de 3 corrections à la fois.
- Si une de mes demandes casse une règle de ce fichier, dis-le moi
  au lieu de l'appliquer en silence.
- Ne remplace jamais un asset existant : crée une nouvelle version numérotée.