summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-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.