From 6af592a0e009cb7881d6f6fe7153d88ec94366b7 Mon Sep 17 00:00:00 2001
From: jensmohr <lha643@jensmohr.de>
Date: Thu, 21 May 2026 20:29:31 +0200
Subject: [PATCH] Add Codex workflow and modularization guidelines

---
 docs/architecture/codex-workflow.md | 67 +++++++++++++++++++++++++++++
 1 file changed, 67 insertions(+)
 create mode 100644 docs/architecture/codex-workflow.md

diff --git a/docs/architecture/codex-workflow.md b/docs/architecture/codex-workflow.md
new file mode 100644
index 0000000..9906421
--- /dev/null
+++ b/docs/architecture/codex-workflow.md
@@ -0,0 +1,67 @@
+# VG-Environment Codex Workflow
+
+## Grundprinzip
+
+VG-Environment wird schrittweise modularisiert.
+Grosse unkontrollierte Refactors sind ausdruecklich unerwuenscht.
+
+## Codex-Arbeitsweise
+
+- Kleine, klar abgegrenzte Prompts.
+- Ein Git-Commit pro sinnvoller Aenderungseinheit.
+- Vor groesseren Aenderungen immer Git-Status pruefen.
+- Keine destruktiven Aenderungen ohne ausdrueckliche Freigabe.
+- Keine stillen IndexedDB-Schemaaenderungen.
+- Keine DB-Full-Scans.
+- Keine Monster-Dateien.
+
+## Empfohlene Codex-Chat-Trennung
+
+Separate Codex-Kontexte fuer:
+
+- VG-Core
+- VG-Observe
+- VG-Block
+- VG-Graph
+- Architektur / Dokumentation
+- Export / Evidence
+- Datenbank / IndexedDB
+
+## Ziel der Trennung
+
+- kleinere Kontexte
+- weniger Halluzinationsrisiko
+- bessere fachliche Isolation
+- kontrollierbare Diffs
+- nachvollziehbare Git-Historie
+
+## Pflicht vor Refactors
+
+Vor Refactors:
+
+1. Git-Status pruefen
+2. kleinen Zielbereich definieren
+3. Architekturgrenzen beachten
+4. moeglichst nur einen Verantwortungsbereich aendern
+
+## IndexedDB-Regeln
+
+- Migrationen nur additiv
+- Keine destruktiven Schemaaenderungen
+- Keine Loeschung historischer Evidenzen ohne ausdrueckliche Freigabe
+
+## Forensische Regeln
+
+- Beobachtung und Eingriff trennen
+- Rohdaten moeglichst erhalten
+- Auswertungen klar von Beobachtungen trennen
+- Keine Behauptung staerker formulieren als die Datenlage
+
+## Zielarchitektur
+
+VG-Environment entwickelt sich als modularer Plattformansatz mit klar getrennten Verantwortlichkeiten zwischen:
+
+- VG-Core
+- VG-Observe
+- VG-Block
+- VG-Graph