From 2b4bd8815cbacdfb06f121e55832ff9605e51ec0 Mon Sep 17 00:00:00 2001
From: Steven Masley <stevenmasley@gmail.com>
Date: Tue, 19 Aug 2025 14:26:36 -0500
Subject: [PATCH 1/9] docs: add generative ai contribution guidelines

Initial language
---
 docs/about/contributing/AI_CONTRIBUTING.md | 33 ++++++++++++++++++++++
 docs/about/contributing/CONTRIBUTING.md    |  5 ++++
 docs/images/icons/ai_intelligence.svg      |  1 +
 docs/manifest.json                         |  6 ++++
 4 files changed, 45 insertions(+)
 create mode 100644 docs/about/contributing/AI_CONTRIBUTING.md
 create mode 100644 docs/images/icons/ai_intelligence.svg

diff --git a/docs/about/contributing/AI_CONTRIBUTING.md b/docs/about/contributing/AI_CONTRIBUTING.md
new file mode 100644
index 0000000000000..a1653ffb1bcff
--- /dev/null
+++ b/docs/about/contributing/AI_CONTRIBUTING.md
@@ -0,0 +1,33 @@
+# Guidelines for Using Generative AI in Contributions
+
+This document defines rules for contributions where an AI system is the primary author of the code (i.e., most of the pull request was generated by AI).
+It applies to all Coder repositories is supplementary to the existing contributing guidelines, not a replacement.
+
+For minor AI-assisted edits, suggestions, or completions where the human contributor is clearly the primary author, these rules do not apply — standard contributing guidelines are sufficient.
+
+## Disclosure
+
+Contributors must **disclose AI involvement** in the pull request description whenever these guidelines apply.
+
+## Human Ownership & Attribution
+
+- All pull requests must be opened under **real user accounts**.
+- Contributors are personally accountable for the content of their PRs, regardless of how it was generated.
+- Default to draft PRs until work has been tested and reviewed.
+
+## Verification & Evidence
+
+All AI-assisted contributions require **manual verification**.
+Contributions without verification evidence will be rejected.
+
+- Test your changes yourself. Don’t assume AI is correct.
+- Provide screenshots showing that the change works as intended.
+  - For visual/UI changes: include before/after screenshots.
+  - For CLI or backend changes: include terminal or api output.
+
+# Why These Rules Exist
+
+Traditionally, maintainers assumed that producing a pull request required more effort than reviewing it.
+With AI-assisted tools, the balance has shifted: generating code is often faster than reviewing it.
+
+Our guidelines exist to safeguard maintainers’ time, uphold contributor accountability, and preserve the overall quality of the project.
diff --git a/docs/about/contributing/CONTRIBUTING.md b/docs/about/contributing/CONTRIBUTING.md
index 7eedebb146dc5..98243d3790f77 100644
--- a/docs/about/contributing/CONTRIBUTING.md
+++ b/docs/about/contributing/CONTRIBUTING.md
@@ -236,6 +236,11 @@ Breaking changes can be triggered in two ways:
   [`release/breaking`](https://github.com/coder/coder/issues?q=sort%3Aupdated-desc+label%3Arelease%2Fbreaking)
   label to a PR that has, or will be, merged into `main`.
 
+### Generative AI
+
+Using AI to help with contributions is acceptable, but only if the [AI Contribution Guidelines](./AI_CONTRIBUTING.md)
+are followed. If most of your PR was generated by AI, please read and comply with these rules before submitting.
+
 ### Security
 
 > [!CAUTION]
diff --git a/docs/images/icons/ai_intelligence.svg b/docs/images/icons/ai_intelligence.svg
new file mode 100644
index 0000000000000..bcef647bf3c3a
--- /dev/null
+++ b/docs/images/icons/ai_intelligence.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" height="24px" viewBox="0 -960 960 960" width="24px" fill="#000000"><path d="M323-160q-11 0-20.5-5.5T288-181l-78-139h58l40 80h92v-40h-68l-40-80H188l-57-100q-2-5-3.5-10t-1.5-10q0-4 5-20l57-100h104l40-80h68v-40h-92l-40 80h-58l78-139q5-10 14.5-15.5T323-800h97q17 0 28.5 11.5T460-760v160h-60l-40 40h100v120h-88l-40-80h-92l-40 40h108l40 80h112v200q0 17-11.5 28.5T420-160h-97Zm217 0q-17 0-28.5-11.5T500-200v-200h112l40-80h108l-40-40h-92l-40 80h-88v-120h100l-40-40h-60v-160q0-17 11.5-28.5T540-800h97q11 0 20.5 5.5T672-779l78 139h-58l-40-80h-92v40h68l40 80h104l57 100q2 5 3.5 10t1.5 10q0 4-5 20l-57 100H668l-40 80h-68v40h92l40-80h58l-78 139q-5 10-14.5 15.5T637-160h-97Z"/></svg>
\ No newline at end of file
diff --git a/docs/manifest.json b/docs/manifest.json
index 66f4e6dbaf476..49c585d2f0ec1 100644
--- a/docs/manifest.json
+++ b/docs/manifest.json
@@ -64,6 +64,12 @@
 							"description": "Security vulnerability disclosure policy",
 							"path": "./about/contributing/SECURITY.md",
 							"icon_path": "./images/icons/lock.svg"
+						},
+						{
+							"title": "AI Contributions",
+							"description": "Guidelines for AI-generated contributions.",
+							"path": "./about/contributing/AI_CONTRIBUTING.md",
+							"icon_path": "./images/icons/ai_intelligence.svg"
 						}
 					]
 				}

