gallowforge/forge-story

FilmForge Story

Die Geschichte steht an erster Stelle: Nichts wird gemalt, vertont oder gekauft, bis der Film auf dem Papier existiert, sekundengenau getaktet und auf das Kreditbudget abgestimmt. Dieser Skill schreibt drei Dateien: story-bible.md, screenplay.md, shotlist.yaml (Vorlagen in templates/). Die Phase ist abgeschlossen, wenn die Einstellungsliste validiert ist und ihr Plan in die Credits passt.

Pfade: scripts/, templates/ und config/ unten sind Ordner innerhalb dieses Skills (das Basisverzeichnis, das beim Laden angezeigt wird), die von ./install.sh dort abgelegt werden. Bei Arbeit von einem Klon des Repositorys befinden sie sich als tools/, templates/ und config/ in dessen Stammverzeichnis.

Schritt 1. Prämisse und These

• Prämisse: Ein Satz, wer was will und was es ihn kostet.
• These: Ein Satz, den das Ende beweist.

Wenn einer von beiden zwei Sätze benötigt, ist die Geschichte noch nicht gefunden. Arbeiten Sie hier weiter; alles Nachgelagerte erbt dies.

Schritt 2. Das Herz: sechs Motoren

Große kurze Animationsfilme tun immer die gleichen wenigen Dinge. Füllen Sie jede Zeile; ein Film, der keine Zeile füllen kann, fehlt ein Teil.

Motor	Test
Eine Beziehung	Zwei Figuren, um die es im Film geht. Alle anderen dienen ihnen.
Ein Fehler, mit einem Preis	Der Fehler des Helden kostet jemandem etwas Reales, auf dem Bildschirm.
Eine Wahl, die das Herz bricht	Der Held gibt auf, was er wollte, durch eigene Hand.
Eine Wendung	Was das Publikum glaubte, ist nicht die Wahrheit, und die Wahrheit wurde vorbereitet.
Ein Spiegel	Ein Bild, das früh lügt und spät die Wahrheit sagt.
Ein Bild, zweimal	Eine Komposition eröffnet und schließt den Film, verändert durch alles dazwischen.

Ausführliches Beispiel (Die Laternenmotte, das Textbeispiel des Repositorys, 36 s): eine Beziehung, ein Leuchtturmmädchen und die Glutmotte, das erste warme Wesen, das sie den ganzen Winter über gehalten hat. Ein Fehler mit einem Preis: Sie will die Wärme behalten, und während sie sie festhält, treibt das Boot auf die Felsen zu. Eine Wahl: Sie öffnet ihre Hände in Richtung der toten Lampe und lässt die Motte hinein. Eine Wendung: Die Motte brennt nicht aus; im Morgengrauen ist das Lampenglas mit hundert kleinen Glutmotten bedeckt. Ein Spiegel: Ihre Spiegelung im Lampenglas, allein und von der Motte erleuchtet, dann verloren im Lichtschein. Ein Bild, zweimal: Der tote Leuchtturm in der Nacht eröffnet den Film, der warme Leuchtturm im Morgengrauen schließt ihn.

Schritt 3. Setups und Payoffs

Eine Tabelle, in der nichts nur einmal vorkommt. Jede Zeile: Was wird vorbereitet (Einstellung), was wird aufgelöst (Einstellung). Wenn ein Bild keine Auflösung hat, schneiden Sie es oder geben Sie ihm eine. Zeilen aus Die Laternenmotte: die tote Lampe im ersten Bild / dasselbe Bild im Morgengrauen, die Lampe warm; die leere Laterne, die sie überallhin mitnimmt / sie bleibt auf dem Boden liegen, sobald die Motte weg ist; eine Motte auf ihrer Fingerspitze / hundert Motten auf dem Glas; kein warmes Gold irgendwo / der Lichtstrahl leuchtet gold.

Schritt 4. Das Farbskript

Eine Zeile pro Szene: Zeitbereich, 3 bis 5 Farben, das Gefühl. Fügen Sie die Regeln hinzu, die Bedeutung tragen („kein warmes Gold, bevor die Lampe angezündet ist“, „die einzige warme Farbe, bevor die Lampe angezündet ist, ist das Orange der Motte“, „kein Blau am Himmel bis zum Morgengrauen“). Regeln werden zu forbid-Einträgen im Kontinuitätsprotokoll, gemessen an jedem Gemälde.

Schritt 5. Das Drehbuch, zeitlich getaktet

• Szenen mit Zeitbereichen; Einstellungen mit Start, Länge, Bildausschnitt und nur dem, was eine Kamera fotografieren kann, im Präsens. Ein Beat, der nicht fotografiert werden kann, ist nicht im Film.
• Unter jeder Szene, was die Musik tut (Instrumente, Energie, ein benannter Treffer, eine geschriebene Stille). Das Drehbuch der Laternenmotte setzt unter „Die Dunkelheit“: „ein tiefer Drohnton, ein sanfter Kick zu jedem Takt. Kalt und einsam.“ Und unter „Das Licht“: „der Treffer bei 0:24, dann warme volle Akkorde“. Wenn die Musik bereits existiert (ein Lied, ein Klavierstück), geht die Geschichte der Reihe nach durch ihre Abschnitte, eine Stimmungszeile unter jedem, und die Einstellungen oder Seiten wechseln mit ihr.
• Worte: Sage nur, was die Bilder nicht können (wer spricht, warum sie gehen, wer stirbt, was das Ende bedeutet). Wortlosigkeit ist eine Stärke: Sie spielt zu jedem überall. Erzählung wird von Hand auf den Bildschirm geschrieben oder gesprochen; in beiden Fällen wird sie später in Filmzeit getaktet (forge-sound).

