Multi-Video-Varianten
Wandelt EINEN freigegebenen Master in N Ausgaben um, ohne die Kontrolle darüber zu verlieren, welche Datei von welchem Quellzustand stammt. Es verwaltet die Variantenmatrix, den Master-Freeze, die Neuanordnungs-Kopien, den gemeinsamen Mix, die Benennung, die Warteschlange für einen Render-Vorgang gleichzeitig, die Agenten-Überwachungsregeln und das Manifest-Gate. Es entwirft nicht den Master (das macht die Type-Skill) und ersetzt nicht die Datei-QA (render-qa-deliver).
Regeln, die dem Rest dieser Datei vorgehen
- Master zuerst, dann eingefroren. Abgeleitete Werke werden nur aus einem Master erstellt, der seine eigene vollständige QA bestanden hat und mit
manifest_check.py freezeaufgezeichnet wurde. Ein später erforderlicher Fix wird im MASTER vorgenommen, mitchangeprotokolliert, in jeder Kopie derselben Runde übernommen, und jedes abgeleitete Werk wird neu gerendert und neu aufgezeichnet. Das Reparieren nur einer Kopie ist verboten. - Neu anordnen, niemals zuschneiden. Jedes Seitenverhältnis ist eine Kopie der Masterquelle (
hf_9x16/,hf_1x1/...) mit eigener Leinwand, Sicherheitszonen, Schriftskalierung, Untertitelspur, Kamerakeys und Gesichtszentrierung. Ein FFmpeg-Zuschnitt oder eine Skalierung eines gerenderten Masters ist keine Variante. - Ein Mix. Neuanordnungen und Hook-Varianten verwenden dieselbe
cues.jsund dieselbenassets/mix.wav-Bytes und werden aus dieser einen Datei gemuxt; Audio wird nicht pro Variante neu aufgebaut. Eine Variante, die wirklich ihren eigenen Mix benötigt (keine Musik, eigene Voice-Over, andere Länge), deklariert dies im Manifest mit einem Grund. - Ein schwerer Job gleichzeitig auf der gesamten Maschine (Render,
check, Matte, ASR, Blender) unterrender_lock. Parallele Arbeit ist auf nicht-schwere Aufgaben beschränkt (Layout, Spezifikation, QA lesen). Maximal 4 Agenten parallel, jeder mit maximal 2 Unter-Agenten. - "Bereit" wird berechnet, nicht behauptet. Das Wort ist nur erlaubt, wenn
manifest_check.py checkmit 0 beendet wird. Ein Timeout, leerer Ordner, fehlender Hash,qa: not_runoder fehlende Beweise istblocked/INSUFFICIENT_EVIDENCE, niemalspass. - Keine kostenpflichtige Aktion ohne
paid-generation-gate; niemals eine andere Claude-Sitzung benachrichtigen; Benutzer- und Projekteinschränkungen überschreiben dieses Verfahren. Sicherheitszonen, -14 LUFS und Leinwände sind Hauspreset v1 (Entscheidungsstandard Q5), keine Plattformvorschrift.
Eingaben -> Ausgaben
Ein: freigegebener Master (hf/, PROMPT.md, DESIGN.md, cues.js, assets/mix.wav) und die Variantenmatrix aus der Aufnahme. Aus: final/<name>_<platform>_<hook>_<aspect>.mp4 x N, final/manifest.json (nur Finals + Manifest), Datei-QA-Berichte unter _work/qa/<aspect>/<round>/, _work/agents/<agent>.progress.md, _work/STATE.md (Warteschlange).
Benennung: <name>_<platform>_<hook>_<aspect>.mp4, <name> ein Kleinbuchstaben-ASCII-Slug (Unterstriche erlaubt), <platform> = meta|tiktok|yt|ig|linkedin|x|all, <hook> = master | hookA | hookA-nomusic | hookA-nocaps, <aspect> = 9x16|4x5|1x1|16x9. Auch akzeptiert: die kurze Pro-Verhältnis-Form <name>_<aspect>.mp4 (Plattform all, Hook master, wie im Auslieferungs-Playbook). Ein Name, den der Benutzer im Ledger angefordert hat, überschreibt die Konvention und wird mit seiner Ledger-ID aufgezeichnet (record --name-ledger-id).
Verfahren
| # | Stufe | Aktion | Artefakt |
|---|---|---|---|
| 0 | Matrix bei Aufnahme | eine Ledger-Zeile pro Datei: Seitenverhältnis, Plattform, Route (organisch / Werbung / Spark), Hook, Version (voll, kein Musik, keine Untertitel, Länge), Master-Seitenverhältnis. Späte „Vielleicht“-Verhältnisse: Layout-Notizen jetzt schreiben, damit eine späte Anfrage ein Agent ist, kein Neubau (references/variant-matrix-and-layout.md) | Matrix in PROMPT.md <inputs>; matrix-Liste im Manifest |
| 1 | Master-Gate | Master freigegeben, render-qa-deliver Alle-Frames-QA bestanden, manifest_check.py freeze <project> --hf hf --matrix ... | eingefrorene src_hash + mix_sha256 |
| 2 | Neuanordnungs-Kopien | ein Agent pro Seitenverhältnis auf einer KOPIE; gleiche Cues und Mix; Layout-Tabelle füllen (was hat sich pro Element geändert, references/variant-matrix-and-layout.md); Preflight 0 Fehler; Snapshot-Overlay bei Hook, Angebot, Endkarte (--describe false, maximal 5 Zeitstempel pro Aufruf) | hf_<aspect>/, _work/qa/<aspect>/layout.md |
| 3 | Hook-/Versionsvarianten | Hook = Sub-Komposition gebunden an Variablen in der Kopie des Seitenverhältnisses, eine Zeile pro Variante; EINE Variation zuerst testen (Batch-Variablen sind in einem Projekt ungetestet); den gemeinsamen Mix muxen; kein Musik / keine Untertitel = deklarierte Mix- oder Layer-Varianten | rows.json, Variantendateien |
| 4 | Warteschlange | die Render-Reihenfolge in _work/STATE.md schreiben (Master, dann jedes Seitenverhältnis, dann Varianten); manifest_check.py stamp VOR jedem Render; Rendern durch hf_deliver / render_lock run einzeln nacheinander; ein Render-Besitzer startet nie einen zweiten schweren Job | Sperrprotokoll, Stempel |
| 5 | Aufzeichnen | nach jedem Render: record (Hashes, angewendete Master-Fixes, Mix-Variante, QA-Status, Lautstärke gemessen an der ENDGÜLTIGEN Datei) | manifest.json |
| 6 | Pro-Ausgabe-QA | frame_qa, caption_qa --band <top>:1450 (9:16), motion_qa wenn Layout Bewegung geändert hat, face_center audit für Sprechermaterial, qa delivery; visuelle Überprüfungsachsen 1 (Komposition/Zuschnitt) und 4 (Lesbarkeit) nur; Achsen 2-3 vererbt, es sei denn, Bewegung hat sich geändert | Berichte + Beweispfade |
| 7 | Bereit-Gate | manifest_check.py check <project> --json beendet mit 0; dem Benutzer die Dateiliste mit Quell-Hash, QA-Status, LUFS/TP anzeigen; Lücken ehrlich auflisten | BEREIT-Bericht |
| 8 | Lernen | Timing-Ledger-Zeilen pro Datei, Lektionen für den Posteingang | _work/timing_ledger.jsonl |
Gates
Zustände sind pass | fail | blocked | n/a mit einem Grund. Ein Timeout, leeres Sample oder fehlende Eingabe ist blocked, niemals pass. Ein erfolgreicher Tool-Aufruf ist Ausführungsbeweis; ein betrachteter Render ist Erscheinungsbeweis.
| Gate | Prädikat | Beweis | Wenn falsch | Besitzer | Erneut prüfen wenn |
|---|---|---|---|---|---|
| G1 Matrix | jede Ausgabe hat eine Ledger-Zeile (Seitenverhältnis, Plattform, Route, Hook, Version) vor jedem Bau | matrix in PROMPT.md und Manifest | fehlende Achse jetzt erfragen; nicht bauen | diese Skill + video-intake | jede neue Verhältnis-/Variantenanfrage |
| G2 Master eingefroren | Master hat vollständige QA bestanden; freeze aufgezeichnet; kein abgeleitetes Werk früher gestartet | Manifest master.src_hash, frozen_utc älter als jeder Stempel | Ableitungen stoppen; einfrieren | diese Skill | jede Master-Quelländerung |
| G3 Neu anordnen | jedes abgeleitete Werk hat eigene Wurzel-Leinwand, Layout-Zeile pro Element, Sicherheitszonen seines Seitenverhältnisses; kein zugeschnittener Master-Render | layout.md-Zeilen + Overlay-Snapshots + Preflight 0 E | das fehlschlagende Element neu anordnen; nicht das gesamte Bild skalieren | der Agent des Seitenverhältnisses | Master-Layout-Änderung, neue Kopie |
| G4 Gemeinsame Assets | cues.* und assets/mix.wav identisch zum Master in jeder Neuanordnungs-/Hook-Kopie; Hook-Varianten muxen, nicht neu mischen | manifest_check.py check: kein M035/M041 | Master-Cues/Mix zurück kopieren; neu rendern | diese Skill | Master-Cue- oder Mix-Änderung |
| G5 Pro-Ausgabe-QA | jede Datei qa: pass mit einer Beweisdetei und LUFS -14 +/- 0.5, TP <= -1 auf der endgültigen Datei (Haus-Gate) | qa_evidence-Pfad, lufs, tp-Zahlen im Manifest | NUR diese Datei reparieren und neu rendern | render-qa-deliver | jedes Neu-Rendern |
| G6 Schwere-Job-Disziplin | genau ein schwerer Job gleichzeitig; <= 4 Agenten, jeder <= 2 Unter-Agenten, jeder mit Dateiliste, Ausgabedatei, Frist, Fortschrittsdatei | render_lock-Protokoll; _work/agents/*.progress.md-Änderungszeiten | einreihen, den zusätzlichen Job stoppen (nur eigener Prozessbaum) | diese Skill | jeden Agentenstart |
| G7 Manifest bereit | veraltet / verwaist / fehlend / nach Render geändert alles abwesend | manifest_check.py check Exit 0 | dem Benutzer die fehlschlagenden Dateien auflisten; die veralteten neu rendern | manifest_check.py | bevor „bereit“ gesagt wird, nach jeder Änderung |
Zahlen (Hauspreset v1, datiert 2026-10-02, Details in references/house-presets.md)
- Leinwände: 9:16 1080x1920, 4:5 1080x1350, 1:1 1080x1080, 16:9 1920x1080; H.264 SDR yuv420p, AAC 48 kHz, 30 fps Standard.
- Sicherheitszonen, Schlüsseltext/CTA/Logo/Preis: 9:16 oben 300 / unten 672 (y <= 1248) / links 140 / rechts 192, Untertitelspur unten <= y 1450; 16:9 x <= 1824, oben 54, unten 162; 4:5 und 1:1 54 px jede Seite. Unverifiziert auf Geräten: die Overlay-Übung durchführen.
- Lautstärke: -14 LUFS integriert +/- 0.5, True Peak <= -1 dBTP, gemessen an der endgültigen Datei; Mix-Zwischen-TP <= -1.5.
- Überwachung: Herzschlag-Check etwa alle 15 Min.; still oder über Frist für 20 Min. = überprüfen, ersetzen oder stoppen; Statuszeile an den Benutzer etwa alle 10 Min. Stille; Render-Timeout 3 x die gemessene ETA. (Quelle: distilled 02 workflow §13.6, 2026-10-01)
Entscheidungsregeln
| Wenn | Dann |
|---|---|
| ein Master-Fix nach Existenz von Ableitungen nötig ist | den MASTER reparieren, change, den Patch auf jede Kopie übertragen, alle neu rendern und neu aufzeichnen |
| eine Kopie andere Timing oder Cues benötigt | das ist eine Master-Änderung; oder ein neuer Schnitt (recut) mit eigenen Ledger-Zeilen, niemals eine stille Abspaltung |
| ein Hook eine andere gesprochene Zeile benötigt | own-vo mit Grund deklarieren; jede andere Variante bleibt auf dem gemeinsamen Mix |
| ein Verhältnis spät angefordert wird | die Layout-Tabelle schreiben, EINEN Agenten auf eine Kopie des eingefrorenen Masters starten; den Master nicht anfassen |
| zwei Render gleichzeitig angefragt werden | sie einreihen; die Sperre entscheidet; die Reihenfolge in STATE.md schreiben |
| ein Agent über seine Frist still ist | seine Fortschrittsdatei prüfen, dann ersetzen oder stoppen (nur eigener Prozessbaum), dann render_lock status |
| der Finals-Ordner einen alten Render enthält | ihn nach _work/delivered/v<N>/ verschieben; „bereit“ ist blockiert, bis der Ordner mit dem Manifest übereinstimmt |
| der Benutzer die Dateien benennt | ihr Name gewinnt; mit --name-ledger-id aufzeichnen und Plattform/Hook/Seitenverhältnis-Felder explizit halten |
Blockierte Zustände (melden, nicht umgehen)
manifest_check.py BLOCKED oder INSUFFICIENT_EVIDENCE; ein abgeleitetes Werk mit veraltetem from_master oder fehlendem Master-Fix; eine nach Render geänderte Quelle; abweichende gemeinsame Cues oder Mix; qa nicht pass; eine versprochene fehlende Variante; eine ungeplante vorhandene Datei. Sage welche Datei, welcher Code und der Fix.
Fallstricke, die jeweils echte Zeit kosten
Späte 16:9-Anfrage bei Auslieferung (eine vollständige Neuanordnung, fallengelassen); ein Master-Fix von 3.7 s nicht auf das 1:1 übertragen; ein alter Render neben den neuen stehengelassen und niemand hat es gemeldet; ein Ableitungs-Agent, der einen Master-Fehler fand und nur seine Kopie reparierte; drei Agenten, die gleichzeitig rendern (ein paralleler Blender-Job verdoppelte einen Render, 11.5 auf 21.5 Min., Laptop des Besitzers); Namenskonflikte zwischen Meta- und TikTok-Schnitten; eine Hook-Variante, die still einen anderen Mix trug. Ein betrachtetes Kontaktblatt jedes Seitenverhältnisses wird dennoch benötigt: Hashes können keine Untertitel auf einem Gesicht sehen.
Referenzen (laden wenn)
references/variant-matrix-and-layout.md- Schreiben der Matrix, Neuanordnen eines Seitenverhältnisses, Hook/kein Musik/keine Untertitel/Längen-Varianten.references/manifest-schema.md- Dateien aufzeichnen,manifest_check.py-Ergebnisse lesen, der Lebenszyklus veralteter Ableitungen.references/parallel-and-agents.md- Agenten starten, Warteschlange, Sperre, Herzschläge, Stoppen, Token-Budget.references/house-presets.md- bevor Leinwand-, Sicherheitszonen-, Lautstärke- oder Plattformnummern zitiert werden (datiertes Modul).agent-content/references/platform-specs.md(kanonische Plattformfakten, anderswo verwaltet) undagent-content/playbooks/wf-08-deliver.md(Auslieferungs-Playbook: Benennung, Manifest-Regeln) - Export-Presets und das Playbook; wenn eine Zahl abweicht, gewinnt die kanonische Datei undreferences/house-presets.mdwird aktualisiert.- Andere Skills:
render-qa-deliver(Datei-QA),hebrew-captions-asr(Untertitelspur),edit-ad-promo(Hook-Ranking),revision-round(Notizen über Seitenverhältnisse hinweg),paid-generation-gate. - Skripte:
scripts/manifest_check.py(--self-check29 Fälle, Exit 0 READY / 1 BLOCKED / 2 INSUFFICIENT_EVIDENCE) undscripts/test_manifest_check.py(Unittest).