Zurück zur StoryForge-Hauptseite
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:
| Merkmal | Wert |
|---|---|
| Titel | Der Leuchtturmhüter |
| Typ | Roman (Ziel 85.000 Wörter) |
| Genres | mystery, contemporary, literary-fiction |
| Sprache | Deutsch |
| Autor-Persona | Maja Sundberg (fiktiv) |
| Schreibmodus | Outliner |
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.
/storyforge:create-author
Der Skill fragt in Phasen. Bei Fiction sind das:
list_genres, bis zu drei), literarische Vorbilder, Muttersprache und SchreibspracheNach 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.
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.
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}.
/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.
/storyforge:book-conceptualizer der-leuchtturmhueter
Fünf Phasen, nach jeder wartet der Skill auf deine Bestätigung:
| Phase | Ergebnis | Ablage |
|---|---|---|
| 1. Prämisse | zwei bis drei Sätze: Figur, Situation, Hauptkonflikt | README, Abschnitt ## Premise |
| 2. Thema | Thema als Frage, nicht als Lehrsatz | README, Abschnitt ## Themes |
| 3. Konflikt-Architektur | äußerer und innerer Konflikt, Einsätze | im Gespräch |
| 4. Struktur-Wahl | zwei bis drei Optionen mit Vor- und Nachteilen | plot/outline.md (erster Entwurf) |
| 5. Pitch | Logline, Elevator Pitch, Vergleichstitel, Klappentext | synopsis.md |
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.
/storyforge:plot-architect der-leuchtturmhueter
Der Skill im Outliner-Modus:
plot/acts.md).plot/outline.md).plot/arcs.md).create_chapter an.plot/timeline.md, Anker-Tag und vorläufige Einträge mit [PLANNED]). Dieser Schritt ist Pflicht.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.
/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.
/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:
| From | To | Distance | Transport | Travel Time | Notes |
|---|---|---|---|---|---|
| Leuchtturm | Hafen | 2 km | zu Fuß | 25 min | Küstenpfad |
| Hafen | Dorf | 1 km | zu Fuß | 15 min | |
| Leuchtturm | Dorf | 3 km | Fahrrad | 40 min | über die Landstraße |
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.
/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:
Der Skill erstellt einen Szenen-Plan für das Kapitel und speichert ihn nach deiner Bestätigung in der Kapitel-README unter ## Scene Plan.
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.
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.
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.
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.
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.
/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.
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.
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
/storyforge:sensitivity-reader der-leuchtturmhueter
Prüft auf problematische Darstellungen, Stereotype und schädliche Tropes. Bei sensiblen Themen ersetzt das keinen menschlichen Sensitivity-Reader.
/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 mitis_final=True.
/storyforge:export-engineer der-leuchtturmhueter epub
Voraussetzungen und Ablauf (vollständig unter Technische Details):
Final (die Vorprüfung blockt sonst)export/front-matter.md ohne PlatzhalterDas Ergebnis liegt unter export/output/der-leuchtturmhueter.epub. Für Leseexemplare gibt es --arc.
/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.
/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.
/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.
Zurück zu plot-architect und den Plot ab Kapitel 7 neu strukturieren. Die Kapitel davor bleiben, wenn sie stehen.
/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.
Kein Problem, Kapitellängen sind Richtwerte. Prüfe, ob zwei Kapitel in einem stecken.
/storyforge:continuity-checker rekonstruiert fehlende Teile aus den Entwürfen.
/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.
/storyforge:rules-audit zeigt, welche Regeln der Scanner nicht sehen kann, und hilft beim Umformulieren.
Passe das Buch an oder lege ein neues Profil an. Pro Buch wird ein Autor gewählt, und du kannst beliebig viele Profile haben.
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.