Tool — Workflow Migration
ArcFlow Scaffolder
Converts n8n workflow JSON exports to ArcFlow YAML definitions. Reads n8n .json, maps nodes to ArcFlow step types, outputs a scaffolded arcflow.yaml ready for manual review and completion.
What it does
- Reads an n8n workflow export (JSON) from disk
- Maps n8n node types to ArcFlow step equivalents (HTTP Request →
http.post, Set →transform, IF →gate, etc.) - Preserves node connections and data flow
- Outputs a scaffolded
arcflow.yamlwith TODOs where manual review is needed - Lists unmapped node types at the end so nothing is silently dropped
n8n is retired
n8n retires when ArcFlow is feature-complete. No new n8n workflows are being built. The scaffolder accelerates the migration of existing workflows. Source: scripts/arcflow_scaffold.py.
Usage
# From the project root
python3 scripts/arcflow_scaffold.py \
--input path/to/n8n-export.json \
--output path/to/arcflow.yaml
# Preview without writing
python3 scripts/arcflow_scaffold.py \
--input path/to/n8n-export.json \
--dry-runNode type mapping
# n8n node type → ArcFlow step type
n8n-nodes-base.httpRequest → http.post / http.get
n8n-nodes-base.set → transform
n8n-nodes-base.if → gate
n8n-nodes-base.function → code (manual review required)
n8n-nodes-base.emailSend → http.post (Sendgrid / SMTP config)
n8n-nodes-base.supabase → supabase.select / supabase.insert
n8n-nodes-base.webhook → trigger.webhook
n8n-nodes-base.scheduleTrigger → trigger.cron
# Unmapped nodes get a TODO comment in the output YAMLOutput format
# arcflow.yaml (scaffolded output)
version: "1"
name: "My Migrated Workflow"
trigger:
type: webhook
path: /trigger/my-migrated-workflow
steps:
- id: step-1
type: http.post
url: "{{env.SOME_API_URL}}" # TODO: verify URL
body: "{{trigger.body}}"
- id: step-2
type: gate
condition: "{{step-1.status == 200}}"
# TODO: verify condition logic from n8n IF node