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:
@@ -0,0 +1,39 @@
|
||||
# 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.
|
||||
Reference in New Issue
Block a user