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 unter `prozesse/` 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 unter `prozesse/` geht das über ein Issue und einen Pull Request (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 unter `prozesse/<name>/` ab – mit Steckbrief und Status `Entwurf` (Regeln: `prozesse/README.md`). Das ist
eine Änderung am 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
- `prozesse/README.md` – versionierte Ablage