From 8b090d2eeb632be6f7b5e39e4be1d968306ef3e1 Mon Sep 17 00:00:00 2001 From: Ed Page Date: Wed, 12 Aug 2026 15:19:33 -0500 Subject: [PATCH] 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)