diff --git a/.gitignore b/.gitignore
index 982654a..12e6bb4 100644
--- a/.gitignore
+++ b/.gitignore
@@ -14,6 +14,9 @@ packages/db/src/generated/
 .env.*
 !.env.example
 
+# Wissensgraph, wird aus dem Quellcode erzeugt
+graphify-out/
+
 coverage/
 test-results/
 playwright-report/
diff --git a/CLAUDE.md b/CLAUDE.md
index 1df8773..4736cc8 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -39,6 +39,31 @@ Vor dem Bau eines Bereichs immer das passende Dokument lesen:
 
 `TASKS.md` enthält die Bauphasen. Arbeite sie in Reihenfolge ab und hake ab, was fertig ist.
 
+## Wissensgraph (graphify)
+
+Für Fragen zum Bestand **zuerst** den Graphen befragen, statt Dateien durchzulesen. Das
+spart Kontext und zeigt Zusammenhänge über Dateigrenzen hinweg.
+
+```bash
+# Achtung: das `graphify` im PATH läuft nicht — es ist für Python 3.10
+# installiert, das System-python3 ist 3.12. Deshalb immer so aufrufen:
+export PYTHONPATH="$HOME/.local/lib/python3.10/site-packages"
+python3.10 -m graphify query "<Frage>" --budget 2000
+python3.10 -m graphify path "<A>" "<B>"      # Zusammenhang zwischen zwei Knoten
+python3.10 -m graphify explain "<Begriff>"   # ein Knoten und seine Nachbarn
+python3.10 -m graphify affected "<X>"        # was hängt an X, rückwärts
+python3.10 -m graphify god-nodes --top 10    # die am stärksten verdrahteten Stellen
+```
+
+**Nach jeder Änderung am Code** den Graphen nachziehen, das kostet nichts und braucht kein
+LLM:
+
+```bash
+python3.10 -m graphify update . --no-cluster
+```
+
+`graphify-out/` ist ein Bauartefakt und liegt nicht im Repository.
+
 ## Harte Regeln
 
 1. **Berechtigungsprüfung immer serverseitig und immer in der Datenbankabfrage.**