# Velith

English · 한국어 · 日本語 · 中文 · Español · Français · Deutsch · Português

**Bücher wie Software bauen.** KI-natives Publikationssystem für strukturierte Langform-Erstellung — von der leeren Seite bis zum EPUB/PDF. `Phase 0: Onboarding → Phase 1: Ideation → Phase 2: Outlining → Phase 3: Drafting → Phase 4: Editing → Phase 5: Publishing`

## Warum Velith? Ein Buch mit rohen LLM-Prompts zu schreiben führt zu unzusammenhängenden Kapiteln, inkonsistenter Stimme und fehlender Struktur. Velith bietet eine **Pipeline nach dem Prinzip Planen-dann-Ausführen** — vor dem Schreiben validieren, Qualität in jeder Phase sichern und die Kontinuität über das gesamte Manuskript aufrechterhalten. ## Benchmark Was die Pipeline mit unstrukturiertem Input macht — [selbst ausprobieren →](https://huggingface.co/spaces/epicsaga/Velith) | Metrik | Roheingabe | Nach der Velith-Pipeline | |--------|-----------|--------------------------| | Strukturbewertung | 2–4 / 10 | 6–9 / 10 | | Redundanz | 20–45% n-gram-Überlappung | < 10% nach Konsolidierung | | KI-Schund-Marker | 6–20 pro 1.000 Wörter | Erkannt und entfernt von style-doctor | | Kapitelhierarchie | Keine | Erkannt + mit Querverweisen kartiert | | Kohärenzbewertung | 0,3–1,5 / 10 | Verbessert durch Abschnittsumstrukturierung | | | Funktion | Warum es wichtig ist | |--|----------|----------------------| | 📋 | 6-Phasen-Pipeline | Jede Phase validiert vor dem Weitermachen — kein Nacharbeiten | | 📖 | 7 Genre-Vorlagen | Belletristik, Sachbuch, Technik, Drehbuch, Poesie, Spiel, Akademisch (+ benutzerdefiniert via genre-creator) | | 🤖 | 8 spezialisierte Agenten | Architektur, Entwurf, Szenengenerierung, Kontinuität, Stil, Cover, Illustrationen, Marketing | | ✏️ | 5-stufiges Lektorat | Beurteilung → Entwicklung → Zeile → Korrektorat → Schlusskorrektur | | 🔄 | Überall fortsetzen | Abgeschlossene Kapitel überspringen, dort weitermachen wo man aufgehört hat | | 📦 | EPUB, PDF, MOBI, TXT, Markdown | Veröffentlichungsfertige Dateien via Pandoc + Calibre | ## Eine Pipeline, viele Artefakte Velith wird als Buch-Pipeline ausgeliefert, aber dieselben 6 Phasen gelten für **jedes strukturierte Langform-Wissen**. Ob das Artefakt ein 300-seitiger Roman oder ein 12-seitiges RFC ist — der Plan-then-Execute-Fluss, die Quality Gates und die Agenten sind identisch. | Artefakt | Genre-Skill | Typische Ausgabe | |----------|-------------|----------------| | Roman / Geschichte | `book-fiction` | EPUB / PDF / MOBI | | Sachbuch | `book-nonfiction` | EPUB / PDF | | RFC / Design-Doc | `book-technical` | Markdown / PDF | | Whitepaper / Forschungsbericht | `book-academic` | PDF (Zitate) | | Kursmaterial / Tutorial | `book-technical` | EPUB / PDF | | Spielszenario / Lore-Bibel | `book-game` | Markdown / EPUB | ## Vergleich | | Velith | Rohe Prompts | Notion AI | Jasper / Sudowrite | Scrivener | |--|-----------|-------------|-----------|-------------------|-----------| | Strukturvalidierung | Phasengesteuerter Pipeline | Keine | Keine | Grundvorlagen | Manuell | | Kapitelübergreifende Kontinuität | Dedizierter Agent | Manuell | Keine | Begrenzt | Manuell | | KI-Schunddetektion | Eingebaut (style-doctor) | Keine | Keine | Keine | Keine | | Genre-Bewusstsein | 8 Genre-Systeme + benutzerdefiniert | Abhängig vom Prompt | Keine | Belletristik-fokussiert | Keine | | Ausgabeformat | EPUB, PDF, MOBI, TXT, Markdown | Kopieren-Einfügen | Markdown / PDF | DOCX, begrenzt | DOCX, PDF | | Qualitätskontrolle | Jede Phase | Keine | Keine | Keine | Keine | | Erfordert | Claude Code, Codex CLI, Agy, Cursor, Cline oder Aider | Beliebiges LLM | Notion-Abo | Abonnement | Lizenz | | Volle Kontrolle | Prompt-Ebene | Vollständig | Black Box | Black Box | Vollständig | ## Installation ### Claude Code ```bash # epicsagas-Marktplatz hinzufügen (erstmalig) claude plugin marketplace add epicsagas # velith installieren claude plugin install velith@epicsagas ``` **Voraussetzungen:** [Claude Code](https://claude.ai/code) CLI installiert und authentifiziert. ### Codex CLI (OpenAI) ```bash codex plugin marketplace add epicsagas/plugins ``` **Voraussetzungen:** [Codex CLI](https://github.com/openai/codex) installiert und mit einem OpenAI-API-Schlüssel konfiguriert. ### Agy (Antigravity) ```bash agy plugin install https://github.com/epicsagas/Velith ``` Agy erkennt Skills und Agenten automatisch aus dem Repository-Root. Keine zusätzliche Konfiguration erforderlich. **Voraussetzungen:** [Agy](https://antigravity.google/docs/cli-install) installiert und konfiguriert. ### Cursor Velith bietet Kontextregeln in `.cursor/rules/`, die dem Cursor-Agent volle Kenntnis des Publishing-Pipelines, Genre-Muster und Bearbeitungsstandards geben. Die Regeln werden beim Öffnen eines Buchprojekts in Cursor automatisch geladen. **Voraussetzungen:** [Cursor](https://cursor.sh) installiert. ### Cline Velith bietet Projektanweisungen in `.clinerules` im Repository-Root. Cline liest diese automatisch beim Arbeiten im Projektverzeichnis. **Voraussetzungen:** [Cline](https://github.com/cline/cline)-Erweiterung in VS Code oder JetBrains installiert. ### Aider Velith bietet Schreibkonventionen in `CONVENTIONS.md`, die über `.aider.conf.yml` automatisch geladen werden. ```bash aider # CONVENTIONS.md wird automatisch geladen ``` **Voraussetzungen:** [Aider](https://aider.chat) installiert und mit einem API-Schlüssel konfiguriert. ## Schnellstart ```bash # Neues Buchprojekt starten > /book-init # Aktuelle Phase automatisch erkennen und fortfahren > /loom ``` Das Plugin führt Sie durch: 1. **Onboarding** — Genre, Zielgruppe, Sprache, Quellmaterial, Stilrichtlinien 2. **Ideation** — Marktforschung, Konzeptdestillation, konkurrierende Titel 3. **Outlining** — Vollständige Kapitelgliederung mit Spezifikationen, Abhängigkeiten, Querverweisen 4. **Drafting** — Kapitelweise Generierung mit parallelen Unteragenten 5. **Editing** — 5-stufiger Pipeline: Beurteilung → Entwicklung → Zeile → Korrektorat → Schlusskorrektur 6. **Publishing** — EPUB/PDF/MOBI-Konvertierung, Metadaten, Marketingplan ## Skills | Skill | Phase | Beschreibung | |-------|-------|--------------| | `/loom` | Router | Phase automatisch erkennen und weiterleiten | | `/book-init` | 0 | Neues Buchprojekt starten — Genre, Zielgruppe, Stilrichtlinien | | `/book-ideation` | 1 | Konzepte generieren und validieren, Wettbewerbsanalyse | | `/book-outline` | 2 | Kapitelgliederung erstellen (mit Abhängigkeiten) | | `/book-draft` | 3 | Kapitel entwerfen (alle/bestimmte/fortsetzen, parallele Agenten) | | `/book-edit` | 4 | 5-stufige Lektorierpipeline | | `/book-publish` | 5 | EPUB/PDF/MOBI-Konvertierung, Cover, Marketing | | `/book-illustrate` | 3-5 | Innenillustrationen — Szenenextraktion, stil-konsistente Prompts, Platzierungsplan | | `/book-status` | — | Terminal-Dashboard + `--ui` Browser-Dashboard | | `/book-fiction` | — | Belletristik-Pattern (15 Beats, Snowflake, Charakterbibel) | | `/book-nonfiction` | — | Sachbuch-Pattern (Problem-Lösung, Evidenzhierarchie) | | `/book-technical` | — | Technikbuch-Pattern (Konzeptgradient, Code, Labs) | | `/book-screenplay` | — | Drehbuch-Pattern (3-Akt, Dialog, A/B-Story) | | `/book-poetry` | — | Poesie-Pattern (Formen, Bildsprache, Strophenstruktur) | | `/book-game` | — | Spiel-Szenario-Pattern (Quest-Bäume, Verzweigungen, Lore-Bibel) | | `/book-academic` | — | Akademisch-Pattern (IMRAD, Literaturreview, Argumentationsketten) | | `/book-genre-creator` | — | Genre-Auswahlhilfe und Assistent für benutzerdefinierte Genre-Erstellung | ## Agenten | Agent | Rolle | |-------|-------| | `book-architect` | Struktur validieren, Gliederungen bewerten, Pacing prüfen | | `chapter-writer` | Kapitelentwürfe mit Genre-Vorlagen generieren | | `continuity-editor` | Kapitelübergreifende Konsistenz (Terminologie, Referenzen, Zeitlinie) | | `style-doctor` | Stimme/Ton-Konsistenz, KI-Schunddetektion | | `scene-generator` — Szenenebene-Analyse mit GMC+RDD-Struktur (nur Belletristik) | | `cover-designer` | Cover-Konzepte + Midjourney/DALL-E-Bildprompts | | `illustrator` | Innenillustrationen — Szenenextraktion, Style-Bible, Prompt-Generierung | | `marketing-expert` | Leserpersonas, Kanalstrategie, 12-Wochen-Launchkalender | ## Visuelles Dashboard

