StoryForge Workflow-Beispiel

English Version

Zurück zur StoryForge-Hauptseite

Überblick

Diese Seite zeigt einen Standalone-Roman im StoryForge-Workflow, von der Einrichtung bis zum EPUB. Das Beispiel-Buch ist „Der Leuchtturmhüter“, ein fiktiver Roman.

Figuren, Handlung und Autoren-Persona sind erfunden. Die Seite zeigt nicht, wie du ein bestimmtes Buch schreibst, sondern in welcher Reihenfolge du die Skills einsetzt. Die Ausgaben sind gekürzt und beispielhaft, die genauen Texte der Skills weichen ab.

Schreibst du eine Serie? Dann lies zusätzlich das Series-Workflow-Beispiel für Serienaufbau, Buchabschluss und das Onboarding des nächsten Bands.

Eckdaten:

Phase 0: Einrichtung (einmalig)

claude plugin add storyforge
/storyforge:setup

/storyforge:setup legt die virtuelle Umgebung unter ~/.storyforge/venv an, installiert die Abhängigkeiten, erzeugt die Verzeichnisse ~/.storyforge/cache und ~/.storyforge/authors, kopiert die Konfigurationsvorlage nach ~/.storyforge/config.yaml, prüft Pandoc (und optional Calibre für MOBI) und die MCP-Verbindung. Details: Installation.

Danach passt du ~/.storyforge/config.yaml an. Für dieses Beispiel:

paths:
  content_root: "~/books"
  authors_root: "~/.storyforge/authors"

defaults:
  language: "de"
  book_type: "novel"
  review_handle: "Maja"   # Präfix deiner Inline-Kommentare im Entwurf

export:
  default_format: "epub"

Alle Schlüssel erklärt die Seite Konfiguration.

Phase 1: Autorenprofil

/storyforge:create-author

Der Skill fragt in Phasen. Bei Fiction sind das:

1. Identität: Pen Name, Genres (aus list_genres, bis zu drei), literarische Vorbilder, Muttersprache und Schreibsprache
2. Stimme: Erzählperspektive, Tempus, Ton (zwei bis vier Deskriptoren aus einer festen Liste), Satzstil, Vokabular-Niveau, Dialogstil, Tempo und der Schreibmodus (Outliner, Plantser oder Discovery Writer)
3. Tiefe: wiederkehrende Themen, was der Autor nie tut, seine typischen Kniffe

Nach deiner Bestätigung legt der Skill das Profil an, trägt die abgefragten Werte nach und zeigt die vorbelegte Liste verbotener Wörter zum Anpassen. Ergebnis: ~/.storyforge/authors/maja-sundberg/profile.md und vocabulary.md. Aufbau und Wirkung der Felder stehen unter Autorenprofile.

Stil-Extraktion (optional)

Hast du eigene Werke, analysiert study-author sie und schreibt die gefundenen Stilmuster ins Profil:

/storyforge:study-author ~/books/werke/die-insel-bei-nacht.epub maja-sundberg

Die Datei muss unter content_root oder authors_root liegen (hier ~/books beziehungsweise ~/.storyforge/authors). Das Werkzeug extract_text_from_file weist Pfade außerhalb davon ab. Kopiere ein Werk aus einem anderen Ordner also vorher dorthin.

Der Skill fragt die Quellgenres ab, stellt eine Checkliste positiver Marker aus den Genres und dem Ton des Autors zusammen, wartet auf deine Bestätigung und analysiert erst dann. Für das Beispiel nehmen wir an, dass Maja neu beginnt.

Phase 2: Brainstorm (optional)

Ist die Idee noch vage:

/storyforge:brainstorm

Im Fiction-Modus läuft der Skill in vier Phasen: Seed, Explore, Develop und Save. Provokante „Was wäre, wenn?“-Fragen schärfen die Idee, am Ende speichert er sie als Idee in {content_root}/ideas/ (Status zum Beispiel raw, developed oder ready). Die gespeicherten Ideen verwaltest du mit /storyforge:ideas. Zum Anlegen des Buchs führt der Skill auf /storyforge:new-book --from-idea {slug}.

