Skip to content

Update AGENTS.md#1701

Merged
st0012 merged 2 commits intoruby:masterfrom
st0012:claude/agents-pr-description-policy
May 7, 2026
Merged

Update AGENTS.md#1701
st0012 merged 2 commits intoruby:masterfrom
st0012:claude/agents-pr-description-policy

Conversation

@st0012
Copy link
Copy Markdown
Member

@st0012 st0012 commented May 7, 2026

  1. I really dislike seeing the Test plan section generated by Claude, whether in my own PR or in other people's. They rarely provide real value and can easily become stale (e.g. it'd list CI passing as one checklist, but can't automatically tick it off when the CI passed)
  2. I now often use agents to develop on my own fork before opening a PR here (like this one). And having it sync to ruby/rdoc master automatically will make my life a lot easier, as well as helping contributors keeping their PRs on the right base.

claude added 2 commits May 7, 2026 03:49
Add a rule under the 'Notes for AI Agents' section requiring concise
PR descriptions (2-4 short paragraphs covering context, rationale, and
notable side effects), with no 'Test plan' section and no Claude Code
session link or other AI attribution.

This overrides the default Claude Code PR template so cloud sessions
working on this repo produce uniform descriptions.
Copilot AI review requested due to automatic review settings May 7, 2026 07:39
@st0012 st0012 requested a deployment to fork-preview-protection May 7, 2026 07:39 — with GitHub Actions Waiting
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the contributor guidance for AI-assisted work by adding expectations for pull request descriptions and fork workflow hygiene, aiming to reduce stale/noisy PR metadata and minimize merge conflict risk when developing on forks.

Changes:

  • Adds a rule requiring concise PR descriptions and explicitly disallowing a “Test plan” section and AI attribution/session links.
  • Adds guidance to fast-forward a fork’s master to ruby/rdoc:master before creating feature branches.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@st0012 st0012 merged commit 236bf4c into ruby:master May 7, 2026
43 of 44 checks passed
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.

3 participants