41 lines
1.5 KiB
Markdown
41 lines
1.5 KiB
Markdown
# LOG: Project Structure Refactoring - 2026-02-04
|
|
|
|
## Context
|
|
Umstrukturierung des Vaults zur besseren Organisation projektspezifischer Dateien.
|
|
|
|
## Problem
|
|
- Memory-Dateien lagen unter `/memory/projects/<name>.md` (flache Struktur)
|
|
- Keine Möglichkeit, zusätzliche projektspezifische Dateien (CLAUDE.md, INSTRUCTIONS.md) zu organisieren
|
|
- Semantische Vermischung: "Memory" als Container für Projekte war unintuitiv
|
|
|
|
## Solution
|
|
1. Neuer `/projects/` Top-Level-Ordner erstellt
|
|
2. Unterordner pro Projekt: `projects/<projekt-name>/`
|
|
3. Standardisierte Dateinamen: `MEMORY.md`, `CLAUDE.md`, `INSTRUCTIONS.md`
|
|
|
|
## Changes
|
|
```diff
|
|
- memory/projects/ligalytics-staffeleinteilung.md
|
|
+ projects/ligalytics-staffeleinteilung/MEMORY.md
|
|
```
|
|
|
|
## Lessons Learned
|
|
|
|
### Was funktionierte gut
|
|
- **Atomic Migration**: Pfad-Änderung + Script-Update + Daten-Migration in einer Session
|
|
- **mkdir -p Pattern**: Auto-Create im Sync-Script verhindert manuelle Ordner-Erstellung
|
|
- **Template-Based Snapshots**: Wiederverwendbares Format für konsistente Dokumentation
|
|
|
|
### Potenzielle Verbesserungen
|
|
- Script könnte erweitert werden für CLAUDE.md / INSTRUCTIONS.md Sync
|
|
- `.gitignore` für sensible Projekt-Daten in Betracht ziehen
|
|
- Überlegen: Projekt-Metadaten in eigener `project.yaml` speichern?
|
|
|
|
## Impact
|
|
- ✅ Bessere Skalierbarkeit für viele Projekte
|
|
- ✅ Klare Trennung zwischen globalem Memory und Projekt-Kontext
|
|
- ✅ Erweiterbar für zukünftige projektspezifische Dateien
|
|
|
|
## Tags
|
|
`#vault-structure` `#refactoring` `#projects` `#memory` `#scripts`
|