diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..fa244c9
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,10 @@
+# secajs
+
+## Architecture
+
+This repository contains a webapp. It covers the full stack which consists of:
+- The client side code, in `src/front/`.
+- The backend service in `src/`, except for `src/front/`.
+- A Postgres database. Database connections and migrations are in `src/database/`.
+- Besides, there is an admin CLI, with entrypoint in `src/cli.js` and commands in `src/commands/`.
+