diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..4278e9e
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,7 @@
+# AGENTS.md — Repo hygiene
+
+Zola site. Catalog is curated (`data/projects.toml`), not the bakery registry.
+Bakery source of truth: `bread-ecosystem/registry/bread-ecosystem.toml`.
+Design tokens: BOS fixed dark (`#0c0c0c` / `#1a1a1a`), not Catppuccin.
+
+Single-trunk `main`. `origin` is Forgejo. Do not invent a `dev`/`beta` branch.