¶ StoryForge - AI Book Writing
¶ Inhaltsverzeichnis
- Überblick
- Was StoryForge anders macht
- Hauptfunktionen
- Writing Modes
- Systemanforderungen
- Installation
- Konfiguration
- Kurzanleitung
- Projekt-Struktur
- Status-Modell
- MCP Tools Übersicht
- Hooks
- Persistenz: Per-Book CLAUDE.md
- Unterseiten
- Fehlerbehebung
- FAQ
¶ Überblick
StoryForge ist ein Claude Code Plugin für das komplette Schreiben von Belletristik — vom ersten Brainstorming über Konzept, Plot, Figuren, Weltenbau, Kapitel-für-Kapitel-Schreibprozess bis hin zum fertigen EPUB, PDF oder MOBI. Der Kern ist das Autorenprofil-System: Jeder Text wird in der Stimme eines definierten (oder aus PDFs extrahierten) Autors geschrieben — nicht generischer KI-Output.
Ja, StoryForge schreibt Prosa — über den
chapter-writer-Skill. Aber es ist kein Ein-Klick-Buchgenerator. Du triffst alle kreativen Entscheidungen (Plot, Figuren, Thema, Wendungen), jede Szene läuft durch deine Review, und der Skill schreibt nur unter strengen Kontext-Constraints (Autorenprofil, Canon, Timeline, Tonal Document, Per-Book-Regeln). Anders gesagt: das Plugin schreibt den Text, aber du bist die Autorin.
Wofür StoryForge gedacht ist:
- Autoren, die KI als Werkzeug nutzen wollen, ohne in generischen AI-Slop zu verfallen
- Self-Publisher, die vom Konzept bis zum EPUB alles aus einer Hand wollen
- Serien-Autoren mit komplexer Canon-Verwaltung über mehrere Bücher hinweg
- Discovery Writer (Pantser), die trotzdem Timeline/Canon/Tonal Consistency brauchen
- Autoren, die Stil-DNA aus eigenen früheren Werken extrahieren wollen
Wofür StoryForge nicht gedacht ist:
- Ein-Klick-Buchgeneratoren — hier gibt es keine "Schreib-mir-einen-Roman"-Taste
- Sachbücher, Ratgeber oder technische Dokumentation (dafür VidCraft oder andere Tools)
- Ghostwriting ohne Autorenbezug — ohne Autorenprofil verweigert das Plugin den Schreibprozess
¶ Was StoryForge anders macht
Die meisten KI-Schreib-Tools produzieren sofort Prosa. StoryForge zwingt dich durch Pflicht-Ladungen vor jedem kreativen Schritt:
Das Chapter-Writer-Skill zum Beispiel lädt 16 verschiedene Kontext-Quellen, bevor das erste Wort geschrieben wird. Jede Regel, jede Figurstimme, jede Kalenderzeile wird aktiv im Prompt-Kontext gehalten.
¶ Die "Never Trust" Regel (Rule #14)
StoryForge ist so konfiguriert, dass es User-Korrekturen bei Prosa nicht blind übernimmt. Wenn du schreibst "dieser Satz ist falsch", wird das Plugin den Text zitieren, den Kontext prüfen und gegebenenfalls widersprechen, wenn du falsch liegst. Hintergrund: Bei englischsprachiger Prosa werden subtile Nuancen oft vom User übersehen.
¶ Die Simile-Discipline
Bildhafte Vergleiche (Similes, Metaphern) werden aktiv gezählt und auf Redundanz geprüft — sowohl innerhalb einer Szene als auch kapitelübergreifend. Das verhindert den klassischen KI-Fehler "jeder Sonnenuntergang ist wie flüssiges Gold".
¶ Hauptfunktionen
¶ Author Profiles — Die Anti-AI-Engine
- Stil-Parameter: Stimme, Tonalität, Satzstruktur, Vokabular
- Banned Words / Preferred Words Listen
- PDF/EPUB/DOCX-Import zur Stil-Extraktion aus eigenen früheren Werken
author_writing_mode: outliner / plantser / discovery- Siehe Detailseite: Autorenprofile
¶ Genre-System mit Mixing
- 11 Base-Genres: horror, fantasy, sci-fi, thriller, mystery, romance, drama, literary-fiction, historical, contemporary, supernatural
- 1 Cross-Cutting: lgbtq (immer mit anderen kombiniert)
- 2 Pre-defined Mixes: dark-fantasy, paranormal-romance
- Freie Kombination: bis zu 3 Genres mischbar (z.B. LGBTQ+ Supernatural Mystery)
- Eigene Genre-Mixes erstellbar mit
/storyforge:genre-creator - Siehe Detailseite: Genre-System
¶ 8 Plot-Methoden
| Methode | Einsatzbereich |
|---|---|
| 3-Act Structure | Universeller Standard für die meisten Romane |
| Hero's Journey | Fantasy, Sci-Fi, Coming-of-Age |
| Save the Cat | Plot-fokussierte Thriller, Mystery, kommerzielle Romane |
| Snowflake Method | Komplexe Plots mit vielen POV-Figuren |
| Freytag's Pyramid | Literarische Fiktion, Drama |
| Seven-Point Story | Strukturierte Action/Thriller |
| Story Circle (Dan Harmon) | Charakter-zentrierte Stories, TV-Serienpilote |
| Kishōtenketsu | Literarisch, East-Asian-inspiriert, konfliktarme Plots |
¶ 33 spezialisierte Skills
Aufgeteilt in Kategorien: Core, Author, Creative, Writing, Research, Production, Series, Utility. Siehe Skills-Detailseite.
¶ Quality Gates
- Chapter Reviewer: 28-Punkte-Qualitäts-Checkliste pro Kapitel
- First-Chapter Gate: 13-Punkte-Check für das erste Kapitel (härter)
- Voice Checker: 7-Dimensionen-Scan auf AI-Tells
- Manuscript Checker: Cross-Chapter-Repetition-Scanner für das komplette Buch
- Continuity Checker: Timeline + Travel Matrix Validation
- Siehe Detailseite: Quality System
¶ Craft Knowledge Base
36+ Referenzdokumente (73.000+ Wörter) eingebaut:
- Story Structure, Plot Craft, Character Arcs
- Pacing, Dialog Craft, Show-Don't-Tell
- POV, Tension & Suspense, Simile Discipline
- Anti-AI-Patterns, Prose Style, Do's and Dont's
- 10 genrespezifische Craft-Guides (z.B. horror-craft, fantasy-craft, mystery-craft)
¶ Writing Modes
StoryForge unterstützt drei Arbeitsweisen für Autoren — je nachdem, wie viel Planung du magst:
| Modus | Für wen | Planung vorab | Schreibprozess |
|---|---|---|---|
| Outliner | Detailplaner | Voller Plot-Outline mit allen Kapitel-Beats | Kapitel folgen dem Plan |
| Plantser | Hybrid-Autoren | 6 Schlüssel-Beats (MVO = Minimum Viable Outline) | Szene-Buffer 3-5 Szenen voraus via Rolling Planner |
| Discovery Writer | Pantser | Nur Prämisse + Protagonist + Core Tension | Szene-für-Szene mit Rolling Planner, kein Plot |
Detail-Vergleich mit Beispielen: Writing Modes
¶ Systemanforderungen
| Anforderung | Version | Hinweise |
|---|---|---|
| Python | 3.10+ | Empfohlen: Python 3.12 |
| Claude Code | 1.0+ | CLI, Desktop oder IDE Extension |
| Pandoc | 3.0+ | Für EPUB/PDF-Export |
| Calibre | optional | Für MOBI-Export |
| LaTeX | optional | Für PDF via xelatex/pdflatex |
¶ Installation
git clone https://github.com/markus-michalski/storyforge.git ~/projekte/storyforge
- Download von GitHub Releases
- Entpacken nach
~/projekte/storyforge/
¶ Schritt 2: Plugin installieren
claude plugin install ~/projekte/storyforge
¶ Schritt 3: Setup ausführen
In Claude Code:
/storyforge:setup
Dies erstellt automatisch:
- Python venv unter
~/.storyforge/venv/ - Dependencies: FastMCP, PyYAML, pdfplumber, python-docx, ebooklib
- Config-Template nach
~/.storyforge/config.yaml - Cache-Verzeichnis
~/.storyforge/cache/ - Authors-Verzeichnis
~/.storyforge/authors/
¶ Schritt 4: Konfiguration anpassen
nano ~/.storyforge/config.yaml
Wichtigster Wert: content_root (wo deine Buchprojekte liegen sollen).
¶ Schritt 5: Erstes Autorenprofil anlegen
/storyforge:create-author
Ohne Autorenprofil verweigert das Plugin den Schreibprozess — das ist Absicht.
¶ Konfiguration
¶ config.yaml
# ~/.storyforge/config.yaml
paths:
content_root: "~/projekte/book-projects"
authors_root: "~/.storyforge/authors"
defaults:
language: "en" # "de" für deutschsprachige Bücher
book_type: "novel" # short-story / novelette / novella / novel / epic
export_format: "epub" # epub / pdf / mobi
pdf_engine: "xelatex" # xelatex / pdflatex / wkhtmltopdf
cover_platform: "midjourney" # midjourney / dall-e
review:
handle: "Markus" # Name für Inline-Review-Kommentare
export:
include_toc: true
include_colophon: true
font_family: "Minion Pro" # nur für PDF
¶ Wort-Längen-Standards pro Buchtyp
| Typ | Wörter | Anzahl Kapitel (typisch) |
|---|---|---|
| short-story | 1.000 - 7.500 | 1 (keine Kapitel) |
| novelette | 7.500 - 17.500 | 3-5 |
| novella | 17.500 - 40.000 | 8-15 |
| novel | 40.000 - 120.000 | 15-35 |
| epic | 120.000+ | 35+ |
¶ Pfade
| Pfad | Inhalt |
|---|---|
~/.storyforge/config.yaml |
User-Konfiguration |
~/.storyforge/cache/state.json |
State Cache (automatisch) |
~/.storyforge/venv/ |
Python Virtual Environment |
~/.storyforge/authors/{slug}/ |
Autorenprofile |
{content_root}/projects/{book-slug}/ |
Buchprojekte |
¶ Kurzanleitung
¶ Standard-Workflow (Outliner) — mit Beispiel "Der Leuchtturmhüter"
1. /storyforge:create-author
→ Legt Autorenprofil "maja-sundberg" an
→ author_writing_mode: outliner
2. /storyforge:new-book
→ Titel: "Der Leuchtturmhüter"
→ Typ: novel
→ Genres: mystery + contemporary + literary-fiction
→ Slug: der-leuchtturmhueter
3. /storyforge:book-conceptualizer der-leuchtturmhueter
→ 5-Phasen-Konzept: Prämisse, Protagonist, Konflikt, Thema, Ton
4. /storyforge:plot-architect der-leuchtturmhueter
→ Methode: 3-Act Structure
→ 18 Kapitel, je 3 Beats
5. /storyforge:character-creator der-leuchtturmhueter
→ Protagonist: Arne Kruse (72, ehemaliger Seemann)
→ Antagonist: Die Insel selbst + seine Vergangenheit
→ 4 Nebenfiguren mit je 14 Psychologie-Schritten
6. /storyforge:world-builder der-leuchtturmhueter
→ Setting: Fiktive Nordseeinsel "Kargholm"
→ Travel Matrix: 6 Locations mit Reisezeiten
→ Kanon-Log initial befüllt
7. /storyforge:chapter-writer der-leuchtturmhueter 01
→ Scene-by-scene Mode (empfohlen)
→ 3 Szenen à ~900 Wörter
→ Jede Szene: Review-Kommentare inline möglich
8. /storyforge:chapter-reviewer der-leuchtturmhueter 01
→ 28-Punkte-Check
9. (Wiederhole Kapitel 2-18)
10. /storyforge:manuscript-checker der-leuchtturmhueter
→ Cross-Chapter-Analyse
→ Interactive Fix Mode
11. /storyforge:voice-checker der-leuchtturmhueter
→ 7-Dimensionen-AI-Tell-Scan
12. /storyforge:export-engineer der-leuchtturmhueter --format epub
13. /storyforge:promo-writer der-leuchtturmhueter
→ Klappentext + Social Media Kampagne
Komplettes durchgerechnetes Beispiel: Workflow-Beispiel
¶ Projekt-Struktur
Jedes Buch ist ein eigenes Verzeichnis unter {content_root}/projects/:
der-leuchtturmhueter/
├── README.md # Buch-Metadaten (YAML Frontmatter)
├── synopsis.md # Klappentext + lange Synopse
├── plot/
│ ├── outline.md # Akt/Beat-Struktur
│ ├── timeline.md # Story-Kalender (Tag für Tag)
│ ├── tone.md # Tonale Leitplanken + Litmus-Test
│ ├── canon-log.md # Story-Bibel (etablierte Fakten)
│ └── arcs.md # Charakter-Arc-Übersicht
├── characters/
│ ├── INDEX.md # Figuren-Übersicht
│ ├── arne-kruse.md # Einzelfiguren
│ ├── inga-holm.md
│ └── pfarrer-thaden.md
├── world/
│ ├── setting.md # Setting inkl. Travel Matrix
│ ├── rules.md # Weltregeln (bei Fantasy: Magiesystem)
│ └── history.md # Welt-Historie
├── chapters/
│ ├── 01-ankunft/
│ │ ├── README.md # Kapitel-Metadaten + Outline + Chapter Timeline
│ │ └── draft.md # Die eigentliche Prosa
│ └── 02-das-leuchtfeuer/
│ ├── README.md
│ └── draft.md
├── CLAUDE.md # Per-Book Rules/Workflows/Callbacks (auto-sync)
├── cover/ # brief.md, prompts.md, art/
├── export/ # front-matter.md, back-matter.md, output/
└── translations/ # {lang}/ mit glossary.md + chapters/
¶ Status-Modell
¶ Buch-Status
Ableitung erfolgt automatisch aus Kapitel-Aggregaten und wird nie rückwärts bewegt:
Auto-Derivation-Regeln:
| Buch-Tier | Trigger |
|---|---|
Drafting |
Irgendein Kapitel über Outline hinaus |
Revision |
Jedes Kapitel auf Revision-Rank oder höher |
Proofread |
Jedes Kapitel auf Final |
Editing, Export Ready und Published bleiben explizit — sie erfordern qualitative Bewertung jenseits der Kapitel-Aggregation.
Floor Rule: Ein vom User gesetzter höherer Tier (Export Ready, Published) wird nie automatisch zurückgesetzt.
¶ Kapitel-Status
Outline → Draft → Revision → Polished → Final
Aliase für Ranking (Display-String bleibt erhalten):
| Alias | Kanonischer Rank |
|---|---|
review, reviewed |
Revision |
drafting |
Draft |
polishing |
Polished |
done |
Final |
¶ Figuren-Status
Concept → Profile → Backstory → Arc Defined → Final
¶ Idea-Status
raw → explored → developed → ready → promoted (oder shelved)
¶ MCP Tools Übersicht
Der MCP Server storyforge-mcp stellt Tools in folgenden Kategorien bereit:
- State Management — Projekte, Kapitel, Charaktere, Sessions
- Content Operations — Scaffolding, Templates, YAML-Frontmatter
- Author Tools — Profile, Vokabular, Stil-Analyse
- Analysis — Dokument-Parsing (PDF/EPUB/DOCX), Voice-Checks
- Export — EPUB/PDF/MOBI-Generierung
- Reference — Craft-Docs, Genre-Regeln, Templates
- Per-Book CLAUDE.md — Lesen/Schreiben des Buch-spezifischen CLAUDE.md
Das vollständige Tool-Inventar mit Parametern: siehe Plugin-Repository servers/storyforge-server/server.py.
Wichtig: Skills dürfen Projektdateien nie direkt parsen. Jeder State-Zugriff läuft über MCP Tools. Das ist Regel #1 in der CLAUDE.md.
¶ Hooks
StoryForge registriert drei Hooks:
¶ PreCompact Sync (precompact_sync_claudemd.py)
Läuft vor jeder Session-Kompaktion. Extrahiert aus dem Gesprächsverlauf Nachrichten mit den Präfixen:
Regel:→ Buch-RegelWorkflow:→ Prozess-RegelCallback:→ zu webender Callback (Figur, Objekt, Thread)
Diese werden in die Buch-CLAUDE.md geschrieben, damit sie Kompaktion überleben und bei jedem Kapitel neu geladen werden.
Beispiel:
User: Regel: Arne Kruse spricht nie in vollständigen Sätzen, wenn er allein ist.
→ Wird automatisch nach projects/der-leuchtturmhueter/CLAUDE.md geschrieben und bei /storyforge:chapter-writer wieder geladen.
¶ Chapter Validator (validate_chapter.py)
Läuft nach jedem Write/Edit auf Kapitel-Dateien. Prüft:
- YAML-Frontmatter-Syntax
- Status-Wert gegen erlaubte Werte
- Pflichtfelder (number, slug, status)
¶ Character Validator (validate_character.py)
Läuft nach jedem Write/Edit auf Charakter-Dateien. Prüft:
- YAML-Frontmatter-Syntax
- Pflichtfelder (name, slug, role)
¶ Persistenz: Per-Book CLAUDE.md
Jedes Buch bekommt eine eigene CLAUDE.md, die als Gedächtnis zwischen Sessions dient:
# Der Leuchtturmhüter — Book-Specific Rules
## Rules
- Arne Kruse spricht nie in vollständigen Sätzen, wenn er allein ist
- Keine Flashbacks vor Kapitel 5 — Rhythmus-Entscheidung
- Insel-Beschreibungen nie länger als 3 Sätze am Stück
## Workflow
- Scene-by-scene writing Pflicht für dieses Buch
- Chapter Reviewer nach jedem Kapitel, nicht gebündelt
## Callbacks
- Leuchtturm-Taschenlampe (Kap 2 eingeführt) → muss in Kap 12 wiederkehren
- Die Münze auf dem Kaminsims (Kap 4) → Auflösung in Kap 16
- Pfarrer Thaden humpelt links (Kap 3) → visuelles Motiv beibehalten
Der Chapter-Writer lädt diese Datei vor jedem Kapitel via get_book_claudemd(book_slug). Damit überleben Regeln Claude-Kompaktion und auch komplette Session-Resets.
¶ Unterseiten
Tiefere Dokumentation in separaten Seiten:
- Skills im Detail — Alle 33 Skills mit Zweck, Input, Output
- Writing Modes — Outliner, Plantser, Discovery — mit Beispielen
- Autorenprofile — Das Anti-AI-Engine-System
- Genre-System — 14 Genres + Mixing + eigene Mixes
- Quality System — Voice Checker, Manuscript Checker, Gates
- Workflow-Beispiel — Ein Buch von Anfang bis Ende
¶ Fehlerbehebung
¶ Problem: Plugin schreibt generische KI-Prosa
Symptome: Text klingt flach, austauschbar, voller Phrasen wie "journey", "realm", "tapestry of emotions".
Ursachen:
- Autorenprofil nicht angelegt oder zu vage
vocabulary.mdhat keinebanned_words-Liste- Keine eigenen Werke via
/storyforge:study-authorimportiert
Lösung:
/storyforge:create-author
# Detaillierte Parameter eintragen
/storyforge:study-author ~/my-previous-book.epub
# Stil-DNA aus eigenem Werk extrahieren
/storyforge:voice-checker my-book chapter-01
# 7-Dimensionen-Scan zeigt konkrete Probleme
¶ Problem: MCP Server verbindet nicht
Symptome: Skills zeigen Fehler, keine MCP Tools verfügbar.
Prüfen:
claude plugin list | grep storyforge
ls ~/.storyforge/venv/bin/python3
~/.storyforge/venv/bin/pip list | grep mcp
Lösung:
/storyforge:setup
¶ Problem: Kapitel widerspricht sich mit vorherigem
Symptome: Figuren handeln inkonsistent, Zeitangaben stimmen nicht, Orte werden anders beschrieben.
Ursache: Canon Log oder Timeline nicht geladen oder veraltet.
Lösung:
/storyforge:continuity-checker my-book
Das Skill rekonstruiert Timeline und Travel Matrix aus allen bestehenden Kapiteln und listet Konflikte.
¶ Problem: State Cache leer
Symptome: list_books zeigt nichts, obwohl Projekte existieren.
Lösung:
/storyforge:session-start
Rebuild passiert automatisch aus den Markdown-Dateien.
¶ Problem: Compaction verliert Buch-Regeln
Symptome: Nach Claude-Kompaktion vergisst das Plugin Buch-spezifische Regeln (z.B. "keine Flashbacks vor Kapitel 5").
Ursache: Regel wurde nicht mit Regel:-Präfix geschrieben und landete deshalb nicht in der Per-Book CLAUDE.md.
Lösung:
User: Regel: Keine Flashbacks vor Kapitel 5.
Der PreCompact-Hook extrahiert die Regel automatisch. Prüfen mit:
cat ~/projekte/book-projects/projects/der-leuchtturmhueter/CLAUDE.md
¶ FAQ
F: Schreibt StoryForge das Buch für mich?
A: Prosa schreibt es — aber nicht das Buch. Der chapter-writer-Skill generiert Text in der definierten Autoren-Voice. Aber alle kreativen Entscheidungen (Plot, Figuren, Thema, Wendungen, Stil) triffst du. Jede Szene reviewst du inline und korrigierst. Ohne deine Reviews und Korrekturen gibt es keinen Fortschritt — das Plugin schreibt nie blind weiter.
F: Brauche ich ein eigenes früheres Werk, um StoryForge zu nutzen?
A: Nein, aber empfohlen. Du kannst ein Autorenprofil manuell befüllen. Der study-author-Skill (PDF/EPUB-Import) beschleunigt aber die Stil-DNA-Erfassung massiv.
F: Welche Sprachen werden unterstützt?
A: Die Writing-Engine ist sprachneutral. Standard ist Englisch, aber Deutsch, Spanisch, Französisch etc. funktionieren, sofern das Autorenprofil in der Zielsprache definiert ist. Craft-Referenzen sind auf Englisch, werden aber auf fremdsprachige Texte angewendet.
F: Kann ich mehrere Bücher einer Serie verwalten?
A: Ja. /storyforge:series-planner erstellt eine Serien-Ebene mit übergreifendem Canon, Arc-Planung und Character Evolution. Jedes Einzelbuch liegt darunter als Standard-Projekt.
F: Was passiert bei Schreibblockaden?
A: /storyforge:unblock diagnostiziert den Block-Typ (Angst / Perfektionismus / Prokrastination / Ablenkung) und liefert zielgerichtete Übungen — keine Generik-Tipps.
F: Kann ich auch Sachbücher schreiben?
A: Nein, StoryForge ist auf Fiktion ausgelegt. Craft-Referenzen, Plot-Methoden und Genre-System sind auf Belletristik zugeschnitten.
F: Wie gut sind die exportierten EPUBs?
A: Produktionsreif. Der Export-Engineer nutzt Pandoc mit EPUB-3-Templates, fügt Front Matter (Copyright, Widmung), Back Matter (About Author, weitere Bücher) hinzu und unterstützt Custom-CSS. Testbar in Calibre, Apple Books und Adobe Digital Editions vor dem Upload zu Amazon KDP / Tolino / Kobo.
F: Kann ich StoryForge für Game Writing oder Drehbücher nutzen?
A: Nicht direkt. Kapitel-Writer ist auf Prosa ausgelegt. Für Drehbücher empfehle ich VidCraft (Script-Writing für Videos). Für Game Writing könntest du StoryForge als Plotting-Tool nutzen und die Prosa-Generierung überspringen.
F: Wie geht das Plugin mit Sensitivitätsthemen um?
A: /storyforge:sensitivity-reader scannt auf problematische Darstellungen (Stereotype, Trauma-Porno, Appropriation). Bei LGBTQ-, Trauma-, oder Rassismus-Themen wird empfohlen, zusätzlich menschliche Sensitivity Reader zu engagieren — das Skill ersetzt das nicht, es ergänzt.
¶ Lizenz
MIT License — GitHub Repository
Entwickelt von Markus Michalski