Akuko, von der Geschichte zum Film

akuko – Geschichte zu Film, eine geprüfte Stufe nach der anderen

Diese Datei ist ein Router. Jede Aktion lebt in einer eigenen Datei unter actions/; lade sie bei Bedarf und folge ihr. Implementiere Aktionsverhalten nicht direkt hier. Gemeinsame Regeln befinden sich in lib/:

• lib/state.md – die Projektdatei, Stufen, Statusübergänge, Entscheidungsfaltung. Lies sie, bevor du etwas schreibst.
• lib/hosts.md – Host-Erkennung, was jeder Host kann, der Host-Adapter.
• lib/spend.md – die Ausgabenschwelle und das Kostenbuch (WP-03). lib/providers.md – Anbieter (WP-03).

Das Projektformat ist schema/akuko-project.ts (akuko.json, JSON Schema in schema/akuko-project.schema.json).

---

Jede Aktion beginnt gleich

1. Erkenne den Host (lib/hosts.md §Erkennung): A claude-artifact · B lokal · C ikenga. Führe node --experimental-strip-types hosts/detect.ts --tools <deine VOLLSTÄNDIGE Tool-Liste – jeder geladene und zurückgestellte Tool-Name> aus. Wenn die Ausgabe eine Warnung enthält oder du unsicher bist, behandle den Host als A (Artifact-DB) und erstelle niemals einen Projektordner. Trage das Ergebnis in akuko.json.host ein.
2. Lies das Projekt über den Host-Adapter (readState()); wenn es keines gibt, leite zu intake weiter (oder setup, wenn die Person zuerst konfigurieren möchte).
3. Falte Entscheidungen, die Personen seit dem letzten Lauf getroffen haben (readDecisions() → lib/state.md §Entscheidungsfaltung), bevor du etwas anderes tust.
4. Lade die Aktionsdatei und folge ihr. Schreibe das Projekt nur über writeState(); speichere Dateien nur über storeAsset().

Routing

Wenn die Person sagt…	Lade diese Datei	Zuständig
„akuko einrichten", „konfigurieren", „Budget festlegen", „meine Schlüssel hinzufügen"	actions/setup.md	WP-08
„meine Einrichtung prüfen", „was fehlt", „Diagnose"	actions/doctor.md	WP-08
„aus dieser Geschichte/diesem Drehbuch einen Film machen", „Projekt starten", „Aufnahme"	actions/intake.md	WP-04
„Aufschlüsselung", „Aufnahmeliste", „Aufschlüsselung", „Aufnahmeliste importieren"	actions/breakdown.md	WP-04
„Figuren", „Schauplätze", „Look / Stil", „Bibel"	actions/bible.md	WP-05
„Storyboard", „Skizzenboard", „Beat-Board", „Board"	actions/board.md	WP-21
„Keyframes", „Endgültige Panels", „Keyframes", „Kontinuitätsprüfung"	actions/keyframes.md	WP-22
„Animieren", „Clips erstellen", „Bewegung", „Treatment", „Kamerafahrten"	actions/motion.md	WP-10 · WP-11 · WP-27
„Lippen-Sync", „den Satz sagen lassen", „Lippensynchronisation"	actions/lipsync.md	WP-28b
„Voice-Over", „Musik", „Soundeffekte", „Ton"	actions/sound.md	WP-12
„Animatic", „Filmvorschau", „lass mich sehen", „Rohschnitt", „Zusammenbau"	actions/assemble.md	B-11 (preview gebaut) · WP-13 (Rohschnitt, Bildlock: Stub)
„Exportieren", „an Resolve senden", „gib mir eine Timeline"	actions/export.md	WP-23 (Resolve-Übergabe)
„habe es geprüft", „meine Anmerkungen anwenden", „Prüfung"	actions/review.md	WP-07a
„zeig mir …", „das Board öffnen", „Ansicht"	actions/view.md	WP-07c
„wo stehen wir", „was ist als nächstes", „Status", „was wird es kosten", „Schätzung"	actions/status.md	WP-30 (Gesamtfilmschätzung)

Export übergibt den freigegebenen Film als Timeline plus Medien an DaVinci Resolve. MP4-Master, Kurzfassungen und ein Canva-Deck sind zurückgestellt (Plan Runde 7): Wenn nach einem MP4 gefragt wird, sag das und biete die Übergabe an.

Wenn nichts passt, führe status aus und biete die nächste von dieser Aktion vorgeschlagene Aktion an. Wenn eine Aktionsdatei (oder die angeforderte Route) immer noch Stub (WP-02) sagt, sag der Person, dass es noch nicht gebaut ist, und stoppe – improvisiere nicht. Ein Animatic wird ebenfalls nicht improvisiert: assemble preview ist die gebaute, kostenlose Route für eines (freigegebene Keyframes, die auf die Aufnahmen abgestimmt sind, niemals eine Prüfungseinheit, niemals im Projekt gespeichert).

Stufen

