Skip to content

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

Open
AndyScherzinger wants to merge 1 commit into
mainfrom
docs/agents-md-ai-policy-839
Open

AndyScherzinger wants to merge 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).
  • 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.

🏁 Checklist

  • ⛑️ Tests (unit and/or integration) are included or not needed
  • 🔙 Backport requests are created or not needed: /backport to stableX.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>
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