Skip to content

[PR #13135/0a4871b0 backport][stable-13] AGENTS.md: clarify changelog fragment rules - #13163

Merged
felixfontein merged 1 commit into
stable-13from
patchback/backports/stable-13/0a4871b01c734d29bccf5da6fc951bbb01c1e388/pr-13135
Oct 30, 2026
Merged

felixfontein merged 1 commit into
stable-13from
patchback/backports/stable-13/0a4871b01c734d29bccf5da6fc951bbb01c1e388/pr-13135

Conversation

@patchback

@patchback patchback Bot commented Oct 30, 2026

Copy link
Copy Markdown

This is a backport of PR #13135 as merged into main (0a4871b).

SUMMARY

Tighten the changelog fragment rules in AGENTS.md:

  • Require the PR URL in every fragment entry, with an example, as LLM-generated contributions frequently omit it.
  • Record changes to module utils and plugin utils (including _-prefixed ones) when they affect previously existing modules or plugins; changes serving only a new module or plugin need no fragment.
  • One entry per plugin changed, rather than per file.
  • Descriptions are a single short sentence; acronyms are always upper-case; entries containing : must be quoted.
  • Move the note about not creating an issue after the PR to the PR rules section.

AI (Claude) was used to draft these changes.

ISSUE TYPE
  • Docs Pull Request
COMPONENT NAME

AGENTS.md

🤖 Generated with Claude Code

* docs(AGENTS.md): clarify changelog fragment rules

Require the PR URL in every fragment entry, clarify how module utils
and plugin utils changes are recorded, and tighten the description
wording rules.

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs(AGENTS.md): name affected plugins for changes in private utils

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
(cherry picked from commit 0a4871b)
@ansibullbot ansibullbot added backport docs new_contributor Help guide this first time contributor labels Oct 30, 2026
@felixfontein
felixfontein merged commit 1a763c8 into stable-13 Oct 30, 2026
150 checks passed
@felixfontein
felixfontein deleted the patchback/backports/stable-13/0a4871b01c734d29bccf5da6fc951bbb01c1e388/pr-13135 branch October 30, 2026 21:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport docs new_contributor Help guide this first time contributor

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants