mikeOnBreeze/cc-crossbeam

Produkt-Demo-Video

Erstelle 2-minütige Produkt-Demo-Videos für technische Projekte mit parallelen Build-Optionen und strukturierter Kritikprüfung.

Wann verwenden

• Demo eines GitHub-Repos, einer API oder eines technischen Produkts
• Benötige schnell ein professionelles Erklärvideo
• Möchte mehrere Ansätze (animiert vs. einfach)

Workflow (7 Phasen)

DISCOVERY → SCRIPT → PARALLELER BUILD → PARALLELE KRITIK → ITERATION → FINAL → AUSLIEFERUNG
   │           │           │                │              │          │         │
 5-10m      10-15m      30-60m           10-15m        0-3 loops   gate    ship it

---

Phase 1: Discovery

Repo klonen und analysieren:

gh repo clone <owner/repo> /tmp/<repo>

Extrahiere:

• Was es tut (1 Satz)
• Für wen es ist
• 3-5 Hauptfunktionen
• Architektur/Fluss
• Visuelle Assets (Logos, Diagramme)

Fragen (oder Standardwerte verwenden):

Frage	Standard
Dauer	2 Min
Zielgruppe	Gemischt (Technik + Business)
Ton	Professionell-konversationell
Format	Animiertes Erklärvideo

---

Phase 2: Script

Verwende die Struktur aus references/script-template.md:

Szene 1: Aufhänger (0:00-0:15) — Problemstellung
Szene 2: Kontext (0:15-0:30) — Warum das wichtig ist
Szene 3-5: Funktionen (0:30-1:30) — 3 Schlüsselfähigkeiten, je 20s
Szene 6: Technisch (1:30-1:50) — Architektur/Glaubwürdigkeit
Szene 7: CTA (1:50-2:00) — Was als nächstes tun

Richtlinien:

• 150 Wörter/Minute
• Maximal 20 Wörter/Satz
• Aktive Stimme
• Konkret statt vage

---

Phase 3: Paralleler Build

Starte 2 Sub-Agenten, um Optionen gleichzeitig zu bauen:

// Option A: Remotion (animiert)
sessions_spawn({
  label: "demo-video-option-a",
  task: `Baue animiertes Demo-Video mit Remotion.
  
  Script: [Script einfügen]
  Stimme: Verwende ElevenLabs, Sprach-ID CcEB0ARKH8qIyzh2I1OR
  Ausgabe: /tmp/demo-video/option-a.mp4
  
  Vorgehen:
  1. Sprachausgabe pro Szene generieren (ElevenLabs API)
  2. Remotion-Projekt mit Szenenkomponenten erstellen
  3. Animationen an Audio-Timing anpassen
  4. Mit 1080p 30fps rendern`
})

// Option B: Folien + ffmpeg (einfach)
sessions_spawn({
  label: "demo-video-option-b", 
  task: `Baue folienbasiertes Demo-Video.
  
  Script: [Script einfügen]
  Stimme: Verwende ElevenLabs, Sprach-ID CcEB0ARKH8qIyzh2I1OR
  Ausgabe: /tmp/demo-video/option-b.mp4
  
  Vorgehen:
  1. Sprachausgabe generieren (ElevenLabs API)
  2. Folien mit Puppeteer erstellen (HTML → PNG)
  3. Mit ffmpeg kombinieren, auf Audio synchronisieren
  4. Einfache Übergänge hinzufügen`
})

Warte auf beide. Präsentiere die Optionen dem Benutzer oder wähle automatisch basierend auf Qualität.

---

Phase 4: Parallele Kritiker

Starte 2 Kritiker-Personas (siehe references/ für vollständige Rubriken):

// Business-Kritiker
sessions_spawn({
  label: "critic-business",
  task: `Bewerte Demo-Video als Business-Kritiker "Mike".
  
  Video: [Pfad]
  Script: [Inhalt]
  
  Siehe references/critic-business.md für vollständige Persona und Rubrik.
  
  Bewertung: Klarheit, Professionalität, Geschäftswert (je 1-10)
  Ausgabe: Strukturierte Bewertung mit Gesamtpunktzahl und spezifischen Korrekturen.`
})

// Technischer Kritiker  
sessions_spawn({
  label: "critic-technical",
  task: `Bewerte Demo-Video als Technischer Kritiker "Senior Engineer".
  
  Video: [Pfad]
  Script: [Inhalt]
  
  Siehe references/critic-technical.md für vollständige Persona und Rubrik.
  
  Bewertung: Technische Genauigkeit, Glaubwürdigkeit, Vollständigkeit (je 1-10)
  Ausgabe: Strukturierte Bewertung mit Gesamtpunktzahl und spezifischen Korrekturen.`
})

---

Phase 5: Iteration

Qualitätstore:

Tor	Aktion
Beide Kritiker ≥7,5, keine kritischen Probleme	→ Ausliefern
Mindestens ein Kritiker <7,0 ODER kritisches Problem	→ Iterieren
Nach 3 Iterationen immer noch fehlschlagend	→ An Menschen eskalieren

Iterationsschleife:

1. Alle kritischen/wichtigen Probleme sammeln
2. In der Reihenfolge der Schwere beheben
3. Nur betroffene Szenen neu rendern (wenn möglich)
4. Kritiker erneut ausführen

---

Phase 6: Finale Überprüfung

Vor der Auslieferung überprüfen:

• Beide Kritiker bestanden (7,5+)
• Keine kritischen Probleme mehr vorhanden
• Audio korrekt synchronisiert
• Alle Szenen sauber gerendert
• CTA ist klar

---

Phase 7: Auslieferung

Ausgabe:

✅ Demo-Video fertig!

📹 Video: demo-video-final.mp4 (2:03)
🎯 Zielgruppe: [Zielgruppe]
📊 Bewertungen: Business 8.2/10 | Technisch 7.8/10

Abdeckung:
1. [Kernpunkt 1]
2. [Kernpunkt 2]  
3. [Kernpunkt 3]

Dateien gespeichert unter: [Speicherort]

Liefern an:

• Slack-Kanal (falls angegeben)
• Speichern in workspace/outputs/

---

Tools & Abhängigkeiten

Tool	Zweck	Erforderlich
ElevenLabs	Sprachausgabe-Generierung	Ja
Remotion	React Video-Framework (Option A)	Eine von A/B
ffmpeg	Videoverarbeitung (Option B)	Eine von A/B
Puppeteer	Folien-Screenshots (Option B)	Eine von A/B
sessions_spawn	Parallele Sub-Agenten	Ja

Standardstimme: CcEB0ARKH8qIyzh2I1OR (Jeremy - Technischer Tutorial-Sprecher)

---

Dateireferenzen

• references/critic-business.md — Business-Kritiker-Persona & Rubrik
• references/critic-technical.md — Technischer Kritiker-Persona & Rubrik
• references/script-template.md — Szenenweise Scriptstruktur
• templates/remotion/ — Remotion-Projektgerüst mit Komponenten
• scripts/generate-voiceover.py — ElevenLabs TTS-Helfer
• scripts/render-slides.sh — ffmpeg Folien-zu-Video-Kombinierer