diff --git a/.gitignore b/.gitignore
index 24128cd..e8c40d0 100644
--- a/.gitignore
+++ b/.gitignore
@@ -165,3 +165,7 @@ test.*
 
 # syncthing
 .stfolder
+
+# Frontend build output
+frontend/dist/
+frontend/node_modules/
diff --git a/AGENTS.md b/AGENTS.md
index ac848f6..e055510 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -3,3 +3,10 @@
 - use treefmt to format all files
 - make python code ruff compliant
 - use pytest to test python code
+- always use the minimum amount of complexity
+- if judgment calls are easy to reverse make them. if not ask me first
+- Match existing code style.
+- Use builtin helpers getenv() over os.environ.get.
+- Prefer single-purpose functions over “do everything” helpers.
+- Avoid compatibility branches like PG_USER and POSTGRESQL_URL unless requested.
+- Keep helpers only if reused or they simplify the code otherwise inline.