Skip to content

Commit 76b806c

Browse files
committed
Clarify AI disclosure requirements in policy docs
Require AI assistance to be disclosed in both PR descriptions and commit messages (previously "and/or"). Add a dedicated section specifying the `Assisted-by: AGENT_NAME:MODEL_VERSION` trailer format for commit messages, explicitly noting that `Co-authored-by` is reserved for human co-authors. Update AGENTS.md accordingly. [ci skip] Assisted-by: Claude Code:claude-sonnet-4-6
1 parent 8fbab81 commit 76b806c

2 files changed

Lines changed: 31 additions & 3 deletions

File tree

AGENTS.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -261,7 +261,9 @@ See *CONTRIBUTING.md* for full conventions. Key points:
261261
- Focus on *why* the change was made, not just *what* changed.
262262
- Use permalink URLs for issue/PR references instead of `#123`.
263263
- When listing items after a colon, add a blank line after the colon.
264-
- When using LLMs or coding agents, include credit via `Co-Authored-By:`.
264+
- When using LLMs or coding agents, include credit via `Assisted-by:`
265+
(not `Co-Authored-By:`, which is reserved for human co-authors).
266+
See *AI\_POLICY.md* for the required format.
265267

266268

267269
Changelog (*CHANGES.md*)

AI_POLICY.md

Lines changed: 28 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,8 +9,9 @@ The Fedify project has the following rules for AI usage:
99

1010
- *All AI usage in any form must be disclosed.* You must state the tool you
1111
used (e.g., Claude, Cursor, GitHub Copilot) along with the extent that
12-
the work was AI-assisted in your pull request description and/or commit
13-
messages.
12+
the work was AI-assisted in both your pull request description and commit
13+
messages. For commit messages, use the `Assisted-by` trailer (see below
14+
for the required format).
1415

1516
- *Pull requests created in any way by AI can only be for accepted issues.*
1617
Drive-by pull requests that do not reference an accepted issue will be
@@ -47,6 +48,31 @@ proven themselves trustworthy to apply good judgment.
4748
[1]: https://github.com/ghostty-org/ghostty/blob/main/AI_POLICY.md
4849

4950

51+
Disclosing AI assistance in commit messages
52+
-------------------------------------------
53+
54+
When AI tools assist with a commit, add an `Assisted-by` trailer to the commit
55+
message. Do *not* use `Co-authored-by` for AI assistants; that trailer is
56+
reserved for human co-authors.
57+
58+
The format is:
59+
60+
~~~~
61+
Assisted-by: AGENT_NAME:MODEL_VERSION
62+
~~~~
63+
64+
For example:
65+
66+
~~~~
67+
Assisted-by: OpenCode:qwen3.6-plus
68+
Assisted-by: Claude Code:claude-sonnet-4-6
69+
Assisted-by: Gemini CLI:gemini-3.1-pro-preview
70+
Assisted-by: Codex:gpt-5.4
71+
~~~~
72+
73+
If multiple AI tools were used, include one `Assisted-by` line per tool.
74+
75+
5076
There are humans here
5177
---------------------
5278

0 commit comments

Comments
 (0)