Decide whether AGENTS.md may stay in the repo root #121

Closed
opened 2026-10-04 01:45:28 +02:00 by clawbot · 3 comments
Collaborator

The shared REPO_POLICIES.md lists the files allowed in the repo root, and AGENTS.md is not one of them. Unlike FORMAT.md and contrib/ (moved by #74), there is no obvious place to move it: tools that read agent instructions look for it in the root. It was flagged in #74 (comment), with the recommendation to keep it in the root and change the shared policy to allow it.

Definition of done

  • Either the shared REPO_POLICIES.md allows AGENTS.md in the repo root and this repo takes that copy, or AGENTS.md moves to an allowed directory and every reference to it is updated.

Model: opus-5-5

The shared `REPO_POLICIES.md` lists the files allowed in the repo root, and `AGENTS.md` is not one of them. Unlike `FORMAT.md` and `contrib/` (moved by https://git.eeqj.de/sneak/mfer/issues/74), there is no obvious place to move it: tools that read agent instructions look for it in the root. It was flagged in https://git.eeqj.de/sneak/mfer/issues/74#issuecomment-45629, with the recommendation to keep it in the root and change the shared policy to allow it. ## Definition of done - Either the shared `REPO_POLICIES.md` allows `AGENTS.md` in the repo root and this repo takes that copy, or `AGENTS.md` moves to an allowed directory and every reference to it is updated. Model: opus-5-5
Author
Collaborator

Question for sneak: may AGENTS.md stay in the repo root?

The shared REPO_POLICIES.md (in https://git.eeqj.de/sneak/prompts) lists the files allowed in the root, and AGENTS.md is not one of them; the current copy there still leaves it out.

Options:

A. (recommended) Keep AGENTS.md in the root and add it to the shared list. Tools that read agent instructions look for it there.
B. Move it to docs/ and update every reference.

Until you answer, AGENTS.md stays where it is; nothing else waits on this.

Model: opus-5-5

Question for sneak: may `AGENTS.md` stay in the repo root? The shared `REPO_POLICIES.md` (in https://git.eeqj.de/sneak/prompts) lists the files allowed in the root, and `AGENTS.md` is not one of them; the current copy there still leaves it out. Options: A. (recommended) Keep `AGENTS.md` in the root and add it to the shared list. Tools that read agent instructions look for it there. B. Move it to `docs/` and update every reference. Until you answer, `AGENTS.md` stays where it is; nothing else waits on this. Model: opus-5-5
sneak was assigned by clawbot 2026-10-04 02:03:41 +02:00
Author
Collaborator

Already decided by sneak's standing rulings, so adopted, not asked (he can reverse it): agent guidance lives in a root AGENTS.md (never a committed vendor directory), and a repo root keeps only README.md, AGENTS.md and LICENSE as markdown, everything else under docs/. So option A: AGENTS.md stays in the root. If the shared REPO_POLICIES.md in https://git.eeqj.de/sneak/prompts does not list it among the allowed root files, file that one-line fix there; this repo takes the updated copy. Reassigned to clawbot.

Model: opus-5-5

Already decided by sneak's standing rulings, so adopted, not asked (he can reverse it): agent guidance lives in a root `AGENTS.md` (never a committed vendor directory), and a repo root keeps only `README.md`, `AGENTS.md` and `LICENSE` as markdown, everything else under `docs/`. So option A: `AGENTS.md` stays in the root. If the shared `REPO_POLICIES.md` in https://git.eeqj.de/sneak/prompts does not list it among the allowed root files, file that one-line fix there; this repo takes the updated copy. Reassigned to clawbot. Model: opus-5-5
sneak was unassigned by clawbot 2026-10-04 03:12:11 +02:00
clawbot self-assigned this 2026-10-04 03:12:11 +02:00
Author
Collaborator

Covered by #116: the shared REPO_POLICIES.md now lists AGENTS.md among the allowed root files (sneak/prompts#89, on next there), and mfer takes that copy verbatim in the re-copy 116 tracks. Closing here.

Model: opus-5-5

Covered by https://git.eeqj.de/sneak/mfer/issues/116: the shared `REPO_POLICIES.md` now lists `AGENTS.md` among the allowed root files (https://git.eeqj.de/sneak/prompts/pulls/89, on `next` there), and mfer takes that copy verbatim in the re-copy 116 tracks. Closing here. Model: opus-5-5
Sign in to join this conversation.