`/book-status --ui` öffnet ein Svelte-basiertes Fortschritts-Dashboard in Ihrem Browser. Das Dashboard aktualisiert sich alle 5 Sekunden automatisch: - 6-Phasen-Pipeline-Tracker (Onboarding → Ideation → Outlining → Drafting → Editing → Publishing) - 8 Agenten-Statuskarten (book-architect, chapter-writer, continuity-editor, cover-designer, illustrator, marketing-expert, scene-generator, style-doctor) - Kapitelgliederung, Entwurfstabelle und 5-stufiges Lektorats-Kanban - Status der Ausgabedateien (EPUB/PDF/MOBI/TXT/MD) mit Veröffentlichungs-Checkliste - Projekteinstellungen und Befehlsreferenz Das Dashboard liest dynamisch aus projektspezifischen `status.json`-Dateien. Das vorkompilierte `dist/` ist enthalten — kein Build-Schritt für Plugin-Nutzer erforderlich. Für lokale Entwicklung ausführen: ```bash cd dashboard npm install npm run dev # http://localhost:5173 npm run build # dist/ neu bauen ``` ## Designprinzipien - **Planen-dann-Ausführen** — Erst die Gliederung, validieren, dann schreiben - **Idempotent** — Abgeschlossene Kapitel überspringen, dort weitermachen wo man aufgehört hat - **Token-Effizient** — Zusammenfassungsbasierter Kontext, kein vollständiger Text - **Genre-Bewusst** — Unterschiedliche Strukturen, Vorlagen und Validierung je Genre - **Qualitätskontrolle** — Jede Phase muss Kriterien bestehen bevor es weitergeht ## Externe Abhängigkeiten Für EPUB/PDF-Ausgabe (Phase 5): ```bash brew install pandoc # EPUB/PDF-Konvertierung brew install texlive # PDF mit CJK/Koreanisch-Unterstützung brew install --cask calibre # MOBI (Kindle)-Konvertierung — optional ``` ### Fehlerbehebung

