diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000000000000000000000000000000000000..5a894ba1aa7ca64c81f9a1cfde6548ccff563a06
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,24 @@
+# AGENTS.md
+
+## Commands
+
+```sh
+bun install              # install deps (run after cloning)
+mise run check           # fmt + lint + typecheck
+mise run fmt             # biome format
+mise run lint            # biome lint
+mise run typecheck       # tsc --noEmit across all packages
+```
+
+## Licensing
+
+This repo uses REUSE. Every file needs SPDX headers or a `.license` sidecar.
+Run `reuse lint` to verify. Each package has its own license — check the
+existing headers before adding files.
+
+## VCS
+
+This is a jj repo. Use kernel-style commit messages (imperative, 50-char
+subject, body explains what/why). Use the format script at
+`~/.config/agents/skills/formatting-commits/scripts/format` to validate
+subjects and reflow bodies.
diff --git a/AGENTS.md.license b/AGENTS.md.license
new file mode 100644
index 0000000000000000000000000000000000000000..3dbb1e29808ff6ce1e89aa3211dbfa6c8aa5ef0e
--- /dev/null
+++ b/AGENTS.md.license
@@ -0,0 +1,3 @@
+SPDX-FileCopyrightText: Amolith <amolith@secluded.site>
+
+SPDX-License-Identifier: CC0-1.0