Skip to content

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

Merged
AndyScherzinger merged 1 commit into
mainfrom
docs/agents-md-ai-policy-839
Nov 21, 2026
Merged

AndyScherzinger merged 1 commit into
mainfrom
docs/agents-md-ai-policy-839

Conversation

@AndyScherzinger

Copy link
Copy Markdown
Member

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 current 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 "never do" list now says what to do instead.
  • Also adds the snippet items this copy was missing (code comments, reuse of existing helpers, access checks, wiring up every context).

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

🖼️ Screenshots

Not applicable, documentation only.

🏁 Checklist

  • ⛑️ Tests (unit and/or integration) are included or not needed
  • 🔙 Backport requests are created or not needed: /backport to stable-xx.x
  • 📅 Milestone is set
  • 🌸 PR title is meaningful (if it should be in the changelog: is it meaningful to users?)

🤖 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.

Runtime changes must also 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>
@codacy-production

Copy link
Copy Markdown

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

NEW Get contextual insights on your PRs based on Codacy's metrics, along with PR and Jira context, without leaving GitHub. Enable AI reviewer
TIP This summary will be updated as you push new changes.

@github-actions

Copy link
Copy Markdown
Contributor

📱 QA build

Download app-qa-debug.apk
QR code Open the QR code for this download
Commit 8408e4a
Version 3466
Available until 7 days after this build

The QA build installs alongside a released Nextcloud app, so you can keep
using your existing install while testing.

Downloading the file requires a GitHub account, so open this link on the
device you want to test on, or transfer the APK to it.

@AndyScherzinger
AndyScherzinger merged commit 9aa4436 into main Nov 21, 2026
14 of 15 checks passed
@AndyScherzinger
AndyScherzinger deleted the docs/agents-md-ai-policy-839 branch November 21, 2026 13:44
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.

1 participant