Phase 3: Buch anlegen

/storyforge:new-book --from-idea der-leuchtturmhueter

Der Skill übernimmt Titel, Genres und Logline der Idee und fragt nach, was fehlt: Kategorie (Fiction oder Memoir), Genres, Buchtyp, Autor, Perspektive und Tempus, Sprache, Zielwortzahl. Beim Schreibmodus zeigt er den Standard des Autors und fragt, ob er für dieses Buch abweichen soll. Danach legt er das Projekt an, erzeugt die Buch-CLAUDE.md, setzt das Buch als aktives Buch in der Session und markiert die Idee als übernommen.

Das Verzeichnis {content_root}/projects/der-leuchtturmhueter/ enthält danach unter anderem:

README.md          # Buch-Metadaten im Frontmatter
CLAUDE.md          # Buch-Regeln und Kontext
synopsis.md
plot/
characters/        # INDEX.md
world/
chapters/
research/
cover/
export/

Das README-Frontmatter trägt unter anderem title, slug, author, genres, book_type, book_category, status: "Idea", language, target_word_count und series. Das Feld author_writing_mode steht beim Anlegen nicht darin: Es erscheint erst, wenn du für das Buch vom Autor-Standard abweichst. Die vollständige Struktur steht unter Technische Details.

Phase 4: Konzept

/storyforge:book-conceptualizer der-leuchtturmhueter

Fünf Phasen, nach jeder wartet der Skill auf deine Bestätigung:

Am Ende steht das Buch auf dem Status Concept. Für Outliner und Plantser empfiehlt der Skill plot-architect, für Discovery Writer den rolling-planner.

Beispiel für die Prämisse im Beispiel-Buch:

Arne Kruse, 72, findet auf der Nordseeinsel Kargholm eine Silbermünze mit Prägedatum 1987, dem Jahr, in dem sein Bruder spurlos verschwand. Je näher er der Wahrheit kommt, desto klarer wird, dass die Insel eigene Regeln hat, was vergessen werden darf.

Phase 5: Plot-Architektur

/storyforge:plot-architect der-leuchtturmhueter

Der Skill im Outliner-Modus:

1. Struktur wählen aus neun Strukturen: 3-Akt, Heldenreise, Save the Cat, 5-Akt (Freytag), Fichtean Curve, Story Circle, Seven-Point, Kishōtenketsu und Snowflake. Für ein literarisches Mystery empfiehlt sich das 3-Akt-Gerüst.
2. Beats abbilden: Du arbeitest jeden Beat mit dem Skill durch und gibst die Beat-Map frei (plot/acts.md).
3. Subplots und Foreshadowing-Tabelle (Plant und Payoff, plot/outline.md).
4. Figurenbögen auf die Beats abgleichen (plot/arcs.md).
5. Kapitelplan mit Nummer, Arbeitstitel, POV, Schlüsselereignissen, Subplots und Wortzahl. Auf Wunsch legt der Skill die Kapitelverzeichnisse mit create_chapter an.
6. Story-Timeline anlegen (plot/timeline.md, Anker-Tag und vorläufige Einträge mit [PLANNED]). Dieser Schritt ist Pflicht.
7. Tonal-Dokument anlegen (plot/tone.md): Ton-Bogen über die Akte, Warnzeichen, unverhandelbare Regeln und fünf bis sechs buchspezifische Litmus-Fragen. Auch dieser Schritt ist Pflicht.

Danach steht das Buch auf Plot Outlined. Für Plantser verkürzt sich der Ablauf auf ein Minimal Viable Outline (die Punkte 3 und 4 dieser Liste entfallen), für Discovery Writer entfällt er, siehe Writing Modes.

Phase 6: Figuren

/storyforge:character-creator der-leuchtturmhueter "Arne Kruse"

