aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/AGENTS.md
diff options
context:
space:
mode:
Diffstat (limited to 'AGENTS.md')
-rw-r--r--AGENTS.md13
1 files changed, 13 insertions, 0 deletions
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.