From 17405de70bc9ce1b216e1a056defbc13ae299d51 Mon Sep 17 00:00:00 2001 From: jensmohr Date: Tue, 26 May 2026 15:38:49 +0200 Subject: [PATCH] Normalize architecture document locations and path conventions --- docs/architecture/codex-workflow.md | 33 +++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/docs/architecture/codex-workflow.md b/docs/architecture/codex-workflow.md index 9906421..bc1fde6 100644 --- a/docs/architecture/codex-workflow.md +++ b/docs/architecture/codex-workflow.md @@ -5,6 +5,39 @@ VG-Environment wird schrittweise modularisiert. Grosse unkontrollierte Refactors sind ausdruecklich unerwuenscht. +## Path Conventions + +Repo-Root ist: + +`E:\_Jenno\Entwicklung\VG-Env` + +Alle Pfadangaben in Codex-Prompts muessen eindeutig sein: + +- entweder ausdruecklich relativ zu Repo-Root +- oder ausdruecklich relativ zum aktuell geoeffneten Workspace-Root + +Standard ist: + +Pfade sind relativ zu Repo-Root, wenn nichts anderes ausdruecklich gesagt wird. + +Verbindliche Zielorte: + +- Architektur-Dokumente: `docs/architecture/` +- Core-Code: `src/core/` +- Modul-Code: `src/modules//` +- Workspace-Dateien: `workspaces/` + +Nicht erlaubt ohne ausdrueckliche Freigabe: + +- `docs/`-Ordner innerhalb von `src/core/` +- `docs/`-Ordner innerhalb von `src/modules/` +- neue Architektur-Dokumente unterhalb von Runtime-Code-Verzeichnissen +- unklare relative Pfade in Multi-root-Workspaces + +Hintergrund: + +Multi-root Workspaces koennen relative Pfade missverstaendlich machen. Deshalb muessen Codex-Prompts kuenftig immer den Bezugspunkt nennen. + ## Codex-Arbeitsweise - Kleine, klar abgegrenzte Prompts.