docs(claude): graphify als Hartregel — Graph-first Memory + Auto-Update ohne explizite Aufforderung

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
chahinebrini 2026-06-10 13:21:07 +02:00
parent c82c94e457
commit f81978362e

View File

@ -4,8 +4,22 @@
## graphify (Knowledge-Graph) ## graphify (Knowledge-Graph)
> ### ⚠️ HARTREGEL — automatisch, ohne dass der User es je erwähnen muss
>
> 1. **Memory/Kontext = Graph-FIRST, immer.** Bei JEDER Frage zu Code, Architektur,
> Modulen oder Traceability ZUERST `graph.json` abfragen (per CLI/Python-Script,
> kompakte Ausgabe) und daraus die relevanten Dateien/Symbole bestimmen — DANN gezielt
> nur diese 12 Dateien lesen. **Nie** blind grep-en oder breit lesen, wenn der Graph
> die Antwort eingrenzen kann. Der User sagt „nutze graphify" NIE explizit — es ist Default.
> 2. **Wartung = Graph-Update, automatisch.** Nach Code-Änderungen in einer Session
> proaktiv `/graphify --update` laufen lassen (Code-only = gratis) und `graph.json` +
> `manifest.json` mit-committen, wenn die übrigen Änderungen committet werden — ohne
> Aufforderung. (Vollautomatisch auch bei eigenen Commits des Users: via `graphify hook install`.)
> 3. **Nie** `graph.json` / `GRAPH_REPORT.md` ganz in den Kontext laden — immer Query/Script.
Ein persistenter graphify-Wissensgraph liegt unter **`graphify-out/graph.json`** Ein persistenter graphify-Wissensgraph liegt unter **`graphify-out/graph.json`**
(14.350 Knoten / 19.326 Kanten, Stand 2026-06-10). (14.350 Knoten / ~19.340 Kanten inkl. 27 Traceability-Kanten, Stand 2026-06-10) und ist
im Repo getrackt (Scratch/Cache via `.gitignore` ausgeschlossen).
**Wann konsultieren:** Bei Fragen zu Codebase-Struktur, Architektur, „was ruft X / wo **Wann konsultieren:** Bei Fragen zu Codebase-Struktur, Architektur, „was ruft X / wo
ist Y", Cross-Modul-Bezügen oder DiGA-Traceability **zuerst den Graphen nutzen**, statt ist Y", Cross-Modul-Bezügen oder DiGA-Traceability **zuerst den Graphen nutzen**, statt