Document the AI agent attribution convention#2718
Merged
tatiana merged 1 commit intoMay 22, 2026
Merged
Conversation
Add an "AI agent attribution" subsection under Commit Messages so the preference is captured in the shared agent guidance: * Do not add an AI coding agent as a ``Co-Authored-By`` trailer -- that trailer is for humans and shows up in GitHub's contributor graph and ``git shortlog -sn`` as if the agent were a person. * Still give the agent credit, but via a plain marker line at the end of the commit body or PR description, e.g. ``🤖 Generated with Claude Code (https://claude.com/claude-code)``. Living in AGENTS.md (not CLAUDE.md) so the rule applies to every agent that reads the shared guidance, not just Claude. 🤖 Generated with Claude Code (https://claude.com/claude-code)
tatiana
requested review from
a team,
corsettigyg,
dwreeves and
jbandoro
as code owners
tatiana
requested review from
pankajastro and
pankajkoti
and removed request for
a team
pankajkoti
approved these changes
May 21, 2026
Contributor
pankajkoti
left a comment
pankajkoti
left a comment
There was a problem hiding this comment.
+1.
Looks like quite a few devs feel the same https://www.reddit.com/r/git/comments/1py9rcv/whats_the_verdict_on_claude_adding_coauthoredby/
pankajastro
approved these changes
May 22, 2026
tatiana
added a commit
that referenced
this pull request
May 27, 2026
Add a short "AI agent attribution" subsection to `AGENTS.md`: when a commit or PR is drafted with an AI coding agent, give the agent credit via a `🤖 Generated with …` marker line rather than a `Co-Authored-By` trailer, so the GitHub contributor graph stays human-only. Stacked on #2703 (which introduces `AGENTS.md`); GitHub will auto-retarget to `main` once #2703 merges. 🤖 Generated with Claude Code (https://claude.com/claude-code)
4 tasks
tatiana
added a commit
that referenced
this pull request
May 27, 2026
Make the project's agent guidance reusable across AI coding tools: - Move every agent-neutral section of `CLAUDE.md` (commands, architecture, coding standards, commit-message format, documentation style, etc.) into a new top-level `AGENTS.md`. The content is byte-identical apart from the introductory paragraph, which is rewritten in agent-neutral language and names `CLAUDE.md` as the canonical place for Claude-only overrides. - Slim `CLAUDE.md` to a small pointer that defers to `AGENTS.md`. The pointer remains the file Claude Code reads on session start, but it no longer duplicates project conventions. Claude-specific instructions can accumulate there in the future without diverging from the shared baseline. - Document the AI-agent attribution convention (originally PR #2718, since folded into this branch): give the assisting agent visible credit via a trailing `🤖 Generated with …` marker, never via a `Co-Authored-By` trailer (that surfaces in the GitHub contributor graph and `git shortlog`, which should stay human-only). - Add `AGENTS.md` to the `Check-changed-files` allowlist in `.github/workflows/test.yml` so docs-only edits to `AGENTS.md` don't trigger the full unit/integration matrix, mirroring how `CLAUDE.md` is already handled. This unlocks other agents — Cursor, Codex, Copilot, etc. — using the same conventions Claude already does, without us maintaining parallel copies. ## Review feedback addressed - [x] Copilot: add `AGENTS.md` to the `Check-changed-files` allowlist in `.github/workflows/test.yml` (mirrors the existing `CLAUDE.md` line). - [x] Copilot: change British "behaviour" to American "behavior" in the `AGENTS.md` intro paragraph for consistency with the rest of the document. ## Rebased onto main The original revision was stacked on `claude-md-require-precommit` (PR #2702). #2702 has since squash-merged to main (commit [`ea04d0da`](ea04d0d)), so this branch has been rebased onto the current `main`. The redundant pre-squash commits were dropped during rebase (`693c3d9c` identified as "patch contents already upstream"; `f8a6bf03` skipped manually). The companion attribution-convention PR #2718 has also been folded into this branch since it built on top of `claude-md-extract-agents-md`. ## Test plan - [x] `pre-commit run --files CLAUDE.md AGENTS.md .github/workflows/test.yml` — all applicable hooks pass locally. - [x] CI run on this PR — pre-commit.ci passes; the full unit/integration matrix runs (because this PR touches `.github/workflows/test.yml`, which is not — and should not be — on the allowlist). Future docs-only `AGENTS.md` PRs will skip the matrix. 🤖 Generated with Claude Code (https://claude.com/claude-code)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Add a short "AI agent attribution" subsection to
AGENTS.md: when a commit or PR is drafted with an AI coding agent, give the agent credit via a🤖 Generated with …marker line rather than aCo-Authored-Bytrailer, so the GitHub contributor graph stays human-only.Stacked on #2703 (which introduces
AGENTS.md); GitHub will auto-retarget tomainonce #2703 merges.🤖 Generated with Claude Code (https://claude.com/claude-code)