AGHEORONO/video-dna

Video DNA

Verwandle einen Ordner mit Filmmaterial in ein Video, das sich anfühlt, als wäre es von jemandem geschnitten, der wirklich dabei war. Bewahre die DNA, verwende nie eine Vorlage: Jedes Video bekommt sein eigenes Thema, das aus dem tatsächlichen Geschehen im Material abgeleitet wird.

Antworte in der Sprache des Nutzers. Untertitel und Texte auf dem Bildschirm verwenden die Sprache des Filmmaterials, sofern nichts anderes angegeben ist.

Hier starten

1. Führe python scripts/doctor.py aus, um zu sehen, was diese Umgebung kann. Lies references/environments.md, wenn etwas fehlt oder du dich in einer Cloud-Sandbox befindest.
2. Sieh dir den Arbeitsordner an, lies dann references/brief.md und sammle das Briefing. Frage nur nach dem, was die Anfrage und das Material nicht bereits beantworten.
3. Lies references/formats.md und verwende das Rezept, das der Anfrage am nächsten kommt. Wenn kein Material vorhanden ist, folge "Kein Material" in references/brief.md.
4. Lies references/pipeline.md, bevor du die Timeline erstellst, und references/tools.md, wenn ein Job mehr als die Kernskripte benötigt.

Arbeitsablauf

Führe die Schritte in dieser Reihenfolge aus. Rendere nichts vor Schritt 5.

0. Briefing. Lege Format, Ausrichtung, Länge, Rhythmus, Bewegungsintensität, visuelle Identität und Audio fest. Siehe references/brief.md. Verwende seine Entscheidungen für das gesamte Video.
1. Bestandsaufnahme. Liste Clips, Fotos, Musik und Logos auf, falls vorhanden. Erstelle Kontaktbögen mit scripts/contact_sheet.py und sieh sie dir an. Transkribiere Sprache mit scripts/transcribe.py, zuerst die kürzesten und dichtesten Clips. Echte Zeilen sind normalerweise das lustigste Material.
2. Geschichte. Schreibe auf, was tatsächlich passiert ist, der Reihe nach, mit den besten echten Zeilen und wer sie gesagt hat. Frage, wer die Leute sind, wenn es dir nicht gesagt wurde.
3. Thema. Schlage 2-3 neue Themen vor, jedes mit 2 konkreten Gags, die auf echten Momenten basieren. Empfehle eines, bevorzugt ein Thema, das das Filmmaterial bereits nahelegt. Halte dann inne und lass den Nutzer wählen. Siehe references/themes.md.
4. Musik. Schlage einen Titel pro Abschnitt mit einem Zieldateinamen vor und bitte den Nutzer, die Dateien in den Ordner zu legen. Ein Name wie 2_chorus_0m45s.mp3 bedeutet "Start bei 0:45". Lade niemals kommerzielle Musik herunter, selbst wenn du darum gebeten wirst. Biete stattdessen generierte Sounds und eine Version ohne Musik an.
5. Zuerst Probe. Erstelle bei allem über etwa 45 Sekunden ein kurzes Kapitel, damit der Nutzer die Richtung beurteilen kann. Erstelle dann den Rest.
6. Prüfung. Führe scripts/qa.py aus, betrachte extrahierte Frames und gehe references/qa-checklist.md durch. Behebe, was du findest, bevor du auslieferst.
7. Auslieferung. Siehe "Wo das fertige Video landet" unten. Füge eine Version ohne Musik hinzu, wenn sinnvoll, einen kopierfertigen Text aus references/copy.md und den ehrlichen Bericht.

Wo das fertige Video landet

scripts/doctor.py meldet die Umgebung. Beende jedes Video auf diese Weise:

• Claude Code: Schreibe fertige Videos direkt in den Benutzerordner, in output/ innerhalb des Arbeitsordners, sofern kein anderer Ort genannt wird. Gib die vollständigen Pfade an. Der Benutzer sollte nie in _work/ suchen müssen.
• Claude-App: Liefere fertige Videos direkt im Chat aus, als Dateien, die der Benutzer öffnen und aus der Unterhaltung herunterladen kann. Kopiere sie in den Ausgabeordner (/mnt/user-data/outputs, falls vorhanden) und verwende das Dateifreigabe-Tool, falls verfügbar. Halte nicht bei einem Sandbox-Pfad an und verkleinere oder teile keine Datei, es sei denn, die Auslieferung schlägt fehl.

Die DNA

