review feedback

Co-authored-by: Copilot <copilot@github.com>

Author: kevinjqliu

AGENTS.md

@@ -163,30 +163,24 @@ The `api/` module has the strongest stability guarantees — breaking changes ar
 
 ## AI-Generated PR Disclosure
 
-Pull requests that are authored or substantially generated by AI, LLM, or automated agents **must** clearly identify themselves. Include the following information in the PR description:
+Pull requests that are authored or substantially generated by AI agents **must** be labeled as "AI-Generated". When creating a PR description, always include an AI Disclosure block at the bottom. Use the template below and fill in the fields you know. For fields you cannot determine, use `[unknown - human to fill in]`.
 
-### Required Fields
-
-- **AI-Generated**: `Yes` — explicitly state that the PR was generated with AI/LLM assistance.
-- **Model**: The specific model used (e.g., `Claude Opus 4.6`, `GPT-4o`, `Gemini 2.5 Pro`). Include the version or snapshot date if available.
-- **Platform/Tool**: The tool or platform that orchestrated the generation (e.g., `GitHub Copilot`, `Cursor`, `Aider`, `Claude Code`, `custom script`).
-- **Human Oversight**: Describe the level of human review applied (e.g., `fully reviewed`, `partially reviewed`, `unreviewed`).
+See the [ASF generative tooling guidelines](https://www.apache.org/legal/generative-tooling.html) for additional policy on AI-generated contributions. Note that AI-generated code cannot carry copyright, so the Apache License header does not apply to purely generated files.
 
-### Optional Fields
+### Required Fields
 
+- **Model**: Set this to your model identifier and version (e.g., `Claude Opus 4.6`, `GPT-4o`, `Gemini 2.5 Pro`).
+- **Platform/Tool**: Set this to the tool or platform that orchestrated the generation (e.g., `GitHub Copilot`, `Cursor`, `Aider`, `Claude Code`, `custom script`).
+- **Human Oversight**: Set this to `fully reviewed`, `partially reviewed`, or `unreviewed`. If unknown, use `[unknown - human to fill in]`.
 - **Prompt Summary**: A brief description of the prompt or task given to the agent.
-- **Agent Version**: Version of the orchestration tool or agent framework, if applicable.
-- **Iteration Count**: How many agent iterations or attempts were used to produce the final result.
-- **Context Window**: Any notable context limitations that may affect completeness.
 
 ### PR Description Template
 
-Add the following block at the bottom of AI-generated PR descriptions:
+Add the following block at the bottom of PR descriptions:
 
 ```
 ---
 **AI Disclosure**
-- AI-Generated: Yes
 - Model: [model name and version]
 - Platform/Tool: [tool or platform name]
 - Human Oversight: [fully reviewed | partially reviewed | unreviewed]