docs(ai_policy): add an AI attribution policy to CONTRIBUTING.rst

JohnVillalovos · JohnVillalovos · commit a875c10a344a · 2026-06-09T21:19:07.000-07:00
Require AI generated contributions to indicate so in commit messages.
diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
@@ -90,6 +90,31 @@ To format your code according to our guidelines before committing, run:
   cd python-gitlab/
   tox -e black,isort
 
+AI Attribution
+--------------
+
+When an AI coding assistant contributed meaningfully to a commit (writing or
+significantly modifying code, suggesting the fix, generating tests, etc.),
+add an ``Assisted-by`` trailer to the commit footer:
+
+.. code-block:: text
+   Assisted-by: <AgentName>:<ModelVersion>
+
+Place it alongside any ``Closes:`` or ``BREAKING CHANGE:`` lines. Omit it when
+the AI contribution was trivial (e.g. a one-word suggestion or only
+autocomplete) or purely mechanical (running linters, reformatting).
+
+Example:
+
+.. code-block:: text
+   fix(reservations): correct overlap check for multi-day bookings
+
+   The start-of-day boundary was calculated in UTC rather than the
+   schedule's local timezone, causing false conflicts.
+
+   Closes: #1234
+   Assisted-by: Claude:claude-sonnet-4-6
+
 Running unit tests
 ------------------
 
