From e7ad0d72ba43c45055366f7780bb852bab22ad6b Mon Sep 17 00:00:00 2001 From: Paul Hallett Date: Fri, 13 Mar 2026 10:51:29 +0000 Subject: [PATCH 1/3] Update AI-assisted coding guidelines in CONTRIBUTING.md Because it's getting way too much, man. --- CONTRIBUTING.md | 19 ++++++++++++++++++- 1 file changed, 18 insertions(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 25b20e13a..6848b13ea 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -28,7 +28,18 @@ Simple! ## AI assisted coding -Using AI assisted coding tools for auto complete, test generation, etc is allowed so long as a human is the overall primary author of a pull request. +AI assisted coding that will be accepted: + +- Auto complete +- Scaffolding for common framework patterns +- Scaffolding for test patternstest generation +- Mass file editing such as tedious repetitive operations + +AI changes that will **NOT** be accepted: + +- Fully automated code generation +- AI generated comments and responses in code review +- Clear lack of understanding of the change Contributions from supervised AI assisted coding agents who build the majority (or all of) a change, such as [co pilot tasks](https://github.blog/changelog/2025-10-28-a-mission-control-to-assign-steer-and-track-copilot-coding-agent-tasks/), will be accepted only on the following basis: @@ -37,6 +48,12 @@ Contributions from supervised AI assisted coding agents who build the majority ( 3. The human author explicitly calls out that an supervised AI agent created the change when they make a pull request. 4. The human author is prepared to own the change (just like any other change they make) and fix any issues that arise from it. +### Maintainers decision is final + +If you cannot sufficiently demonstrate good use of AI tooling we will close your change. + +We contribute to this project in our free time. Our time is valuable. Our time is not to be spent doing the thinking for you because you outsourced work to an LLM coding agent. + ## Financial contributions From 065060357a7f488f6c2a1fd807e6bbb7b6b2b32d Mon Sep 17 00:00:00 2001 From: Paul Hallett Date: Fri, 13 Mar 2026 11:03:00 +0000 Subject: [PATCH 2/3] Update pull_request_template --- .github/pull_request_template.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index e13c797ce..d9b13f1a2 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -3,3 +3,5 @@ * Include a description of the proposed changes and how to test them. * Consider adding the `no-deploy` label if this PR shouldn't be deployed and does not alter the data served by the API. --> + +- [ ] I have read and understood the [AI Assisted Contribution guidelines](https://github.com/PokeAPI/pokeapi/blob/master/CONTRIBUTING.md#ai-assisted-coding) \ No newline at end of file From 16997b4a6df40eadd6f64ff3f5fc5c5e90112183 Mon Sep 17 00:00:00 2001 From: Paul Hallett Date: Tue, 24 Mar 2026 08:58:39 +0000 Subject: [PATCH 3/3] Update review template, modify contributing --- .github/pull_request_template.md | 17 ++++++++++++++++- CONTRIBUTING.md | 14 ++++++-------- 2 files changed, 22 insertions(+), 9 deletions(-) diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index d9b13f1a2..afe78176d 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -4,4 +4,19 @@ * Consider adding the `no-deploy` label if this PR shouldn't be deployed and does not alter the data served by the API. --> -- [ ] I have read and understood the [AI Assisted Contribution guidelines](https://github.com/PokeAPI/pokeapi/blob/master/CONTRIBUTING.md#ai-assisted-coding) \ No newline at end of file +## Change description + + Add your change description here + +## AI coding assistance disclosure + + Provide details on how you used AI coding to assist you in this change + +## Contributor check list + + + +- [ ] I have written a description of the issue and explained why the fix solves the problem. +- [ ] I have written tests for my code changes. +- [ ] I have read and understood the [AI Assisted Contribution guidelines](https://github.com/PokeAPI/pokeapi/blob/master/CONTRIBUTING.md#ai-assisted-coding). +- [ ] I will own this change in production, and I am prepared to fix any bugs caused by my code change. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 6848b13ea..58b954835 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -28,24 +28,23 @@ Simple! ## AI assisted coding -AI assisted coding that will be accepted: +The types of AI-assisted coding that will be accepted: -- Auto complete - Scaffolding for common framework patterns - Scaffolding for test patternstest generation -- Mass file editing such as tedious repetitive operations +- Mass file editing for tedious repetitive changes -AI changes that will **NOT** be accepted: +The types of AI changes that will **NOT** be accepted: - Fully automated code generation - AI generated comments and responses in code review -- Clear lack of understanding of the change +- Lack of understanding of the change Contributions from supervised AI assisted coding agents who build the majority (or all of) a change, such as [co pilot tasks](https://github.blog/changelog/2025-10-28-a-mission-control-to-assign-steer-and-track-copilot-coding-agent-tasks/), will be accepted only on the following basis: 1. A human can verifiably prove they have reviewed and checked that the contribution does what it says it does. -2. The human author provides evidence of the prompt given to the AI agent, and the logs of it producing the change. (For example - co pilot tasks produces a public log). -3. The human author explicitly calls out that an supervised AI agent created the change when they make a pull request. +2. If requested, the human author must provide evidence of the prompt given to the AI agent, and the logs of it producing the change. (For example - co pilot tasks produces a public log). +3. If requested, the human author explicitly calls out that an supervised AI agent created the change when they make a pull request. 4. The human author is prepared to own the change (just like any other change they make) and fix any issues that arise from it. ### Maintainers decision is final @@ -54,7 +53,6 @@ If you cannot sufficiently demonstrate good use of AI tooling we will close your We contribute to this project in our free time. Our time is valuable. Our time is not to be spent doing the thinking for you because you outsourced work to an LLM coding agent. - ## Financial contributions We also welcome financial contributions in full transparency on our [open collective](https://opencollective.com/pokeapi).