diff --git a/src/CLAUDE.md b/src/CLAUDE.md
index 7b394aa69f..770763ea4f 100644
--- a/src/CLAUDE.md
+++ b/src/CLAUDE.md
@@ -8,4 +8,5 @@ Syntax reminders:
 Conventions:
 
 - Prefer `@import` at the **bottom** of the file, but the auto formatter will move them so you don't need to worry about it.
+- **Never** use `@import()` inline inside of functions. **Always** put them at the bottom of the file or containing struct. Imports in Zig are free of side-effects, so there's no such thing as a "dynamic" import.
 - You must be patient with the build.