Skip to content

Remove CHANGELOG.md and stop agents from recreating it - #753

Merged
wow-miley merged 1 commit into
mainfrom
wow-miley/remove-changelog-guidance
Sep 3, 2026
Merged

Remove CHANGELOG.md and stop agents from recreating it#753
wow-miley merged 1 commit into
mainfrom
wow-miley/remove-changelog-guidance

Conversation

@wow-miley

Copy link
Copy Markdown
Contributor

I removed CHANGELOG.md because every recent PR added an entry to its shared "Unreleased" section, which guaranteed merge conflicts and reset CI on any other PR open in parallel whenever one merged.

No CI gate or build script depended on the file, and no doc explicitly instructed adding changelog entries — agents were pattern-matching the file's own structure and prior PR history. I added an explicit "Changelog" section to AGENTS.md telling agents not to recreate the file or add entries, so the convention doesn't resurface by imitation.

🤖 Generated with Claude Code

Every recent PR added an entry to the same Unreleased section in
CHANGELOG.md. There was no explicit rule telling agents to do this —
they were pattern-matching the file's own structure and the git
history of prior PRs. With many PRs open in parallel, this guaranteed
merge conflicts and reset CI on unrelated branches whenever one PR
merged.

No CI gate or build script depended on the file's presence.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Sep 3, 2026

Copy link
Copy Markdown

Concept staleness check — 1 warning(s).

These changes touched files listed under a concept's tracked_sources without updating the concept file. Either update the concept (and bump last_verified) or include a Concept-Verified: <ConceptName> trailer in a commit on this PR.

Validator output
⚠ Concept 'Ampere' may be stale: AGENTS.md matches tracked_sources pattern AGENTS.md but docs/concepts/ampere.md was not modified.

validate-concepts: 1 warning(s). Validator informs; never blocks.

@wow-miley
wow-miley merged commit ba0db44 into main Sep 3, 2026
11 checks passed
@wow-miley
wow-miley deleted the wow-miley/remove-changelog-guidance branch September 3, 2026 01:09
wow-miley added a commit that referenced this pull request Sep 3, 2026
Resolves one conflict: `CHANGELOG.md` was removed on main (#753, "do not
create one, and do not add a changelog entry as part of a PR"), so my
Added/Fixed entries for this branch are dropped rather than reinstating the
file. Everything the entries recorded is in the commit message and the PR.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant