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

name, description

name	description
sn-bpmn	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.