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>
40 lines
1.8 KiB
Markdown
40 lines
1.8 KiB
Markdown
# Prozessmodelle
|
||
|
||
Hier liegen die versionierten Prozessmodelle der AG Prozesse, ein Ordner je Prozess (ADR 0003).
|
||
Arbeitsentwürfe gehören nicht hierher, sondern nach `entwuerfe/` (nicht versioniert).
|
||
|
||
```
|
||
prozesse/
|
||
antrag-pruefen/
|
||
README.md Steckbrief: Status, Stand, Zuständigkeit, offene Punkte
|
||
antrag-pruefen.md Arbeitsschritt-Beschreibung – die maßgebliche Quelle
|
||
antrag-pruefen.bpmn daraus erzeugt, nie von Hand bearbeiten
|
||
```
|
||
|
||
## Regeln
|
||
|
||
- **Ordnername:** Kleinbuchstaben, Ziffern, Bindestriche (`antrag-pruefen`). Die beiden Modelldateien heißen wie
|
||
der Ordner.
|
||
- **Genau drei Dateien.** Keine Originalunterlagen (Word, PDF), keine Bilder — die bleiben lokal in `referenz/`.
|
||
- **Die `.md` ist maßgeblich.** Die `.bpmn` wird nach jeder Änderung neu erzeugt und mitcommittet:
|
||
`python scripts/pruefe_prozesse.py --erzeugen`. Änderungen, die in PICTURE nachgetragen werden, fließen nicht
|
||
zurück — wer etwas dauerhaft ändern will, ändert die `.md`.
|
||
- **Status im Steckbrief:** `Entwurf` (liegt zur gemeinsamen Bearbeitung hier) oder `abgenommen` (fachlich
|
||
bestätigt). Den Wechsel auf `abgenommen` macht ein eigener Pull Request, dessen Review die Abnahme ist.
|
||
- **Keine personenbezogenen Daten.** Zuständigkeiten als Funktion, keine Namen, Aktenzeichen oder Verfahrensdaten.
|
||
|
||
## Prüfen
|
||
|
||
```bash
|
||
python scripts/pruefe_prozesse.py # Struktur, Status, .bpmn aktuell?
|
||
python -m pytest -q # enthält dieselbe Prüfung
|
||
```
|
||
|
||
## Einen Prozess ablegen
|
||
|
||
1. Entwurf mit dem Skill `sn-bpmn` erstellen und fachlich prüfen.
|
||
2. Branch `feature/<issue-nr>-<prozessname>` von `main`.
|
||
3. Ordner anlegen, Entwurf als `<name>.md` hineinkopieren, Steckbrief aus `docs/vorlagen/prozess_readme.md`.
|
||
4. `python scripts/pruefe_prozesse.py --erzeugen`, dann Tests.
|
||
5. Pull Request — der Agent bereitet vor, der Mensch pusht.
|