diff --git a/dot_config/mise/config.toml.tmpl b/dot_config/mise/config.toml.tmpl
index b37ab30..febae85 100644
--- a/dot_config/mise/config.toml.tmpl
+++ b/dot_config/mise/config.toml.tmpl
@@ -83,4 +83,8 @@ op                                          = "latest"
 
 # Not in mise (installed elsewhere):
 #   htop/tree/nmap/wireguard-tools/telnet/postgresql-client — OS-native (C deps)
+#
+# direnv intentionally NOT used — mise officially discourages running both
+# (PATH conflicts, "not bugs"). mise's [env] + `_.file = '.env'` in a project
+# mise.toml replaces .envrc, auto-applied on cd via `mise activate`.
 {{- end }}