43 lines
3.2 KiB
Markdown
43 lines
3.2 KiB
Markdown
# 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.
|