Vous pouvez opérer à l'intérieur du dépôt de la marque, ou travailler à partir d'un contexte externe.
Ne devinez pas l'identité de la marque. Analysez le code source ou recherchez l'URL fournie.
PIPELINE D'EXÉCUTION
ÉTAPE 1 — Recueillir le contexte
⛔ STOP. Posez ces deux questions à l'utilisateur :
-
« Sommes-nous à l'intérieur du dépôt de votre marque, ou souhaitez-vous fournir une URL (par exemple votre site marketing) afin que je puisse rechercher votre marque en ligne ? »
-
« Souhaitez-vous une musique de fond générée ? Si oui, vous aurez besoin d'une clé ELEVEN_LABS_API_KEY dans votre environnement. Vous pouvez en obtenir une sur https://elevenlabs.io → Profil → Clés API. »
Attendez que l'utilisateur réponde aux deux questions.
N'essayez pas de lire les fichiers .env ni de vérifier les clés vous-même. Faites confiance aux réponses de l'utilisateur.
Si l'utilisateur fournit une URL, utilisez-la pour l'étude de marque à l'ÉTAPE 3 au lieu d'analyser le code source. Si l'utilisateur refuse la musique, sautez l'ÉTAPE 4 et l'ÉTAPE 5.
ÉTAPE 2 — Assurer les dépendances d'exécution Helios
Installez les paquets requis :
npm install @helios-project/core @helios-project/renderer @helios-project/cli
Vous effectuerez le rendu en mode DOM.
ÉTAPE 3 — Extraire l'intelligence de marque depuis le dépôt
Si l'utilisateur a fourni une URL au lieu d'un dépôt, récupérez cette URL et extrayez les mêmes signaux de marque depuis le site en ligne. Ignorez les éléments spécifiques au code source (config Tailwind, tokens de design, etc.) et concentrez-vous sur les éléments de marque visibles.
Analysez :
• Configuration Tailwind ou variables CSS • Feuilles de style globales • Tokens de design • Assets du logo • Favicon • Structure de la documentation • Descriptions des fonctionnalités • Flux d'intégration • Texte d'aide et microcopie • Architecture de l'information • Composants d'interface utilisateur • Utilisation existante du motion design
Construisez un profil de marque interne :
• Proposition de valeur principale • Public cible • Ton de la voix (instructif, bienveillant, autoritaire) • Densité visuelle • Palette primaire • Palette d'accentuation • Caractère typographique • Modèles de hiérarchie de l'information • Style d'explication (d'abord visuel ou plutôt textuel)
Toutes les décisions créatives doivent s'aligner sur ce profil.
ÉTAPE 4 — Générer la musique originale (Ignorer si pas de musique)
Utilisez ElevenLabs avec la clé ELEVEN_LABS_API_KEY existante.
Générez une piste instrumentale correspondant à :
• Ton calme et bienveillant • Progression régulière sans pics dramatiques • Présence subtile en arrière-plan (ne doit pas concurrencer la narration) • Durée cible
Enregistrez l'audio localement.
ÉTAPE 5 — Analyser l'audio avec ffmpeg (Ignorer si pas de musique)
Extrayez :
• BPM • Horodatages des temps • Contretemps • Pics d'énergie
Créez une carte temporelle des temps forts.
Les transitions de section doivent s'aligner sur les contretemps. Les révélations de texte à l'écran doivent s'aligner sur les temps.
ÉTAPE 6 — Lire les règles de conception motion
Avant de produire le cahier des charges créatif, lisez et intériorisez :
skills/guided/motion-design-rules
Chaque règle de cette compétence est obligatoire pour cette composition.
ÉTAPE 7 — Produire le cahier des charges créatif
Vous êtes un directeur créatif senior et un architecte pédagogique spécialisé dans la conception pour Helios utilisant motion.dev.
Exemple d'entrée : expliquer le fonctionnement de notre flux de paiement en 60 secondes
Sortie :
• Un cahier des charges créatif structuré • Enveloppé dans un seul bloc de code • Aucune explication en dehors
Le cahier des charges doit inclure :
• Durée • Format d'image (16:9) • Résumé de marque • Arc narratif (Introduction → Problème → Solution → Fonctionnement → Appel à l'action) • Langage motion (mesuré, délibéré, progressif) • Décomposition synchronisée des sections sur les temps forts • Horodatages exacts par section • Script voix-off (conversationnel, clair) • Texte à l'écran (en-têtes de section, étiquettes de fonctionnalités, numéros d'étape) • Composition visuelle (mises en page nettes, espaces généreux) • Comportement d'animation motion.dev explicite • Logique de transition (fondus enchaînés fluides entre les sections, glissements pour le contenu) • Ordre de superposition • Direction audio • Besoins en assets • Indicateurs d'étape ou marqueurs de progression
Utilisez uniquement une terminologie compatible motion.dev.
Exigences de structure narrative :
• Accroche d'ouverture (5 premières secondes) • Identification du problème • Présentation de la solution • Démonstration pas à pas • Résumé et appel à l'action
ÉTAPE 8 — Implémenter la composition Helios basée sur le DOM
En utilisant le cahier des charges créatif :
Créez un fichier composition.html qui :
• Utilise HTML + CSS + motion.dev • Implémente les animations via WAAPI / CSS / motion.dev • Aligne les transitions de section sur les contretemps • Utilise des en-têtes de section clairs avec numérotation des étapes • Inclut le fichier audio généré • A une durée exacte • Privilégie la lisibilité et la clarté visuelle
Exposez le runtime Helios :
import { helios } from "@helios-project/core";
window.helios = helios;
helios.bindToDocumentTimeline({
autoSyncAnimations: true
});
Exigences :
• window.helios doit être défini • helios.bindToDocumentTimeline() doit être appelé • autoSyncAnimations: true doit être activé • Toutes les animations CSS et WAAPI doivent se synchroniser correctement • Aucun aléatoire • Synchronisation déterministe • Le texte doit rester à l'écran suffisamment longtemps pour être lu (minimum 3 secondes par message clé)
ÉTAPE 9 — Rendre avec la CLI officielle Helios (mode DOM)
Effectuez le rendu avec :
npx @helios-project/cli render ./composition.html -o output.mp4
Exigences :
• Format 16:9 • Durée correcte • Audio attaché • CSS et WAAPI entièrement synchronisés • Sortie MP4 de haute qualité
Le fichier de sortie doit être :
output.mp4
RÈGLES D'EXÉCUTION
Si la durée ≤ 30 secondes Compressez en : Accroche → Concept clé → Appel à l'action.
Si aucune durée n'est spécifiée Par défaut : 60 secondes.
Maximum 5 sections pour toute durée. Chaque section doit avoir un en-tête clair à l'écran. Le rythme doit permettre la compréhension — ne précipitez jamais l'information.
Ne reformulez jamais la demande originale. N'expliquez jamais votre raisonnement. Le cahier des charges créatif doit être produit uniquement à l'intérieur d'un seul bloc de code.