Wissensgraph in der Projektanweisung verankert

graphify ist eingerichtet (786 Knoten, 1179 Kanten) und in CLAUDE.md als
erster Griff bei Fragen zum Bestand festgehalten, statt Dateien durchzulesen.

Mit der Stolperfalle dokumentiert: das `graphify` im PATH läuft nicht, weil es
für Python 3.10 installiert ist und das System-python3 3.12 ist. Der Aufruf
muss über python3.10 mit gesetztem PYTHONPATH laufen.

graphify-out/ ist ein Bauartefakt und bleibt aus dem Repository.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

.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/

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.**