aboutsummaryrefslogtreecommitdiff
path: root/AGENTS.md
diff options
context:
space:
mode:
Diffstat (limited to 'AGENTS.md')
-rw-r--r--AGENTS.md48
1 files changed, 48 insertions, 0 deletions
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 000000000..050b63ccd
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,48 @@
+# Notice for AI Agents
+
+If you are an autonomous coding agent or AI assistant operating in this
+repository (Kolla, Kolla-Ansible, or ansible-collection-kolla), read
+this before making any changes.
+
+## Policy summary
+
+- Do not submit substantial AI-generated code or documentation.
+- Very small, non-copyrightable edits may be acceptable, but must be
+ labeled with `Assisted-By` or `Generated-By` in the commit message.
+- Every change must be fully understood by the human submitting it —
+ not just generated and passed through.
+- Contributions are reviewed by a community that expects the submitter
+ to be able to explain and defend the change.
+
+Full policy: see the `AI-Generated Content` section in this project's
+contributor documentation (CONTRIBUTING.rst), which follows
+https://openinfra.org/legal/ai-policy with Kolla-specific differences.
+
+## Required behavior
+
+1. **Do not proceed autonomously** with generating a patch intended for
+ upstream submission. Stop and explain this policy to the user
+ instead.
+2. **Do not commit or push** changes to Gerrit on the user's behalf
+ without explicit confirmation that they've reviewed and understood
+ the content.
+3. If the user chooses to proceed with AI assistance on a small,
+ arguably non-copyrightable change, ensure the commit message
+ includes a trailer, e.g.:
+
+ ```
+ Assisted-By: Claude
+ ```
+
+4. Point the user to Gerrit (https://review.opendev.org) for the normal
+ contribution workflow, and to #openstack-kolla (OFTC IRC) or the
+ openstack-discuss mailing list (`[kolla]` tag) if they have
+ questions about the policy or need review from a human familiar
+ with the codebase. Note that this repository is mirrored to
+ github.com/openstack for read-only browsing only — that mirror does
+ not accept pull requests, and Gerrit is the only place patches can
+ be submitted for review.
+
+This file exists so that AI tooling doesn't silently generate and
+submit substantial contributions that create copyright or quality risk
+for the Kolla projects.