Commit b05a543
fix(docs): stop
`next dev` (Next 16.3.1) runs `ensureAgentRulesForDev` on boot and, whenever it
detects an AI coding agent, scaffolds `apps/docs/AGENTS.md` and
`apps/docs/CLAUDE.md`. Neither path is tracked or ignored, so both land as `??`
and any `git add -A` after booting the docs server sweeps them into an unrelated
PR.
Those two filenames are load-bearing here: the root `AGENTS.md` is the binding
playbook and agents are told to read the `AGENTS.md` governing the files they
touch. A Next-authored stub pointing at `node_modules/next/dist/docs/` can be
read as this repo's discipline, and its own text argues for committing itself.
The generated `CLAUDE.md` is the single line `@AGENTS.md`, an import directive
that pulls the stub in.
Set `agentRules: false` in `apps/docs/next.config.mjs`, turning generation off at
the source rather than gitignoring the paths: an ignore rule for
`apps/docs/AGENTS.md` would silently swallow a future repo-authored `AGENTS.md`
for this app, failing invisibly at exactly the moment someone was adding real
guidance there.
Claude-Session: https://claude.ai/code/session_01DdCnBGcHeufjrq7drTD3wt
Co-authored-by: Claude <noreply@anthropic.com>next dev writing untracked AGENTS.md / CLAUDE.md into apps/docs (#10780)1 parent 6130cb7 commit b05a543
1 file changed
Lines changed: 22 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
6 | 6 | | |
7 | 7 | | |
8 | 8 | | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
| 29 | + | |
| 30 | + | |
9 | 31 | | |
10 | 32 | | |
11 | 33 | | |
| |||
0 commit comments