From f0c626059451e1f8621600e610240739d5633560 Mon Sep 17 00:00:00 2001
From: sommerfeld <sommerfeld@sommerfeld.dev>
Date: Thu, 2 Jul 2026 11:35:35 +0100
Subject: Prune stale dotfiles commentary

---
 AGENTS.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)
 create mode 100644 AGENTS.md

(limited to 'AGENTS.md')

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..b7da485
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,13 @@
+# Agent Notes
+
+- Keep comments in config files operational. Prefer section labels and short
+  purpose notes; avoid migration history or explanations that only justify an
+  old decision.
+- Package placement: pacman owns system-coupled pieces; Home-Manager owns
+  user-leaf tools; project compilers/linkers belong in per-project Nix dev
+  shells via direnv.
+- Do not add global Home-Manager packages that shadow the system build
+  toolchain (`gcc`, `clang`, `ld`, `make`, `pkg-config`, language runtimes,
+  etc.) unless the user explicitly asks for that tradeoff.
+- On the Arch host, keep GPU/OpenGL Wayland apps in pacman unless they have
+  been smoke-tested from Nix against the host graphics stack.
-- 
cgit v1.3.1