- beispiele/referenz_gewannenfestlegung.md/.bpmn: aus dem ersten echten Einlese-Durchgang (input/Gewannenvermessung.md), als „Test“ markiert, fachlich nicht abgenommen. 4 Lanes, externer Pool, 14 Gateways, verschachtelte Varianten; Byte-Vergleich über pruefe_prozesse.py. - tests/test_referenzmodelle.py: je Referenzmodell keine Lane „Nicht zugeordnet“, höchstens vier Kanten je Gateway, keine Kante durch eine Raute (Geometrie aus test_md_to_bpmn.py übernommen). - Gefunden: Kante S12→S13 läuft durch die Raute von S13 – als xfail(strict=True) mit Verweis auf #8. AGENTS.md regelt, dass xfail nur für so erfasste Konverterfehler an Referenzmodellen zulässig ist. - Anleitung, Fallstricke (zwei Einträge), STATUS. - Tests: python -m pytest -q -> 82 bestanden, 1 xfail (#8). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Dokumentation – Wegweiser
| Ordner | Charakter | Wann lesen |
|---|---|---|
status/STATUS.md |
lebend, kurz | immer zuerst – aktueller Stand, Baustellen |
wissen/fallstricke.md |
lebend | bei Überraschungen; vor Arbeiten am Konverter und am PICTURE-Import |
wissen/glossar.md |
lebend | Fachbegriffe (Flurbereinigung, BPMN) |
entscheidungen/ |
append-only (ADR) | warum etwas so ist; neue Entscheidung = neue Datei |
leitfaden/03_arbeitsweise.md |
stabil | Einstieg, Arbeitszyklus, Checklisten |
leitfaden/04_werkzeuge_einrichten.md |
stabil | Einrichtung: Claude Code als CLI und in VS Code; von null zur ersten Aufgabe |
leitfaden/05_git_arbeitsweise.md |
verbindlich | Branches, Pull Requests, was der Agent darf |
leitfaden/07_prozesse_einlesen.md |
stabil | Einsteiger-Ablauf: Beschreibung in input/ legen, einlesen, freigeben |
vorlagen/ |
Vorlagen | Issue, PR, Übergabe, Repo-AGENTS.md, Steckbrief eines Prozesses |
Die Fachdoku des Konverters (Markdown-Syntax, Elementkatalog, Modellierregeln) liegt beim Skill in
.agents/skills/sn-bpmn/, die versionierten Prozessmodelle in prozesse/ (Regeln: prozesse/README.md).
Regel: Lebende Dokumente werden mit jeder Änderung gepflegt, Momentaufnahmen nicht nachträglich geändert (neue Analyse = neue Datei mit Datum).