diff --git a/AGENTS.md b/AGENTS.md
index 7f1f0b3..186a592 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -86,3 +86,4 @@ def lookup_job_for_partition(partition_ref: str) -> str:
 
 ## Notes / Tips
 - Rust dependencies are implemented via rules_rust, so new dependencies should be added in the `MODULE.bazel` file.
+- Designs/plans should rarely include code snippets, outside of specifying interfaces or very specific changes.