n8n-Build-Konventionen¶

Workflow-Architektur¶

Komponieren statt aufblähen. Kleine, wiederverwendbare Subworkflows + „Execute Workflow"-Node aus Parent-Workflows. Keine Monolithen.
Vor neuem Code: prüfen, ob ein bestehender Subworkflow das schon tut (search_workflows).
Subworkflows nach Capability benennen: sub: send-slack-alert, sub: enrich-contact, sub: plenty-lookup.

Immer Schemas prüfen. get_node_types für jeden geplanten Node aufrufen — auch für „bekannte" Nodes. Schemas driften.
Built-in Nodes vor Code Nodes. HTTP Request, Set, IF, Switch, Merge, Item Lists etc. zuerst.
Leichte Logik in Expressions ({{ $json.foo.toUpperCase() }}) statt Code Node.
Code Node nur bei: komplexe Transforms, Multi-Step-Iteration über verschachtelte Daten. Begründen.

validate_workflow vor Publish.
prepare_test_pin_data + test_workflow zur Verifikation, vor publish_workflow.

Default: Continue (using error output) statt Stop Workflow, außer bewusst anders entschieden.
Bei externen APIs: Retry on Fail aktivieren, nicht Never Error: true.
Subworkflow-Outputs als strukturiertes Objekt (status, data, method, …), nicht als JSON-String.

Im code-Parameter eines Code-Nodes ist .join() zur Stringkonstruktion nicht erlaubt (Security-Filter). Stattdessen: jsCode als ein String mit \n oder per +-Konkatenation aufbauen.
CRITICAL — update_workflow zerstört Credential-Bindungen. newCredential('Name') matcht NICHT mit existierenden Credentials gleichen Namens, sondern legt einen leeren Placeholder an. Nach jedem update_workflow sind ALLE Credentials in allen Nodes weg → Workflow läuft ins Leere.
Konsequenz: für surgical Single-Node-Patches in produktiven Workflows lieber per UI editieren, oder nach update_workflow SOFORT zusammen mit Susi alle Credential-Drops in der UI neu setzen.
Vorher klar sagen, welche Nodes welche Credentials brauchen.

Klickbarer Link zu jedem Workflow, den du erstellst oder änderst.
Format (Markdown): [workflow name](workflow-url) — in der finalen Antwort, nicht im Tool-Output vergraben.
Bei mehreren Workflows (Parent + Subworkflows): alle verlinken.

URL: https://ai-mokebo.app.n8n.cloud/
Projekte:
Susi Projects (Team) — ID uK9eJgH0LF2SK87i ← Default-Ablageort für neue Workflows
Mokebo Gang <ai@mokebo.de> (Personal) — ID Y6M7vNhKKlTBOBX3