Schritt 6. Den Film auf die Credits zuschneiden

paint_credits = credits x 0.95 - sheets - plates - proofs - score
paintings     = floor(paint_credits / (price x 1.3))        # 1.3 = Der Nachmal-Puffer
runtime       = paintings x average hold                     # Gemalte Halte: 4 bis 6 s pro Stück

Ausführliches Beispiel: 70 Credits (66,5 ausgabefähig), zwei Blätter und eine Platte (8,25, etwa 11,8 mit Puffern), eine 64 s lange Partitur (9,28): etwa 45,4 übrig für Gemälde, also 12 Gemälde zu 2,75 mit dem Puffer: ein 60-Sekunden-Film bei 5 s pro Halt. Die Laternenmotte hat 6 Einstellungen in 36 s; budget.py plant es bei 39,08 von 66,50 ausgabefähig, mit 27,42 übrig nach dem, was bereits ausgegeben wurde: Platz für 7 weitere Gemälde mit Wiederholungen.

Regeln beim Zuschneiden:

• Heldenbilder zuerst: Nennen Sie die 2 bis 4 Einstellungen, die die Leute etwas fühlen lassen müssen. Sie werden vor allem anderen als Proofs gemalt.
• Echte Bewegung nur dort, wo nichts anderes funktioniert (Flug, eine Verwandlung, die der Höhepunkt ist). Ansonsten Schlüsselposen, die schnappen (poses: 2) und Leben im Schnitt.
• Verwenden Sie eine Platte oder ein Gemälde wieder, wo die Geschichte es erlaubt (kind: reuse): Der Bild-zweimal-Motor ist kostenlos.

Schritt 7. Die Einstellungsliste

Schreiben Sie shotlist.yaml (Schema: references/shotlist-schema.md). Jede Einstellung: id, scene, dur, kind, framing, beat, characters, refs (jedes Figurenblatt), cut_on, und wo die Musikbeschreibung einen Story-Treffer nennt, pin. Dann:

python3 scripts/shotlist.py validate shotlist.yaml
python3 scripts/budget.py shotlist.yaml --production production.yaml

Wiederholen, bis validate keine Fehler mehr anzeigt und budget FITS sagt. Warnungen, auf die reagiert werden muss: gemalte Halte unter 1,5 s oder über 10 s, Erzählung schneller als 2,4 Wörter pro Sekunde, eine Figur im Bild ohne ihr zugehöriges Blatt.

Ausgabeformat

1. story-bible.md: Prämisse, These, die sechs Motoren, Welt, Figuren (Handle, Aussehen, Wollen, Bewegung), Requisiten und Zustände, Setups und Payoffs, Farbskript, Produktionsregeln.
2. screenplay.md: Szenen mit Zeiten, Musiknotizen, Einstellungen mit Start, Länge, Bildausschnitt, Handlung, Worten.
3. shotlist.yaml: Validiert, passt.
4. Ein kurzer Bericht: Laufzeit, Einstellungsanzahl, geplante vs. verfügbare Credits, die Heldenbilder, das eine Risiko.

Gate-Checkliste

• Prämisse und These sind jeweils ein Satz
• Alle sechs Motoren ausgefüllt; jedes Setup aufgelöst
• Farbskript mit seinen Regeln
• Jede Einstellung fotografierbar; jeder Beat unter seiner Musik
• shotlist.py validate: Keine Fehler
• budget.py: FITS, Reserve unberührt
• Heldenbilder benannt

Reparaturtabelle

Symptom	Behebung
Das Ende sitzt nicht	Die Wahl fehlt oder wird für den Helden getroffen; oder die Wendung wurde nicht vorbereitet. Überprüfen Sie die Motoren 3 und 4 erneut
Es fühlt sich an wie eine Dia-Show	Beats beschreiben Zustände, keine Handlungen; schreiben Sie jeden Beat als etwas, das sich im Bild ändert
Über Budget	Weniger, längere Halte; Platten wiederverwenden; Schlüsselposen statt Video; dann Einstellungen der Priorität 3 streichen
Erzählungs-Warnungen	Weniger Worte, oder lassen Sie die Zeile über den nächsten Schnitt laufen (Erzählung lebt in Filmzeit)
Figuren lesen sich nicht als dieselben Leute	Kein Story-Fehler: forge-style-lock (Blätter, Anker, Maßstabsverriegelungen)

Referenzen

• references/story-engine.md: Die sechs Motoren detailliert, mit Aufschlüsselung der Laternenmotte
• references/shotlist-schema.md: Jedes Einstellungslisten-Feld, seine Werte und welches Tool es liest