pandoc nicht gefunden

Über Homebrew installieren: ```bash brew install pandoc ```

CJK/PDF-Zeichen fehlen oder sind beschädigt

Eine CJK-fähige LaTeX-Distribution installieren: ```bash brew install texlive # Oder für Minimalinstallation: brew install basictex && sudo tlmgr install collection-langkorean ```

Plugin-Befehle nach der Installation nicht gefunden

Claude Code neu starten um Plugins neu zu laden: ```bash claude restart ```

## Projektstruktur Wenn Sie ein Buchprojekt erstellen, richtet Velith folgendes ein: ``` {project-dir}/ ├── PRD.md # Buchanforderungen ├── STYLE.md # Stimme, Ton, Konventionen ├── ideation.md # Ideen, Marktforschung ├── outline.md # Vollständige Kapitelgliederung ├── drafts/ # Kapitelentwürfe │ ├── ch00-foreword.md │ ├── ch01-xxx.md │ └── ... ├── edits/ # Lektoriatsberichte │ └── editorial-report.md ├── publish/ # Finale Ausgabedateien │ ├── book.epub │ ├── book.pdf │ ├── book.mobi │ └── metadata.yaml └── sources/ # Quellmaterial-Referenzen ``` ## Integration ### Integrierte Agent-Workflows Kein zusätzliches Setup — werden automatisch in der Pipeline ausgeführt: - **discover** — Während `/book-outline` untersucht `book-architect` blinde Flecken und Widersprüche im Buchkonzept vor der Strukturfestlegung - **council** — Während `/book-outline` und `/book-edit` werden verschiedene redaktionelle Perspektiven (Lektorat, Struktur, Zeilenbearbeitung) in Gliederungs- und Überarbeitungsentscheidungen einbezogen ### alcove — Research-Vault als Quellmaterial [alcove](https://github.com/epicsagas/alcove) ist ein privater Dokumentserver, der es Velith Agenten ermöglicht, beim Schreiben auf Ihre bestehenden Notizen, Recherchen und Projektdokumente als Quellmaterial zuzugreifen. **Wann es hilft:** - Sie haben jahrelange Recherche-Notizen, Interview-Transkripte oder Referenzdokumente, die der Agent zitieren soll - Sie schreiben Sachbücher und benötigen Fakten aus strukturierter Projektdokumentation - Sie pflegen eine Wissensbasis mit Glossaren, Zeitleisten oder Weltbau-Details, die der Agent berücksichtigen soll **So verwenden Sie es:** 1. Installieren und konfigurieren Sie alcove als MCP-Server in Ihren Claude Code-Einstellungen 2. Geben Sie bei `/book-init` Ihr alcove-Projekt als Quelle an 3. Agenten fragen alcove beim Verfassen automatisch ab und beziehen Ihre Recherche ein ### obsidian-forge — Vom Denken zum Schreiben [obsidian-forge](https://github.com/epicsagas/obsidian-forge) verbindet Ihren Obsidian-Vault mit Velith, sodass Sie in Obsidian recherchieren und mit Velith schreiben können, ohne Dateien manuell zu kopieren. **Wann es hilft:** - Ihre Recherchen, Charakterprofile und Referenznotizen leben bereits in einem Obsidian-Vault - Sie möchten Gliederungen in Obsidians verlinkter Notizumgebung iterieren, bevor Sie sie an Velith übergeben - Sie arbeiten mit Koautoren zusammen, die Obsidian für Brainstorming bevorzugen **So verwenden Sie es:** ```bash # Buchprojekt in Ihrem Obsidian-Vault erstellen (01-Projects/) of book init my-book --genre non-fiction --lang ko # In Obsidian arbeiten: Recherche-Notizen, Charakterprofile, Referenzen # Notizen mit book/my-book taggen um sie als Quellmaterial zu verknüpfen of book sync my-book # In ein eigenständiges Verzeichnis exportieren wenn bereit zum Schreiben of book export my-book --output ~/projects/my-book # Nun velith auf dem exportierten Projekt ausführen > /loom ``` Sowohl alcove als auch obsidian-forge sind **optional** — Velith funktioniert eigenständig. ## Beitragen Siehe [CONTRIBUTING.md](../../CONTRIBUTING.md). PRs willkommen — schauen Sie sich Issues mit dem Label `good first issue` an. ## Lizenz [Apache-2.0](../../LICENSE)