• Ein Thema, vollkommen durchgehalten. Dieselben Schriftarten, Farben, Animationen und Sounds vom ersten bis zum letzten Frame. Jedes Grafik-Element gehört zur Welt des Themas.
• Jedes Grafik-Element trägt einen wahren Witz oder eine wahre Tatsache aus diesem Filmmaterial. Nichts Dekoratives, nichts Generisches. Ein Label mit einem echten Wert auf einem echten Display schlägt jede Standard-Untertitelung.
• Rückbezüge. Baue etwas früh ein und zahle es später aus. Eine Zeile vom Anfang kehrt am Ende zurück.
• Hook in den ersten 2-3 Sekunden mit dem stärksten Moment, kehre dann auf eine Weise zum Anfang zurück, die zum Thema gehört.
• Rhythmus. Schneide auf den Beat, Punch-Zoom auf Pointen, verwende bewegte Übergänge, Shake bei Einschlägen, beschleunige die langweiligen Passagen. Lasse gesprochene Zeilen ganz.
• Untertitel für alle Sprache, Wort für Wort, gestaltet für das Thema. Zensiere nur auf dem Bildschirm Flüche.
• Sounddesign. Jedes Grafik-Element hat seinen eigenen Sound. Musik ändert sich pro Abschnitt, der große Höhepunkt des Tracks trifft den Schlüsselmoment, und Musik duckt sich unter Sprache.
• Klarheit schlägt Dichte. Wenn ein Witz Kontext braucht, den der Zuschauer nicht hat, schneide ihn heraus. Für einen Erstzuschauer müssen Was, Wo, Wann und Wie viel klar sein.

Wahrheitsregeln

• Erfinde niemals eine Tatsache. Alles, was abgeleitet, annähernd oder illustrativ ist, muss zur Bestätigung aufgelistet werden: Daten, Rollen, Zahlen, Preise, Körpergrößen, wer was gesagt hat.
• Liste unsichere Transkriptionszeilen zur Bestätigung durch den Benutzer auf. transcribe.py markiert Wörter mit geringer Konfidenz.
• Illustrative Zahlen, die als echte Ergebnisse gelesen werden könnten, müssen gekennzeichnet oder entfernt werden.
• Lege echten Personen keine Worte als Zitate in den Mund. Schriftliche Witze sind in Ordnung, wenn sie wie Untertitel gelesen werden.
• Frage, bevor du peinliche Momente von Personen einfügst und bevor du Gesichter von Fremden unverpixelt zeigst.
• Behalte offizielle Texte von Sponsoren und Förderern Wort für Wort bei. Wenn es nicht mit ihren Logos übereinstimmt, frage nach, anstatt es zu bearbeiten.
• Überprüfe das Ziel eines QR-Codes und warne den Benutzer, wenn es sich um ein öffentlich bearbeitbares Dokument handelt.

Umgang mit Korrekturen

Setze Feedback exakt um und lasse alles andere unberührt. Behalte die Timeline als Daten bei, sodass eine Änderung nur die betroffenen Segmente neu rendert. Wenn etwas entfernt werden muss, um eine Längenbegrenzung einzuhalten, sage, was du entfernt hast.

Ehrlicher Bericht

Du kannst kein Audio hören oder in Echtzeit sehen. Gib dies jedes Mal in klaren Worten an:

• was du überprüft hast (extrahierte Frames, Dauern, Pegel, QR-Dekodierung);
• was der Benutzer nach Gehör und Augen beurteilen muss (Beatsync, Untertitel-Timing, Mix-Balance);
• was du entfernt hast und was du nicht wie gewünscht tun konntest;
• ob Plattformen das Video aufgrund von kommerzieller Musik stummschalten könnten.

Mitgelieferte Dateien

Datei	Verwendung
scripts/doctor.py	Überprüft Werkzeuge und Abhängigkeiten
scripts/contact_sheet.py	Zeitgestempelte Bildraster zur Überprüfung von Filmmaterial und Renderings
scripts/transcribe.py	Wortgenaues Transkript mit Markierungen für geringe Konfidenz
scripts/captions.py	Wort-für-Wort ASS-Untertitel, auf die Timeline abgebildet
scripts/beats.py	Tempo, Beat-Zeiten und stärkste Einschläge eines Tracks
scripts/sfx.py	Generiert urheberrechtsfreie Soundeffekte
scripts/music.py	Generiert einen einfachen originären Chiptune- oder Pulsmusik- Hintergrund, der loopbar ist
scripts/setup_tools.py	Überprüft und installiert optionale Werkzeuge nach Profil und speichert Whisper-Modelle
scripts/toolbox.py	Szenenerkennung, Ausschnitte, Gesichter, QR, Schriftarten, HTML-Szenen, Stems, Voiceover, Lautstärke, Timeline-Export
scripts/render.py	Timeline-JSON zu finalem MP4, mit optionaler Version ohne Musik
scripts/qa.py	Dauer-, Format-, Größen-, Lautstärke-, ASS- und QR-Prüfungen
scripts/fit_size.py	Komprimiert auf eine Zielgröße oder teilt für die Übertragung
references/brief.md	Fragen, die zu Beginn gestellt werden, und was mit einem leeren Ordner zu tun ist
references/formats.md	Rezepte pro Videotyp
references/themes.md	Wie man ein Thema findet, mit ausgearbeiteten Beispielen
references/pipeline.md	Timeline-Format, Render-Regeln, ASS-Animation-Rezepte
references/tools.md	Welches Werkzeug für welchen Bedarf, inklusive Whisper-Backends
references/environments.md	Unterschiede zwischen Claude Code und Claude-App
references/qa-checklist.md	Prüfungen vor der Auslieferung
references/copy.md	Post-Untertitel und teilbare Nachrichten