diff --git a/.gitignore b/.gitignore
index d6fe8f9..37a962f 100644
--- a/.gitignore
+++ b/.gitignore
@@ -21,4 +21,3 @@ Thumbs.db
 .claude/
 
 # Local hygiene notes (not for commit)
-CLAUDE.md
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..578d722
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,13 @@
+# AGENTS.md — Repo hygiene
+
+Follow [`CONTRIBUTING.md`](CONTRIBUTING.md). Single-trunk: `main` plus short-lived `feature/` / `fix/` branches. `dev`/`beta` are bakery tracks (tags / main), not git branches.
+
+## Remotes
+- `origin` — Forgejo (`git.breadway.dev`) — authoritative.
+- `github` — mirror. Day-to-day push `origin` only.
+
+## Product
+GTK4 app launcher + `breadbox-sync` icon cache. Theme via `bread-theme` (pin by tag on `git.breadway.dev`). Toggle uses `bread-utils::singleton`, not a homegrown PID file.
+
+## Distribution
+Bakery (`bakery.toml`). Forgejo `.forgejo/workflows/` is canonical; do not re-add a GitHub Actions release workflow.