xichia/novel-framework

Was macht novel-framework?

Ein Git-ähnliches Framework für die Entwicklung von Romanen mit Kanon, Verzweigungen, Entscheidungsprotokollen, Agenten-Fähigkeiten und umkehrbarer Story-Architektur.

Übersicht

Dieses Framework ermöglicht es, Romane mit denselben Prinzipien zu entwickeln, die Softwareentwickler:innen von Versionskontrollsystemen kennen. Es richtet sich an Autor:innen, die mit KI-Agenten zusammenarbeiten, und bietet:

• Kanon – Ein verbindlicher „Master“-Zweig, der die offizielle, veröffentlichte Version der Geschichte darstellt.
• Branches – Alternative Handlungsstränge, Charakterperspektiven oder experimentelle Szenen, die unabhängig vom Kanon entwickelt werden.
• Decision Logs – Ein vollständiges Protokoll aller wichtigen Story-Entscheidungen mit Begründung, Alternativen und Auswirkungen.
• Agent Skills – Modulare KI-Fähigkeiten, die spezifische Aufgaben wie Plotanalyse, Dialogerzeugung oder Charakterkonsistenz übernehmen.
• Reversible Story Architecture – Jede Änderung kann rückgängig gemacht oder in andere Zweige übernommen werden, ähnlich wie bei Git-Commits.

Verwendung

1. Initialisieren Sie das Framework mit novel init in Ihrem Projektverzeichnis.
2. Erstellen Sie einen Kanon-Zweig: novel branch canon.
3. Fügen Sie Entscheidungen hinzu: novel decision add --title "Charaktere treffen sich im Café" --choice "Sie bleiben diskret" --impact "Spannung bleibt erhalten".
4. Nutzen Sie Agent Skills: novel skill run char-dev --target protagonist.
5. Führen Sie Branches zusammen: novel merge branch alternate-ending.

Konfiguration

Erstellen Sie eine novel.config.json-Datei im Wurzelverzeichnis:

{
  "canonBranch": "main",
  "decisionLogDir": ".novel/decisions",
  "skillsDir": ".novel/skills",
  "storyStructure": {
    "acts": 3,
    "chaptersPerAct": 10
  }
}

Beispiel für einen Decision Log

---
date: 2025-03-22
title: "Protagonist erhält Einladung"
choice: "Er nimmt an – gegen seinen Instinkt"
alternatives:
  - "Er lehnt ab – Geschichte wird zu kurz"
  - "Er zögert – Cliffhanger möglich"
impact: "Führt zu Kapitel 7, erhöht Konflikt mit Antagonist"
status: accepted
---

Agent Skills

Folgende Standard-Skills sind enthalten:

• char-dev – Charakterentwicklung und Konsistenzprüfung
• plot-analyzer – Analyse der Handlungsstruktur und Erkennung von Logiklücken
• dialogue-tune – Optimierung von Dialogen hinsichtlich Charakterstimme und Subtext
• world-build – Erweiterung und Validierung der Weltbaudetails

Lizenz

MIT