Keep agent guidance in one root AGENTS.md (closes #31)

Writes down sneak's 2026-08-22 ruling: the in-repo memory rule that older vendored copies of `REPO_POLICIES.md` still carry was retired, not lost. `prompts/REPO_POLICIES.md` gains one bullet after the files a new repo must contain: guidance for coding agents lives in one `AGENTS.md` at the repository root, never under a file or directory named after one agent tool, and never split into separate memory files. `AGENTS.md` joins the files allowed in the repo root, which would otherwise forbid it. Both checklists get the matching item; the existing-repo one says to move such a file's content into `AGENTS.md` and delete it. The Dockerfile finding at the end of the issue is tracked in #90. Model: opus-5-5
2026-10-04 08:02:24 +02:00
parent 5805909fb9
commit 562b40bfe5
4 changed files with 21 additions and 4 deletions
@@ -21,6 +21,12 @@ fmt-check, and commit.

 # Completed Steps

+- 2026-10-04: `REPO_POLICIES.md` now states that guidance for coding agents
+  lives in one `AGENTS.md` at the repository root, never under a file or
+  directory named after one agent tool and never in separate memory files (issue
+  31). This retires the rule, still present in older vendored copies, that kept
+  agent memory as committed files under `.claude/memory/`. `AGENTS.md` joins the
+  list of files allowed in the root, and both checklists say so.
 - 2026-10-04: Rewrote the note under the canonical Go `make test` example in
  `REPO_POLICIES.md` (issue 77), which still named the cache-busting build
  argument that `--no-cache` replaced. It now says where Go's test result cache