diff --git a/AGENTS.md b/AGENTS.md
index 316f2716..00735065 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -3,6 +3,7 @@
 > This file is identical to CLAUDE.md. Keep them in sync.
 
 ## CODING ENVIRONMENT
+- Install astral uv if not already installed
 - Always use `uv run` to run files instead of the global `python` command.
 - Read `.env.example` for environment variables.
 - All CI checks must pass; failing checks block merge.
diff --git a/CLAUDE.md b/CLAUDE.md
index 56f6c3f1..794164d0 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -3,6 +3,7 @@
 > This file is identical to AGENTS.md. Keep them in sync.
 
 ## CODING ENVIRONMENT
+- Install astral uv if not already installed
 - Always use `uv run` to run files instead of the global `python` command.
 - Read `.env.example` for environment variables.
 - All CI checks must pass; failing checks block merge.