diff --git a/AGENTS.md b/AGENTS.md
index 0813e2d..84685bd 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -37,3 +37,9 @@ transport. It does not store or search vectors; that is `@corbits/memory`.
 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` before declaring work complete.