From a6cefc4c3e39931e487693e130a8a08fbe154ff3 Mon Sep 17 00:00:00 2001
From: Amolith <amolith@secluded.site>
Date: Sun, 5 Apr 2026 16:08:00 -0600
Subject: [PATCH] Add top-level AGENTS.md

Non-discoverable repo conventions: commands, REUSE licensing
requirements, and VCS/commit style expectations.
---
 AGENTS.md         | 24 ++++++++++++++++++++++++
 AGENTS.md.license |  3 +++
 2 files changed, 27 insertions(+)
 create mode 100644 AGENTS.md
 create mode 100644 AGENTS.md.license

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