Skip to content

docs(agents): allow AI-drafted text written for human readers - #5907

Merged
GVodyanov merged 1 commit into
mainfrom
chore/ai-policy-human-text
Nov 18, 2026
Merged

GVodyanov merged 1 commit into
mainfrom
chore/ai-policy-human-text

Conversation

@GVodyanov

Copy link
Copy Markdown
Contributor

The org AI policy changed in nextcloud/.github#839: issues, PR descriptions and comments may now be drafted with AI, as long as they're written for human readers, disclosed, and follow the repo's templates. This updates our AGENTS.md to match, along the lines of nextcloud/mail#14132:

  • New section on issues, PR descriptions and comments: plain text for humans, templates filled in, AI footer, agent-only details in a collapsed <details> block.
  • Runtime changes are validated on a live instance, with the agent giving the contributor steps to test it themselves.
  • Commit bodies explain why, not how; the example commit now shows that and uses a current Assisted-by value.

The example Assisted-by trailer printed by the AI policy workflow is updated to match the org template.
Docs-only change, nothing to test at runtime.

🤖 AI (if applicable)

  • The content of this PR was partly or fully generated using AI

Assisted by ClaudeCode:claude-opus-5-5

The org AI policy (nextcloud/.github#839) now allows issues, PR
descriptions and comments to be drafted with AI, as long as they are
written for people, disclosed and follow the templates. It also asks
for live-instance testing of runtime changes and commit bodies that
explain why rather than how. Bring AGENTS.md in line so agents follow
the current policy.

Assisted-by: ClaudeCode:claude-opus-5-5
Signed-off-by: Grigory V <scratchx@gmx.com>
@nextcloud-command nextcloud-command added the AI assisted This PR contains AI-assisted commits label Nov 18, 2026
@codecov

codecov Bot commented Nov 18, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@GVodyanov
GVodyanov marked this pull request as ready for review November 18, 2026 09:36
@GVodyanov
GVodyanov merged commit 7d7d237 into main Nov 18, 2026
47 checks passed
@GVodyanov
GVodyanov deleted the chore/ai-policy-human-text branch November 18, 2026 09:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

AI assisted This PR contains AI-assisted commits

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants