diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..f39591b
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,14 @@
+# use-acp
+
+React hooks for the [Agent Client Protocol](https://agentclientprotocol.com/) (ACP) over WebSockets. Published to npm as `use-acp`.
+
+## Development
+
+```bash
+pnpm install
+pnpm test        # vitest
+pnpm lint        # biome check --write (autofix.ci runs this on PRs)
+pnpm lint:ci     # biome check, no writes
+pnpm typecheck   # tsc --noEmit
+pnpm build       # tsc -> dist/
+```
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 120000
index 0000000..47dc3e3
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1 @@
+AGENTS.md
\ No newline at end of file