From 9596a42386ba79f04170b297fe3b06e530142bf6 Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 3 Sep 2026 02:37:14 +0000 Subject: [PATCH] docs(agents): stop telling authors to hand-edit generated CHANGELOG.md Post-task checklist item 6 read "Update `CHANGELOG.md` / `ROADMAP.md` if user-facing or architectural", which contradicts the same file 34 lines above: the changeset section states the changeset body "ships to consumers as `CHANGELOG.md` inside the npm package". `CHANGELOG.md` is generated output, written by the changesets release step from the entries item 3 already requires, so item 6 was directing the author to hand-edit a generated artifact that the next Version Packages run overwrites or collides with. Drop the `CHANGELOG.md` half; keep `ROADMAP.md`, which may genuinely be hand-maintained and is not in question here. Byte-negative on one line (-17 bytes), no line added or re-wrapped: the file is at its ratchet ceiling with headroom 0. Co-Authored-By: Claude Fable 5.1 Claude-Session: https://claude.ai/code/session_01LraLgQVGq8egUwfYZpbYt1 --- AGENTS.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index 8b8cf792b0..2c0050adb4 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1151,7 +1151,7 @@ registry? Add it to `OPEN_CAPABILITY_REGISTRIES` in the same PR that fixes it. pinned SHA before merging. 5. **Touched `packages/spec`? Regenerate and commit its artifacts before pushing** — § *Touched `packages/spec`* above is the authority; note `OS_SKIP_DTS=1` greens `check:api-surface` locally and reds it in CI. -6. Update `CHANGELOG.md` / `ROADMAP.md` if user-facing or architectural. +6. Update `ROADMAP.md` if user-facing or architectural. 7. **Delete temporary artifacts** — screenshots, traces, scratch logs, `.playwright-mcp/`, throwaway `tmp*.ts`, ad-hoc scripts. Repo must look identical to before, minus intended changes.