diff --git a/.github/scripts/run_smoke.py b/.github/scripts/run_smoke.py
index 3822a45..1c3d6a0 100644
--- a/.github/scripts/run_smoke.py
+++ b/.github/scripts/run_smoke.py
@@ -1,7 +1,7 @@
 """
 Run the workspace smoke test suite.
 
-Reads `smoke_tests.txt` from the workspace root and `config/build/env_vars.yaml`
+Reads `smoke_tests.txt` from the workspace root and `config/build/profile_smoke.yaml`
 for per-script env var overrides, then runs each listed script with the
 appropriate environment. Continues through failures and exits non-zero
 if any script failed.
@@ -23,7 +23,11 @@
 
 WORKSPACE = Path(__file__).resolve().parents[2]
 SMOKE_FILE = WORKSPACE / "smoke_tests.txt"
-ENV_VARS_FILE = WORKSPACE / "config" / "build" / "env_vars.yaml"
+# Prefer the canonical profile name; fall back to the legacy name until the
+# stage-3 cleanup drops the fallback.
+ENV_VARS_FILE = WORKSPACE / "config" / "build" / "profile_smoke.yaml"
+if not ENV_VARS_FILE.exists():
+    ENV_VARS_FILE = WORKSPACE / "config" / "build" / "env_vars.yaml"
 SCRIPTS_DIR = WORKSPACE / "scripts"
 
 
diff --git a/AGENTS.md b/AGENTS.md
index a59fe4e..74076cc 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -38,7 +38,7 @@ cap grids/masks).
 ## Testing
 
 On CI, every PR is gated on Python **3.12 and 3.13** by `smoke_tests.yml` (runs
-`python .github/scripts/run_smoke.py`, driven by `smoke_tests.txt` + `config/build/env_vars.yaml` —
+`python .github/scripts/run_smoke.py`, driven by `smoke_tests.txt` + `config/build/profile_smoke.yaml` —
 the definition of green), `navigator_check.yml` (PyAutoHands's reusable navigator-catalogue check;
 see *Notebooks vs Scripts*), and `url_check.yml` (link checking). The smoke and navigator jobs check
 out **PyAutoHands** as a sibling and run the PyAuto* libraries from the **same-named branch** of each
diff --git a/config/build/env_vars.yaml b/config/build/profile_smoke.yaml
similarity index 96%
rename from config/build/env_vars.yaml
rename to config/build/profile_smoke.yaml
index 62265dd..c21ed1a 100644
--- a/config/build/env_vars.yaml
+++ b/config/build/profile_smoke.yaml
@@ -27,7 +27,7 @@ defaults:
 #
 # 2026-07-23: the last remaining override, `guides/results/`, was removed for
 # the same reason — it is an autogalaxy_workspace path copied in from that
-# repo's env_vars.yaml. HowToGalaxy contains only chapter_*/tutorial_*.py, so
+# repo's profile_smoke.yaml. HowToGalaxy contains only chapter_*/tutorial_*.py, so
 # it never matched a file here. Do not copy override patterns between repos; a
 # pattern that matches nothing is silently inert, not an override. The list is
 # now empty, and `overrides: []` is written explicitly because env_config.py