Naming format: source_thing
Examples:
crm_first_name not data1scrape_article_summary not scrapeCllm_email_draft not llm_output_7blockbuster_last_week not knowledge_base_33blockbuster_diff not output_2The read-aloud test: Say the variable name out loud. If someone unfamiliar with your workflow can't immediately tell what's inside, rename it.
Your workflow tool will auto-name variables for you (e.g.,scrape_a,scrape_b). Always rename these before moving on.
Why this matters now, not later: Workflows with generic variable names become unreadable around 8-10 nodes. At that point, every edit requires clicking into each node to figure out what the variable actually holds. This cost compounds when handing workflows off to teammates.
Naming format: source_thing
Examples:
crm_first_name not data1scrape_article_summary not scrapeCllm_email_draft not llm_output_7blockbuster_last_week not knowledge_base_33blockbuster_diff not output_2The read-aloud test: Say the variable name out loud. If someone unfamiliar with your workflow can't immediately tell what's inside, rename it.
Your workflow tool will auto-name variables for you (e.g.,scrape_a,scrape_b). Always rename these before moving on.
Why this matters now, not later: Workflows with generic variable names become unreadable around 8-10 nodes. At that point, every edit requires clicking into each node to figure out what the variable actually holds. This cost compounds when handing workflows off to teammates.