Was macht Workflow-Visualizer?
Wenn jemand einen Workflow im Detail verstehen möchte, reicht Fließtext selten aus. Ein Prozess hat eine Reihenfolge, Übergaben, Entscheidungen und Wartezeiten. Eine passende Grafik macht das auf einen Blick lesbar. Sie ersetzt die lange Textantwort, anstatt sie zu ergänzen.
Die Form wird frei gewählt. Keine Form hat Vorrang, weder der Zeitstrahl noch eine andere. Die Struktur des Workflows entscheidet.
Wann dieser Skill angewendet wird
Zwei Bedingungen müssen zusammen erfüllt sein:
- Der Kontext ist ein Workflow, Prozess oder Verfahren (der eigene des Nutzers, eines, das besprochen wurde, oder eines, das von Grund auf erklärt werden muss).
- Der Nutzer wünscht mehr Tiefe: „im Detail“, „genauer“, „Schritt für Schritt“, „noch einmal erklären“, „wie läuft das ab“.
Wenn das Wort „Workflow“ nur beiläufig fällt und die Frage schnell beantwortet ist, antworte kurz im Chat. Eine Grafik für jede beiläufige Erwähnung entwertet sie.
Ablauf
- Den Prozess klären. Den Prozess aus dem Gespräch, aus Dateien oder aus Quellen nehmen, die der Nutzer nennt. Wenn etwas Wesentliches fehlt, kurz einmal nachfragen. Keine Schritte, Dauern oder Werkzeuge erfinden. Alles, was nicht verifiziert ist, wird mit „Offen“ markiert.
- Die Struktur lesen, dann die Form wählen. Siehe den nächsten Abschnitt. Im Chat einen Satz sagen, welche Form gewählt wurde und warum. Der Nutzer kann mit einem Wort widersprechen.
- Gliedern. Insgesamt 4 bis 10 Schritte, gruppiert in 2 bis 4 Phasen oder Spuren. Mehr verwässert die Grafik; fasse Unterprozesse stattdessen zusammen.
- Jeden Schritt befüllen.
- Zeitmarker oder Position: eine reale Dauer, ein Zeitpunkt oder die Reihenfolge („Schritt 3“). Keine geschätzten Uhrzeiten.
- Ein Symbol aus der Legende.
- Ein Titel (Substantiv, kurz) und ein bis zwei Sätze, was passiert und warum.
- Optional Wichtig-Box: nur wenn eine Information den Prozess entscheiden kann oder scheitern lässt (Voraussetzung, Fehlerquelle, Freigabe).
- Optional Konkret-Box: ein greifbares Bild, Beispiel oder Analogie, das einen abstrakten Schritt fassbar macht. Das Bild erklärt etwas; es schmückt nicht.
- Die Legende aufbauen. Nur die Symbole, die in der Grafik vorkommen, plus die Elemente der gewählten Form. Die Legende steht oben.
- Als Seite ausliefern. Sie aus
assets/base-template.htmlaufbauen (Tokens, Kopfzeile, Legende, Boxen) und die Struktur der gewählten Form nachreferences/shapes.mdhinzufügen. Für das Flussdiagramm gibt es ein fertiges Beispiel inassets/flowchart-example.html: dessen CSS wiederverwenden und den Inhalt ersetzen. Die Seite mit dem Namen des Workflows betiteln, z. B. „Dokumentenfreigabefluss“. Wenn die Umgebung Seiten oder Artefakte veröffentlichen kann, dort veröffentlichen; andernfalls eine eigenständige HTML-Datei ausliefern. - Im Chat antworten. Ein oder zwei Sätze: die gewählte Form mit Begründung und etwaige offene Punkte. Den Inhalt der Grafik nicht wiederholen.
Die Form wählen
Zuerst die Struktur des Workflows lesen, dann entscheiden. Diese Fragen helfen:
- Gibt es Entscheidungen, deren Ergebnis zurückführt (eine Schleife), oder deren Pfade wieder zusammentreffen, und soll der Leser den Pfad mit dem Finger nachverfolgen können? → Flussdiagramm
- Teilen sich Pfade an Entscheidungen und enden an verschiedenen Orten, ohne zurückzukehren? → Verzweigung
- Tragen mehrere Personen, Werkzeuge oder Rollen Teile des Prozesses, liegt die Schwierigkeit in den Übergaben, und gibt es keine Schleife? → Spuren
- Beginnt der Prozess nach dem letzten Schritt unverändert von neuem, oder speist das Ergebnis den nächsten Durchlauf, ohne dass dazwischen Entscheidungen getroffen werden? → Zyklus
- Laufen Stränge gleichzeitig und müssen irgendwo zusammenkommen? → Parallele Spuren
- Ist der Prozess im Kern eine zeitliche Abfolge von Schritten mit Wartezeiten, Fristen oder Dauern, die wichtig sind? → Zeitstrahl
- Mischt der Workflow mehrere Eigenschaften? Diejenige wählen, bei der der Leser am wahrscheinlichsten einen Fehler macht. Die sekundäre Eigenschaft wird eine Infobox oder ein Orts-Tag: Ein Flussdiagramm kann zeigen, wo ein Schritt stattfindet, ohne Spuren zu benötigen.
Eine Schleife ist der häufigste Grund, die Form zu wechseln. Sie in einer Infobox zu verstecken, begräbt sie, und genau dort stolpern Leser. Wenn es eine gibt, ist das Flussdiagramm meist die ehrlichste Form, auch wenn Spuren oder der Zeitstrahl auf den ersten Blick passend aussehen.
Nicht nach Aussehen oder Gewohnheit wählen. Eine Form, die nicht zur Struktur passt, verfälscht den Prozess: Eine Achse verbirgt Alternativen, Spuren ohne echte Übergaben sind Dekoration.
Die genauen Bauregeln für jede Form stehen in references/shapes.md. Nur den Abschnitt der gewählten Form lesen.
Symbole
Alle eckig, keine Kreise. Die Formen werden mit CSS gezeichnet, nicht mit Zeichen, damit sie überall gleich aussehen.
| Symbol | Form | Bedeutung |
|---|---|---|
| Aktion | gefülltes Quadrat | etwas wird getan oder erzeugt |
| Entscheidung | leeres Quadrat | der Fluss verzweigt sich hier |
| Prüfpunkt | Raute | Prüfung, Abnahme, Freigabe |
| Übergabe | Dreieck | Ergebnis geht an eine Person, ein Werkzeug oder eine Phase |
| Warten | waagerechter Balken | nichts geschieht aktiv, Zeit vergeht |
| Offen | gestricheltes Quadrat | Information fehlt oder ist ungeprüft |
Weitere Symbole nur hinzufügen, wenn der Workflow sie wirklich benötigt, und sie in der Legende erklären.
Gestaltung
Die Vorlage bringt ein neutrales Standard-Design mit: warmer Papierhintergrund, fast schwarze Tinte, eine helle Akzentfarbe nur als Fläche, und die System-Schriftart. Alle Farben sind Tokens in :root. Wenn der Nutzer eine Marke oder ein Designsystem hat, nur diese Tokens ändern; die Struktur nicht umgestalten.
- Papier als Hintergrund, Tinte für Titel, Graphit für Fließtext, ein ruhiger Farbton für ruhige Flächen, Haarlinien für Linien.
- Der Akzent wird nur als Fläche verwendet, nie als Text- oder Linienfarbe. Text darauf ist immer Tinte. Höchstens ein großes Akzentband pro Seite; die kleinen Markierungsbalken (10px) unter Phasen- und Spurentiteln dürfen wiederholt werden.
- Eine Schriftfamilie. Hierarchie durch Gewicht und Buchstabenabstand; Buchstabenabstand nur bei Großbuchstaben.
- Keine Schatten, Farbverläufe, abgerundeten Ecken, Emojis oder Ausrufezeichen. Listen verwenden Tintenquadrate. Verbindungen sind gerade Linien mit rechten Winkeln, 2px Tinte.
- Die Seite bleibt einfarbig auf Papier. Alle Farben werden explizit gesetzt, damit sie in hellen und dunklen UIs gleich gelesen werden.
- Mobile First, kein horizontales Scrollen der Seite. Alles, was breiter sein muss (Spuren), scrollt in einem eigenen Container.
Keine neuen Farben, Schriftarten oder Formen erfinden. Wenn dem System etwas fehlt, die Lücke benennen und innerhalb der Tokens lösen.
Sprache
Die Grafik in der Sprache schreiben, die der Nutzer verwendet. Sachlich, substantivbasiert und kurz halten. Kein Füllstoff, keine Trendsprache. Erklärungen dürfen lebendig, aber präzise sein: ein starkes Bild statt drei schwacher.
Checkliste vor der Auslieferung
- Die Form folgt der Struktur des Workflows, und der Chat-Satz nennt den Grund.
- Jede Schleife ist als Pfad gezeichnet und nicht nur im Text erwähnt.
- Jede Zeitangabe ist dokumentiert oder nur als Reihenfolge markiert.
- Alles, was nicht verifiziert ist, trägt das Symbol „Offen“.
- Alle Symbole in der Grafik erscheinen in der Legende, und keine anderen.
- Der Akzent wird nur als Fläche verwendet, nie als Text oder Linie.
- Kein Text läuft über den Rand, nicht einmal bei 400px Breite.
- Der Chattext wiederholt nicht den Inhalt der Grafik.