n8n-dokumentation

name	n8n-dokumentation
description	Dokumentiert n8n-Workflows automatisch mit erklärenden Sticky-Note-Nodes in einfacher Sprache, damit Einsteiger nachvollziehen können, was passiert. Verwenden nach dem Bauen/Validieren eines Workflows oder wenn der User um Dokumentation, Erklärung, Kommentare oder Sticky Notes für einen Workflow bittet.

Workflow dokumentieren (Sticky Notes in Klartext)

Nach dem Bauen/Validieren eines Workflows erklärende Sticky Notes einfügen, die in einfacher, nicht-technischer Sprache beschreiben, was der Workflow tut — damit Einsteiger (und der Kunde) den Ablauf verstehen, ohne jeden Node zu öffnen.

Wann

• Nach n8n_create_workflow oder nach signifikanten Änderungen (neue Nodes/Logik).
• Wenn der User sagt „dokumentiere den Workflow", „erklär mir das", „mach Kommentare/Sticky Notes rein".
• Sprache = die Sprache des Users (Default: Deutsch).

Was schreiben (verständlich, nicht technisch)

1. Eine Übersichts-Sticky oben links: Was macht der Workflow in 1–2 Sätzen? Wann läuft er (Trigger)? Was kommt raus?
2. Pro logischem Abschnitt eine Sticky (z.B. „Daten empfangen", „Prüfen & Filtern", „KI-Antwort erzeugen", „E-Mail senden") direkt über/neben den zugehörigen Nodes:
   • Was passiert hier, in Alltagssprache.
   • Worauf der Nutzer achten muss (z.B. „braucht eine E-Mail-Credential").

• Keine Code-Details, keine Node-Interna — das Warum, nicht das Wie.

Wie einfügen (n8n-mcp)

Sticky Notes sind normale Nodes vom Typ n8n-nodes-base.stickyNote. Per n8n_update_partial_workflow mit addNode-Operationen einfügen — sie verändern den Datenfluss nicht (keine Connections nötig).

Parameter einer Sticky Note:

• content — Markdown-Text (Überschrift ## + kurze Erklärung).
• width, height — Größe (z.B. 320 × 160), groß genug für den Text.
• color — Zahl 1–7 (Farbe je Abschnitt, z.B. 4=blau Übersicht, 5=grün Eingang, 3=gelb Verarbeitung, 2=rot Ausgang/Achtung).
• position — [x, y]; Sticky oberhalb der zugehörigen Nodes platzieren (kleineres y), damit sie als „Überschrift" über der Gruppe liegt und keine Nodes überdeckt.

Beispiel-Operation:

{
  "type": "addNode",
  "node": {
    "name": "Doku: Übersicht",
    "type": "n8n-nodes-base.stickyNote",
    "position": [-200, -160],
    "parameters": {
      "content": "## Was macht dieser Workflow?\nEr empfängt ein Formular, prüft die Eingaben, lässt die KI eine Antwort schreiben und schickt sie per E-Mail.\n\n**Läuft, wenn** das Webhook-Formular abgeschickt wird.",
      "height": 180,
      "width": 340,
      "color": 4
    }
  }
}

Vorgehen

1. Workflow lesen (n8n_get_workflow), Nodes in logische Abschnitte gruppieren und deren Positionen merken.
2. Pro Abschnitt eine Sticky knapp oberhalb der Gruppe platzieren (y kleiner als die Nodes), plus eine Übersichts-Sticky oben links.
3. Alle Stickies in einem n8n_update_partial_workflow-Call (mehrere addNode-Operationen) einfügen.
4. Kurz validieren (n8n_validate_workflow) — Sticky Notes dürfen nichts kaputtmachen.

Don't

• Keine Secrets/Keys oder personenbezogene Daten in den Text schreiben.
• Stickies nicht über Nodes legen (überdeckt sie) — immer daneben/darüber.
• Nicht jeden Node einzeln kommentieren — pro Abschnitt eine Sticky reicht.