DanielandClaude Opus 5.5
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>
72 lines
3.6 KiB
Markdown
72 lines
3.6 KiB
Markdown
---
|
|
name: sn-bpmn
|
|
description: Wandelt eine Prozessbeschreibung (Rohtext, Stichpunkte oder bereits strukturierte Arbeitsschritt-.md) in eine BPMN-2.0-Datei für den Import in PICTURE um. Aufrufen, wenn ein Verwaltungsprozess als Ablaufdiagramm für PICTURE modelliert werden soll.
|
|
---
|
|
|
|
# BPMN-Prozess-Konverter
|
|
|
|
Begleitet den Weg von einer (oft unstrukturierten) Prozessbeschreibung zu
|
|
einer importierbaren BPMN-2.0-Datei für PICTURE, mit `md_to_bpmn.py` in
|
|
diesem Verzeichnis.
|
|
|
|
Lies `Anleitung.md` in diesem Verzeichnis für die vollständige
|
|
Markdown-Syntax (Schritt-Typen, Verzweigungen, Rücksprung-Erkennung,
|
|
Verantwortliche/Swimlanes), `Elementkatalog.md` für die vollständige
|
|
Liste der PICTURE-BPMN-Elemente und `Modellierregeln.md` für die
|
|
fachlichen BPMN-Modellierregeln, bevor du eine Arbeitsschritt-.md
|
|
schreibst oder bearbeitest.
|
|
|
|
## Ablauf
|
|
|
|
1. **Quelle ermitteln.** Frage nach der Rohtext-, Word- oder PDF-Quelle,
|
|
falls keine angegeben oder angehängt wurde. Liegen Beschreibungen im
|
|
Eingangsordner `input/`, übernimmt der Skill `sn-einlesen` die Steuerung
|
|
und ruft diesen Skill je Datei auf. Gibt es den Prozess schon in der
|
|
Prozessbibliothek (`Prozessbibliothek/<name>/`), ist dessen `<name>.md`
|
|
der Ausgangspunkt: dann auf einem Arbeitsbranch im Klon der Bibliothek
|
|
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; `<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.
|
|
|
|
3. **Auf Freigabe warten.** Nicht eigenständig weiterbearbeiten. Der
|
|
Nutzer passt `entwuerfe/<name>.md` selbst an (Reihenfolge,
|
|
Verzweigungen, Verantwortliche, Formulierungen) und meldet sich, wenn
|
|
sie passt.
|
|
|
|
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 entwuerfe/<name>.bpmn
|
|
```
|
|
Ergebnis kurz melden (Anzahl Schritte/Kanten/Lanes, Pfad der Datei) und
|
|
anbieten, das Modell im Repository abzulegen (Schritt 5).
|
|
|
|
Vorschau im Browser, offline: `python scripts/vorschau.py entwuerfe/<name>.bpmn`
|
|
(geht auch direkt mit der `.md`, schon vor der Freigabe in Schritt 3).
|
|
Beim Anbieten der Vorschau dazusagen, dass PICTURE abweichen kann.
|
|
|
|
5. **Ablegen (nur auf Wunsch).** Ablauf und Regeln:
|
|
`docs/leitfaden/08_prozessbibliothek.md` (ADR 0004). Kurz: Issue in der
|
|
Bibliothek, im Klon `Prozessbibliothek/` Branch
|
|
`feature/<issue-nr>-<name>` von `main`, Ordner `<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
|
|
und direkt umwandeln.
|