diff --git a/.nvmrc b/.nvmrc
index 2edeafb09..8fdd954df 100644
--- a/.nvmrc
+++ b/.nvmrc
@@ -1 +1 @@
-20
\ No newline at end of file
+22
\ No newline at end of file
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 000000000..4fbe956db
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,24 @@
+# AGENTS.md
+
+## Project Structure
+- `_site/` - Generated static site output
+- `src/` - Source files (posts, pages, templates, styles, data)
+- `src/_includes/` - Nunjucks layouts and partials
+- `src/_11ty/` - Eleventy plugins and custom filters
+- `src/_data/` - Global data files
+- `src/posts/` - Blog posts in Markdown
+- `src/pages/` - Static pages
+- `src/styles/` - TailwindCSS source files
+
+## Build Commands
+- See @package.json for available npm commands for this project.
+- Always run `npm run prettier:fix` after code changes to ensure consistent formatting.
+
+## Code Conventions
+- Use kebab-case for markdown files (e.g., `mein-blog-post.md`) and CSS files.
+- Use snake_case for JavaScript utility modules (e.g., `post_url.js`)
+
+## Agent Safety Rules
+- Do not commit, push, or create PRs unless explicitly asked.
+- Ask before destructive git operations (for example hard reset, rebase, force push).
+- Allowed by default: reading files, searching, diffs, status/log, and running builds/tests/format checks.
\ No newline at end of file
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 000000000..eef4bd20c
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1 @@
+@AGENTS.md
\ No newline at end of file