# 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.