diff --git a/AGENTS.md b/AGENTS.md
index 552a964..6b97347 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -308,3 +308,9 @@ host schema's `tenant` / `principal` (see the data model).
 ```sh
 bun install && bun run check
 ```
+
+## Conventions
+
+- Read `README.md` before changing public behavior.
+- Keep changes focused; update docs and tests alongside code changes.
+- Run `bun run check` (typecheck, lint, format, tests) before declaring work complete.