intake → breakdown → sketch → bible → keyframes → motion → sound → assemble → export (0–8, schema/akuko-project.ts#STAGES; das Filmprofil ist profiles/film/profile.json). Eine Stufe wird nur geöffnet, wenn die Stufen davor freigegeben sind (lib/state.md §Stufen).

Prüfungsregeln

Diese gelten auf jedem Host und in jeder Aktion und Ansicht:

1. Nur eine Person genehmigt. Aktionen verschieben Einheiten zu pending-review; nur eine Entscheidung einer Person verschiebt eine Einheit zu approved. Keine Aktion oder Ansicht genehmigt automatisch, macht Vorauswahlen oder stapelgenehmigt.
2. Nie automatisch über die Prüfung hinausgehen. Jede Stufe endet an einem Prüfungs-Gate (Atelier ux_mode: approve): ausführen, dann auf das Erstellte warten.
3. Eine Einheit nach der anderen innerhalb einer Stufe: erstellen, zeigen, warten – regeneriere nicht die gesamte Stufe, weil eine Aufnahme zurückgeschickt wurde.
4. Entscheidungen gehen durch das Entscheidungsformat (Decision im Schema), das von einer Prüfungsoberfläche in den Speicher des Hosts geschrieben wird. Eine Ansicht bearbeitet niemals akuko.json und ruft niemals writeState() auf.
5. Angeforderte Änderungen werden umgesetzt, dann markiert: überarbeite die Einheit, füge einen Kommentar „Überarbeitet: …" hinzu, gib sie an pending-review zurück.

Ausgabenregeln

1. Kein kostenpflichtiger Aufruf ohne OK. Jeder kostenpflichtige Auftrag (Bild, Video, TTS) durchläuft die Ausgabenschwelle (lib/spend.md): zeige die Schätzung, die Obergrenze, was ausgegeben wurde und was übrig ist, wenn du genehmigst, warte dann auf eine explizite Genehmigung dieses Auftrags.
2. Keine Obergrenze, keine Ausgabe. Wenn akuko.json.budget null ist, lehne kostenpflichtige Aufträge ab und verweise auf setup.
3. Nie die Obergrenze oder ein approved_max eines Auftrags überschreiten; stattdessen anhalten und fragen.
4. Geld wird niemals versteckt oder gerundet. Jeder kostenpflichtige Aufruf wird im ledger[] aufgezeichnet, ob erfolgreich oder fehlgeschlagen.
5. Schlüssel bleiben in der Umgebung (oder dem Geheimnisspeicher des Hosts) – niemals in akuko.json, einer Ansicht, der Artifact-Datenbank, dem Buch oder einer Datei, die das Board lesen kann, und niemals zurückgemeldet. Auf claude.ai (Host A) wird ein Schlüssel pro Chat eingefügt, und nur, wenn ein kostenpflichtiger direkter Aufruf kurz bevorsteht: überprüfe zuerst das Netzwerk (scripts/probe.ts), sage der Person, dass der Schlüssel im Verlauf dieses Chats sichtbar sein wird, nur für diesen Chat verwendet wird und niemals irgendwo geschrieben wird, erhalte „verwende meinen Schlüssel für diesen Chat", setze ihn dann nur in der Umgebung dieses Befehls, reserviere, speichere im Board, sende (lib/spend.md §Host A, R-11).
6. Hausregeln gehen vor Geld. Wenn das Projekt rules hat, wird jeder Auftrag vor der Ausgabenschwelle daraufhin überprüft, und ein Verstoß wird abgelehnt (rules-breach), unter Nennung der Regel und des anstößigen Textes oder der Datei. Melde es und stoppe; formuliere niemals um, lasse einen Verweis weg oder bearbeite die Regeln, um daran vorbeizukommen. Führe rules/cli.ts check für eine kostenlose Vorabprüfung aus (lib/state.md §„Regel-Wächter (WP-26)").
7. Ein Plan-Kontingent ist auch eine Ausgabe. Ein verbundenes Tool, das das eigene Plan-Kontingent der Person anstelle von Geld verwendet (Canvas monatliches KI-Limit auf claude.ai), erhält eine OK für jede Welle: die Anzahl, den Dienst, dass akuko nicht sehen kann, was übrig ist, und die genaue Antwort genehmige <n> <dienst> Generationen. Jede Generation kommt in das Buch mit null Geld und einer Stückzahl (lib/spend.md §Kontingent).

Hosts in einem Satz

• A — claude-artifact (claude.ai): Node und Dateien nur in einem entfernten Arbeitsbereich, der einen Chat dauert, also kein dauerhafter Projektordner. Das Projekt lebt in der Datenbank des Board-Artifakts; der Agent liest und schreibt es mit Tool-Aufrufen und führt die Stufenbefehle auf einer Arbeitskopie aus. Generierung über verbundene MCPs (z. B. Canva), manuelle Prompt-Pakete und kostenpflichtige direkte APIs mit einem für diesen Chat eingefügten Schlüssel (R-11, nach einer Netzwerküberprüfung); MP4-Renderings lokal.
• B — lokal (Claude Code): akuko.json auf der Festplatte, Dateien im Projektordner, alle Anbieter über Umgebungsschlüssel, HyperFrames + FFmpeg.
• C — ikenga: B plus die Ikenga-Brücke (und Studio, wenn sein MCP verbunden ist); Studio besitzt den Render-Status.

Details und der Fähigkeitsnachweis: lib/hosts.md.

Dateien

SKILL.md              Dieser Router
actions/*.md          Eine Datei pro Aktion (Atelier-Frontmatter)
lib/state.md          Projektdateiregeln, Stufen, Übergänge, Entscheidungsfaltung
lib/hosts.md          Host-Erkennung, Fähigkeiten, manuelle Host-Überprüfung
hosts/types.ts        HostAdapter-Vertrag (G-HOST)
hosts/{claude-artifact,local,ikenga}.ts   Ein Adapter pro Host
profiles/film/        Das Filmprofil
schema/               akuko.json-Format (G-SCHEMA)