diff --git a/.env.example b/.env.example
index 67752a6..5b2c0e2 100644
--- a/.env.example
+++ b/.env.example
@@ -177,11 +177,15 @@ RUN_N8N_IMPORT=
 # n8n configuration
 ############
 
-# Number of n8n worker replicas (for the n8n-worker service). Defaults to 1 if unset.
-N8N_WORKER_COUNT=
+# Number of n8n worker-runner pairs to generate.
+# Each worker gets its own dedicated task runner sidecar.
+# After changing, run: bash scripts/generate_n8n_workers.sh
+# Defaults to 1 if unset.
+N8N_WORKER_COUNT=1
 
-# Number of n8n task runner replicas (for Code/Python node execution). Defaults to 1 if unset.
-N8N_RUNNER_COUNT=
+# Enable offloading manual executions to workers (recommended for production).
+# When true, the main n8n instance does not execute workflows, only coordinates.
+OFFLOAD_MANUAL_EXECUTIONS_TO_WORKERS=true
 
 # Maximum number of concurrent Code node executions per task runner. Defaults to 5.
 N8N_RUNNERS_MAX_CONCURRENCY=5