Projektwissen/.agents/skills/sn-bpmn/SKILL.md

---
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.