Prozessmodelle versioniert unter prozesse/<name>/ ablegen

Jedes Modell bekommt einen eigenen Ordner mit Steckbrief (README.md,
Status Entwurf|abgenommen), der maßgeblichen Arbeitsschritt-.md und der
daraus erzeugten .bpmn (ADR 0003).

- scripts/pruefe_prozesse.py prüft Ordnername, Dateien, Status und ob
  jede .bpmn byte-gleich mit der Umwandlung ihrer .md ist; --erzeugen
  erzeugt alle .bpmn neu. md_to_bpmn.py arbeitet deterministisch.
- tests/test_pruefe_prozesse.py: Bestandsprüfung plus 11 Fälle für die
  Prüflogik; pytest.ini sammelt .agents/skills und tests.
- Die in Anleitung.md genannten, nie committeten Beispiele liegen jetzt
  unter .agents/skills/sn-bpmn/beispiele/ und werden mitgeprüft.
- Skill sn-bpmn: Entwürfe nach entwuerfe/, neuer Schritt 5 „Ablegen“.
- Vorlage docs/vorlagen/prozess_readme.md, Doku und Fallstricke ergänzt.
- Tests: python -m pytest -q -> 44 bestanden.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-09-23 13:02:48 +02:00
co-authored by Claude Opus 5.5
parent 012509b6d1
commit 55c024dbc9
25 changed files with 835 additions and 35 deletions
+19 -4
View File
@@ -19,13 +19,17 @@ schreibst oder bearbeitest.
## Ablauf
1. **Quelle ermitteln.** Frage nach der Rohtext-, Word- oder PDF-Quelle,
falls keine angegeben oder angehängt wurde.
falls keine angegeben oder angehängt wurde. Gibt es den Prozess schon
unter `prozesse/<name>/`, ist dessen `<name>.md` der Ausgangspunkt:
dann auf einem Arbeitsbranch direkt dort ändern statt in `entwuerfe/`,
und nach Schritt 3 mit Schritt 5 weitermachen.
2. **Entwurf erzeugen.** Lies die Quelle und leite daraus eine
strukturierte Arbeitsschritt-`.md` nach der Syntax aus `Anleitung.md`
ab. Triff nachvollziehbare fachliche Annahmen (Schrittgrenzen,
Verzweigungen, Verantwortliche wo erkennbar) und schreibe das Ergebnis
nach `entwuerfe/<name>.md` (Verzeichnis bei Bedarf anlegen). Gleiche den
nach `entwuerfe/<name>.md` (Verzeichnis bei Bedarf anlegen; `<name>` in
Kleinbuchstaben mit Bindestrichen, z. B. `antrag-pruefen`). Gleiche den
Entwurf gegen `Modellierregeln.md` ab und behebe Verstöße direkt im
Entwurf. Fasse kurz zusammen, welche Annahmen getroffen wurden, und
weise auf Stellen hin, die fachlich geprüft werden sollten.
@@ -38,9 +42,20 @@ schreibst oder bearbeitest.
4. **BPMN erzeugen.** Erst nach ausdrücklicher Freigabe (z. B. "ist
angepasst", "passt so", "wandle um"):
```
python .agents/skills/sn-bpmn/md_to_bpmn.py entwuerfe/<name>.md <name>.bpmn
python .agents/skills/sn-bpmn/md_to_bpmn.py entwuerfe/<name>.md entwuerfe/<name>.bpmn
```
Ergebnis kurz melden (Anzahl Schritte/Kanten/Lanes, Pfad der Datei).
Ergebnis kurz melden (Anzahl Schritte/Kanten/Lanes, Pfad der Datei) und
anbieten, das Modell im Repository abzulegen (Schritt 5).
5. **Ablegen (nur auf Wunsch).** Ablauf und Regeln: `prozesse/README.md`
(ADR 0003). Kurz: Branch `feature/<issue-nr>-<name>` von `main`, Ordner
`prozesse/<name>/` mit `<name>.md` und Steckbrief `README.md` aus
`docs/vorlagen/prozess_readme.md` (Status `Entwurf`, Annahmen aus
Schritt 2 unter „Annahmen und offene Punkte“), dann
`python scripts/pruefe_prozesse.py --erzeugen` und `python -m pytest -q`.
Vorher prüfen, dass keine Namen, Aktenzeichen oder Verfahrensdaten in der
`.md` stehen. Commit und Pull-Request-Text vorbereiten; pushen macht der
Mensch. Den Status `abgenommen` setzt nie der Agent von sich aus.
Wenn der Nutzer direkt eine bereits fertige Arbeitsschritt-`.md` angibt
und ausdrücklich nur die Umwandlung möchte, Schritt 2-3 überspringen