You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@iceberg.apache.org by "pvary (via GitHub)" <gi...@apache.org> on 2026/09/18 18:56:28 UTC
[PR] Docs: Add AI contribution and disclosure rules to AGENTS.md [iceberg]
pvary opened a new pull request, #18168:
URL: https://github.com/apache/iceberg/pull/18168
From the community sync on AI-generated contributions: screen-length generated PR summaries, duplicate PRs for one issue, PRs auto-filed from issues, and disclosure that says AI was used without saying what it touched. Reviewer attention is the bottleneck, so that is stated once up front and the rest are concrete rules, like search for duplicates first, run spotlessApply and the affected tests, hold the description to a paragraph, never self-certify review.
---
**AI Disclosure**
- Model: Claude Opus 5
- Platform/Tool: GitHub Copilot CLI
- Human Oversight: Iterated multiple times and Fully reviewed
- Prompt Summary: Incorporate requirements from a community discussion on AI-generated contributions, reduced to rules an agent can check.
Generated-by: GitHub Copilot CLI (Claude Opus 5)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@iceberg.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@iceberg.apache.org
For additional commands, e-mail: issues-help@iceberg.apache.org
Re: [PR] Docs: Add AI contribution and disclosure rules to AGENTS.md [iceberg]
Posted by "pvary (via GitHub)" <gi...@apache.org>.
pvary commented on PR #18168:
URL: https://github.com/apache/iceberg/pull/18168#issuecomment-5772188622
@sungwy: Any more comments?
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@iceberg.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@iceberg.apache.org
For additional commands, e-mail: issues-help@iceberg.apache.org
Re: [PR] Docs: Add AI contribution and disclosure rules to AGENTS.md [iceberg]
Posted by "uros-b (via GitHub)" <gi...@apache.org>.
uros-b commented on PR #18168:
URL: https://github.com/apache/iceberg/pull/18168#issuecomment-5762318914
+1, LGTM
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@iceberg.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@iceberg.apache.org
For additional commands, e-mail: issues-help@iceberg.apache.org
Re: [PR] Docs: Add AI contribution and disclosure rules to AGENTS.md [iceberg]
Posted by "pvary (via GitHub)" <gi...@apache.org>.
pvary commented on PR #18168:
URL: https://github.com/apache/iceberg/pull/18168#issuecomment-5781477339
Merged to main.
Thanks for the reviews @uros-b, @nastra, @rambleraptor, @huaxingao, @sungwy, @szehon-ho
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@iceberg.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@iceberg.apache.org
For additional commands, e-mail: issues-help@iceberg.apache.org
Re: [PR] Docs: Add AI contribution and disclosure rules to AGENTS.md [iceberg]
Posted by "pvary (via GitHub)" <gi...@apache.org>.
pvary commented on code in PR #18168:
URL: https://github.com/apache/iceberg/pull/18168#discussion_r4061303717
##########
AGENTS.md:
##########
@@ -163,19 +165,29 @@ The `api/` module has the strongest stability guarantees — breaking changes ar
## PR & Commit Conventions
+- **Never open a PR generated from an issue without a human in the loop.**
+- Search open PRs and issues for the same problem before starting. Don't add a duplicate.
- PR titles follow `Module: Description` format (e.g., `Core: Fix ...`, `Spark: Add ...`, `Docs: Update ...`).
- One concern per PR. Unrelated whitespace, import, or formatting changes go in separate PRs.
- Keep first version of a PR minimal — defer recovery, optimization, and edge cases to follow-ups.
+- Before opening a PR, run `./gradlew spotlessApply` and build and test the modules you changed (see Commands). Never submit code you have not compiled and run.
+- PR description is one paragraph, under 120 words: the problem, the approach, and anything a reviewer would not guess from the diff. Plus the issue link, the test plan, and the AI Disclosure block. Nothing else.
+- Never restate the diff: no file-by-file walkthrough, no per-method summaries, no "Changes made" checklist, no "Summary", "Background", "Motivation", or "Testing" headings, no emoji.
+- If the change needs more than a paragraph to explain, the PR is too big.
Review Comment:
Removed
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@iceberg.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@iceberg.apache.org
For additional commands, e-mail: issues-help@iceberg.apache.org
Re: [PR] Docs: Add AI contribution and disclosure rules to AGENTS.md [iceberg]
Posted by "sungwy (via GitHub)" <gi...@apache.org>.
sungwy commented on code in PR #18168:
URL: https://github.com/apache/iceberg/pull/18168#discussion_r4053960179
##########
AGENTS.md:
##########
@@ -163,19 +165,29 @@ The `api/` module has the strongest stability guarantees — breaking changes ar
## PR & Commit Conventions
+- **Never open a PR generated from an issue without a human in the loop.**
+- Search open PRs and issues for the same problem before starting. Don't add a duplicate.
- PR titles follow `Module: Description` format (e.g., `Core: Fix ...`, `Spark: Add ...`, `Docs: Update ...`).
- One concern per PR. Unrelated whitespace, import, or formatting changes go in separate PRs.
- Keep first version of a PR minimal — defer recovery, optimization, and edge cases to follow-ups.
+- Before opening a PR, run `./gradlew spotlessApply` and build and test the modules you changed (see Commands). Never submit code you have not compiled and run.
+- PR description is one paragraph, under 120 words: the problem, the approach, and anything a reviewer would not guess from the diff. Plus the issue link, the test plan, and the AI Disclosure block. Nothing else.
+- Never restate the diff: no file-by-file walkthrough, no per-method summaries, no "Changes made" checklist, no "Summary", "Background", "Motivation", or "Testing" headings, no emoji.
+- If the change needs more than a paragraph to explain, the PR is too big.
Review Comment:
I find this a bit subjective and confusing: a "big PR" can satisfy this requirement by pointing to a design document to do most of the explanation.
I feel my confusion is rooted in the fact that we are trying to combine two orthogonal attributes of a PR that may not have a direct correlation - the length of the PR description, and the length or complexity of the code changes in the PR. I think it would be simpler if we just targeted one of those. We already have line 174 on PR description. shall we just remove this?
```suggestion
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@iceberg.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@iceberg.apache.org
For additional commands, e-mail: issues-help@iceberg.apache.org
Re: [PR] Docs: Add AI contribution and disclosure rules to AGENTS.md [iceberg]
Posted by "pvary (via GitHub)" <gi...@apache.org>.
pvary merged PR #18168:
URL: https://github.com/apache/iceberg/pull/18168
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@iceberg.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@iceberg.apache.org
For additional commands, e-mail: issues-help@iceberg.apache.org