aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/AGENTS.md
blob: b7da4853ba1bbd4239566bc2111e75e98377eef0 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
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.