diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000000..bc498eb211
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1 @@
+This is a local development server hosted at HOST env variable (please read config.env file). When you make any changes to the codebase the server hot-reloads. Please make sure you wait for it to restart to test. This project is hosted on docker compose for local development. If you need access to the database during development, credentials are in config.env file. 
\ No newline at end of file
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000000..4eba020841
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1 @@
+Please read AGENTS.md in root of the project file for more information.
\ No newline at end of file