GitHub: markus-michalski/storyforge · Lizenz: PolyForm Noncommercial 1.0.0
Diese Dokumentation beschreibt den aktuellen Stand des Plugins. Änderungen je Version stehen im CHANGELOG des Projekts.
StoryForge ist ein Claude-Code-Plugin für KI-gestütztes Buchschreiben. Es ist kein allgemeiner Schreibassistent, sondern ein strukturierter Workflow mit Autorenprofilen, Qualitätsprüfungen und einer Prosa-Prüfung, die verhindert, dass fertige Texte nach KI klingen.
Für wen:
Was StoryForge nicht ist:
| Bereich | Ohne Plugin | Mit StoryForge |
|---|---|---|
| Autorenstimme | geht nach dem ersten Prompt verloren | Autorenprofil wird bei jedem Kapitel geladen, ein Hook prüft jede Änderung am Entwurf |
| Plot-Konsistenz | auf das Gedächtnis des Modells angewiesen | Timeline, Travel Matrix, Canon-Fakten und Promises-Register |
| Plot-Holes | werden nicht erkannt | analyze_plot_logic plus Prüfpunkte im Reviewer |
| Genres | allgemein | 16 Genre-Definitionen mit Konventionen, Tropes und erwarteten Beats |
| Memoir | nicht vorgesehen | eigene Buchkategorie mit Einwilligungs-Tracking und Verleumdungs-Prüfung |
| Prüfung | keine | Kapitel-Review mit 33 Punkten, Manuscript-Checker, Continuity-Checker, Humanizer |
| Schreibmodus | keiner | Outliner, Plantser, Discovery |
| Autoren-Lernen | keines | Erkenntnisse wandern von Buch zu Autor und werden im nächsten Buch durchgesetzt; auch deine Korrekturen in den Review-Runden fließen als Style Principles ins Profil |
Validierung steht nicht nur im Skill-Prompt, sondern im Hook. Der Hook läuft nach jedem Schreibvorgang auf einer Kapitel-draft.md. Findet er einen Blocker, beendet er sich mit Exit-Code 2 und gibt die Funde an das Modell zurück, das sie beheben muss, bevor es weiterschreibt. Dazu kommen strukturierte Data Briefs: Statt langer Lese-Listen liefert ein MCP-Tool ein JSON mit allen Daten, die das Modell für ein Kapitel braucht.
Vergleiche und Metaphern werden gezählt und über Kapitel hinweg auf Wiederholung geprüft. Der Chapter Writing Brief führt die Zahl der Vergleiche je Kapitel mit.
Jeder Autor hat ein Verzeichnis ~/.storyforge/authors/{slug}/ mit profile.md (Ton, Perspektive, Tempus, Stil), vocabulary.md, studied-works/ und examples/. Verbotene Phrasen (Don'ts), wiederkehrende Tics und Style Principles („Writing Discoveries“) liegen in der Datenbank. Der Prosa-Hook setzt die Don'ts und die wiederkehrenden Tics durch. Die Style Principles liest chapter-writer, und chapter-reviewer sowie author-check prüfen sie. Der Hook scannt sie nicht.
Mit /storyforge:study-author analysierst du eigene oder fremde Werke (PDF, EPUB, DOCX, TXT) und überträgst den Stil ins Profil. Mit /storyforge:harvest-author-rules übernimmst du Erkenntnisse eines fertigen Buchs ins Profil. Mit /storyforge:chapter-voice-harvest lernt StoryForge aus deinen Korrekturen in den Review-Runden und übernimmt bestätigte Muster als Style Principles ins Profil. Mehr: Autorenprofile.
| Typ | Genres |
|---|---|
| Basis (13) | Horror, Fantasy, Sci-Fi, Thriller, Mystery, Romance, Drama, Literary Fiction, Historical, Contemporary, Supernatural, Kinderbuch, Märchen |
| Übergreifend (1) | LGBTQ, wird mit jedem anderen Genre kombiniert |
| Mixe (2) | Dark Fantasy, Paranormal Romance |
Ein Buch kombiniert ein bis drei Genres. Eigene Genres und Mixe legst du mit /storyforge:genre-creator an. Mehr: Genre-System.
| Modus | Für wen | Vorgehen |
|---|---|---|
| Outliner | Planer | vollständiger Plot vor dem ersten Kapitel |
| Plantser | Hybrid | schlankes Outline, danach szenenweise Planung mit rolling-planner |
| Discovery | Entdeckungsschreiber | Szene für Szene ohne Outline, Kontinuität wird nachträglich geprüft |
Alle Modi nutzen dieselben Prüfungen. Mehr: Writing Modes.
plot-architect bietet neun Strukturen an: 3-Akt, Heldenreise, Save the Cat, 5-Akt (Freytag), Fichtean Curve, Story Circle, Seven-Point, Kishōtenketsu und Snowflake.
book_category: memoir ist eine zweite Buchkategorie neben Fiction. Sie bringt vier Strukturtypen (chronologisch, thematisch, verflochten, Vignetten), reale Personen unter people/ mit Einwilligungsstatus, eigene Skill-Varianten (-memoir) und eine Ethik-Prüfung vor dem Export. Mehr: Memoir-Unterstützung.
Serien liegen unter series/{serie}/{buch}/. Mit harvest-character-evolution hältst du den Endzustand wiederkehrender Figuren fest, new-book --copy-recurring-from= kopiert sie ins nächste Buch, und bootstrap-book-from-series bereitet sie vor. Die Daten fließen in den Chapter Writing Brief des Folgebands. Beispiel: Series-Workflow.
Hook bei jedem Schreibvorgang, Chapter Reviewer (33 Punkte, Kapitel 1 mit zusätzlich 13 Eröffnungs-Punkten), Chapter Voice Harvest, Humanizer, Proofreader, Voice Checker, Manuscript Checker, Continuity Checker und Plot-Logik. Details: Quality System.
Das Plugin bringt Craft-Referenzen mit: 33 allgemeine Handwerks-Dokumente unter reference/craft/ (Struktur, Plot, Figuren, Tempo, Dialog, POV, Spannung, Anti-AI-Muster und weitere), 9 genrespezifische Guides unter reference/genre/, 6 Memoir-Dokumente und fünf Vokabellisten für die POV-Prüfung.
claude plugin add storyforge
/storyforge:setup
/storyforge:create-author Mein Name
/storyforge:new-book
/storyforge:help
Voraussetzungen und Einzelheiten: Installation.
1. /storyforge:create-author Mein Name
2. /storyforge:new-book
3. /storyforge:book-conceptualizer mein-buch
4. /storyforge:plot-architect mein-buch
5. /storyforge:character-creator mein-buch
6. /storyforge:world-builder mein-buch
7. /storyforge:chapter-writer mein-buch 1
8. /storyforge:chapter-reviewer mein-buch 01-kapitel
9. /storyforge:chapter-humanizer mein-buch 01-kapitel
10. /storyforge:chapter-proofreader mein-buch 01-kapitel
11. /storyforge:manuscript-checker mein-buch
12. /storyforge:export-engineer mein-buch epub
Optional kannst du nach dem Review /storyforge:chapter-voice-harvest mein-buch 01-kapitel aufrufen, vor dem Humanizer; sind keine Rückmeldungen protokolliert, endet er mit einer Zeile.
1. /storyforge:create-author Mein Name
2. /storyforge:new-book (Kategorie memoir wählen)
3. /storyforge:book-conceptualizer mein-memoir
4. /storyforge:plot-architect-memoir mein-memoir
5. /storyforge:character-creator-memoir mein-memoir
6. /storyforge:chapter-writer-memoir mein-memoir 1
7. /storyforge:emotional-truth-prompt mein-memoir 01-kapitel
8. /storyforge:chapter-reviewer-memoir mein-memoir 01-kapitel
9. /storyforge:manuscript-checker-memoir mein-memoir
10. /storyforge:memoir-ethics-checker mein-memoir
11. /storyforge:export-engineer mein-memoir epub
Optional kannst du nach dem Review /storyforge:chapter-voice-harvest mein-memoir 01-kapitel aufrufen, vor dem Humanizer; sind keine Rückmeldungen protokolliert, endet er mit einer Zeile.
Für Plantser und Discovery Writer kommt rolling-planner vor jedem Kapitel dazu. /storyforge:next-step sagt dir jederzeit, was als Nächstes dran ist.
| Seite | Inhalt |
|---|---|
| Installation | Voraussetzungen, Setup, Windows-Hinweise |
| Konfiguration | config.yaml, linter_mode, Speicherorte |
| Skills-Referenz | Alle 61 Skills mit Argumenten |
| MCP-Tools | Alle 95 Tools des MCP-Servers |
| Technische Details | Hooks, Buchregeln, Briefs, Status-Modell, Migration |
| Datenschutz | Lokale Daten, externe Verbindungen, reale Personen |
| Fehlerbehebung | Häufige Probleme und Lösungen |
| Writing Modes | Outliner, Plantser, Discovery |
| Autorenprofile | Voice-System und Writing Discoveries |
| Genre-System | Genres, Mixing, eigene Genres |
| Quality System | Alle Prüfungen im Detail |
| Memoir-Unterstützung | Memoir als Buchkategorie |
| Workflow-Beispiel | Ein Buch von der Idee bis zum EPUB |
| Series-Workflow-Beispiel | Trilogie und Buchabschluss |
| Charakter-Anatomie | Aufbau einer Figurendatei |
| Banlist-Architektur | Wie verbotene Phrasen durchgesetzt werden |
Schreibt StoryForge das Buch für mich?
Es schreibt Prosa in der Stimme deines Autorenprofils, aber die kreativen Entscheidungen liegen bei dir. Jedes Kapitel durchläuft dein Inline-Review, und das Plugin wartet auf deine Freigabe, bevor es weiterschreibt.
Brauche ich eigene Werke als Vorlage?
Nein, aber es hilft. Du kannst ein Profil von Hand ausfüllen. study-author beschleunigt die Erfassung des Stils.
Welche Sprachen werden unterstützt?
Die Sprache wird je Buch festgelegt, der Standard ist Englisch. Die Craft-Referenzen sind englisch, gelten aber auch für andere Sprachen. chapter-proofreader prüft in der Sprache des Buchs.
Kann ich eine Serie verwalten?
Ja, mit series-planner und dem Serien-Lebenszyklus, siehe oben.
Was mache ich bei einer Schreibblockade?
/storyforge:unblock diagnostiziert die Art der Blockade anhand deines Buchs und schlägt gezielte Schritte vor.
Kann ich Drehbücher oder Spiele schreiben?
Nicht direkt. chapter-writer ist für Prosa gebaut. Für Video-Skripte gibt es VidCraft.
Wie gehe ich mit sensiblen Themen um?
/storyforge:sensitivity-reader prüft auf problematische Darstellungen, Stereotype und schädliche Tropes. Bei sensiblen Themen ersetzt das keinen menschlichen Sensitivity-Reader.
Der Hook meldet Blocker an meinem Entwurf. Was tun?
Die Meldung nennt Datei, Zeile und Quelle. Siehe Fehlerbehebung.
StoryForge steht unter der PolyForm Noncommercial License 1.0.0. Persönliche, nicht-kommerzielle Nutzung ist erlaubt. Kommerzielle Nutzung braucht eine ausdrückliche Genehmigung des Maintainers. Für Beiträge gilt eine Beitragsvereinbarung (CLA).