Der Skill führt in 14 Schritten durch Rolle, Archetyp, GMC (Ziel, Motivation, Konflikt), Want und Need, Motivationskette, den „Ghost“ (die prägende Wunde), Psychologie, fatalen Fehler, menschliche Details, Lebenskontext, Stimme, Bogen und Beziehungen. Nach den tragenden Schritten wartet er jeweils auf deine Bestätigung. Das Ergebnis ist characters/arne-kruse.md mit YAML-Frontmatter (name, role, status und weitere Felder) und den Abschnitten der Figur. Du wiederholst das für Inga Holm, Pfarrer Thaden und Jürgen Kruse. Aufbau einer Figurendatei: Charakter-Anatomie.

Optional ergänzt du im Frontmatter die Blöcke knowledge (POV-Grenze) und tactical (Kampf- und Reiseszenen), siehe Technische Details.

Phase 7: Weltbau

/storyforge:world-builder der-leuchtturmhueter

Der Skill arbeitet nach dem Eisberg-Prinzip: Er baut nur, was die Geschichte braucht. Er füllt world/setting.md (Wo, Wann, sensorische Palette und Schlüsselorte, später Gesellschaft und Kultur), world/rules.md (zum Beispiel Magiesysteme, falls vorhanden, und eine Konsistenz-Checkliste), world/history.md und world/glossary.md. Jedes kulturelle Element soll einen Konflikt erzeugen können.

Die Datei world/setting.md hat in der Vorlage einen Abschnitt Travel Matrix. Er ist die Quelle für Entfernungen und Reisezeiten. Der world-builder selbst fragt Reisezeiten nur in seiner Konsistenz-Checkliste ab, die Routen trägt chapter-writer ein, bevor er eine Reisesszene schreibt. Reviewer und Continuity Checker vergleichen Kapitel später damit. Das Werkzeug erwartet die Spalten From, To, Distance, Transport, Travel Time und Notes, ein Raster mit Orten als Spaltenköpfen wird falsch gelesen:

Canon-Fakten (etablierte Tatsachen wie Baujahr oder Alter einer Figur) liegen in der Datenbank. Sie entstehen beim Abschluss eines Kapitels (siehe Phase 8) und über add_canon_fact, das auch continuity-checker, chapter-fixer und manuscript-checker nutzen. Du kannst das Tool direkt aufrufen.

Phase 8: Kapitel schreiben

/storyforge:chapter-writer der-leuchtturmhueter 1

Zuerst wählst du den Modus: Szene für Szene (empfohlen), ganzes Kapitel oder alle verbleibenden Kapitel nacheinander (nur für rohe Erstentwürfe). Der Skill markiert das Kapitel als Draft, lädt den Chapter Writing Brief und gibt vor jeder Szene den Pre-Scene Logic Audit aus, siehe Quality System.

Im Szenenmodus ist der Ablauf:

1. Der Skill erstellt einen Szenen-Plan für das Kapitel und speichert ihn nach deiner Bestätigung in der Kapitel-README unter ## Scene Plan.

2. Er schreibt eine Szene (Richtwert rund 900 Wörter) und hängt sie direkt an draft.md an. Im Chat steht nur Szenennummer, Wortzahl und eine Zeile Zusammenfassung.

3. Du liest die Szene in draft.md und schreibst deine Anmerkungen als Blöcke mit deinem Review-Handle direkt in die Datei:

   Maja: Der Moment, in dem er an der Tasse riecht, ist gut. Halten.
   Maja: Thadens Dialog ist zu redselig. Die Hälfte streichen.
   

4. Der Skill prüft jede Anmerkung, bevor er sie umsetzt (er zitiert die Stelle und begründet, wenn er widerspricht), setzt sie um und entfernt den Block.

5. Nach deiner Freigabe folgt die nächste Szene. Nach zwei freigegebenen Szenen empfiehlt der Skill eine neue Session.

Der Prosa-Hook läuft bei jedem Schreibvorgang mit. Beim Abschluss des Kapitels aktualisiert der Skill den Kapitelstatus (Review oder Final nach deiner Wahl), die ## Chapter Timeline in der README, die Story-Timeline, die Promises und die Canon-Fakten (neue etablierte Fakten trägt er mit add_canon_fact in die Datenbank ein) und schlägt bei Review oder Final einen Snapshot der POV-Figur vor.

Regeln und Callbacks im Schreibfluss

