diff --git a/AGENTS.md b/AGENTS.md
index f98b6e5..dc01daf 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -51,3 +51,10 @@ Bei jeder relevanten Verhaltensaenderung:
 
 Wenn ein Feature nur geplant ist, darf es nicht als fertig dokumentiert werden.
 
+## 7) Umgang mit `data/qctextbuilder.db`
+
+- `data/qctextbuilder.db` ist versionierbar, aber kein normales Immer-mitcommitten-Artefakt.
+- Standardregel: bei normalen Code-/Doku-Commits **nicht** automatisch mit aufnehmen, auch wenn sich die Datei geaendert hat.
+- Wenn ein reproduzierbarer lokaler Zustand bewusst festgehalten werden soll, darf die DB gezielt als eigener Snapshot-Commit aufgenommen werden.
+- Snapshots der DB bewusst separat von Code-Commits halten, damit Aenderungen an Laufzeitdaten klar von Codeaenderungen getrennt bleiben.
+