Skip to content

docs(agents): require AI-disclosure footer on agent-drafted GitHub messages#973

Open
potiuk wants to merge 1 commit into
mainfrom
docs/agents-ai-message-footer
Open

docs(agents): require AI-disclosure footer on agent-drafted GitHub messages#973
potiuk wants to merge 1 commit into
mainfrom
docs/agents-ai-message-footer

Conversation

@potiuk

@potiuk potiuk commented Jun 27, 2026

Copy link
Copy Markdown
Member

What

Adds an "GitHub messages drafted by agents" section to AGENTS.md requiring an AI-disclosure footer on any agent-drafted message posted to GitHub (PR/issue comments, reviews, line-level comments, discussion replies).

Why

We post agent-drafted comments/reviews on this repo's PRs (allowlist triage, verify findings, upstream coordination). They should carry the same disclosure the rest of the ASF agent tooling uses, so it's transparent that a message was AI-generated — and, when applicable, that a human reviewed it before posting.

Details

  • Footer is required whether or not a human reviewed the draft; the wording differs:
    • no review: Drafted-by: <Agent> (no human review before posting)
    • reviewed: Drafted-by: <Agent>; reviewed by @<handle> before posting
  • Placed on its own paragraph, after a blank line + horizontal rule; uses the same agent string as the Generated-by: commit trailer.
  • In addition to (not a replacement for) the existing Generated-by: commit trailer + PR-body disclosure.

Mirrors the convention in apache/airflow and the apache-magpie / apache/airflow-steward framework. Docs-only.

Generated-by: Claude Opus 4.8 (1M context)

…ssages

Any agent-drafted message posted to GitHub on a user's account (PR/issue
comments, reviews, line comments, discussion replies) must end with a
`Drafted-by:` attribution footer disclosing it was AI-generated — and, when a
human reviewed it first, naming the reviewer. Mirrors the convention used in
apache/airflow and the apache-magpie / airflow-steward framework. Complements
the existing `Generated-by:` commit trailer.

Generated-by: Claude Opus 4.8 (1M context)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant