nixos-config/common/AGENTS.md, branch mainmy nixos setuphttps://git.hwebs.info/nixos-config/atom?h=main2026-08-04T22:41:40Zcommon: update AGENTS.md commit trailer guidelines2026-08-04T22:41:40ZHenry J. Websterhwebs@hwebs.info2026-08-04T22:41:40Zurn:sha1:a8273dea992f0b31c59f87c5441271f97d2b729ccommon: require agents to work on a branch, not main2026-08-04T21:04:51ZHenry J Websterhwebs@hwebs.info2026-08-04T04:38:21Zurn:sha1:8f9fbf2f4a269eae143c9e279afc6608ce64b7d0
Committing directly to main let it diverge from origin/main, so the next
pull became a rebase with a conflict on this very file. Recording the rule
where every harness will read it keeps main fast-forwardable.
Assisted-by: Claude:claude-opus-4-8
profiles: add agent-context — one AGENTS.md for every harness2026-08-04T04:26:57ZHenry J. Websterhwebs@hwebs.info2026-08-04T04:26:57Zurn:sha1:6f135470d274daa3e7a7fec1cb8f36204abd90f0
There is no cross-vendor standard for agent instruction files: claude-code
reads CLAUDE.md, opencode and pi read AGENTS.md, each with its own global
path. Keep one canonical file (common/AGENTS.md) in this repo, ship it to
/etc/AGENTS.md, and symlink every harness's global context path to it via
tmpfiles for all normal users:
~/.claude/CLAUDE.md (claude-code 2.1.187 — no AGENTS.md support)
~/.config/opencode/AGENTS.md (opencode 1.15.10)
~/.pi/agent/AGENTS.md (pi 0.75.4)
Paths verified against the packaged binaries; see the profile header for
details and for the per-repo convention (AGENTS.md + CLAUDE.md symlink).
Assisted-by: claude-code:Fable 5