Skip to content

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

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

AndyScherzinger merged 1 commit into
masterfrom
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.
  • Updates the Assisted-by example to a current model.

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

🖼️ Screenshots

Not applicable, documentation only.

🚧 TODO

🏁 Checklist

  • ⛑️ Tests (unit and/or integration) are included or not needed
  • 🔖 Capability is checked 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>
@github-actions

Copy link
Copy Markdown
Contributor

📱 QA build

Download app-qa-debug.apk
QR code Open the QR code for this download
Commit 24e2ec9
Version 7082
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.

@github-actions

Copy link
Copy Markdown
Contributor

Codacy

Lint

TypemasterPR
Warnings1716
Errors00

SpotBugs

CategoryBaseNew
Bad practice77
Correctness88
Dodgy code4040
Internationalization33
Malicious code vulnerability33
Performance77
Security1111
Total7979

@AndyScherzinger
AndyScherzinger merged commit e98c7ff into master Nov 21, 2026
18 of 20 checks passed
@AndyScherzinger
AndyScherzinger deleted the docs/agents-md-ai-policy-839 branch November 21, 2026 13:44
@AndyScherzinger AndyScherzinger added this to the 26.0.0 milestone Nov 21, 2026
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