Projektwissen/docs/leitfaden/07_prozesse_einlesen.md

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.

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 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). 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 – Arbeitsweise insgesamt
• 08_prozessbibliothek.md – versionierte Ablage in der Prozessbibliothek