Schreibst du im Chat eine Zeile mit einem der Präfixe Regel:, Rule:, Workflow: oder Callback:, sichert der PreCompact-Hook sie vor der Kontext-Komprimierung für das Buch. Die Zeile muss einzeilig sein, Groß- und Kleinschreibung des Präfixes ist egal, der Text darf höchstens 300 Zeichen lang sein. Mit /storyforge:register-callback legst du solche Einträge direkt an:

Regel: Arne spricht allein nie in vollständigen Sätzen. Innere Monologe bestehen aus Fragmenten.
Callback: Die Silbermünze aus Kapitel 3 muss in Kapitel 17 bei der Konfrontation mit Thaden wiederkommen.

Regeln, Workflows und Callbacks liegen in der Datenbank. In den Chapter Writing Brief der Folgekapitel fließen davon nur Regeln (als rules_to_honor) und Callbacks (als callbacks_in_register). Workflows stehen nicht im Brief.

Kapitel prüfen

/storyforge:chapter-reviewer der-leuchtturmhueter 01-ankunft

Bei Kapitel 1 läuft zusätzlich die Liste mit 13 Eröffnungs-Punkten, danach die 33 Punkte des Reviewers. Ergebnis ist ein Urteil PASS, WARN oder FAIL. Funde setzt chapter-fixer gezielt als Edit-Patches um, ohne den Entwurf neu zu schreiben. Vor dem Humanizer läuft optional chapter-voice-harvest: Er wertet deine Korrekturen aus der Review-Runde aus und übernimmt bestätigte Stimmmuster ins Autorenprofil; sind keine Rückmeldungen protokolliert, endet er mit einer Zeile. Danach folgen chapter-humanizer und chapter-proofreader. Details: Quality System.

Für jedes weitere Kapitel wiederholst du Schreiben, Review, Fixen, Voice Harvest, Humanizer und Proofreader. Zwischendurch zeigt /storyforge:book-dashboard Stand, Kapitelstatus und den nächsten Schritt, und /storyforge:next-step sagt dir, was als Nächstes ansteht.

Phase 9: Zwischen-Checks

Nach einigen Kapiteln:

/storyforge:continuity-checker der-leuchtturmhueter

Der Skill prüft das Buch gegen Timeline, Travel Matrix und Canon-Fakten und meldet zum Beispiel:

Kap 6, Z. 198: "Arne ist vor zwei Stunden gekommen"
Timeline: Arne kam vor einer Stunde und vierzig Minuten
→ kleiner Konflikt

Außerdem hilft validate_timeline_consistency bei Zeitdrift über Kapitelgrenzen.

Phase 10: Revision

Haben alle Kapitel den Weg Review, Humanizer und Proofreader hinter sich:

/storyforge:manuscript-checker der-leuchtturmhueter --interactive

Der Skill scannt das ganze Buch auf Buchregel-Verstöße, Klischees, Wiederholungen über Kapitel hinweg, Filterwörter, Adverb-Häufungen, Plot-Löcher und mehr, schreibt den Report nach research/manuscript-report.md und geht die schweren Funde einzeln mit dir durch. Danach prüfst du die geänderten Kapitel erneut mit dem Reviewer.

Optional:

/storyforge:rules-audit der-leuchtturmhueter   # prüft, ob Buchregeln für den Scanner sichtbar sind
/storyforge:voice-checker der-leuchtturmhueter # Gesamt-Score, kein Pflichtschritt

Phase 11: Produktion

Sensitivity Reader (optional)

/storyforge:sensitivity-reader der-leuchtturmhueter

Prüft auf problematische Darstellungen, Stereotype und schädliche Tropes. Bei sensiblen Themen ersetzt das keinen menschlichen Sensitivity-Reader.

Cover

/storyforge:cover-artist der-leuchtturmhueter

Der Skill erarbeitet mit dir cover/brief.md (Stimmung, Palette, Genre-Konventionen, visuelle Elemente) und cover/prompts.md mit fertigen Prompts für den in der Konfiguration eingestellten Bildgenerator. Die Prompts erzeugen ein textfreies Bild. Das Bild erzeugst du extern und übernimmst es mit import_cover_image(book_slug, pfad, is_final) ins Projekt. Mit is_final=True gilt es als Cover für den Export.

