diff --git a/web/AGENTS.md b/web/AGENTS.md
new file mode 100644
index 0000000..af3b7c8
--- /dev/null
+++ b/web/AGENTS.md
@@ -0,0 +1,9 @@
+<!-- BEGIN:nextjs-agent-rules -->
+
+## This is NOT the Next.js you know
+
+This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` (resolved from this file's directory; in monorepos the `next` package may not be visible from the repo root) before writing any code. Heed deprecation notices.
+
+This block is written and re-added by `next dev` — verify at `node_modules/next/dist/server/lib/generate-agent-files.js`. Removing it from a diff only re-creates the uncommitted change; committing it with your work keeps the tree clean.
+
+<!-- END:nextjs-agent-rules -->
diff --git a/web/CLAUDE.md b/web/CLAUDE.md
new file mode 100644
index 0000000..43c994c
--- /dev/null
+++ b/web/CLAUDE.md
@@ -0,0 +1 @@
+@AGENTS.md