From 08bf2cb43e884692809dcae13e6aaaf58d375655 Mon Sep 17 00:00:00 2001
From: Steven Masley <stevenmasley@gmail.com>
Date: Tue, 19 Aug 2025 14:28:50 -0500
Subject: [PATCH 2/9] typo

---
 docs/about/contributing/AI_CONTRIBUTING.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/about/contributing/AI_CONTRIBUTING.md b/docs/about/contributing/AI_CONTRIBUTING.md
index a1653ffb1bcff..79ff06aa0ad0f 100644
--- a/docs/about/contributing/AI_CONTRIBUTING.md
+++ b/docs/about/contributing/AI_CONTRIBUTING.md
@@ -1,7 +1,7 @@
 # Guidelines for Using Generative AI in Contributions
 
 This document defines rules for contributions where an AI system is the primary author of the code (i.e., most of the pull request was generated by AI).
-It applies to all Coder repositories is supplementary to the existing contributing guidelines, not a replacement.
+It applies to all Coder repositories and is supplementary to the existing contributing guidelines, not a replacement.
 
 For minor AI-assisted edits, suggestions, or completions where the human contributor is clearly the primary author, these rules do not apply — standard contributing guidelines are sufficient.
 

From dd148afbbde299e4c4ada74a392fe9f4401db85b Mon Sep 17 00:00:00 2001
From: Steven Masley <stevenmasley@gmail.com>
Date: Tue, 19 Aug 2025 14:38:28 -0500
Subject: [PATCH 3/9] fix headings

---
 docs/about/contributing/AI_CONTRIBUTING.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/about/contributing/AI_CONTRIBUTING.md b/docs/about/contributing/AI_CONTRIBUTING.md
index 79ff06aa0ad0f..8c864969bd0c0 100644
--- a/docs/about/contributing/AI_CONTRIBUTING.md
+++ b/docs/about/contributing/AI_CONTRIBUTING.md
@@ -5,17 +5,17 @@ It applies to all Coder repositories and is supplementary to the existing contri
 
 For minor AI-assisted edits, suggestions, or completions where the human contributor is clearly the primary author, these rules do not apply — standard contributing guidelines are sufficient.
 
-## Disclosure
+### Disclosure
 
 Contributors must **disclose AI involvement** in the pull request description whenever these guidelines apply.
 
-## Human Ownership & Attribution
+### Human Ownership & Attribution
 
 - All pull requests must be opened under **real user accounts**.
 - Contributors are personally accountable for the content of their PRs, regardless of how it was generated.
 - Default to draft PRs until work has been tested and reviewed.
 
-## Verification & Evidence
+### Verification & Evidence
 
 All AI-assisted contributions require **manual verification**.
 Contributions without verification evidence will be rejected.
@@ -25,7 +25,7 @@ Contributions without verification evidence will be rejected.
   - For visual/UI changes: include before/after screenshots.
   - For CLI or backend changes: include terminal or api output.
 
-# Why These Rules Exist
+## Why These Rules Exist
 
 Traditionally, maintainers assumed that producing a pull request required more effort than reviewing it.
 With AI-assisted tools, the balance has shifted: generating code is often faster than reviewing it.

From 985bb3b8a55195b69e79b92c06c476e991688cfb Mon Sep 17 00:00:00 2001
From: Steven Masley <stevenmasley@gmail.com>
Date: Tue, 19 Aug 2025 14:40:43 -0500
Subject: [PATCH 4/9] fix headings

---
 docs/about/contributing/AI_CONTRIBUTING.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/about/contributing/AI_CONTRIBUTING.md b/docs/about/contributing/AI_CONTRIBUTING.md
