Add AI agent policy documentation

.changeset/ai_agents.md

@@ -0,0 +1,11 @@
+---
+default: docs
+---
+
+# Update to disclosure of AI generated code
+
+Added `AGENTS.md` to inform autonomous AI agents about restrictions in this
+repository.
+
+As a reminder, the guidelines can be found in
+[our Contribution Guidelines](https://github.com/SableClient/Sable/blob/dev/CONTRIBUTING.md)

.cursorrules

@@ -0,0 +1,6 @@
+# Cursor Rules
+
+This repository does not permit autonomous AI agents to operate on the
+repository.
+
+See AGENTS.md and CONTRIBUTING.md for the complete policy.

.github/copilot-instructions.md

@@ -0,0 +1,6 @@
+# Copilot Instructions
+
+This repository does not permit autonomous AI agents to operate on the
+repository.
+
+See AGENTS.md and CONTRIBUTING.md for the complete policy.

.vscode/settings.json

@@ -14,5 +14,9 @@
     "editor.defaultFormatter": "oxc.oxc-vscode"
   },
   "nixEnvSelector.nixFile": "${workspaceFolder}/flake.nix",
-  "nixEnvSelector.useFlakes": true
+  "nixEnvSelector.useFlakes": true,
+  "explorer.fileNesting.enabled": true,
+  "explorer.fileNesting.patterns": {
+    "AGENTS.md": "AGENTS.md, CLAUDE.md, COPILOT.md, .cursorrules"
+  }
 }

AGENTS.md

@@ -0,0 +1,75 @@
+# AGENTS.md
+
+## Policy Summary
+
+This repository does not permit autonomous AI agents to operate on the
+repository (including editing files, opening issues, or creating pull requests).
+
+Human contributors MAY use AI-assisted development tools provided that:
+
+- the human fully reviews and understands all generated output
+- AI assistance is disclosed
+- all licensing requirements are satisfied
+- the contribution adds meaningful human value
+
+Examples of prohibited autonomous behavior include:
+
+- automated pull request generation
+- unattended repository modifications
+- autonomous issue filing
+- bulk AI-generated comments or reviews
+
+Interactive editor assistance used directly by a human contributor is permitted
+subject to the disclosure requirements below.
+
+## RESTRICTIONS
+
+We expect and appreciate authentic engagement in our community.
+
+Do not post output from Large Language Models or similar generative AI as
+comments on GitHub, as such comments tend to be formulaic and low content.
+
+If you use generative AI tools as an aid in developing code, ensure that you
+fully understand the proposed changes and can explain why they are the correct
+approach; additionally, you **must** disclose which parts of the code were:
+
+- Fully generated by the AI tool.
+- Written alongside the AI tool (examples: line completion, rewriting code
+  generated by AI).
+
+Make sure you have added value based on your personal competency to your
+contributions. Just taking some input, feeding it to an AI and posting the
+result is not of value to the project. We reserve the right to rigorously reject
+seemingly AI generated low-value contributions.
+
+Maintainers may close issues and PRs that are not useful or productive,
+including those that are fully generated by AI. If a contributor repeatedly
+opens unproductive issues or PRs, they may be blocked.
+
+## Licensing and Legal Requirements
+
+> inspired by
+> <https://github.com/torvalds/linux/blob/master/Documentation/process/coding-assistants.rst>
+
+All contributions must comply with the projects's licensing requirements:
+
+- All code must be compatible with AGPL-3.0-only
+
+## Signed-off-by and Developer Certificate of Origin
+
+AI agents MUST NOT add Signed-off-by tags. Only humans can legally certify the
+Developer Certificate of Origin (DCO). The human submitter is responsible for:
+
+- Reviewing all AI-generated code
+- Ensuring compliance with licensing requirements
+- Adding their own Signed-off-by tag to certify the DCO
+- Taking full responsibility for the contribution
+
+## Contributing
+
+See ./CONTRIBUTING.md for:
+
+- disclosure requirements
+- licensing requirements
+- attribution requirements
+- contributor expectations

CLAUDE.md

@@ -0,0 +1,6 @@
+# CLAUDE.md
+
+This repository does not permit autonomous AI agents to operate on the
+repository.
+
+See AGENTS.md and CONTRIBUTING.md for the complete policy.

CONTRIBUTING.md

@@ -63,6 +63,34 @@ Make sure you have added value based on your personal competency to your contrib
 
 Maintainers may close issues and PRs that are not useful or productive, including those that are fully generated by AI. If a contributor repeatedly opens unproductive issues or PRs, they may be blocked.
 
+### Attribution
+
+> taken from linux's AI policy
+> <https://github.com/torvalds/linux/blob/master/Documentation/process/coding-assistants.rst>
+
+When AI tools contribute to the project development, proper attribution helps
+track the evolving role of AI in the development process. Contributions should
+include an Assisted-by tag in the following format::
+
+```
+Assisted-by: AGENT_NAME:MODEL_VERSION [TOOL1] [TOOL2]
+```
+
+Where:
+
+- `AGENT_NAME` is the name of the AI tool or framework
+- `MODEL_VERSION` is the specific model version used
+- `[TOOL1] [TOOL2]` are optional specialized analysis tools used (e.g.,
+  coccinelle, sparse, smatch, clang-tidy)
+
+Basic development tools (git, gcc, make, editors) should not be listed.
+
+Example:
+
+```
+Assisted-by: Claude:claude-3-opus coccinelle sparse
+```
+
 ## Release notes and versioning (Knope)
 
 We use [Knope](https://knope.tech/) with the Knope GitHub Bot to manage change documentation and releases. The workflow configuration lives in [`knope.toml`](./knope.toml).

COPILOT.md

@@ -0,0 +1,6 @@
+# COPILOT.md
+
+This repository does not permit autonomous AI agents to operate on the
+repository.
+
+See AGENTS.md and CONTRIBUTING.md for the complete policy.