From d016febe989a7db9900fd4c31296289fdac42b3b Mon Sep 17 00:00:00 2001 From: Ed Page Date: Wed, 12 Aug 2026 12:47:17 -0500 Subject: [PATCH 1/4] docs(ai): Start with regex's policy --- AI_POLICY.md | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 AI_POLICY.md diff --git a/AI_POLICY.md b/AI_POLICY.md new file mode 100644 index 00000000..9ce08834 --- /dev/null +++ b/AI_POLICY.md @@ -0,0 +1,34 @@ +# AI Policy + +Using AI (i.e., LLMs) as tools for coding is welcome. +A high bar is held for all contributions to this project. +Moreover, the project maintainers remain responsible for any code that is published as part of a release. +Contributors are expected to be responsible for any code they publish. + +**AI should not be used to generate comments when communicating with maintainers**. +Comments are expected to be written by humans. +Comments that are believed to be written by AI may be hidden without notice. + +If you are opening an issue, +you should be able to describe the problem in your own words. + +If you are opening a pull request, +you are expected to be able to explain the proposed changes in your own words. +This includes the pull request body and responses to questions. +**Do not copy responses from the AI when replying to questions from maintainers.** + +This project requires a human in the loop who understands the work produced by AI. +**Autonomous agents are not allowed to be used for contributing to our projects**. +Pull requests that appear in violation of this will be closed, +perhaps without notice. + +If you wish to include context from an interaction with AI in your comments, +it must be in a quote block (e.g., using `>`) and disclosed as such. +It must be accompanied by human commentary explaining the relevance and implications of the context. +Do not share long snippets. + +AI is useful when communicating as a non-native English speaker. +If you are using AI to edit your comments for this purpose, +please take the time to ensure it reflects your own voice and ideas. +If using AI for translation, +we recommend writing in your native language and including the AI translation in a quote block. From 516da22ea731aadec557d1d04152173a18835d99 Mon Sep 17 00:00:00 2001 From: Ed Page Date: Wed, 12 Aug 2026 13:14:30 -0500 Subject: [PATCH 2/4] docs(ai): Try out uv's policy --- AI_POLICY.md | 28 +++++++++++++--------------- 1 file changed, 13 insertions(+), 15 deletions(-) diff --git a/AI_POLICY.md b/AI_POLICY.md index 9ce08834..3c87dd29 100644 --- a/AI_POLICY.md +++ b/AI_POLICY.md @@ -1,34 +1,32 @@ # AI Policy -Using AI (i.e., LLMs) as tools for coding is welcome. -A high bar is held for all contributions to this project. -Moreover, the project maintainers remain responsible for any code that is published as part of a release. -Contributors are expected to be responsible for any code they publish. +We support using AI (i.e., LLMs) as tools for coding. +However, you remain responsible for any code you publish and we are responsible for any code we merge and release. +We hold a high bar for all contributions to our projects. **AI should not be used to generate comments when communicating with maintainers**. -Comments are expected to be written by humans. -Comments that are believed to be written by AI may be hidden without notice. +We expect comments on our projects to be written by humans. +We may hide any comments that we believe are AI generated. If you are opening an issue, -you should be able to describe the problem in your own words. +we expect you to describe the problem in your own words. If you are opening a pull request, -you are expected to be able to explain the proposed changes in your own words. +we expect you to be able to explain the proposed changes in your own words. This includes the pull request body and responses to questions. **Do not copy responses from the AI when replying to questions from maintainers.** -This project requires a human in the loop who understands the work produced by AI. -**Autonomous agents are not allowed to be used for contributing to our projects**. -Pull requests that appear in violation of this will be closed, -perhaps without notice. +Due to the foundational nature of our projects, +we require a human in the loop who understands the work produced by AI. +**We do not allow autonomous agents to be used for contributing to our projects**. +We will close any pull requests that we believe were created autonomously. If you wish to include context from an interaction with AI in your comments, it must be in a quote block (e.g., using `>`) and disclosed as such. It must be accompanied by human commentary explaining the relevance and implications of the context. Do not share long snippets. -AI is useful when communicating as a non-native English speaker. +We understand that AI is useful when communicating as a non-native English speaker. If you are using AI to edit your comments for this purpose, please take the time to ensure it reflects your own voice and ideas. -If using AI for translation, -we recommend writing in your native language and including the AI translation in a quote block. +If using AI for translation, we recommend writing in your native language and including the AI translation in a quote block. From 82c988371ded5215f838e18789b60513be38f123 Mon Sep 17 00:00:00 2001 From: Ed Page Date: Wed, 12 Aug 2026 15:14:35 -0500 Subject: [PATCH 3/4] docs(gh): Add a PR template Goals - Encourage having an issue approved first - Encourage meaningful content (unlike most AI generated PR descriptions) --- .github/PULL_REQUEST_TEMPLATE.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) create mode 100644 .github/PULL_REQUEST_TEMPLATE.md diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md new file mode 100644 index 00000000..a5c0c228 --- /dev/null +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -0,0 +1,14 @@ + + +### What does this PR try to solve? + + +Closes # + +### Notes to reviewers + + From 8b090d2eeb632be6f7b5e39e4be1d968306ef3e1 Mon Sep 17 00:00:00 2001 From: Ed Page Date: Wed, 12 Aug 2026 15:19:33 -0500 Subject: [PATCH 4/4] docs(ai): Solidify the policy --- .github/PULL_REQUEST_TEMPLATE.md | 2 + AI_POLICY.md | 64 ++++++++++++++++++++++---------- 2 files changed, 47 insertions(+), 19 deletions(-) diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md index a5c0c228..cc42102f 100644 --- a/.github/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -12,3 +12,5 @@ Examples: - Larger context this fits within - Manual testing and why it wasn't automated --> + +LLM involvement: diff --git a/AI_POLICY.md b/AI_POLICY.md index 3c87dd29..b2ad65fd 100644 --- a/AI_POLICY.md +++ b/AI_POLICY.md @@ -1,32 +1,58 @@ -# AI Policy +# AI policy -We support using AI (i.e., LLMs) as tools for coding. -However, you remain responsible for any code you publish and we are responsible for any code we merge and release. -We hold a high bar for all contributions to our projects. +Project maintainers are responsible for any code that is published as part of a release. +Contributors are responsible for their contributions, both in terms of communications and code. +This responsibility is for both understanding of and the quality of their contributions. -**AI should not be used to generate comments when communicating with maintainers**. +## Personal use + +You are free to use an AI locally for your own purposes, +including to answer your questions, analyze, distill, refine, check, suggest, and review. + +## Communication + +**AI should not be used to generate comments when communicating with maintainers.** We expect comments on our projects to be written by humans. -We may hide any comments that we believe are AI generated. +We may hide or delete any comments where we believe AI generation was involved. If you are opening an issue, -we expect you to describe the problem in your own words. +we expect you to have personally reproduced the problem and to describe it in your own words. If you are opening a pull request, we expect you to be able to explain the proposed changes in your own words. This includes the pull request body and responses to questions. -**Do not copy responses from the AI when replying to questions from maintainers.** - -Due to the foundational nature of our projects, -we require a human in the loop who understands the work produced by AI. -**We do not allow autonomous agents to be used for contributing to our projects**. -We will close any pull requests that we believe were created autonomously. - -If you wish to include context from an interaction with AI in your comments, -it must be in a quote block (e.g., using `>`) and disclosed as such. -It must be accompanied by human commentary explaining the relevance and implications of the context. -Do not share long snippets. +**Do not copy responses from an AI when replying to questions from maintainers.** +Do not run agents or bots on pull requests without first getting approval. We understand that AI is useful when communicating as a non-native English speaker. If you are using AI to edit your comments for this purpose, please take the time to ensure it reflects your own voice and ideas. -If using AI for translation, we recommend writing in your native language and including the AI translation in a quote block. +If using AI for translation, we recommend writing in your native language and including the AI translation in a [`
` block]. + +If you wish to include context from an interaction with AI in your comments, +it must be in a [`
` block] and disclosed as such. +The block must include human commentary explaining the relevance and implications of the context. +The content of your comment must stand on its own even without the quoted content. +Do not share long snippets. + +## Code + +Using AI as tools for coding requires receiving permission on the relevant issue before a PR is posted. + +This project requires a human in the loop who understands the work produced by AI. +**We do not allow autonomous agents to be used for contributing to this project**. +We will close any pull requests that we believe were created **without meaningful involvement** from the contributor. +Contributions should not "read" as being written by an AI. + +Some areas require specific expertise or care when touching. +AI generated code, even with human review, is prohibited for: +- none + +We view AI as providing a way to improve quality and will hold AI-assisted contributions to a higher standard. +We will be more free in asking for changes. + +The involvement of AI assistance must be disclosed in PRs. + +For documentation, including comments in code, see [Communication](#communication). + +[`
` block]: https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections)