1 files changed, 87 insertions, 0 deletions
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..c73e886
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,87 @@
+# AGENTS.md
+
+## Project
+
+This repository is a personal website built with ASP.NET Core Razor Pages on .NET 10.
+
+The site should stay as close to a static site as practical while still using Razor Pages for structure, layouts, routing, and maintainability.
+
+## Primary Goal
+
+Minimalism is a major goal.
+
+When making changes, prefer:
+
+- fewer files
+- fewer dependencies
+- less JavaScript
+- less client-side state
+- less markup
+- less configuration
+- less visual noise
+
+If a feature adds complexity, it should earn its place.
+
+## Technical Direction
+
+- Use Razor Pages, not MVC controllers, unless there is a strong reason.
+- Prefer static content and server-rendered markup.
+- Prefer plain HTML and CSS over client-side frameworks.
+- Prefer zero-JS solutions when possible.
+- If JavaScript is necessary, keep it small, local, and framework-free.
+- Avoid adding databases, auth, APIs, background services, or build tooling unless explicitly needed.
+- Avoid third-party frontend libraries by default.
+- Keep the solution in `.slnx` format.
+
+## Current Baseline
+
+- .NET 10
+- Razor Pages
+- Custom CSS in `wwwroot/css/site.css`
+- No Bootstrap
+- No jQuery
+- No README
+- GPL license at repo root
+
+## Design Principles
+
+- Clean, calm, and intentional beats flashy.
+- Simple typography and spacing are better than heavy UI chrome.
+- Content should lead the design.
+- Animations should be rare and subtle.
+- Mobile and desktop should both feel deliberate.
+
+## Editing Guidance
+
+- Before adding a dependency, ask whether the same outcome can be achieved with HTML, CSS, or Razor alone.
+- Before adding a new page model or service, ask whether static markup is enough.
+- Before adding configuration, ask whether a hardcoded value is acceptable for a personal site.
+- Remove dead files and template leftovers when you see them.
+- Keep naming straightforward and boring.
+- Favor clarity over cleverness.
+
+## Content and Structure
+
+- Keep page structure shallow and easy to navigate.
+- Prefer a small number of well-crafted pages over many thin pages.
+- Reuse the shared layout when possible.
+- Do not introduce blog, CMS, tagging, search, or feed systems unless explicitly requested.
+
+## Performance
+
+- Keep asset count low.
+- Keep CSS lean.
+- Avoid shipping large libraries for tiny interactions.
+- Favor static assets and built-in ASP.NET Core features.
+
+## Commands
+
+Common verification command:
+
+```bash
+dotnet build dwalker.xyz.slnx
+```
+
+## Decision Rule
+
+If two approaches are both acceptable, choose the one that is simpler to understand, simpler to maintain, and easier to delete later.