schreibwerkstatt/README.md
Kenearos 70205b6b93 Add Floskel-Killer skill: adversarial prose review against clichés and repetitive patterns
New skill with 6 detection categories (moment inflation, vague emotions,
conjunctive overload, atmosphere formulas, structural ticks, leitmotif wear)
plus quantitative thresholds and severity-graded reporting. Integrated into
Lektor workflow, CLAUDE.md orchestrator pipeline, and README.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-17 19:48:33 +02:00

143 lines
5.9 KiB
Markdown

# 📖 Schreibwerkstatt
**BMAD-Modul für KI-gestützte Roman-Entwicklung**
> Schreibe Romane mit einem Team spezialisierter KI-Agenten — von der Synopsis bis zum fertigen E-Book.
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![BMAD Compatible](https://img.shields.io/badge/BMAD-v6-blue.svg)](https://github.com/bmad-code-org/BMAD-METHOD)
---
## Was ist das?
Schreibwerkstatt ist ein [BMAD](https://github.com/bmad-code-org/BMAD-METHOD)-kompatibles Modul das den Prozess des Romanschreibens in spezialisierte Rollen aufteilt — genau wie BMAD es für Software-Entwicklung tut.
Statt dass eine KI alles alleine macht, arbeiten **7 spezialisierte Agenten** zusammen:
| Agent | Rolle | Was er tut |
|-------|-------|-----------|
| 🎭 **Dramaturg** (Dr. Dramatis) | Plot-Architekt | Synopsis, Kapitelplan, Spannungsbögen |
| ✍️ **Autor** (Quill) | Prosa-Schreiber | Kapitel nach Bibel und Plan schreiben |
| 🔴 **Lektor** (Rotfeder) | Qualitätsprüfer | Sprache, Stil, Konsistenz |
| 🧠 **Figurenprüfer** (Persona) | Charakter-Psychologin | Figurenkonsistenz, Motivation, Arcs |
| ⏱️ **Kontinuitätsprüfer** (Chronos) | Archivar | Plotholes, Zeitlinien, Logik |
| 🔮 **Motivjäger** (Symbolon) | Literaturwissenschaftler | Motive, Symbole, Themen |
| 🎯 **Floskel-Killer** | Adversarial Review | Klischees, Fuellmuster, repetitive Patterns |
| 🤖 **KI-Muster-Erkennung** | Perplexity Gate | Erkennt AI-Slop |
## Features
- **Bibel-System**: Single Source of Truth für Figuren, Orte, Stil und Motive
- **State-Management**: Versionierter Zustand pro Kapitel (wer weiß was, wer fühlt was)
- **Review-Pipeline**: Jedes Kapitel durchläuft eine Qualitätsprüfung mit Human-in-the-Loop
- **KI-Muster-Erkennung**: Erkennt typische KI-Formulierungen und schlägt Alternativen vor
- **Export**: EPUB, DOCX und Markdown
- **Deutsch-first**: Komplett auf Deutsch, mit englischer Unterstützung
## Schnellstart
### Standalone (ohne BMAD)
```bash
git clone https://github.com/Kenearos/schreibwerkstatt.git
cd schreibwerkstatt
bash scripts/setup.sh
claude
```
Dann sage: **"Hilfe"**
### Als BMAD-Modul
```bash
# In einem bestehenden BMAD-Projekt:
npx bmad-method install
# → Wähle "Schreibwerkstatt" aus der Modulliste
```
> **Hinweis:** Die Integration in den offiziellen BMAD-Installer ist geplant. Aktuell funktioniert die Standalone-Installation.
## Projektstruktur
```
schreibwerkstatt/
├── CLAUDE.md # Orchestrator (Herzstück)
├── module.yaml # BMAD-Modul-Definition
├── bibel/ # 📚 Single Source of Truth
│ ├── stil.md # Tonalität, Regeln, verbotene Wörter
│ ├── motive.md # Motivregister und Symbolik
│ ├── figuren/ # Eine Datei pro Figur
│ │ └── _vorlage.md # Template
│ └── orte/ # Eine Datei pro Ort
│ └── _vorlage.md # Template
├── geschichte/ # 📋 Planung
│ ├── synopsis.md # Handlungsübersicht
│ └── plan.md # Kapitelplan mit Beats
├── zustand/ # 🔄 State-Management
│ ├── aktuell.md # Globaler Projektzustand
│ └── kapitel/ # Pro-Kapitel-Zustand
├── skills/ # 🤖 BMAD-Skills
│ ├── sw-setup/ # Setup-Workflow
│ ├── dramaturg/ # Plot & Struktur
│ ├── autor/ # Prosa schreiben
│ ├── lektor/ # Lektorat
│ ├── figurenprufer/ # Figurenkonsistenz
│ ├── kontinuitaetsprufer/ # Plotholes & Logik
│ ├── motivjaeger/ # Motive & Symbole
│ ├── stilprufer/ # Stilanalyse
│ ├── floskel-killer/ # Anti-Klischee & Pattern-Scan
│ ├── ki-muster-erkennung/ # Anti-AI-Slop
│ └── kapitel-export/ # EPUB/DOCX/MD Export
├── agents/ # 🎭 Agent-Definitionen (YAML)
├── scripts/ # ⚙️ Setup & Export-Scripts
└── _bmad-output/ # 📁 Generierte Dateien
├── kapitel/ # Geschriebene Kapitel
└── export/ # EPUB, DOCX, MD
```
## Workflow
```
1. Bibel füllen → Figuren, Orte, Stil, Motive definieren
2. Synopsis → Mit dem Dramaturg die Handlung entwickeln
3. Kapitelplan → Beats und Spannungsbögen planen
4. Schreiben → Kapitel für Kapitel mit dem Autor
5. Review → Lektor, Figurenprüfer, Kontinuität, Motive
6. Floskel-Check → Klischees, Moment-Inflation, vage Emotionen finden
7. KI-Check → AI-Slop erkennen und umschreiben
8. Export → EPUB, DOCX oder Markdown
```
Jeder Schritt ist ein **Gate** — du entscheidest ob es weitergeht.
## Voraussetzungen
- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) (empfohlen)
- Python 3.8+ (für Export-Funktionen)
- Optional: `python-docx`, `ebooklib` (für DOCX/EPUB-Export)
## Inspiration
Schreibwerkstatt kombiniert Ideen aus:
- **[BMAD Method](https://github.com/bmad-code-org/BMAD-METHOD)** — Multi-Agent-Architektur und Modul-System
- **[Claude Book](https://github.com/topics/claude-book)** — Bibel-System, Perplexity Gate, State-Management
- **Klassische Lektoratsprozesse** — Review-Pipeline mit spezialisierten Rollen
## Contributing
Pull Requests willkommen! Besonders gesucht:
- Neue Agenten (z.B. Worldbuilder, Dialog-Coach)
- Verbesserungen an der KI-Muster-Erkennung
- Übersetzungen (aktuell: Deutsch, geplant: English)
- Bessere Export-Templates
## Lizenz
[MIT](LICENSE) — Mach damit was du willst.
---
*Gebaut mit 🖊️ und KI von [Kenearos](https://github.com/Kenearos)*