BPMN 2.0 · Markdown · Open Source (MIT)

Prozesswissen, das Code und KI verstehen

bpmn-md ist eine textbasierte DSL für BPMN-Diagramme: eingebettet in Markdown, reviewbar in Pull Requests und geeignet als Kontext für LLMs. Die Brücke zwischen Werkzeugen wie Signavio oder Camunda und moderner, KI-gestützter Entwicklung — ohne Vendor Lock-in.

Auf die Warteliste Syntax ansehen

Die Lücke zwischen Vibe-Coding und BPMN

LLM-gestützte Entwicklung liefert oft Code — aber selten ein geteiltes Verständnis der Geschäftsprozesse dahinter. Gleichzeitig sitzt Prozesswissen in visuellen Enterprise-Tools, für Git und KI schwer nutzbar.

bpmn-md schließt diese Lücke: Prozesse werden als Text beschrieben, den Menschen, Versionskontrolle und KI gleichermaßen zugänglich ist — bei standardnaher BPMN-Notation (Pools, Lanes, Events, Gateways, Message Flows).

Prozessdokumentation im Repo — neben Code und Docs
LLM-Kontext — z. B. mit llms.txt und klarer Syntax
Kein Ersatz für Execution-Engines — Fokus auf Modellierung & Wissen
Kein Lock-in — eure Prozessdefinitionen bleiben eure Textdateien

Für wen bpmn-md gedacht ist

Orientierung an der Produktvision: Teams, die BPMN kennen und textbasierte Workflows mit Entwicklung und KI verbinden wollen.

Entwicklungsteams

Wenn KI Code vorschlägt, soll sie den Prozess kennen — nicht nur Syntax. bpmn-md-Dateien im Repo geben LLMs Kontext für prozessnahere Implementierung und Reviews.

Prozessanalysten & Fachbereich

Prozesse lesbar wie eine Beschreibung, mit echtem BPMN im Hintergrund — nicht nur ein Flowchart. Einbettbar in Markdown, abstimmbar mit IT in denselben Werkzeugen wie die Dokumentation.

KI-Assistenz & Tooling

Ein standardisiertes Textformat für Prozesskontext: parsebar, diffbar, generierbar. Ergänzt Camunda/Signavio dort, wo Wissen in Git und Docs leben soll.

Was ihr konkret gewinnt

Echtes BPMN — nicht „nur ein Diagramm“

Im Gegensatz zu generischen Flowcharts (z. B. Mermaid) unterstützt bpmn-md BPMN 2.0: Tasks mit Typen, Gateways, Events, Pools, Lanes und Message Flows zwischen Teilnehmern.

Text first — wie euer restliches Wissen

Kein proprietäres Binary im Git-Alltag: Markdown-Codeblöcke, diffs in PRs, Suche und Automatisierung wie bei Code — passend zu Docs-as-Code.

Diagramm & Layout

Auto-Layout (ELK.js) für übersichtliche SVGs; optional Companion-Layout (JSON) für editornahe Feinjustierung — dokumentiert im Projekt.

Portal & Playground

Playground zum Live-Editieren; Portal für Projekte und Prozesslisten mit Editor — für Teams, die zentral arbeiten wollen (weiter ausgebaut).

Funktionen (Stand Projekt)

DSL-Parser (Events, Tasks, Gateways, alle Flow-Typen inkl. Message Flow)
Pools, Lanes, Kollaborationen über Organisationen/Rollen hinweg
SVG-Rendering mit BPMN-2.0-nahen Formen und Icons
Direktiven: @title, @direction, @theme, Metadaten für Kataloge
Markdown-Extraktion aus ```bpmn-md-Blöcken
llms.txt zur Anbindung von KI-Assistenten an die Syntax

So sieht die Syntax aus

Kurzes Beispiel — vollständige Spezifikation in der Projektdokumentation (docs/syntax-spec.md im Repository).

@title "Order Fulfillment"

pool "Customer"
  (start) --> [Place Order]:user
  [Place Order] -..-> [Receive Order]

pool "Online Shop"
  lane "Sales"
    [Receive Order] --> [Validate Order]:service
    [Validate Order] --> <Valid?>
    <Valid?> -->|yes| [Confirm Order]:send

Warteliste für frühen Zugang

Wir informieren dich über den Ausbau von Portal, Landing und Releases — ohne Spam. Die Anmeldung läuft über die Mailchimp Marketing API auf dem Server — kein API-Key wird im Browser ausgeliefert.