Update Systemprompt und Architekturhinweis

This commit is contained in:
breitenbach76 2026-06-21 15:56:01 +02:00
parent 07050fa5a6
commit 1f12fb5625
3 changed files with 525 additions and 0 deletions

43
CLAUDE.md Normal file
View file

@ -0,0 +1,43 @@
# CLAUDE.md Arbeitsanweisung für dieses Repo
Dieses Repository ist die **öffentliche, unter Creative Commons veröffentlichte Konzeptsammlung** des **DIGIT Operating Models (DIGITOM)** der Stadt Freiburg (Amt für Digitales und IT). Es enthält ausschließlich die strukturierten Konzept-Dateien (YAML) der fünf Kernfunktionen sowie übergreifende Meta-Dokumente.
Orientierung zur Struktur: siehe [#00_meta/README_architektur.md](#00_meta/README_architektur.md) und [#00_meta/digitom_taxonomie.yaml](#00_meta/digitom_taxonomie.yaml).
## Wichtig: Dies ist ein Spiegel-Repository
- Dieses Repo ist ein **Einweg-Spiegel** eines internen Arbeitsrepositories. Änderungen entstehen **upstream** und werden hierher übertragen.
- **Hier nicht direkt inhaltlich bearbeiten** Änderungen an den Konzept-YAMLs fließen nicht zurück und gingen beim nächsten Sync verloren. Ausnahme: ausdrücklich auf dieses Repo bezogene Meta-/Doku-Dateien (z. B. dieses `CLAUDE.md`, das Architektur-README).
## Oberste Regel: Quelltreue
- Beantworte inhaltliche Fragen zum DIGITOM **ausschließlich** auf Basis der Dateien in diesem Repo. **Nichts erfinden** keine Konzepte, Rollen, Pfade, Beispiele oder Zahlen, die nicht belegt sind.
- Steht etwas nicht im Repo, sag das offen und nenne, was stattdessen abgedeckt ist statt zu raten.
- Bleib nachvollziehbar: **Dateipfad nennen** (als klickbaren Link, ggf. mit `:Zeile`).
## Begriffe & Glossar
- Verwende die offiziellen DIGITOM-Begriffe. Setze ähnliche Begriffe **nicht gleich** „Bedarf" ≠ „Demand".
- Primäre Begriffsreferenz: [service-portfolio-management_glossar.yaml](#02_service-portfolio-management/service-portfolio-management_glossar.yaml); funktionsspezifische Glossare ergänzen.
- Rollen statt Namen: „das Demand-Portfolio-Management", „der Service Owner" keine Personennamen.
## Vollständigkeit
- Hat ein Konzept mehrere Varianten/Pfade (z. B. die drei Routing-Ziele Mission Board / DSR-mit-Delegation / DSR), **nenne alle**.
- Bei Schnittstellenthemen beide Seiten und den Übergabepunkt erklären.
- Verantwortlichkeiten über die RACI-Logik benennen (R/A/C/I), inkl. der Accountable-Rolle auch wenn sie außerhalb der gerade betrachteten Funktion liegt.
## Status beachten
Jedes Konzept-YAML hat einen `status`/`meta.status`-Block: `draft` (in Entwicklung), `review` (zur Abstimmung), `abgenommen_in_gesamtkonzept`/`final` (gültig). **Weise auf nicht-finalen Status hin**, wenn du daraus zitierst.
## Repo-Konventionen
- **Konzepttypen:** Funktion · Practice · Rolle · Gremium · Wertschöpfungsprozess definiert in [#00_meta/digitom_taxonomie.yaml](#00_meta/digitom_taxonomie.yaml).
- **Funktionsordner:** `#01_*` DPM · `#02_*` SPM · `#03_*` SHM · `#04_*` Mission Board · `#05_*` Prozessmanagement.
- **Dateitypen:** `README_*` = Navigation · `*_glossar.yaml` = Begriffe · `*_funktionsbeschreibung.yaml` = Mandat/Schnittstellen · `*_governance*.yaml` / `*_raci.yaml` = Verantwortlichkeiten · `*_schema_*.yaml` = Artefaktstruktur · `*-lifecycle-blueprint*` = Prozessabläufe.
- **Sprache:** Deutsch ist Standard.
## Lizenz
Inhalte stehen unter Creative Commons (siehe Repository-Lizenzangabe) und dürfen unter den dort genannten Bedingungen nachgenutzt werden.