Skip to content

docs: sync AGENTS.md with AI policy update from org template - #66857

Open
AndyScherzinger wants to merge 2 commits into
masterfrom
docs/agents-md-ai-policy-839
Open

AndyScherzinger wants to merge 2 commits into
masterfrom
docs/agents-md-ai-policy-839

Conversation

@AndyScherzinger

@AndyScherzinger AndyScherzinger commented Nov 20, 2026 •

Copy link
Copy Markdown
Member
  • Resolves: #

Summary

Brings AGENTS.md in line with the AI policy update in nextcloud/.github#839. Agents were still told never to write issues, PR descriptions or comments, which now contradicts the org-wide policy they reference.

  • Takes over the updated agent snippet: AI-drafted text is allowed when it is written for human readers, disclosed (PR checkbox, Assisted by … footer on comments and issues) and posted only on the contributor's behalf; commit bodies explain why; runtime changes are validated on a live instance. The "must never do" list now says what to do instead.
  • Aligns the repository-specific test rule with the policy: agent testing may support, but not replace, the contributor's own testing on a live instance.
  • Updates the Assisted-by example to the policy's current example value.
  • Also syncs the AI section of .github/CONTRIBUTING.md with the org contributing guide, which still required PR descriptions and comments in the contributor's own words.

To verify: compare the agent snippet section with AGENT_MD_SNIPPETS.md on nextcloud/.github master.

TODO

Checklist

AI (if applicable)

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

The org-wide AI policy now allows AI-drafted issues, PR descriptions
and comments as long as they are written for human readers, disclosed
and posted on the contributor's behalf. The agent instructions still
told agents never to write such text, which contradicts the policy
they point to.

The repository-specific test rule is aligned as well: runtime changes
must be validated on a live instance, and agent testing may support
but not replace the contributor's own testing.

Assisted-by: ClaudeCode:claude-opus-5-5
Signed-off-by: Andy Scherzinger <info@andy-scherzinger.de>
@AndyScherzinger
AndyScherzinger requested a review from a team as a code owner November 20, 2026 12:03
@AndyScherzinger
AndyScherzinger requested review from come-nc and icewind1991 and removed request for a team November 20, 2026 12:03
@AndyScherzinger AndyScherzinger added this to the Nextcloud 36 milestone Nov 20, 2026
@AndyScherzinger

Copy link
Copy Markdown
Member Author

/backport to stable35

@AndyScherzinger AndyScherzinger changed the title docs: sync AGENTS.md with AI policy update from nextcloud/.github#839 docs: sync AGENTS.md with AI policy update from org template Nov 20, 2026
…b#839

The contributing guide still required PR descriptions and comments in
the contributor's own words and live testing only for new features.
Bring its AI section in line with the org-wide contributing guide.

Assisted-by: ClaudeCode:claude-opus-5-5
Signed-off-by: Andy Scherzinger <info@andy-scherzinger.de>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants