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.

```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