Repository navigation
Conversation
AI-assisted commits must now carry an `Assisted-By` trailer naming the tool and model with their versions, and AI-assisted pull requests must end with an `AI Disclosure` block, in the same format as Apache Iceberg. AGENTS.md no longer tells agents to hide AI tool names. CONTRIBUTING.md documents both requirements with examples, and the pull request template gets a checkbox and a commented-out disclosure block. Assisted-By: Claude Code 2.1.311 (Claude Sonnet 5.5)
| Otherwise, leave it as is. | ||
| --- | ||
| **AI Disclosure** |
There was a problem hiding this comment.
This block is inspired by what Apache Iceberg does, with one difference: I did not include the Prompt Summary line, because it can get very verbose, and imho it has no real value: what matters is the resulting code; the original prompt has no legal value.
There was a problem hiding this comment.
Following recent feedback on the ML, this block has been removed.
There was a problem hiding this comment.
🟡 Changes recommended
The disclosure guidance does not tell maintainers to preserve Assisted-By trailers in squash-merge messages, so disclosures on branch commits may be lost from project history.
1 open issue
What changed in this PR
This PR makes AI-assistance disclosure mandatory in Polaris contribution metadata, replacing the previous recommendation.
Changes:
- Requires
Assisted-Bycommit trailers identifying the tool, model, and versions. - Requires an
AI Disclosureblock in PR descriptions, with human oversight stated by the author. - Aligns agent guidance and the PR template with these requirements.
| File | Description |
|---|---|
CONTRIBUTING.md |
Documents disclosure requirements and provides examples. |
AGENTS.md |
Requires disclosure and reserves oversight declarations for humans. |
.github/pull_request_template.md |
Adds a disclosure checkbox and commented-out disclosure block. |
Review effort: Balanced
| ``` | ||
|
|
||
| Never set `Human Oversight` to `fully reviewed` yourself: use | ||
| `[unknown - human to fill in]` and let the human author state what they actually |
There was a problem hiding this comment.
Should we instruct agents to write a notice about this back to the human?.. e.g. in CLI log?
orca-review-bot
left a comment
There was a problem hiding this comment.
Nice cleanup. AGENTS.md no longer contradicts CONTRIBUTING, and the format matches what reviewers have already been asking for. A few small things are inline. Two that aren't tied to a line:
- The PR description has the
Assisted-Byline but noAI Disclosureblock at the end. Can we add one so this PR follows its own rule? - This turns disclosure from "encouraged" into "must". The last wiki note on the Oct 5 dev-list thread says no consensus. Can we link the thread or vote that agreed on making it mandatory?
Docs only, so no tests or changelog fragment needed.
🤖 AI-generated review comment — agents make mistakes, so please verify before acting on it.
| ``` | ||
|
|
||
| Never set `Human Oversight` to `fully reviewed` yourself: use | ||
| `[unknown - human to fill in]` and let the human author state what they actually |
There was a problem hiding this comment.
[unknown - human to fill in] isn't one of the three allowed values in CONTRIBUTING. Can we add a line in the Disclosing AI usage section of CONTRIBUTING saying the author replaces this placeholder before merge?
🤖 AI-generated review comment — agents make mistakes, so please verify before acting on it.
| - Platform/Tool: [tool or platform name and version] | ||
| - Human Oversight: [fully reviewed | partially reviewed | unreviewed] | ||
| --> | ||
|
|
There was a problem hiding this comment.
Two extra blank lines at the end of the template. Can we drop them?
🤖 AI-generated review comment — agents make mistakes, so please verify before acting on it.
youngrae81
left a comment
There was a problem hiding this comment.
+1, one clear format is easier to follow.
One question: for PRs already under review when this lands, is it enough to add the AI Disclosure block to the description and put the Assisted-By trailer in the squash-merge message, rather than rewriting reviewed commits?
|
In my view the |

AI-assisted commits should now carry an
Assisted-Bytrailer naming the tool and model with their versions, and AI-assisted pull requests should properly disclose AI usage. AGENTS.md no longer tells agents to hide AI tool names. CONTRIBUTING.md documents both requirements with examples, and the pull request template gets new checkboxes.Assisted-By: Claude Code 2.1.311 (Claude Sonnet 5.5)
Checklist
changelog.d/(if needed, seechangelog.d/README.md)site/content/in-dev/unreleased(if needed)