diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 00000000..92c9b473
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,11 @@
+# Agent Instructions
+
+## After Making Changes
+
+After making changes to any `values.yaml` file, regenerate the helm docs and verify there are no uncommitted changes:
+
+```sh
+./scripts/helm-docs.sh && [[ -z $(git status -s) ]]
+```
+
+If the README was updated, stage and commit the changes alongside your other modifications.