index 8c864969bd0c0..b5cfca669726f 100644
--- a/docs/about/contributing/AI_CONTRIBUTING.md
+++ b/docs/about/contributing/AI_CONTRIBUTING.md
@@ -5,17 +5,17 @@ It applies to all Coder repositories and is supplementary to the existing contri
 
 For minor AI-assisted edits, suggestions, or completions where the human contributor is clearly the primary author, these rules do not apply — standard contributing guidelines are sufficient.
 
-### Disclosure
+## Disclosure
 
 Contributors must **disclose AI involvement** in the pull request description whenever these guidelines apply.
 
-### Human Ownership & Attribution
+## Human Ownership & Attribution
 
 - All pull requests must be opened under **real user accounts**.
 - Contributors are personally accountable for the content of their PRs, regardless of how it was generated.
 - Default to draft PRs until work has been tested and reviewed.
 
-### Verification & Evidence
+## Verification & Evidence
 
 All AI-assisted contributions require **manual verification**.
 Contributions without verification evidence will be rejected.

From 6c6c9f7b3dfd3eabaa4a273964079507b56b3b4c Mon Sep 17 00:00:00 2001
From: Steven Masley <Emyrk@users.noreply.github.com>
Date: Tue, 19 Aug 2025 15:10:47 -0500
Subject: [PATCH 5/9] Update docs/about/contributing/AI_CONTRIBUTING.md

Co-authored-by: Danny Kopping <danny@coder.com>
---
 docs/about/contributing/AI_CONTRIBUTING.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/about/contributing/AI_CONTRIBUTING.md b/docs/about/contributing/AI_CONTRIBUTING.md
index b5cfca669726f..5b9f8517dc08d 100644
--- a/docs/about/contributing/AI_CONTRIBUTING.md
+++ b/docs/about/contributing/AI_CONTRIBUTING.md
@@ -1,7 +1,7 @@
 # Guidelines for Using Generative AI in Contributions
 
 This document defines rules for contributions where an AI system is the primary author of the code (i.e., most of the pull request was generated by AI).
-It applies to all Coder repositories and is supplementary to the existing contributing guidelines, not a replacement.
+It applies to all Coder repositories and is supplementary to the [existing contributing guidelines](./CONTRIBUTING.md), not a replacement.
 
 For minor AI-assisted edits, suggestions, or completions where the human contributor is clearly the primary author, these rules do not apply — standard contributing guidelines are sufficient.
 

From 4388a7473190386f3be0c294e7c20cd598e82819 Mon Sep 17 00:00:00 2001
From: Steven Masley <stevenmasley@gmail.com>
Date: Tue, 19 Aug 2025 15:13:02 -0500
Subject: [PATCH 6/9] remove some lanuage

---
 docs/about/contributing/AI_CONTRIBUTING.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/docs/about/contributing/AI_CONTRIBUTING.md b/docs/about/contributing/AI_CONTRIBUTING.md
index 5b9f8517dc08d..0401bccab3c60 100644
--- a/docs/about/contributing/AI_CONTRIBUTING.md
+++ b/docs/about/contributing/AI_CONTRIBUTING.md
@@ -13,7 +13,6 @@ Contributors must **disclose AI involvement** in the pull request description wh
 
 - All pull requests must be opened under **real user accounts**.
 - Contributors are personally accountable for the content of their PRs, regardless of how it was generated.
-- Default to draft PRs until work has been tested and reviewed.
 
 ## Verification & Evidence
 

From 706560be7c2f2c7322c8374c33d79498a0d070a9 Mon Sep 17 00:00:00 2001
From: Steven Masley <Emyrk@users.noreply.github.com>
Date: Wed, 20 Aug 2025 07:42:57 -0500
Subject: [PATCH 7/9] Update docs/about/contributing/AI_CONTRIBUTING.md

Co-authored-by: Cian Johnston <cian@coder.com>
---
 docs/about/contributing/AI_CONTRIBUTING.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/about/contributing/AI_CONTRIBUTING.md b/docs/about/contributing/AI_CONTRIBUTING.md
index 0401bccab3c60..95db8de5c6492 100644
--- a/docs/about/contributing/AI_CONTRIBUTING.md
+++ b/docs/about/contributing/AI_CONTRIBUTING.md
@@ -11,7 +11,7 @@ Contributors must **disclose AI involvement** in the pull request description wh
 
 ## Human Ownership & Attribution
 
-- All pull requests must be opened under **real user accounts**.
+- All pull requests must be opened under **user accounts linked to a human**, and not an application ("bot account").
 - Contributors are personally accountable for the content of their PRs, regardless of how it was generated.
 
 ## Verification & Evidence

