docs: strengthen agent disclosure to cover commits and per-round comments#7
Closed
mnriem wants to merge 1 commit into
Closed
docs: strengthen agent disclosure to cover commits and per-round comments#7mnriem wants to merge 1 commit into
mnriem wants to merge 1 commit into
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>
7 tasks
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
1 participant
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.