StoryForge: Konfiguration
Alle Konfigurationsschlüssel von StoryForge: config.yaml, welche Werte tatsächlich wirken, Per-Buch-Einstellung linter_mode, Autorenprofil-Schreibmodus und Speicherorte.
StoryForge: Konfiguration
Die Datei ~/.storyforge/config.yaml
Das Setup-Skill kopiert config/config.example.yaml nach ~/.storyforge/config.yaml. Beim Laden werden die Werte der Datei über eingebaute Standardwerte gelegt. Fehlt die Datei, gelten die Standardwerte. Pfade unter paths werden mit ~ und Umgebungsvariablen aufgelöst.
Zum Bearbeiten kannst du die Datei direkt ändern oder /storyforge:configure nutzen. Das Skill zeigt die aktuellen Werte, fragt nach Änderungen und liest die Datei danach zur Kontrolle erneut.
paths:
content_root: "~/projekte/book-projects"
authors_root: "~/.storyforge/authors"
defaults:
language: "en"
book_type: "novel"
review_handle: "Author"
export:
default_format: "epub"
cover:
platform: "midjourney"
post_processing:
tool: "canva"
Schlüssel und ihre Wirkung
| Schlüssel | Standard | Wirkung |
|---|---|---|
paths.content_root |
~/projekte/book-projects |
Wurzel für Bücher, Serien und Ideen. Wird von allen Buch-Tools genutzt. |
paths.authors_root |
~/.storyforge/authors |
Ort der Autorenprofile. |
defaults.review_handle |
Author |
Name, mit dem du Inline-Kommentare in draft.md einleitest (zum Beispiel Author: diese Zeile passt nicht). Das Tool get_review_handle_config und der Chapter-Writing-Brief liefern ihn an die Skills. |
export.default_format |
epub |
Format, das export-engineer nimmt, wenn du keines nennst (epub, pdf oder mobi). Fehlt der Wert, fragt das Skill nach. |
post_processing.tool |
canva |
Werkzeug für die Cover-Typografie: canva, gimp oder photoshop. Das Tool get_post_processing_config und cover-typography-mockup richten sich danach. Ein unbekannter Wert fällt auf canva zurück. |
Schlüssel ohne Wirkung
Die Beispiel-Config enthält weitere Schlüssel, die der Plugin-Code und die Skills nicht auswerten. Du kannst sie setzen, sie ändern aber nichts. Das Skill /storyforge:configure bietet einige davon trotzdem zur Änderung an (Sprache, Buchtyp, Buchkategorie, PDF-Engine, Cover-Plattform).
| Schlüssel | Stattdessen |
|---|---|
defaults.language |
Die Sprache fragt new-book beim Anlegen des Buchs ab (Vorschlag: Englisch) und speichert sie im Buch. |
defaults.book_type |
Den Buchtyp fragt new-book ab. |
defaults.book_category |
Die Kategorie (fiction oder memoir) fragt new-book ab. |
export.pandoc_path |
Der Export ruft pandoc aus dem PATH auf. |
export.calibre_path |
Der MOBI-Export ruft ebook-convert aus dem PATH auf. |
export.pdf_engine |
Der PDF-Export nutzt fest xelatex. |
cover.platform |
cover-artist erzeugt Prompts für DALL-E und Midjourney, unabhängig vom Wert. |
cover.default_style |
Wird nicht gelesen. |
translation.preserve_formatting, translation.include_glossary |
Werden nicht gelesen. |
Wenn Pandoc oder Calibre nicht im
PATHliegen, hilft der Config-Schlüssel nicht. Ergänze denPATHdes Systems.
Einstellungen pro Buch
linter_mode
Der Prosa-Hook prüft jede Änderung an einer draft.md. Standard ist strict: Bei Funden der Stufe „block“ beendet sich der Hook mit Exit-Code 2 und gibt die Meldung an Claude zurück, das den Text korrigieren muss. Pro Buch kannst du auf warn umschalten, dann werden Blocker nur noch als Hinweis gemeldet. Der Wert steht im YAML-Frontmatter der CLAUDE.md im Buch-Hauptverzeichnis:
---
linter_mode: warn
---
Gültig sind nur strict und warn. Eine globale Einstellung in der config.yaml gibt es nicht. Details zum Hook: Technische Details.
Buch-Metadaten
Titel, Autor, Genres, Buchtyp, Kategorie und Sprache stehen im Frontmatter der README.md des Buchs. Beim Anlegen vorgeschlagene Zielwortzahlen je Buchtyp:
Buchtyp (book_type) |
Vorschlag Zielwortzahl |
|---|---|
short-story |
5.000 |
novelette |
12.000 |
novella |
30.000 |
novel |
80.000 |
epic |
120.000 |
Die Kategorie book_category ist fiction oder memoir und unabhängig vom Buchtyp. Ein Memoir kann also eine Novella sein.
Einstellungen pro Autor
Im Frontmatter von profile.md des Autors steht author_writing_mode mit den Werten outliner, plantser oder discovery. Der Wert steuert, welche Planungs-Skills dir vorgeschlagen werden. Ändern kannst du ihn über /storyforge:configure oder das Tool update_author. Für Memoir-Bücher fragt /storyforge:create-author stattdessen nach Structured, Accumulative oder Discovery; beim Speichern über update_author werden Structured und Accumulative automatisch auf outliner beziehungsweise plantser abgebildet, danach steht im Profil der kanonische Wert. Ein Buch kann den Modus überschreiben. Mehr dazu auf der Seite Writing Modes.
Speicherorte
| Pfad | Inhalt |
|---|---|
~/.storyforge/config.yaml |
Konfiguration |
~/.storyforge/venv/ |
Virtuelle Python-Umgebung |
~/.storyforge/cache/state.json |
State-Cache, wird automatisch neu aufgebaut |
~/.storyforge/db/ |
SQLite-Datenbanken: storyforge.db (Session), authors.db (Autoren-Erkenntnisse, Review-Feedback) und eine Datei je Serie oder Einzelband |
~/.storyforge/snapshots/ |
Vergleichsfassungen und Rohfassungen der Fiction-Entwürfe (einfache Dateien, lokal; Verzeichnis per Umgebungsvariable STORYFORGE_SNAPSHOT_DIR änderbar) |
~/.storyforge/authors/{slug}/ |
Autorenprofile: profile.md, vocabulary.md, studied-works/, examples/ |
~/.storyforge/genres/{genre}/ |
Eigene Genres (README.md), angelegt mit /storyforge:genre-creator. Überleben Plugin-Updates; bei gleichem Namen hat das eigene Genre Vorrang vor einem eingebauten. |
{content_root}/projects/{buch}/ |
Einzelbände |
{content_root}/series/{serie}/{buch}/ |
Bücher einer Serie |
{content_root}/ideas/{slug}.md |
Buchideen, eine Markdown-Datei je Idee |
Die Datenbanken enthalten Buchregeln, Callbacks, Canon-Fakten, Charakter-Snapshots, Autoren-Erkenntnisse, Review-Rückmeldungen und die Cover-Verwaltung. Aufbau und Verzeichnisstruktur eines Buchs: Technische Details.