Prozessbibliothek als eigenes Repository auslagern (#9) #11

2026-09-25T08:50:16Z

Daniel commented

2026-09-25 08:50:16 +00:00

ADR 0004 ersetzt ADR 0003: Die Prozessmodelle liegen im Repository
AG_Prozesse/Prozessbibliothek, geklont nach Prozessbibliothek/ (neuer
Eintrag in workspace.toml, .gitignore). prozesse/ ist entfernt; das
Ablageformat (Ordner je Prozess, drei Dateien, Status) bleibt.
pruefe_prozesse.py prüft den Klon (Ort über setup_workspace.repos_root),
lässt Punkt-Ordner wie .git aus und erlaubt in der Wurzel nur die## Was
Die Prozessmodelle ziehen aus prozesse/ in das eigene Repository AG_Prozesse/Prozessbibliothek. Es wird als Klon
Prozessbibliothek/ in den Workspace geholt und von pruefe_prozesse.py und einlesen.py dort gesucht.
Regeln, Vorlagen, Konverter und Prüfung bleiben in Projektwissen (ADR 0004 ersetzt ADR 0003).
Closes Prozesse liegen im Projektwissen-Repo (#9)

Abnahmekriterien, abgestimmt vor der Umsetzung, weil das Issue noch keine hatte:

prozesse/ ist aus Projektwissen entfernt, Prozessbibliothek steht in workspace.toml und .gitignore
pruefe_prozesse.py und einlesen.py finden die Modelle im Klon, auch unter repos_root aus
workspace.local.toml
Fehlt der Klon, gibt es keinen roten Test, sondern einen deutlichen Hinweis bzw. eine pytest-Warnung
ADR 0004, Ablageregeln in docs/leitfaden/08_prozessbibliothek.md, alle Verweise nachgezogen
Startdateien für das neue Repo vorbereitet (README, AGENTS, CLAUDE, .gitattributes, .claude/settings.json)

Wie geprüft

python -m pytest -q: 88 passed, 1 xfailed, 1 warning. Das xfail ist #8, die Warnung meldet, dass die
Bibliothek noch nicht geklont ist
python scripts/pruefe_umlaute.py: GRÜN: 0 Fund/e in 12 Datei(en).
python scripts/pruefe_prozesse.py: GRÜN: 0 Befund/e, 0 Prozess(e), 3 Beispiel(e). mit Hinweis
„Prozessbibliothek nicht geklont“
Startdateien der Bibliothek mit pruefe_bibliothek() geprüft: keine Befunde
python scripts/hallo.py --nur-pruefen --ohne-netz: meldet Prozessbibliothek als fehlenden Ordner mit dem
Befehl python scripts/setup_workspace.py
Bei Modellen der Prozessbibliothek: nicht betroffen, es gab noch keine Modelle
PICTURE-Import: nicht nötig, weil sich die BPMN-Ausgabe nicht ändert

Änderungen an Syntax und Ablageformat

Ablageformat: Ort geändert (#9, ADR 0004). Die Modelle liegen nicht mehr in prozesse/<name>/, sondern im
Repository Prozessbibliothek unter <name>/. Die Regeln aus prozesse/README.md stehen jetzt in
docs/leitfaden/08_prozessbibliothek.md. Neu ist die erlaubte Wurzel der Bibliothek: README.md, AGENTS.md,
CLAUDE.md, .gitattributes, .gitignore sowie Punkt-Ordner wie .git und .claude. Ordner je Prozess, drei
Dateien und Status bleiben gleich. Modelle angepasst: keine, es gab noch keine. Markdown-Syntax: unverändert.

Übergabenotiz

Aufgabe: #9: Projektwissen und Prozessbibliothek entflechten. Die Modelle bekommen ein eigenes Repository.
Stand: fertig in Projektwissen. Das Repo Prozessbibliothek muss noch angelegt und befüllt werden (siehe Offen).
Geändert:

docs/entscheidungen/0004-prozessbibliothek-eigenes-repo.md (neu), 0003 auf „ersetzt durch 0004“, Übersicht
docs/leitfaden/08_prozessbibliothek.md (neu): Regeln aus prozesse/README.md mit neuem Ort, dazu der Ablauf
„Wenn sich der Konverter ändert“ (zwei Pull Requests); prozesse/README.md entfernt
workspace.toml, .gitignore: Eintrag Prozessbibliothek
scripts/pruefe_prozesse.py: BIBLIOTHEK über setup_workspace.repos_root(), pruefe_bibliothek() mit erlaubten
Wurzeldateien, Punkt-Ordner ausgelassen, hinweis_bibliothek() bei fehlendem Klon
scripts/einlesen.py: Bestand aus der Bibliothek, Pfad immer als Prozessbibliothek/<name>/, Punkt-Ordner
ausgelassen
tests/test_pruefe_prozesse.py (4 neue Tests, Bestandstest mit Warnung), tests/test_einlesen.py: Fixture auf
die Bibliothek umgestellt, erwarteter Pfad jetzt Prozessbibliothek/antrag-pruefen/ (bewusste
Verhaltensänderung), 2 neue Tests
Verweise: AGENTS.md, README.md, docs/README.md, Skills sn-bpmn, sn-einlesen, sn-aufgabe-bearbeiten,
Leitfäden 03 und 07, Vorlagen issue.md und pull_request.md, fallstricke.md, STATUS.md, scripts/vorschau.py,
werkzeuge/vorschau/README.md

Nachweis: pytest: 88 passed, 1 xfailed, 1 warning. PICTURE-Import nicht nötig, weil sich die Ausgabe nicht ändert
Entscheidungen/Annahmen:

Repo-Name, Aufbau mit Prozessordnern in der Wurzel und Prüfung aus Projektwissen wurden vor der Umsetzung
so abgestimmt
Die Ablageregeln sind maßgeblich in Projektwissen, damit Regel und Prüfskript im selben PR geändert werden. Die
README der Bibliothek verweist darauf
Eine fehlende Bibliothek ist kein Testfehler, sondern eine Warnung. Sonst wäre ein frischer Klon von Projektwissen
rot, bevor setup_workspace.py gelaufen ist
Vorlage docs/vorlagen/prozess_readme.md bleibt in Projektwissen

Offen / nächste Schritte (Mensch):

In Gitea das Repo AG_Prozesse/Prozessbibliothek anlegen, öffentlich und mit README initialisiert
(Branch main). Ohne initialen Commit scheitert git clone --branch main, und solange das Repo fehlt oder
privat ist, bricht python scripts/gitea.py tickets ohne Repo-Angabe mit Exit 1 ab
Diesen PR mergen, dann /hallo bzw. python scripts/setup_workspace.py, das klont Prozessbibliothek/
Startdateien aus entwuerfe/prozessbibliothek-start/ (lokal, nicht versioniert) auf einem Branch im Klon
committen. Das kann der Agent vorbereiten; Push und PR in der Bibliothek macht der Mensch
ADR 0004 vom Team annehmen lassen (STATUS, Baustelle 2)

Wissensbasis: fallstricke.md (Byte-Vergleich: zweiter PR in der Bibliothek), ADR 0004, Leitfaden 08,
STATUS.md (Erledigt, Baustelle 2)
Kontext für die nächste Sitzung: docs/leitfaden/08_prozessbibliothek.md, scripts/pruefe_prozesse.py
(BIBLIOTHEK, pruefe_bibliothek), entwuerfe/prozessbibliothek-start/

Checkliste

Nur Änderungen zum Issue
Keine Debug-print, kein auskommentierter Code
Keine personenbezogenen Daten, keine internen Originalunterlagen
Doku des Skills nachgezogen (Anleitung.md, SKILL.md von sn-bpmn, sn-einlesen, sn-aufgabe-bearbeiten)
Wissensbasis nachgezogen (ADR 0004, Leitfaden 08, fallstricke.md, STATUS.md)

🤖 Generated with Claude Code

- ADR 0004 ersetzt ADR 0003: Die Prozessmodelle liegen im Repository AG_Prozesse/Prozessbibliothek, geklont nach Prozessbibliothek/ (neuer Eintrag in workspace.toml, .gitignore). prozesse/ ist entfernt; das Ablageformat (Ordner je Prozess, drei Dateien, Status) bleibt. - pruefe_prozesse.py prüft den Klon (Ort über setup_workspace.repos_root), lässt Punkt-Ordner wie .git aus und erlaubt in der Wurzel nur die## Was Die Prozessmodelle ziehen aus `prozesse/` in das eigene Repository `AG_Prozesse/Prozessbibliothek`. Es wird als Klon `Prozessbibliothek/` in den Workspace geholt und von `pruefe_prozesse.py` und `einlesen.py` dort gesucht. Regeln, Vorlagen, Konverter und Prüfung bleiben in Projektwissen (ADR 0004 ersetzt ADR 0003). Closes #9 Abnahmekriterien, abgestimmt vor der Umsetzung, weil das Issue noch keine hatte: - [x] `prozesse/` ist aus Projektwissen entfernt, `Prozessbibliothek` steht in `workspace.toml` und `.gitignore` - [x] `pruefe_prozesse.py` und `einlesen.py` finden die Modelle im Klon, auch unter `repos_root` aus `workspace.local.toml` - [x] Fehlt der Klon, gibt es keinen roten Test, sondern einen deutlichen Hinweis bzw. eine pytest-Warnung - [x] ADR 0004, Ablageregeln in `docs/leitfaden/08_prozessbibliothek.md`, alle Verweise nachgezogen - [x] Startdateien für das neue Repo vorbereitet (README, AGENTS, CLAUDE, `.gitattributes`, `.claude/settings.json`) ## Wie geprüft - `python -m pytest -q`: `88 passed, 1 xfailed, 1 warning`. Das xfail ist #8, die Warnung meldet, dass die Bibliothek noch nicht geklont ist - `python scripts/pruefe_umlaute.py`: `GRÜN: 0 Fund/e in 12 Datei(en).` - `python scripts/pruefe_prozesse.py`: `GRÜN: 0 Befund/e, 0 Prozess(e), 3 Beispiel(e).` mit Hinweis „Prozessbibliothek nicht geklont“ - Startdateien der Bibliothek mit `pruefe_bibliothek()` geprüft: keine Befunde - `python scripts/hallo.py --nur-pruefen --ohne-netz`: meldet `Prozessbibliothek` als fehlenden Ordner mit dem Befehl `python scripts/setup_workspace.py` - Bei Modellen der Prozessbibliothek: nicht betroffen, es gab noch keine Modelle - PICTURE-Import: nicht nötig, weil sich die BPMN-Ausgabe nicht ändert ## Änderungen an Syntax und Ablageformat Ablageformat: **Ort geändert** (#9, ADR 0004). Die Modelle liegen nicht mehr in `prozesse/<name>/`, sondern im Repository `Prozessbibliothek` unter `<name>/`. Die Regeln aus `prozesse/README.md` stehen jetzt in `docs/leitfaden/08_prozessbibliothek.md`. Neu ist die erlaubte Wurzel der Bibliothek: `README.md`, `AGENTS.md`, `CLAUDE.md`, `.gitattributes`, `.gitignore` sowie Punkt-Ordner wie `.git` und `.claude`. Ordner je Prozess, drei Dateien und Status bleiben gleich. Modelle angepasst: keine, es gab noch keine. Markdown-Syntax: unverändert. ## Übergabenotiz **Aufgabe:** #9: Projektwissen und Prozessbibliothek entflechten. Die Modelle bekommen ein eigenes Repository. **Stand:** fertig in Projektwissen. Das Repo `Prozessbibliothek` muss noch angelegt und befüllt werden (siehe Offen). **Geändert:** - `docs/entscheidungen/0004-prozessbibliothek-eigenes-repo.md` (neu), `0003` auf „ersetzt durch 0004“, Übersicht - `docs/leitfaden/08_prozessbibliothek.md` (neu): Regeln aus `prozesse/README.md` mit neuem Ort, dazu der Ablauf „Wenn sich der Konverter ändert“ (zwei Pull Requests); `prozesse/README.md` entfernt - `workspace.toml`, `.gitignore`: Eintrag `Prozessbibliothek` - `scripts/pruefe_prozesse.py`: `BIBLIOTHEK` über `setup_workspace.repos_root()`, `pruefe_bibliothek()` mit erlaubten Wurzeldateien, Punkt-Ordner ausgelassen, `hinweis_bibliothek()` bei fehlendem Klon - `scripts/einlesen.py`: Bestand aus der Bibliothek, Pfad immer als `Prozessbibliothek/<name>/`, Punkt-Ordner ausgelassen - `tests/test_pruefe_prozesse.py` (4 neue Tests, Bestandstest mit Warnung), `tests/test_einlesen.py`: Fixture auf die Bibliothek umgestellt, erwarteter Pfad jetzt `Prozessbibliothek/antrag-pruefen/` (bewusste Verhaltensänderung), 2 neue Tests - Verweise: `AGENTS.md`, `README.md`, `docs/README.md`, Skills `sn-bpmn`, `sn-einlesen`, `sn-aufgabe-bearbeiten`, Leitfäden 03 und 07, Vorlagen `issue.md` und `pull_request.md`, `fallstricke.md`, `STATUS.md`, `scripts/vorschau.py`, `werkzeuge/vorschau/README.md` **Nachweis:** `pytest`: `88 passed, 1 xfailed, 1 warning`. PICTURE-Import nicht nötig, weil sich die Ausgabe nicht ändert **Entscheidungen/Annahmen:** - Repo-Name, Aufbau mit Prozessordnern in der Wurzel und Prüfung aus Projektwissen wurden vor der Umsetzung so abgestimmt - Die Ablageregeln sind maßgeblich in Projektwissen, damit Regel und Prüfskript im selben PR geändert werden. Die README der Bibliothek verweist darauf - Eine fehlende Bibliothek ist kein Testfehler, sondern eine Warnung. Sonst wäre ein frischer Klon von Projektwissen rot, bevor `setup_workspace.py` gelaufen ist - Vorlage `docs/vorlagen/prozess_readme.md` bleibt in Projektwissen **Offen / nächste Schritte (Mensch):** 1. In Gitea das Repo `AG_Prozesse/Prozessbibliothek` anlegen, **öffentlich** und **mit README initialisiert** (Branch `main`). Ohne initialen Commit scheitert `git clone --branch main`, und solange das Repo fehlt oder privat ist, bricht `python scripts/gitea.py tickets` ohne Repo-Angabe mit Exit 1 ab 2. Diesen PR mergen, dann `/hallo` bzw. `python scripts/setup_workspace.py`, das klont `Prozessbibliothek/` 3. Startdateien aus `entwuerfe/prozessbibliothek-start/` (lokal, nicht versioniert) auf einem Branch im Klon committen. Das kann der Agent vorbereiten; Push und PR in der Bibliothek macht der Mensch 4. ADR 0004 vom Team annehmen lassen (STATUS, Baustelle 2) **Wissensbasis:** `fallstricke.md` (Byte-Vergleich: zweiter PR in der Bibliothek), ADR 0004, Leitfaden 08, `STATUS.md` (Erledigt, Baustelle 2) **Kontext für die nächste Sitzung:** `docs/leitfaden/08_prozessbibliothek.md`, `scripts/pruefe_prozesse.py` (`BIBLIOTHEK`, `pruefe_bibliothek`), `entwuerfe/prozessbibliothek-start/` ## Checkliste - [x] Nur Änderungen zum Issue - [x] Keine Debug-`print`, kein auskommentierter Code - [x] Keine personenbezogenen Daten, keine internen Originalunterlagen - [x] Doku des Skills nachgezogen (`Anleitung.md`, `SKILL.md` von `sn-bpmn`, `sn-einlesen`, `sn-aufgabe-bearbeiten`) - [x] Wissensbasis nachgezogen (ADR 0004, Leitfaden 08, `fallstricke.md`, `STATUS.md`) 🤖 Generated with [Claude Code](https://claude.com/claude-code)

Daniel added 1 commit 2026-09-25 08:50:17 +00:00

Prozessbibliothek als eigenes Repository auslagern (#9 ) 31131cc5c3

- ADR 0004 ersetzt ADR 0003: Die Prozessmodelle liegen im Repository
  AG_Prozesse/Prozessbibliothek, geklont nach Prozessbibliothek/ (neuer
  Eintrag in workspace.toml, .gitignore). prozesse/ ist entfernt; das
  Ablageformat (Ordner je Prozess, drei Dateien, Status) bleibt.
- pruefe_prozesse.py prüft den Klon (Ort über setup_workspace.repos_root),
  lässt Punkt-Ordner wie .git aus und erlaubt in der Wurzel nur die
  Repo-Dateien. Fehlt der Klon, gibt es einen Hinweis statt eines Befunds;
  pytest warnt dann.
- einlesen.py sucht den Bestand in der Bibliothek und nennt Treffer als
  Prozessbibliothek/<name>/, auch wenn der Klon woanders liegt.
- Regeln aus prozesse/README.md nach docs/leitfaden/08_prozessbibliothek.md,
  inklusive Ablauf bei Konverteränderungen (zwei Pull Requests).
- Verweise in AGENTS.md, README, Skills, Leitfäden, Vorlagen, Fallstricken
  und STATUS nachgezogen.
- Tests: python -m pytest -q -> 88 bestanden, 1 xfail (#8), 1 Warnung
  (Bibliothek noch nicht geklont).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Daniel merged commit 6050ce3296 into main

2026-09-25 08:51:12 +00:00

Daniel deleted branch feature/9-prozessbibliothek

2026-09-25 08:51:13 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: AG_Prozesse/Projektwissen#11