From fae9289c3a2286f9d6f667a16b4d7ce4e2a045f5 Mon Sep 17 00:00:00 2001 From: Tatiana Al-Chueyr Date: Thu, 21 May 2026 10:31:21 +0100 Subject: [PATCH] Document AI agent attribution convention MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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) --- AGENTS.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index e1c139ee00..d836bb38cd 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -108,6 +108,18 @@ Follow the [seven rules of a great Git commit message](https://cbea.ms/git-commi Do not use Conventional Commits type prefixes (`feat:`, `fix:`, `chore:`, etc.). +### AI agent attribution + +When a commit or PR description is drafted with the help of an AI coding agent (Claude Code, Cursor, Codex, Copilot, etc.), give the agent credit, but **do not add the agent as a `Co-Authored-By` trailer**. The Git `Co-Authored-By` trailer is reserved for human collaborators — it surfaces in GitHub's contributor graph and `git shortlog -sn` as if the agent were a person, which it isn't. Those signals are reserved for humans. + +Instead, mark the assistance with a plain line at the end of the commit body or PR description (separated from the rest by a blank line): + +``` +🤖 Generated with Claude Code (https://claude.com/claude-code) +``` + +Substitute the equivalent for whichever agent was used. The convention is "visible credit, no person-shaped artefact" — the marker keeps the assist discoverable in `git log` without polluting human contribution stats. + ## Python Coding Standards ### Logging