diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..09c3bd5
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,12 @@
+# AGENTS.md
+
+## Cursor Cloud specific instructions
+
+This is `@tacc/core-components`, a React component library (TypeScript/JSX) built with Vite and demoed via Storybook. No backend, database, or Docker required.
+
+### Commands
+
+See `README.md` "Developing" for key commands:
+
+- (if missing dependencies) `npm install --include=optional`
+- `npm start`