Projektwissen/docs/leitfaden/08_prozessbibliothek.md

Die Prozessbibliothek: Ablage der Prozessmodelle

Regeln und Ablauf für die versionierten Prozessmodelle der AG Prozesse (ADR 0004). Die Modelle liegen im eigenen Repository AG_Prozesse/Prozessbibliothek, die Regeln und die Prüfung hier in Projektwissen. Arbeitsentwürfe gehören nicht in die Bibliothek, sondern nach entwuerfe/ (nicht versioniert).

Wo sie liegt

python scripts/setup_workspace.py klont die Bibliothek in den Ordner Prozessbibliothek/ im Workspace, oder unter repos_root aus workspace.local.toml, wenn dort ein anderer Ort eingetragen ist. Projektwissen versioniert den Ordner nicht mit, denn er ist ein eigener Git-Klon.

Prozessbibliothek/
  README.md              kurz: was hier liegt, Verweis auf diesen Leitfaden
  AGENTS.md, CLAUDE.md   Anweisungen für KI-Agenten
  antrag-pruefen/
    README.md            Steckbrief: Status, Stand, Zuständigkeit, offene Punkte
    antrag-pruefen.md    Arbeitsschritt-Beschreibung – die maßgebliche Quelle
    antrag-pruefen.bpmn  daraus erzeugt, nie von Hand bearbeiten

Regeln

• Ordnername: Kleinbuchstaben, Ziffern, Bindestriche (antrag-pruefen). Die beiden Modelldateien heißen wie der Ordner.
• Genau drei Dateien je Prozess. Keine Originalunterlagen (Word, PDF), keine Bilder. Die bleiben lokal in referenz/. In der Wurzel der Bibliothek liegen außer den Prozessordnern nur README.md, AGENTS.md, CLAUDE.md, .gitattributes und .gitignore.
• Die .md ist maßgeblich. Die .bpmn wird nach jeder Änderung neu erzeugt und mitcommittet: python scripts/pruefe_prozesse.py --erzeugen (aus Projektwissen). Änderungen, die in PICTURE nachgetragen werden, fließen nicht zurück. Wer etwas dauerhaft ändern will, ändert die .md.
• Status im Steckbrief: Entwurf (liegt zur gemeinsamen Bearbeitung hier), abgenommen (fachlich bestätigt) oder Import (maschinell aus einem PICTURE-Export übernommen, fachlich nicht geprüft; Ordnername import-<name>). Den Wechsel auf abgenommen macht ein eigener Pull Request, dessen Review die Abnahme ist. Ein Import-Modell wird zum Entwurf, sobald jemand es fachlich überarbeitet – ebenfalls per Pull Request. Wie zurückgewandelt wird und was dabei verloren geht: docs/wissen/picture_import.md.
• Keine personenbezogenen Daten. Zuständigkeiten als Funktion, keine Namen, Aktenzeichen oder Verfahrensdaten.
• Issues zu einem Modell werden in der Bibliothek angelegt, Issues zu Konverter, Skills und Doku in Projektwissen. Branches heißen in beiden Repositories feature/<issue-nr>-<kurzname>.

Prüfen

Aus dem Workspace-Root (Projektwissen):

python scripts/pruefe_prozesse.py     # Struktur, Status, .bpmn aktuell? Prüft auch die Skill-Beispiele
python -m pytest -q                   # enthält dieselbe Prüfung

Ist die Bibliothek nicht geklont, prüfen beide nur die Skill-Beispiele und weisen darauf hin.

Einen Prozess ablegen

1. Entwurf mit dem Skill sn-bpmn erstellen und fachlich prüfen.
2. Issue in der Bibliothek, dann im Klon Prozessbibliothek/ einen Branch feature/<issue-nr>-<prozessname> von main anlegen.
3. Ordner anlegen, Entwurf als <name>.md hineinkopieren, Steckbrief aus docs/vorlagen/prozess_readme.md.
4. In Projektwissen: python scripts/pruefe_prozesse.py --erzeugen, dann python -m pytest -q.
5. Im Klon committen. Pull Request in der Bibliothek: Der Agent bereitet vor, der Mensch pusht.

Wenn sich der Konverter ändert

Ändert ein Pull Request in Projektwissen die BPMN-Ausgabe, meldet pruefe_prozesse.py die betroffenen Modelle als veraltet. Dann in der Bibliothek einen Branch mit demselben Issue-Bezug anlegen, python scripts/pruefe_prozesse.py --erzeugen ausführen, die neuen .bpmn dort committen und beide Pull Requests gemeinsam mergen: erst Projektwissen, direkt danach die Bibliothek.