Skip to contentSkip to conversation

docs/process: document AI-assisted patch tags

PATCH In review Andrew Cooper 3 participants 4 messages Jun 15 – Jun 19

lore
Share & tools
lore
#0 lore raw

PATCH v4 1/1 docs/process: document AI-assisted patch tags

From: Cody Zuschlag <[email protected]>

Add documentation for the Assisted-by tag to clarify how AI-assisted tooling may be disclosed in Xen patches.

The guidance follows the Linux kernel documentation.

Assisted-by ChatGPT:gpt-5.5

---
CC: Anthony PERARD <[email protected]>
CC: Michal Orzel <[email protected]>
CC: Jan Beulich <[email protected]>
CC: Julien Grall <[email protected]>
CC: Roger Pau Monné <[email protected]>
CC: Stefano Stabellini <[email protected]>

v4:
* Make it a well-formed patch
* Remove reference to tools which don't work in the Xen tree

---
 docs/process/sending-patches.pandoc | 31 +++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)
docs/process/sending-patches.pandoc +31 -0
index 798ecceb39d1..b924fa2b87b2 100644
@@ -195,6 +195,28 @@ E.g.:
 
     Requested-by: Jane Doe <[email protected]>
 
+### Assisted-by:
+
+When AI tools contribute to Xen 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 [, ...]
+
+Where:
+
+* `AGENT_NAME` is the name of the AI tool or framework
+* `MODEL_VERSION` is the specific model version used
+
+Basic development tools (git, gcc, make, editors) should not be listed.
+Specialised but deterministic tools may optionally be listed, but their use
+should be clear from other context in the commit message.
+
+Example:
+
+    Assisted-by: Claude:claude-3-opus
+
 ### Signed-off-by:
 
 This mandatory tag specifies the author(s) of a patch (for each author a
@@ -209,6 +231,15 @@ E.g.:
 The author must be a natural person (not a team or just a company) and the
 `Signed-off-by:` tag must include the real name of the author (no pseudonym).
 
+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
+
 By signing the patch with her/his name the author explicitly confirms to have
 made the contribution conforming to the `Developer's Certificate of Origin`:
 

base-commit: efcb4c5e2f2734cd4cac38a9f01e03c5e54c8eb8

Signature · 1 line
2.39.5
Acked-by on v4 1/1
#1 lore raw
Quoted 8 lines · Andrew Cooper

From: Cody Zuschlag <[email protected]>

Add documentation for the Assisted-by tag to clarify how AI-assisted tooling may be disclosed in Xen patches.

The guidance follows the Linux kernel documentation.

Assisted-by ChatGPT:gpt-5.5

Really, seeing how it managed to mangle an otherwise extremely simple patch to the point that required manual fixup to apply I would consider removing this Assisted-by.

The wording is verbatim from Linux, and Andrew is the one that has adjusted the chunks plus removed the inapplicable references.

Quoted 2 lines

Regards, Roger.

#2 lore raw
Quoted 8 lines · Roger Pau Monné
Quoted 7 lines · Andrew Cooper

From: Cody Zuschlag <[email protected]>

Add documentation for the Assisted-by tag to clarify how AI-assisted tooling may be disclosed in Xen patches.

The guidance follows the Linux kernel documentation.

Quoted 7 lines
Quoted 1 line
Assisted-by ChatGPT:gpt-5.5

Really, seeing how it managed to mangle an otherwise extremely simple patch to the point that required manual fixup to apply I would consider removing this Assisted-by.

The wording is verbatim from Linux, and Andrew is the one that has adjusted the chunks plus removed the inapplicable references.

Ok.

Quoted 3 lines
Quoted 2 lines

Thanks.

I'm going to get this committed now.  It's long overdue.  v3 did have more acks and there's nothing controversial changed.

~Andrew

Acked-by on v4 1/1
#3 lore raw
In reply to Andrew Cooper
Quoted 10 lines · Andrew Cooper

From: Cody Zuschlag <[email protected]>

Add documentation for the Assisted-by tag to clarify how AI-assisted tooling may be disclosed in Xen patches.

The guidance follows the Linux kernel documentation.

Assisted-by ChatGPT:gpt-5.5

Thanks,

--
Anthony Perard | Vates XCP-ng Developer

XCP-ng & Xen Orchestra - Vates solutions

web: https://vates.tech