Für den Titel-Schriftzug auf dem textfreien Bild hilft /storyforge:cover-typography-mockup. Es erzeugt einen HTML-Mockup mit Platzierung und Font-Pairing sowie eine Anleitung für das konfigurierte Werkzeug (Canva, GIMP oder Photoshop). Das fertige Bild importierst du erneut mit is_final=True.

Export

/storyforge:export-engineer der-leuchtturmhueter epub

Voraussetzungen und Ablauf (vollständig unter Technische Details):

• alle Kapitel auf Final (die Vorprüfung blockt sonst)
• ausgefüllte export/front-matter.md ohne Platzhalter
• keine übrig gebliebenen Review-Kommentare im Entwurf
• ein importiertes finales Cover wird eingebunden, ohne Cover wird trotzdem exportiert

Das Ergebnis liegt unter export/output/der-leuchtturmhueter.epub. Für Leseexemplare gibt es --arc.

Promo

/storyforge:promo-writer der-leuchtturmhueter

Der Skill schreibt zuerst den Klappentext (export/blurb.md), entwickelt dann eine Kampagnen-Strategie und erzeugt plattformspezifische Texte unter promo/ für Facebook, Instagram, X, TikTok, Bluesky und Newsletter, dazu Zitat-Karten, Hashtags und einen Content-Kalender.

Phase 12: Übersetzung (optional)

/storyforge:translator der-leuchtturmhueter en

Der Skill legt translations/en/glossary.md an und stimmt das Glossar zuerst mit dir ab. Danach übersetzt er Kapitel für Kapitel nach translations/en/chapters/ und wartet nach jedem Kapitel auf deine Freigabe oder Korrektur.

Phase 13: Serie (optional)

/storyforge:series-planner kargholm-saga

Legt eine Serien-Ebene an, mit gemeinsamem Kanon und wiederkehrenden Figuren. Den ganzen Lebenszyklus (Buchabschluss mit harvest-author-rules und harvest-character-evolution, Onboarding des nächsten Bands) zeigt das Series-Workflow-Beispiel.

Häufige Abweichungen vom Idealfall

Mein Plot trägt ab Kapitel 7 nicht mehr

Zurück zu plot-architect und den Plot ab Kapitel 7 neu strukturieren. Die Kapitel davor bleiben, wenn sie stehen.

Eine Nebenfigur wird wichtiger als geplant

/storyforge:character-creator für diese Figur laufen lassen, bei Bedarf plot-architect erneut für die Bogen-Anpassung und mit Callback: festhalten, dass die Figur präsent bleibt.

Ein Kapitel ist doppelt so lang wie geplant

Kein Problem, Kapitellängen sind Richtwerte. Prüfe, ob zwei Kapitel in einem stecken.

Die Timeline wird unübersichtlich

/storyforge:continuity-checker rekonstruiert fehlende Teile aus den Entwürfen.

Ich stecke fest

/storyforge:unblock diagnostiziert die Ursache der Blockade (Angst, Perfektionismus, Aufschieben oder Ablenkung) und gibt gezielte Schritte. Für die Frage, was als Nächstes dran ist, ist /storyforge:next-step richtig.

Regeln werden vom Hook ignoriert

/storyforge:rules-audit zeigt, welche Regeln der Scanner nicht sehen kann, und hilft beim Umformulieren.

Das Autorenprofil passt nicht mehr zum Buch

Passe das Buch an oder lege ein neues Profil an. Pro Buch wird ein Autor gewählt, und du kannst beliebig viele Profile haben.

Wichtigste Lektion

Kein Buch folgt dem idealen Workflow. StoryForge ist eine Struktur, die dir erlaubt, vom Pfad abzuweichen, ohne verloren zu gehen. Die Prüfungen sind deine Versicherung, dass du nach dem Abweichen einsammelst, was du brauchst.

← Zurück zur StoryForge-Hauptseite