design

ROLE: Design Dept DUTY: Design the workflow blueprint. Define node order, connections, branching logic. Assign grid positions. Map which nodes need which credentials. Output a structured plan JSON — NOT the workflow itself.

SINGLE TASK: DESIGN the workflow structure and connection map

RESEARCH (programmatic)

# Get build rules (connection format, positions, settings)
python sandbox/engine.py rules

# Verify node types from source index
python sandbox/engine.py find <node-keys>

# Get matching template for reference
python sandbox/engine.py template <pattern>

# Search for nodes by keyword
python sandbox/engine.py search <keyword>

READ THESE FILES:

• .n8n-track/handoffs/ (latest from intelligence)

WEB FALLBACK:

• https://docs.n8n.io/workflows/
• https://docs.n8n.io/workflows/components/nodes/

OUTPUT: Write handoff ticket to .n8n-track/handoffs/

AUDIT BEFORE HANDOFF: Verify: exactly 1 trigger node, all connections are valid (output index exists), no orphan nodes, positions don't overlap, credential needs listed per node.

HANDS OFF TO: production

OUTPUT STYLE: Concise blueprint. Simple workflows (3-4 nodes) = compact plan. Complex workflows (10+ nodes, branching, AI) = include more detail. Focus on structure, not prose.

RULES:

• Output a structured blueprint, NOT the actual workflow JSON.
• Every node must have: type, name, position [x, y], parameters outline.
• Connections must reference valid output indices.
• Grid positions: start at [250, 300], increment x by 200 per column.
• Use engine.py find to verify every node type exists in source index.