diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..76127b1
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,22 @@
+# AGENTS.md
+
+This file is for code-writing LLM agents like Claude Code, Gemini CLI, Cursor, etc.
+
+CLAUDE.md symlinks to this file.
+
+## Overview
+
+This repository contains code for the Python SDK for Replicate's HTTP API.
+
+Most of the code is autogenerated from Replicate's public OpenAPI spec.
+
+When writing custom code, put it in the `lib/` directory whenever possible.
+
+## Development Commands
+
+Use the `scripts/` directory to run scripts:
+
+- `scripts/lint` - Run linting checks (ruff + pyright + mypy) and import verification
+- `scripts/format` - Run code formatting (ruff format + doc formatting)
+- `scripts/test` - Run full test suite (includes Prism mock server setup and Pydantic v1 compatibility tests)
+- `scripts/mock` - Start Prism mock server for testing
\ No newline at end of file
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