DanielandClaude Opus 5.5
31131cc5c3
- ADR 0004 ersetzt ADR 0003: Die Prozessmodelle liegen im Repository AG_Prozesse/Prozessbibliothek, geklont nach Prozessbibliothek/ (neuer Eintrag in workspace.toml, .gitignore). prozesse/ ist entfernt; das Ablageformat (Ordner je Prozess, drei Dateien, Status) bleibt. - pruefe_prozesse.py prüft den Klon (Ort über setup_workspace.repos_root), lässt Punkt-Ordner wie .git aus und erlaubt in der Wurzel nur die Repo-Dateien. Fehlt der Klon, gibt es einen Hinweis statt eines Befunds; pytest warnt dann. - einlesen.py sucht den Bestand in der Bibliothek und nennt Treffer als Prozessbibliothek/<name>/, auch wenn der Klon woanders liegt. - Regeln aus prozesse/README.md nach docs/leitfaden/08_prozessbibliothek.md, inklusive Ablauf bei Konverteränderungen (zwei Pull Requests). - Verweise in AGENTS.md, README, Skills, Leitfäden, Vorlagen, Fallstricken und STATUS nachgezogen. - Tests: python -m pytest -q -> 88 bestanden, 1 xfail (#8), 1 Warnung (Bibliothek noch nicht geklont). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
151 lines
7.8 KiB
Markdown
151 lines
7.8 KiB
Markdown
# Prozesse einlesen: vom Eingangsordner zum BPMN-Diagramm
|
||
|
||
Für Kolleginnen und Kollegen, die eine Prozessbeschreibung in ein BPMN-Modell für PICTURE überführen wollen.
|
||
Git- oder Programmierkenntnisse braucht es dafür nicht. Stand 23.09.2026.
|
||
|
||
**Kurz:** Beschreibung als `.md`-Datei in den Ordner `input/` legen, Claude Code starten, „Lies den Ordner input
|
||
ein“ sagen, die Rückfragen beantworten, den Entwurf prüfen und freigeben. Fertig ist eine `.bpmn`-Datei für PICTURE.
|
||
|
||
```mermaid
|
||
flowchart TD
|
||
A["Beschreibung als .md<br/>nach input/ legen"] --> B["Claude Code: „Lies input ein“"]
|
||
B --> C{"Dateityp .md<br/>und UTF-8?"}
|
||
C -->|nein| X["abgelehnt – Datei bleibt liegen,<br/>Grund wird genannt"]
|
||
C -->|ja| D{"schon eingelesen<br/>und unverändert?"}
|
||
D -->|ja| Y["übersprungen"]
|
||
D -->|nein| E{"gibt es den Prozess<br/>schon?"}
|
||
E -->|nein| F["neuer Prozess:<br/>Entwurf in entwuerfe/"]
|
||
E -->|ja| G{"deine Entscheidung"}
|
||
G -->|aktualisieren| H["vorhandenen Prozess<br/>ergänzen"]
|
||
G -->|eigener Prozess| F
|
||
G -->|überspringen| Z["kein Vermerk,<br/>kommt beim nächsten Mal wieder"]
|
||
F --> I["Entwurf prüfen,<br/>Vorschau ansehen"]
|
||
H --> I
|
||
I -->|"„passt so“"| J["BPMN erzeugen"]
|
||
J --> K["Vermerk mit Datum/Uhrzeit<br/>oben in der .md"]
|
||
```
|
||
|
||
## 1. Einmalig: Einrichtung
|
||
|
||
Wer schon mit Claude Code im Ordner `AG_Prozesse` arbeitet, kann diesen Abschnitt überspringen. Sonst:
|
||
[`04_werkzeuge_einrichten.md`](04_werkzeuge_einrichten.md) Abschnitte 2 und 3 (Git, Python, Projektwissen holen,
|
||
Claude Code). Danach gibt es den Ordner `AG_Prozesse`; `input/` darin entsteht beim ersten Einlesen von selbst.
|
||
|
||
`input/` wird **nicht** mit Git geteilt. Was dort liegt, sieht nur, wer an deinem Rechner arbeitet.
|
||
|
||
## 2. Die Datei vorbereiten
|
||
|
||
**Vorerst werden nur `.md`-Dateien angenommen** (Markdown, also reiner Text). Word-, PDF- oder `.txt`-Dateien
|
||
werden abgelehnt und bleiben unverändert liegen.
|
||
|
||
So wird aus einer Word- oder PDF-Beschreibung eine `.md`-Datei:
|
||
|
||
1. In VS Code (oder dem Windows-Editor) eine neue Datei anlegen.
|
||
2. Den Text der Beschreibung hineinkopieren. Überschriften dürfen mit `# ` beginnen, Aufzählungen mit `- `.
|
||
Die erste Überschrift oder eine Zeile `Prozess: <Name>` wird als Prozessname verwendet.
|
||
3. Speichern unter `AG_Prozesse\input\<kurzer-name>.md`, **Codierung UTF-8** (VS Code speichert so; im Windows-Editor
|
||
unter „Speichern unter“ → Codierung „UTF-8“ wählen). Sonst werden Umlaute nicht gelesen und die Datei abgelehnt.
|
||
|
||
Vorher prüfen und entfernen: **Namen von Personen, Aktenzeichen, Verfahrensdaten.** Zuständigkeiten als Funktion
|
||
schreiben („Sachbearbeitung“, „Teamleitung“). Der Inhalt wird zur Verarbeitung an den KI-Anbieter übertragen.
|
||
|
||
Wer die Syntax schon kennt, kann direkt eine Arbeitsschritt-`.md` schreiben
|
||
(`.agents/skills/sn-bpmn/Anleitung.md`). Sie wird dann nur geprüft und nicht neu formuliert.
|
||
|
||
## 3. Einlesen starten
|
||
|
||
Im Ordner `AG_Prozesse` Claude Code starten (Terminal: `claude`, oder VS Code mit der Erweiterung) und schreiben:
|
||
|
||
> *Lies den Ordner input ein.*
|
||
|
||
(oder den Befehl `/sn-einlesen` wählen). Der Agent zeigt zuerst eine Übersicht, zum Beispiel:
|
||
|
||
```
|
||
[neu] input/antragspruefung.md: „Antragsprüfung im Sachgebiet“ (Rohtext)
|
||
ähnlich (0.44): Entwurf (lokal) entwuerfe/antrag-pruefen.md – „Antrag prüfen“
|
||
[abgelehnt] input/vorlage.docx: Dateityp .docx – vorerst nur .md
|
||
[eingelesen] input/wegebau.md: am 2026-09-20 10:12:03 +0200 (neu -> entwuerfe/wegebau-abnehmen.md)
|
||
```
|
||
|
||
Dieselbe Übersicht bekommst du ohne Agent mit `python scripts/einlesen.py`.
|
||
|
||
## 4. Entscheiden: Gibt es den Prozess schon?
|
||
|
||
Für jede neue Datei sucht der Agent im Bestand – versionierte Prozesse der Prozessbibliothek und deine lokalen Entwürfe
|
||
unter `entwuerfe/` – und sagt, ob und warum ein vorhandener Prozess passt. Gibt es einen, fragt er dich:
|
||
|
||
| Wenn du wählst … | … passiert |
|
||
|---|---|
|
||
| **Vorhandenen Prozess aktualisieren** | Der vorhandene Entwurf bzw. Prozess wird um die neuen Inhalte ergänzt. Bei Prozessen der Prozessbibliothek geht das über ein Issue und einen Pull Request dort (Abschnitt 7). |
|
||
| **Als neuen Prozess anlegen** | Es entsteht ein eigener Entwurf mit anderem Namen. |
|
||
| **Datei überspringen** | Nichts passiert. Die Datei erscheint beim nächsten Einlesen wieder. |
|
||
| **Einlesen beenden** | Der Agent hört auf; die übrigen Dateien bleiben unberührt. |
|
||
|
||
Gibt es keinen passenden Prozess, legt der Agent einen neuen Entwurf an und schlägt einen Namen vor. Du kannst
|
||
ihn ändern.
|
||
|
||
## 5. Entwurf prüfen und freigeben
|
||
|
||
Der Agent schreibt den Entwurf nach `entwuerfe/<name>.md` und nennt die Stellen, an denen er etwas **annehmen**
|
||
musste (Schrittgrenzen, Verzweigungen, Zuständigkeiten). Genau dort lohnt der fachliche Blick.
|
||
|
||
- Als Diagramm ansehen: `python scripts/vorschau.py entwuerfe/<name>.md` – öffnet den Browser, offline.
|
||
- Änderungen direkt in `entwuerfe/<name>.md` machen oder dem Agenten sagen, was anders sein soll.
|
||
- Wenn es passt: *„passt so, wandle um“*. **Vorher wandelt der Agent nicht um.**
|
||
|
||
Danach liegt `entwuerfe/<name>.bpmn` bereit für den Import in PICTURE.
|
||
|
||
## 6. Der Vermerk
|
||
|
||
Nach erfolgreichem Einlesen steht in der ersten Zeile deiner Datei in `input/` ein Vermerk, zum Beispiel:
|
||
|
||
```
|
||
<!-- eingelesen: 2026-09-23 14:05:12 +0200 | neu | entwuerfe/antrag-pruefen.md | inhalt: 3f2a9c1e0b7d -->
|
||
```
|
||
|
||
Datum und Uhrzeit, Ergebnis (`neu` oder `aktualisiert`) und wo das Ergebnis liegt. In der Markdown-Vorschau ist die
|
||
Zeile unsichtbar, im Editor sichtbar. Bitte nicht von Hand ändern.
|
||
|
||
- **Unveränderte Dateien mit Vermerk** werden beim nächsten Einlesen übersprungen.
|
||
- **Änderst du die Datei danach**, erkennt das der Agent (Prüfsumme) und bietet sie als „geändert“ erneut an.
|
||
Der neue Vermerk kommt obenauf, der alte bleibt als Verlauf stehen.
|
||
- **Kein Vermerk** bei Überspringen, Abbruch oder wenn der Entwurf nicht freigegeben wurde.
|
||
|
||
## 7. Für alle sichtbar ablegen (optional)
|
||
|
||
Entwürfe liegen nur auf deinem Rechner. Soll das Modell für die Gruppe verfügbar sein, legt der Agent es auf
|
||
Wunsch in der Prozessbibliothek ab, einem eigenen Repository, unter `<name>/` mit Steckbrief und Status `Entwurf`
|
||
(Regeln: [`08_prozessbibliothek.md`](08_prozessbibliothek.md)). Das ist eine Änderung an einem gemeinsamen
|
||
Repository:
|
||
|
||
1. Der Agent bereitet einen Issue-Text vor; **du** legst das Issue in Gitea an und nennst ihm die Nummer.
|
||
2. Der Agent legt den Ordner auf einem eigenen Branch an und bereitet Commit und Pull-Request-Text vor.
|
||
3. **Du** pushst und stellst den Pull Request; eine Kollegin oder ein Kollege prüft.
|
||
|
||
## 8. Häufige Fragen
|
||
|
||
**Meine Word-Datei wird abgelehnt.** Vorerst nur `.md`, siehe Abschnitt 2.
|
||
|
||
**„keine UTF-8-Datei“.** Die Datei in VS Code öffnen, unten rechts auf die Codierung klicken → „Mit Codierung
|
||
speichern“ → UTF-8.
|
||
|
||
**Die Datei wird immer wieder als neu angezeigt.** Sie wurde übersprungen oder nicht freigegeben – dann gibt es
|
||
keinen Vermerk. Einlesen erneut starten und abschließen, oder die Datei aus `input/` entfernen, wenn sie nicht
|
||
mehr gebraucht wird.
|
||
|
||
**Der Agent hält zwei Prozesse für gleich, die es nicht sind.** Die Ähnlichkeit ist nur ein Hinweis. „Als neuen
|
||
Prozess anlegen“ wählen und einen unterscheidbaren Namen vergeben.
|
||
|
||
**Ich möchte eine Datei noch einmal komplett neu einlesen.** Die Vermerkzeilen oben löschen; dann gilt sie wieder
|
||
als neu.
|
||
|
||
**Kann ich mehrere Dateien auf einmal einlesen?** Ja, sie liegen alle in `input/`. Der Agent bearbeitet sie
|
||
nacheinander und fragt bei jeder einzeln.
|
||
|
||
## Siehe auch
|
||
|
||
- Skill `sn-einlesen` (`.agents/skills/sn-einlesen/SKILL.md`) – was der Agent genau tut
|
||
- Skill `sn-bpmn` und `.agents/skills/sn-bpmn/Anleitung.md` – Entwurf und Syntax
|
||
- [`03_arbeitsweise.md`](03_arbeitsweise.md) – Arbeitsweise insgesamt
|
||
- [`08_prozessbibliothek.md`](08_prozessbibliothek.md) – versionierte Ablage in der Prozessbibliothek
|