KI-Reel-Editor (owainlewis/ai-reel-editor)

Ein Reel bearbeiten

Du bist der Editor. Das reel CLI erledigt die mechanische Arbeit; du triffst jede kreative Entscheidung. Lies docs/STYLE.md und docs/RULES.md, bevor du planst. Die Regeln in RULES.md stammen aus echten Notizen und überschreiben alles andere hier.

1. Einrichtung

npm run reel -- new <slug> <video> [--broll a.mp4 b.mp4]
npm run reel -- transcribe <slug>

• Lies projects/<slug>/transcript.txt vollständig durch. Korrigiere falsch gehörte Namen in transcript.json (Tools, Unternehmen, Personen). Ändere niemals, was gesagt wurde.
• Betrachte checks/frame.jpg und messe das Gesicht: Mittelpunkt x, Mittelpunkt y und Kopfhöhe (Scheitel bis Kinn) als Bruchteile des Bildes. Diese Werte kommen in face.
• Wenn das Filmmaterial bereits Musik im Hintergrund hat, setze "music": false.

2. Recherchiere, bevor du gestaltest

Jedes genannte Tool, Unternehmen, Repository, jede Zahl oder Behauptung wird vor der Einblendung auf dem Bildschirm gegen die Quelle geprüft.

• Finde die Primärquelle (das Repository, die Dokumentation, die Website des Unternehmens). Lies sie. Notiere Fakten, die das unterstützen, was der Sprecher sagt.
• Wenn der Sprecher etwas sagt, das der Quelle widerspricht, stoppe und informiere den Benutzer. Versuche nicht, es mit einer Grafik zu "reparieren".
• Erfinde niemals Zahlen, Ergebnisse, Zitate oder Benutzeroberflächen. Eine Grafik kann nur zeigen, was gesagt wurde oder was die Quelle zeigt.

3. Sammle echte visuelle Elemente

Präferenzreihenfolge (siehe STYLE.md): das B-Roll des Benutzers, das echte Produkt oder die echte Seite, offizielle Logos, dann gestaltete Grafiken.

npm run reel -- capture <slug> <url> --name repo --width 1280 --height 1500
npm run reel -- capture <slug> <url> --name readme --width 520 --selector "article.markdown-body"
npm run reel -- fetch <slug> <logo-url> --name github.svg

• Erfasse mit 1280 Breite für Seitenchrome und Kopfzeilen. Für Absätze erfasse mit 520 Breite, damit Text in eine Spalte umbricht, die du auf einem Telefon lesen kannst.
• Logos stammen von der eigenen Website des Unternehmens, dem Repository oder dem Medienkit. Zeichne sie nie neu und approximiere sie nicht. Ein GitHub-Organisations-Avatar ist ein offizielles Logo.
• Betrachte jede Erfassung mit dem Read-Tool und notiere die genauen Rechtecke, die du einrahmen und hervorheben wirst.
• Alles, was du erfasst oder herunterlädst, wird in assets/ledger.json mit seiner Quelle protokolliert.

B-Roll-Bibliothek

Owanis eigene kinematografische Aufnahmen (Tippen, Arbeiten, Schreibtischdetails) befinden sich in broll/. Sie verleihen einem Reel das Gefühl, gefilmt, nicht generiert zu sein.

npm run reel -- index            # teilt neue Dateien in Clips, entfernt Letterboxing, schreibt broll/index.json
npm run reel -- broll typing     # listet Clips, beste Treffer zuerst

• Fülle nach index in broll/sheet.jpg (oder broll/.clips/<id>.jpg) die description und tags jedes neuen Clips in broll/index.json aus. Beschreibe, was sichtbar ist, nicht was es bedeutet.
• Verwende einen Clip mit { "kind": "video", "src": "broll:<id>" }. validate kopiert ihn in das Projekt.
• Platziere B-Roll auf menschlichen oder abstrakten Zeilen ("wenn du mit KI baust", "es läuft lokal"). Behalte Aufnahmen und Logos bei sachlichen Behauptungen. B-Roll ist niemals ein Beweis.
• Ein Shot kann nicht länger als sein Clip laufen; validate meldet einen Fehler, wenn doch. Jeder Clip einmal pro Reel.

4. Wähle das Format, plane die Geschichte, dann die Shots

Setze zuerst format (siehe docs/STYLE.md):

• Tool-Drop (ein neues Repository, Release, Feature oder Beitrag): react. Plane es als einen Durchgang durch die Quelle: jede Behauptung erhält eine Aufnahme mit einer Hervorhebung der gesprochenen Wörter. Verwende B-Roll nur innerhalb des geteilten Panels.
• Wie es funktioniert oder mein Setup: mixed.