From bf983b85e9ca13d4fb09e992917ce404a0e8be5d Mon Sep 17 00:00:00 2001
From: Steven Masley <Emyrk@users.noreply.github.com>
Date: Wed, 20 Aug 2025 07:43:02 -0500
Subject: [PATCH 8/9] Update docs/about/contributing/AI_CONTRIBUTING.md

Co-authored-by: Cian Johnston <cian@coder.com>
---
 docs/about/contributing/AI_CONTRIBUTING.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/about/contributing/AI_CONTRIBUTING.md b/docs/about/contributing/AI_CONTRIBUTING.md
index 95db8de5c6492..9baba6f997d07 100644
--- a/docs/about/contributing/AI_CONTRIBUTING.md
+++ b/docs/about/contributing/AI_CONTRIBUTING.md
@@ -1,7 +1,7 @@
 # Guidelines for Using Generative AI in Contributions
 
 This document defines rules for contributions where an AI system is the primary author of the code (i.e., most of the pull request was generated by AI).
-It applies to all Coder repositories and is supplementary to the [existing contributing guidelines](./CONTRIBUTING.md), not a replacement.
+It applies to all Coder repositories and is a supplement to the [existing contributing guidelines](./CONTRIBUTING.md), not a replacement.
 
 For minor AI-assisted edits, suggestions, or completions where the human contributor is clearly the primary author, these rules do not apply — standard contributing guidelines are sufficient.
 

From 5adc972979bc93d2be3673e91c0d259b791b7691 Mon Sep 17 00:00:00 2001
From: Steven Masley <stevenmasley@gmail.com>
Date: Wed, 20 Aug 2025 07:47:08 -0500
Subject: [PATCH 9/9] shorter title

---
 docs/about/contributing/AI_CONTRIBUTING.md | 2 +-
 docs/manifest.json                         | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/about/contributing/AI_CONTRIBUTING.md b/docs/about/contributing/AI_CONTRIBUTING.md
index 9baba6f997d07..8771528f0c1ce 100644
--- a/docs/about/contributing/AI_CONTRIBUTING.md
+++ b/docs/about/contributing/AI_CONTRIBUTING.md
@@ -1,4 +1,4 @@
-# Guidelines for Using Generative AI in Contributions
+# AI Contribution Guidelines
 
 This document defines rules for contributions where an AI system is the primary author of the code (i.e., most of the pull request was generated by AI).
 It applies to all Coder repositories and is a supplement to the [existing contributing guidelines](./CONTRIBUTING.md), not a replacement.
diff --git a/docs/manifest.json b/docs/manifest.json
index 49c585d2f0ec1..69c9a29173dd6 100644
--- a/docs/manifest.json
+++ b/docs/manifest.json
@@ -66,7 +66,7 @@
 							"icon_path": "./images/icons/lock.svg"
 						},
 						{
-							"title": "AI Contributions",
+							"title": "AI Contribution Guidelines",
 							"description": "Guidelines for AI-generated contributions.",
 							"path": "./about/contributing/AI_CONTRIBUTING.md",
 							"icon_path": "./images/icons/ai_intelligence.svg"

<!DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Transitional//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd'>
<html xmlns='http://www.w3.org/1999/xhtml'>
<head>
<title>pFad - Phonifier reborn</title>
<meta http-equiv='Content-Type' content='text/html; charset=utf-8' />
</head>
<body>
<h1>Pfad - The Proxy pFad of &#169; 2024 Garber Painting. All rights reserved.</h1>


<!-- Disclaimer -->
<p>Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.</p>
<br>
<p>Alternative Proxies:</p><p><a href="http://rainy.clevelandohioweatherforecast.com/php-proxy/index.php?q=https://patch-diff.githubusercontent.com/raw/coder/coder/pull/19427.patch" target="_blank">Alternative Proxy</a></p><p><a href="http://rainy.clevelandohioweatherforecast.com/pFad/index.php?u=https://patch-diff.githubusercontent.com/raw/coder/coder/pull/19427.patch" target="_blank">pFad Proxy</a></p><p><a href="http://rainy.clevelandohioweatherforecast.com/pFad/v3index.php?u=https://patch-diff.githubusercontent.com/raw/coder/coder/pull/19427.patch" target="_blank">pFad v3 Proxy</a></p><p><a href="http://rainy.clevelandohioweatherforecast.com/pFad/v4index.php?u=https://patch-diff.githubusercontent.com/raw/coder/coder/pull/19427.patch" target="_blank">pFad v4 Proxy</a></p></body>
</html>