diff --git a/.agents/rules/python.md b/.agents/rules/python.md
index 21f6671b93..701397fced 100644
--- a/.agents/rules/python.md
+++ b/.agents/rules/python.md
@@ -14,6 +14,8 @@
   link to its definition in the docstring.
 
 ## Type Checking & Annotations
+* **`importlib.metadata` `PackagePath`**: `f.locate()` is typed as `PathLike`.
+  Wrap with `pathlib.Path(f.locate())` to call `.exists()`, `.is_file()`, etc.
 * **In-file disables vs target skipping**: Prefer `# pyrefly: ignore[<error-code>]`
   (e.g. `[missing-import]`) over `tags = ["no-pyrefly"]`.
 * **No blanket ignores**: NEVER use bare `# type: ignore` or literal
diff --git a/.agents/rules/starlark.md b/.agents/rules/starlark.md
index 4517b06aec..2eccba7eab 100644
--- a/.agents/rules/starlark.md
+++ b/.agents/rules/starlark.md
@@ -41,6 +41,8 @@ globs: "*.bzl,BUILD,BUILD.bazel,*.bazel"
   `while` loops; iterate over fixed-size ranges or explicit collections.
 
 ## Code Style & Conventions
+* **Dict union (`|`)**: Use `|` instead of `dicts.add(...)` from
+  `@bazel_skylib//lib:dicts.bzl` when merging dictionaries.
 * **Docstring Formatting Invariants**: Use triple-quoted strings for multi-line
   docstrings without trailing backslashes (`\`) for line continuation.
 * **No Bazel Copyright Headers**: Do not add Bazel copyright headers to new or