From b35172745ff7c995153690d87c6ba91c99136163 Mon Sep 17 00:00:00 2001 From: Kevin Liu Date: Tue, 24 Mar 2026 22:33:56 -0700 Subject: [PATCH] add a section on AI-Generated PR Disclosure --- AGENTS.md | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 6378b2a9c534..58eac4e1c9d0 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -161,6 +161,38 @@ The `api/` module has the strongest stability guarantees — breaking changes ar - Commit messages describe the *what* and *why*, not implementation details. - Apache License header required on all new files (enforced by spotless pre-commit hook). +## 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: + +### 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`). + +### Optional Fields + +- **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: + +``` +--- +**AI Disclosure** +- AI-Generated: Yes +- Model: [model name and version] +- Platform/Tool: [tool or platform name] +- Human Oversight: [fully reviewed | partially reviewed | unreviewed] +- Prompt Summary: [brief description of the task] +``` + ## Boundaries - **Never** modify `.asf.yaml`, `LICENSE`, `NOTICE`, or `versions.props` without explicit discussion.