buchwerk

Aus einem Thema (plus optionalen Hinweisen und einer optionalen Spezialisierung, die den Umfang begrenzt) entsteht ein deutschsprachiges Sachbuch. Ein Python-Backend steuert Agenten des Claude Agent SDK (Opus 5.5): Recherche und Deutung, Gliederung, Kapitel parallel schreiben, jedes Kapitel durch einen unabhängigen Agenten prüfen, Querverweise abgleichen, Vorwort, Montage (Markdown, README, PDF). Das Buch wird im Browser als Leseansicht gezeigt.

make install     # venv + npm
make build       # Frontend bauen
make run         # http://localhost:8020

Auth lokal: der Agent SDK nutzt den Claude-Code-Login des Rechners (oder ANTHROPIC_API_KEY, falls gesetzt).

Produktion (Docker, Traefik-Netz web, https://buchwerk.marha.de):

cp .env.example .env      # CLAUDE_CODE_OAUTH_TOKEN eintragen (claude setup-token) oder ANTHROPIC_API_KEY
make prod                 # docker compose up -d --build
make logs / make stop

storage/ und .claude-data/ (Sitzungen der CLI) werden als Volumes eingebunden; die Claude-Code-CLI liegt als Binary im SDK, Node wird im Container nicht gebraucht.

Ablauf (backend/pipeline.py): Stufen seriell, innerhalb einer Stufe bis zu PARALLEL Agenten gleichzeitig. Jeder Agent arbeitet im Themenverzeichnis storage/<Thema>/; sein Abschlussbericht landet unter berichte/ und dient als Marker: existiert der Bericht, gilt die Aufgabe als erledigt. Pause bricht laufende Agenten ab, „Fortsetzen“ wiederholt nur, was noch fehlt. Prompts liegen in prompts/, Schnittstelle in API.md.