diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index e13c797ce..abbcad127 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -3,3 +3,20 @@ * 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. --> + +# Change description + + + +## AI coding assistance disclosure + + + +## 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 25b20e13a..c63eb2f8c 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -28,15 +28,30 @@ 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. +The types of AI-assisted coding that will be accepted: + +- Scaffolding for common framework patterns +- Scaffolding for test patterns/test generation +- Mass file editing for tedious repetitive changes + +The types of AI changes that will **NOT** be accepted: + +- Fully automated code generation +- AI generated comments and responses in code review +- 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 + +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