/brag (Brag Ultra)
Du hast es gebaut. Jetzt lass uns damit angeben – in ultrasatter Apple-Qualität.
Aufruf-Dispatch (muss zuerst erfolgen)
Bevor das Projekt inspiziert wird, muss der vollständige /brag-Aufruf analysiert werden. Wenn der Aufruf --voice enthält, setze voice.enabled = true. Wenn --format oder --kit angegeben ist, konfiguriere die Rendering-Pipeline entsprechend.
/brag verwandelt das aktuelle Projekt (Web-App, mobile App, Desktop-GUI, CLI/TUI-Tool oder Bibliothek) in ein ultra-hochglanzpoliertes Launch-Video und ein soziales Launch-Kit.
Was Brag Ultra tut
- Projekt inspizieren & echte UI/CLI erfassen: Scannt Projektcode, Architektur und Live-Instanzen. Erfasst echte mobile Emulatoren (
adb), Webseiten (Puppeteer), Desktop-Fenster oder Terminal-Sitzungen (asciinema/ CSS-Terminal-Frame). - Multi-Format Responsive Planung: Plant adaptive Layouts für 16:9 Querformat (X, YouTube), 9:16 Hochformat (TikTok, Reels, Shorts) und 1:1 Quadrat (LinkedIn, Instagram).
- Apple-gleiches Storyboarding & Scripting: Erstellt eine wirkungsvolle Erzählung mit kritisch gedämpften Federn, kinetischen Shadern, SVG-Strich-Tracing und authentischen Projektdaten.
- Intelligentes Audio-Mastering & Ducking: Duckt Hintergrundmusik automatisch um -12dB unter Sprachkommentar (Kokoro TTS) mit sanften 0,3s Attack / 0,5s Release-Kurven und mischt pegellevelierte SFX.
- Komplettes Launch-Kit: Rendert Multi-Format-MP4s, extrahiert Frame-0-gebackene Poster-JPGs, generiert knackige Zwei-Pass-animierte Preview-GIFs und gibt strukturierte Social-Copy &
launch-metadata.jsonaus.
Den Aufruf parsen
Der Benutzer kann mit natürlicher Sprache oder Flags aufrufen:
/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.
Unterstützte Flags & Optionen
| Option | Werte | Standard | Beschreibung |
|---|---|---|---|
--tone | Preset oder freie Beschreibung | apple-keynote / abgeleitet | Ästhetik & Tempo-Stil |
--format | landscape (16:9), vertical (9:16), square (1:1), all | landscape | Video-Seitenverhältnis und CSS-Reflow-Ziel |
--duration | Sekunden (z. B. 15s, 20s) | auto (15–25s) | Gesamtdauer |
--voice | Flag | Erzählung aus | Opt-in Kokoro Voiceover mit -12dB Auto-Ducking |
--kit | Flag | Standard-Render | Vollständiges Launch-Kit generieren (MP4s, GIF, Poster JPG, Metadaten JSON) |
--terminal | Flag | automatisch erkannt | CLI/TUI-Terminal-Wiedergabe & Chrome aktivieren |
--no-music | Flag | Musik an | Hintergrundmusik deaktivieren |
--no-sfx | Flag | SFX an | Soundeffekte deaktivieren |
--title | String | abgeleitet | Benutzerdefinierter Produkttitel |
Wenn --format all oder --kit angegeben ist, generiere alle 3 Seitenverhältnisse (16:9, 9:16, 1:1) zusammen mit dem animierten GIF und dem Metadaten-Bundle.
Kernpfeiler von Brag Ultra
1. Multi-Format Responsive Reflow
Keine hässlichen schwarzen Balken oder naives Letterboxing. Die Komposition fließt intelligent um:
- 16:9 Querformat (
1920x1080): Side-by-Side-Split-Layouts, Doppel-Geräterahmen, Breitbild-Terminal-Ansichten. - 9:16 Hochformat (
1080x1920): Zentrierter vertikaler Stack, vollhohe mobile Geräterahmen, große Schrift-Clamps, strenge Sicherheitszonen (Polsterung oben/unten für Plattform-Overlays). - 1:1 Quadrat (
1080x1080): Enger, fokussierter Ausschnitt, zentrierte Hero-Karte, kontrastreiche Typografie.
2. Intelligentes Audio-Mastering & Voiceover-Ducking
- Hintergrundmusik duckt automatisch um -12dB, wenn Sprachkommentare oder Dialoge abgespielt werden.
- Ducking-Kurve: 0,3s sanfter Attack vor Sprache, 0,5s Release nach Sprache.
- Master-Limiter und Lautstärkenormalisierung: SFX durchschlagen bei 0,60–0,85 ohne digitales Clipping.
3. Terminal-/CLI-/TUI-Bildschirmaufnahme
- Dedizierte Unterstützung für Terminal-Tools (
pluvia,hyperindex,omnihud,token-trimmer, etc.). - Spielt Live-Befehle mit realistischer menschlicher Tippgeschwindigkeit (40–90 ms Jitter), ANSI-Syntaxfarben und synchronisierten Tastendruck-Audios (
keyboard/keypress-*.wav) ab. - Hochauflösender SVG-/Canvas-Terminal-Frame mit Apple-Ampel-Fenster-Chrome und Titanrand.
4. Kinetische Shader & Bewegungs-Polish
- Filmkörnung-Textur: Dezentes SVG
feTurbulence/ Canvas-Rauschen (3–5% Deckkraft) eliminiert Farbverläufe und verleiht filmische Wärme. - Chromatische Aberration: Mikro-RGB-Split bei schnellen Schnitten und Slam-Impacts.
- Feder-Physik: GSAP kritisch gedämpfte Kurven (
ease: "expo.out",ease: "power4.out"odermass: 1, stiffness: 120, damping: 14). - SVG-Strich-Tracing: Animierte Pfadzeichnung (
stroke-dashoffset) für Logos, Architekturknoten und UI-Konturen.
5. Komplette Launch-Kit-Generierung
Produziert ein einsatzbereites Release-Verzeichnis:
brag.mp4/brag-16x9.mp4,brag-9x16.mp4,brag-1x1.mp4brag.gif(Zwei-Pass-Palettenoptimiertes 30fps animiertes Preview für GitHub READMEs & Discord-Einbettungen unter 10 MB)brag.jpg(Hochauflösender Poster-Frame, direkt in Frame 0 des MP4 gebacken)share-copy.txt(Kurze, prägnante Ein-Post-Bildunterschrift)share-copy-variants.md(Angepasste Bildunterschriften für X/Twitter, LinkedIn, Reddit, Product Hunt)launch-metadata.json(OpenGraph, Twitter-Card-Tags, Keywords, Zeitstempel)
Ausgabeverzeichnis
Standardausgabe erfolgt nach brag-output/ (oder mit Zeitstempel brag-output-YYYY-MM-DD-HHmmss/, falls bereits vorhanden):
brag-output/
brag.mp4 # Primäres gerendertes Video
brag-16x9.mp4 # 16:9 Querformat-Render (falls Multi-Format)
brag-9x16.mp4 # 9:16 Hochformat-Render (falls Multi-Format)
brag-1x1.mp4 # 1:1 Quadrat-Render (falls Multi-Format)
brag.jpg # Hochauflösender Poster-Frame (in Frame 0 gebacken)
brag.gif # Hochauflösendes animiertes GIF-Preview
brag-plan.md # Storyboard & kreativer Plan
composition-brief.md # Hyperframes-Briefing
share-copy.txt # Primäre Post-Bildunterschrift
share-copy-variants.md # Multiplattform-Post-Text
launch-metadata.json # OpenGraph & Social-Media-Metadaten
composition/ # Hyperframes-Quellprojekt
Workflow-Schritte
- Schritt 1: Live-UI/Terminal inspizieren & erfassen: Lies references/step-1-inspect.md & references/capture-workflow.md
- Schritt 2: Planen & Storyboarden: Lies references/step-2-plan.md & references/apple-design-guide.md
- Schritt 3: Mit Hyperframes komponieren: Lies references/step-3-compose.md & references/audio.md
- Schritt 4: Validieren, rendern & Launch-Kit ausliefern: Lies references/step-4-deliver.md
Stil-Presets
Vollständige Definitionen in references/tones.md:
| Stil | Energie | Einzeiler |
|---|---|---|
apple-keynote | Stille Zuversicht, taktile Physik, erhabene Zurückhaltung | Ästhetik einer Apple-Flaggschiff-Produktpräsentation |
default | Verspielt, sauber, postbar | Good-Vibes-Consumer- & Creative-Showcase |
polished | Ernst, elegant, hohe Handwerkskunst | Premium-Entwickler-Tool oder Enterprise-Produkt |
yc-parody | Trockene Startup-Energie | Ernsthafte Präsentation von kühnen oder skurrilen Konzepten |
chaotic | Schnell, laut, entfesselt | High-Velocity-Hype-Reel |
deadpan | Ruhig, trocken, untertrieben | Minimalistisches Timing, bei dem Zurückhaltung der Punchline ist |
cinematic | Dramatisch, Blockbuster-Maßstab | Große Bewegungen, orchestrale/synthie-artige Swells, Trailer-Tempo |
app-store | Glatt, Feature-Card-sauber | Knackiger UI-Walkthrough mit taktilen Mikrointeraktionen |