diff --git a/Agents.md b/Agents.md
new file mode 100644
index 000000000..aa3441aef
--- /dev/null
+++ b/Agents.md
@@ -0,0 +1,3 @@
+# Repository Agent Notes
+
+- When a PR needs visual evidence such as images or videos, add those assets to the PR description or a PR comment using GitHub-hosted attachment links. Do not commit generated image or video artifacts into the codebase unless the user explicitly asks for them to be part of the repository.