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>
This commit is contained in:
Harlekin
2026-09-01 23:03:06 +02:00
co-authored by Claude Opus 5
parent 1e5a470daf
commit e5211dcb5d
2 changed files with 28 additions and 0 deletions
+25
View File
@@ -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.**