Skip to content

Require AI disclosure in commit messages and pull request descriptions - #6130

Open
adutra wants to merge 3 commits into
apache:mainfrom
adutra:update-ai-disclosure
Open

adutra wants to merge 3 commits into
apache:mainfrom
adutra:update-ai-disclosure

Conversation

@adutra

@adutra adutra commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

AI-assisted commits should now carry an Assisted-By trailer 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

  • 🛡️ Don't disclose security issues! (contact security@apache.org)
  • 🔗 Clearly explained why the changes are needed, or linked related issues: Fixes #
  • 🧪 Added/updated tests with good coverage, or manually tested (and explained how)
  • 💡 Added comments for complex logic
  • 🧾 Added a changelog entry in changelog.d/ (if needed, see changelog.d/README.md)
  • 📚 Updated documentation in site/content/in-dev/unreleased (if needed)

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)
@github-project-automation github-project-automation Bot moved this to PRs In Progress in Basic Kanban Board Nov 18, 2026
Copilot AI balanced review requested due to automatic review settings November 18, 2026 11:01
Comment thread .github/pull_request_template.md Outdated
Otherwise, leave it as is.
---
**AI Disclosure**

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Following recent feedback on the ML, this block has been removed.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 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-By commit trailers identifying the tool, model, and versions.
  • Requires an AI Disclosure block 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

Comment thread CONTRIBUTING.md Resolved
dimas-b
dimas-b previously approved these changes Nov 18, 2026
Comment thread AGENTS.md Outdated
```

Never set `Human Oversight` to `fully reviewed` yourself: use
`[unknown - human to fill in]` and let the human author state what they actually

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we instruct agents to write a notice about this back to the human?.. e.g. in CLI log?

@github-project-automation github-project-automation Bot moved this from PRs In Progress to Ready to merge in Basic Kanban Board Nov 18, 2026

@orca-review-bot orca-review-bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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-By line but no AI Disclosure block 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.

Comment thread CONTRIBUTING.md Resolved
Comment thread CONTRIBUTING.md Resolved
Comment thread CONTRIBUTING.md Resolved
Comment thread AGENTS.md Outdated
```

Never set `Human Oversight` to `fully reviewed` yourself: use
`[unknown - human to fill in]` and let the human author state what they actually

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[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.

Comment thread .github/pull_request_template.md Outdated
- Platform/Tool: [tool or platform name and version]
- Human Oversight: [fully reviewed | partially reviewed | unreviewed]
-->

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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 youngrae81 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

+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?

@dimas-b

dimas-b commented Nov 19, 2026 •

Copy link
Copy Markdown
Contributor

@youngrae81 :

Contributors are encouraged to disclose significant AI assistance [...], so my reading is that it is not a requirement. ASF guidelines require disclosure only for copyrighted materials. I'd say there's no need to update existing PRs.

https://polaris.apache.org/community/contributing-guidelines/#guidelines-for-ai-assisted-contributions

In my view the Assisted-By tag is an aid to reviewers that LLMs were involved.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants