/brag (Brag Ultra)
Vous l'avez construit. Maintenant, vantons-nous — avec une ultra-fidélité digne d'Apple.
Répartition de l'invocation (doit être faite en premier)
Avant d'inspecter le projet, analysez l'invocation complète de /brag. Si l'invocation contient --voice, définissez voice.enabled = true. Si --format ou --kit est fourni, configurez le pipeline de rendu en conséquence.
/brag transforme le projet actuel (application web, application mobile, application de bureau, outil CLI/TUI, ou bibliothèque) en une vidéo de lancement ultra-polie et un kit de lancement social.
Ce que fait Brag Ultra
- Inspecte le Projet & Capture l'Interface/CLI Réelle : Analyse le code du projet, son architecture et les instances en cours. Capture de vrais émulateurs mobiles (
adb), des pages web (Puppeteer), des fenêtres de bureau, ou des sessions terminal (asciinema/ cadre terminal CSS). - Planification Réactive Multi-Format : Planifie des mises en page adaptatives pour 16:9 Paysage (X, YouTube), 9:16 Vertical (TikTok, Reels, Shorts) et 1:1 Carré (LinkedIn, Instagram).
- Storyboard & Script de Qualité Apple : Conçoit un récit à fort impact avec des ressorts à amortissement critique, des shaders cinétiques, du traçage SVG, et des données de projet authentiques.
- Mixage Audio Intelligent & Ducking : Atténue automatiquement la musique de fond de -12dB sous la narration vocale (TTS Kokoro) avec des courbes d'attaque douces de 0,3s et de relâchement de 0,5s, et mixe des effets sonores à impact équilibré.
- Livraison d'un Kit de Lancement Complet : Produit des MP4 multi-format, extrait des affiches JPG cuites à l'image 0, génère des GIF d'aperçu animés nets en deux passes, et produit des textes sociaux structurés et
launch-metadata.json.
Analyse de l'invocation
L'utilisateur peut invoquer avec du langage naturel ou des drapeaux :
/brag
/brag --tone polished --format vertical
/brag --format all --kit --voice
/brag --tone chaotic --format square
/brag this CLI tool. Make it feel like an Apple developer keynote.
Drapeaux et Options Pris en Charge
| Option | Valeurs | Défaut | Description |
|---|---|---|---|
--tone | préréglage ou description libre | apple-keynote / déduit | Style esthétique et rythmique |
--format | landscape (16:9), vertical (9:16), square (1:1), all | landscape | Format vidéo et cible de réorganisation CSS |
--duration | secondes (ex. 15s, 20s) | auto (15–25s) | Durée totale |
--voice | drapeau | narration désactivée | Voix off Kokoro optionnelle avec ducking automatique de -12dB |
--kit | drapeau | rendu standard | Générer le kit de lancement complet (MP4, GIF, affiche JPG, JSON de métadonnées) |
--terminal | drapeau | détection automatique | Activer la lecture et le chrome du terminal CLI/TUI |
--no-music | drapeau | musique activée | Désactiver la musique de fond |
--no-sfx | drapeau | effets sonores activés | Désactiver les effets sonores |
--title | chaîne | déduit | Titre personnalisé du produit |
Lorsque --format all ou --kit est spécifié, générez les 3 formats (16:9, 9:16, 1:1) ainsi que le GIF animé et le lot de métadonnées.
Piliers Fondamentaux de Brag Ultra
1. Réorganisation Réactive Multi-Format
Pas de barres noires gênantes ni de letterboxing naïf. La composition se réorganise intelligemment :
- 16:9 Paysage (
1920x1080) : Mises en page divisées côte à côte, cadres duo d'appareils, vues terminal grand écran. - 9:16 Vertical (
1080x1920) : Pile verticale centrée, cadres d'appareils mobiles en pleine hauteur, grandes pinces de police, zones de sécurité strictes (rembourrage haut/bas pour les superpositions de plateforme). - 1:1 Carré (
1080x1080) : Recadrage serré et ciblé, carte héros centrée, typographie à contraste élevé.
2. Mixage Audio Intelligent & Ducking de la Voix Off
- La musique de fond est automatiquement atténuée de -12dB chaque fois que la narration vocale ou un dialogue est joué.
- Courbe de ducking : 0,3s d'attaque douce avant la parole, 0,5s de relâchement après la parole.
- Limiteur maître et normalisation du volume : les effets sonores percent à 0,60–0,85 sans écrêtage numérique.
3. Capture d'Écran Terminal / CLI / TUI
- Support dédié pour les outils terminal (
pluvia,hyperindex,omnihud,token-trimmer, etc.). - Rejoue les commandes en direct avec un rythme de frappe humain réaliste (gigue de 40–90ms), des couleurs de syntaxe ANSI, et des sons de frappe synchronisés (
keyboard/keypress-*.wav). - Cadre terminal SVG / Canvas haute résolution avec chrome de fenêtre Apple (feux de circulation) et bordure titane.
4. Shader Cinétique & Polissage du Mouvement
- Texture de Grain de Film : Bruit SVG
feTurbulence/ canvas subtil (3–5% d'opacité) éliminant les bandes de couleur et ajoutant de la chaleur cinématographique. - Aberration Chromatique : Micro-séparation RVB sur les coupes à haute vélocité et les impacts violents.
- Physique de Ressort : Courbes à amortissement critique GSAP (
ease: "expo.out",ease: "power4.out", oumass: 1, stiffness: 120, damping: 14). - Tracé SVG : Dessin de chemin animé (
stroke-dashoffset) pour les logos, les nœuds architecturaux et les contours d'interface.
5. Génération du Kit de Lancement Complet
Produit un répertoire de sortie clé en main :
brag.mp4/brag-16x9.mp4,brag-9x16.mp4,brag-1x1.mp4brag.gif(Aperçu GIF animé optimisé en deux passes, 30ips, pour README GitHub et embeds Discord, <10 Mo)brag.jpg(Affiche haute résolution, cuite directement dans l'image 0 du MP4)share-copy.txt(Légende de publication unique et concise)share-copy-variants.md(Légendes personnalisées pour X/Twitter, LinkedIn, Reddit, Product Hunt)launch-metadata.json(Balises OpenGraph, Twitter Card, mots-clés, horodatages)
Répertoire de Sortie
La sortie par défaut va dans brag-output/ (ou brag-output-YYYY-MM-DD-HHmmss/ si existant) :
brag-output/
brag.mp4 # Vidéo rendue principale
brag-16x9.mp4 # Rendu 16:9 Paysage (si multi-format)
brag-9x16.mp4 # Rendu 9:16 Vertical (si multi-format)
brag-1x1.mp4 # Rendu 1:1 Carré (si multi-format)
brag.jpg # Affiche haute résolution (cuite dans l'image 0)
brag.gif # Aperçu GIF animé haute résolution
brag-plan.md # Storyboard & plan créatif
composition-brief.md # Résumé Hyperframes
share-copy.txt # Légende de publication principale
share-copy-variants.md # Texte de publication multi-plateforme
launch-metadata.json # Métadonnées OpenGraph & sociales
composition/ # Projet source Hyperframes
Étapes du Flux de Travail
- Étape 1 : Inspecter & Capturer l'Interface/le Terminal en Direct : Lire references/step-1-inspect.md & references/capture-workflow.md
- Étape 2 : Planifier & Storyboarder : Lire references/step-2-plan.md & references/apple-design-guide.md
- Étape 3 : Composer avec Hyperframes : Lire references/step-3-compose.md & references/audio.md
- Étape 4 : Valider, Rendre & Livrer le Kit de Lancement : Lire references/step-4-deliver.md
Préréglages de Ton
Définitions complètes dans references/tones.md :
| Ton | Énergie | Phrase d'Accroche |
|---|---|---|
apple-keynote | Confiance tranquille, physique tactile, retenue sublime | Esthétique de révélation de produit phare Apple |
default | Enjoué, propre, publiable | Vitrine grand public et créative, bonne vibes |
polished | Sérieux, élégant, hautement artisanal | Outil développeur premium ou produit d'entreprise |
yc-parody | Énergie startup impassible | Livraison sérieuse de concepts audacieux ou farfelus |
chaotic | Rapide, fort, déjanté | Bande de pub à haute vélocité |
deadpan | Calme, sec, sobre | Timing minimaliste où la retenue est la chute |
cinematic | Dramatique, à l'échelle d'un blockbuster | Grand mouvement, houles orchestrales/synth, rythme de bande-annonce |
app-store | Fluide, fiche fonctionnelle nette | Visite guidée d'interface nette avec micro-interactions tactiles |