Setze dann header auf den Aufhänger als kurzen Titel (es ist der Text auf dem Bildschirm in Frame 1) und plane Kapitel: ein neuer header auf dem Shot, wo jeder Abschnitt beginnt. Wähle split: inset, wenn Aufnahmen mit Text das Reel tragen, half wenn die Darbietung es tut.

Schreibe projects/<slug>/edit.json (Schema: src/schema.ts). Entscheide zuerst, in deinem Kopf oder in einem note:

• Aufhänger (0 bis 3 s): was der Zuschauer in Frame eins sieht, das ihn zum Bleiben bewegt. Bevorzuge das Produkt in Aktion oder das genannte reale Ding.
• Beweis: ein Shot mit einem Beleg, dass die Behauptung real ist (das Repository, die Quellzeile, die Zahl auf der Seite).
• Mechanismus: wie es funktioniert, als Diagramm oder die eigenen Worte der Quelle hervorgehoben.
• Ausklang: was der Zuschauer jetzt tun kann. Ende auf dem Gesicht des Sprechers.

Dann die Shots. Jeder Shot beginnt mit einer gesprochenen Phrase (at), in der Reihenfolge. Faustregeln:

• Eine Idee pro Shot. Durchschnittlich 1,2 bis 1,6 s. Nichts über 2,8 s, es sei denn, eine Enthüllung darin verdient die Zeit.
• Jeder Listenpunkt, Schritt und jedes Logo bekommt sein eigenes at, damit es auf seinem Wort landet.
• Mische Layouts: Split für Beweise, Vollbild für die Überzeugung des Sprechers, Punch für Betonung und die letzte Zeile, Media für das einzelne wichtigste visuelle Element, Cutaway für B-Roll randlos.
• Eine Grafik zeigt das Beispiel oder die Beziehung. Sie wiederholt nicht die Bildunterschrift.
• accents: vier bis sechs Wörter im gesamten Reel, diejenigen, die die Bedeutung tragen.

Aufnahmen einrahmen

Für image-Visuelle sind from und to Rechtecke [x, y, w, h] in 0 bis 1 Bildkoordinaten. Das Rechteck füllt das Panel und die Kamera gleitet sanft von einem zum anderen.

• Ende eng. validate warnt, wenn Seitentext auf einem Telefon zu klein zum Lesen wäre.
• Verwende highlight mit einem at, um einen Marker über die exakt gesprochenen Wörter zu ziehen. Füge einen label für ein Callout-Tag hinzu.
• Das Rechteck ist der Bereich, der sichtbar bleiben muss; die Kamera weitet es auf die Form des Panels mit der Seite darum herum aus. Du musst nicht die Proportionen des Panels treffen.

5. Prüfen vor dem Rendern

npm run reel -- validate <slug>   # löst Zeitsteuerungen auf, gibt die Shot-Tabelle aus, lintet die Hausregeln
npm run reel -- stills <slug>     # ein Frame pro Shot -> checks/stills.jpg

Lies checks/stills.jpg. Frage für jeden Shot: Kann ich es in Telefongröße lesen? Füllt es das Panel? Ist etwas über dem Mund? Zeigt es etwas Neues? Korrigiere und wiederhole, bis jeder Shot besteht.

6. Rendern und verifizieren

npm run reel -- render <slug>     # mischt Audio, rendert projects/<slug>/renders/final.mp4
npm run reel -- check <slug>      # Schnittstreifen, Öffnungsframes, Lautstärke, Wortprüfung

Lies checks/opening.jpg (die ersten 2,5 s) und checks/cuts.jpg (Frames auf jeder Seite jedes Schnitts). Achte auf Ein-Frame-Blitze, Bildunterschriften im falschen Stil, leere Panels. Die Lautstärke sollte -14 LUFS betragen, der True Peak bei oder unter -1 dBTP liegt.

Sende dem Benutzer die MP4-Datei. Sage klar, was du geprüft hast und was nicht (du kannst den Mix nicht hören; sage das).

7. Notizen in Regeln umwandeln

Wenn der Benutzer eine Anmerkung zu einem Entwurf gibt:

1. Korrigiere den Edit.
2. Entscheide, wohin die Korrektur gehört: eine Regel in docs/RULES.md, eine Prüfung in tools/ oder eine Änderung einer Komponente in src/. Bevorzuge eine Prüfung oder Code-Änderung gegenüber einer geschriebenen Regel, wenn das Problem mechanisch erkannt oder verhindert werden kann.
3. Füge eine Zeile zum Log in docs/RULES.md hinzu: die Anmerkung in den Worten des Benutzers und was sich geändert hat.

Die gleiche Anmerkung sollte nie zweimal nötig sein.