docs: strengthen agent disclosure to cover commits and per-round comments#3071
Merged
Merged
Conversation
…ents Expand the AGENTS.md PR-review section into a continuous disclosure policy. Disclosure is no longer a one-time PR-body event: - Commits: require an Assisted-by: (autonomous|supervised) trailer on every agent-authored commit; ban hiding agent authorship behind the operator's git identity; preserve tool-generated Co-authored-by lines. - Comments: re-state agent identity each review round. - Anti-patterns: forbid replying "Done"/pushing fixes seconds after a review trigger without disclosure, and claiming human review for automated commits. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Updates AGENTS.md to clarify that AI/agent disclosure is ongoing across the full PR lifecycle (not just a one-time PR-body note), and expands guidance to explicitly cover commit trailers, per-round comment disclosure, and anti-patterns that obscure agent authorship.
Changes:
- Renames the section to “Agent Disclosure for PRs, Comments, and Commits” and states disclosure is continuous.
- Adds explicit commit guidance requiring an
Assisted-by:trailer including agent + (autonomous|supervised), and preserves tool-generatedCo-authored-by:trailers. - Adds per-review-round comment disclosure requirements and documents anti-patterns to avoid.
Show a summary per file
| File | Description |
|---|---|
| AGENTS.md | Expands and restructures agent disclosure guidance to cover commits, per-round comments, and disallowed practices. |
Copilot's findings
Tip
Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
- Files reviewed: 1/1 changed files
- Comments generated: 0
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Strengthens the agent disclosure guidance in
AGENTS.mdso it covers the full PR lifecycle, not just the initial submission. Motivated by PRs where a one-time AI-disclosure paragraph in the PR body does not reflect the agent-authored commits and replies added during review rounds.Renames "Responding to PR Review Comments" → "Agent Disclosure for PRs, Comments, and Commits" and expands it into three parts:
Assisted-by: <agent> (autonomous|supervised)trailer on every agent-authored commit; ban hiding agent authorship behind the operator's git identity; preserve tool-generatedCo-authored-by:trailers (e.g. Copilot Autofix).The section now opens by stating disclosure is continuous, not a one-time event.
Scope / limitations
This hardens the norm for agents that read this repo's
AGENTS.md(in-repo cloud agents, Copilot coding agent, maintainer sessions). It does not enforce anything on external forks' local agents — that still requires CI / commit-trailer enforcement, which is intentionally out of scope here.Testing
Documentation-only change; no code or tests affected.
AI Disclosure
Drafted with GitHub Copilot CLI (model: Claude Opus 4.8) under my direct review and supervision.