diff --git a/AGENTS.md b/AGENTS.md
index 8a89717..dcaf985 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -43,3 +43,9 @@ bun install
 bun run check   # typecheck + lint + format:check + test
 bun run test:e2e # Postgres tests; DATABASE_URL, default localhost:5432
 ```
+
+## 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.