Skip to content

Commit 02b4de1

Browse files
committed
AGENTS.md: Align AI attribution policy with Kubernetes community
Adopt the policy established in kubernetes/community#8918: disclose AI assistance in the PR description rather than via commit trailers. Listing AI tooling as a co-author or using 'Assisted-by' / 'Co-developed-by' trailers is now explicitly prohibited, matching the Kubernetes steering committee's position on AI disclosure. Further rationale: the Assisted-by schema (tool + model name) doesn't capture common multi-agent patterns (planner + executor), and model names alone don't tell reviewers much — the prompt harness and skills matter just as much. Also adds two new guidance sections: - Pull request size: encourage splitting prep commits out separately - Commit messages and text: remind agents that natural language can't be machine-checked, so humans should own the commit message prose Signed-off-by: Colin Walters <walters@verbum.org>
1 parent f50c226 commit 02b4de1

1 file changed

Lines changed: 36 additions & 4 deletions

File tree

common/AGENTS.md

Lines changed: 36 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -16,11 +16,43 @@ and the DCO check fails, tell the human to review
1616
the code and give them instructions on how to add
1717
a signoff.
1818

19-
### Attribution
19+
### Attribution and AI disclosure
2020

21-
When generating substantial amounts of code, you SHOULD
22-
include an `Assisted-by: TOOLNAME (MODELNAME)`. For example,
23-
`Assisted-by: Goose (Sonnet 4.5)`.
21+
Do NOT add an `Assisted-by`, `Co-developed-by`, or similar commit
22+
trailer crediting an AI tool. Instead, disclose AI assistance in the
23+
**pull request description**. Examples:
24+
25+
- "I used a LLM to generate just unit tests."
26+
- "This code was written in part with the assistance of generative AI."
27+
- "A LLM was used to generate almost all of the code, but I am knowledgeable in this problem domain and reviewed it carefully."
28+
- "This code is generated, I am only partially knowledgable in this domain."
29+
- "Code is LLM generated; I don't know the progamming language but it did fix the problem."
30+
31+
(The closer the commits are to being *entirely* AI, the more likely
32+
it is that you should submit the PR as a draft, or even file an
33+
issue first with a proposed design)
34+
35+
If you're an agent generating a git commit, ensure your human sees
36+
this choice and preferably writes the text on their own.
37+
38+
### Pull request size
39+
40+
It is *very strongly* encouraged to split up "preparatory" commits
41+
that are independently reviewable from the main PR, and submit those separately.
42+
43+
### Commit messages and text
44+
45+
Software can be machine checked (via compilation and unit/integration tests)
46+
but natural languages like English cannot. It is strongly encouraged
47+
for you to write the commit message on your own, and to double check its
48+
accuracy.
49+
50+
It is common in general for LLM-assisted/generated code to miss updating
51+
documentation or describe things incorrectly (especially after iteration).
52+
You should review these.
53+
54+
When responding to review comments (and commenting in general) similarly
55+
that should be using your own written language by default.
2456

2557
## Code guidelines
2658

0 commit comments

Comments
 (0)