summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorHenry J. Webster <hwebs@hwebs.info>2026-08-04 17:41:40 -0500
committerHenry J. Webster <hwebs@hwebs.info>2026-08-04 17:41:40 -0500
commita8273dea992f0b31c59f87c5441271f97d2b729c (patch)
tree6aba82da1a7be5fad3d329b012472a5e31074e13
parenta4c50351f5d55438a102d48c63dcbb62f9ef5e8d (diff)
common: update AGENTS.md commit trailer guidelines
-rw-r--r--common/AGENTS.md13
1 files changed, 9 insertions, 4 deletions
diff --git a/common/AGENTS.md b/common/AGENTS.md
index 44d4a94..6e0019c 100644
--- a/common/AGENTS.md
+++ b/common/AGENTS.md
@@ -8,12 +8,12 @@ in nixos-config and rebuild — it is read-only everywhere else on purpose.
## Machines
-- `kusanagi` — AMD workstation (ROCm GPU; Ollama/Immich/Kavita services).
-- `enzo` — laptop.
+- `kusanagi` — workstation
+- `enzo` — laptop
Both are NixOS, configured by the flake in `nixos-config`.
-## If you are running as `yokai` (the agent sandbox)
+## You are running as system user `yokai` (the agent sandbox)
- You work in your own clone of each repo under `/srv/git/<repo>`; the owner's
canonical repo lives in their home, which you cannot reach.
@@ -34,7 +34,12 @@ Both are NixOS, configured by the flake in `nixos-config`.
- Always work on a branch, never commit directly to `main`. Committing to
`main` lets it diverge from `origin/main` and turns the next pull into a
rebase-conflict mess; a branch keeps `main` clean to fast-forward.
-- Trailers: `Assisted-by: AGENT_NAME:MODEL_VERSION`. Do NOT use `Co-authored-by`.
+- Trailers: `Assisted-by: AGENT_NAME:MODEL_VERSION`.
+ - AGENT_NAME is the name of the AI harness, tool, or framework
+ - If unsure, default to `unknown`
+ - MODEL_VERSION is the specific model used
+ - If unsure, default to `unknown`
+ - Do NOT use `Co-authored-by`.
- Commit subjects: `area: imperative summary` (e.g. `profiles: extract shared
sandbox profile`); the body explains why, not what.