From 6ecf51c3824f89f11df5b515416e4102c60ac33c Mon Sep 17 00:00:00 2001 From: kunchenguid Date: Thu, 9 Jul 2026 17:57:25 -0700 Subject: [PATCH] docs(agents): add Maintaining this file self-governance section Append the canonical firstmate preamble so agents keep AGENTS.md concise and point to authoritative sources instead of duplicating codebase detail. --- AGENTS.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index b45e563..9bb25a0 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -3,4 +3,11 @@ Deliberate decisions in this repo - do NOT silently revert them: - `homebrew.onActivation.cleanup = "zap"` in `configuration.nix` is intentional. It forces the good habit of declaring every Homebrew package in the Nix config instead of installing things ad-hoc, which keeps the machine reproducible. Do not soften it to `uninstall` or `none`. Users are warned about its effect in README.md; this note is for anyone tempted to change the setting itself. -- Never commit `.no-mistakes/` validation evidence to this public repo. `.no-mistakes/` is gitignored; if a validation pipeline stages evidence into a branch, drop it before merging. \ No newline at end of file +- Never commit `.no-mistakes/` validation evidence to this public repo. `.no-mistakes/` is gitignored; if a validation pipeline stages evidence into a branch, drop it before merging. + +## Maintaining this file + +Keep this file for knowledge useful to almost every future agent session in this project. +Do not repeat what the codebase already shows; point to the authoritative file or command instead. +Prefer rewriting or pruning existing entries over appending new ones. +When updating this file, preserve this bar for all agents and keep entries concise.