digitom_cc/CLAUDE.md

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 und #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; 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.
• 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.