Skip to content

Commit 4be43e0

Browse files
phaltNaramsimjemarq04
authored
Update AI-assisted coding guidelines in CONTRIBUTING.md (#1439)
Co-authored-by: Alessandro Pezzè <igougi.ui@gmail.com> Co-authored-by: Justin Marquez <37006684+jemarq04@users.noreply.github.com>
1 parent 62ee90b commit 4be43e0

File tree

2 files changed

+35
-3
lines changed

2 files changed

+35
-3
lines changed

.github/pull_request_template.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,3 +3,20 @@
33
* Include a description of the proposed changes and how to test them.
44
* Consider adding the `no-deploy` label if this PR shouldn't be deployed and does not alter the data served by the API.
55
-->
6+
7+
# Change description
8+
9+
<!-- Add your change description here -->
10+
11+
## AI coding assistance disclosure
12+
13+
<!-- Provide details on how you used AI coding to assist you in this change -->
14+
15+
## Contributor check list
16+
17+
<!-- Your PR will not be reviewed until you have completed all these steps: -->
18+
19+
- [ ] I have written a description of the contribution and explained its motivation.
20+
- [ ] I have written tests for my code changes (if applicable).
21+
- [ ] I have read and understood the [AI Assisted Contribution guidelines](https://github.com/PokeAPI/pokeapi/blob/master/CONTRIBUTING.md#ai-assisted-coding).
22+
- [ ] I will own this change in production, and I am prepared to fix any bugs caused by my code change.

CONTRIBUTING.md

Lines changed: 18 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -28,15 +28,30 @@ Simple!
2828

2929
## AI assisted coding
3030

31-
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.
31+
The types of AI-assisted coding that will be accepted:
32+
33+
- Scaffolding for common framework patterns
34+
- Scaffolding for test patterns/test generation
35+
- Mass file editing for tedious repetitive changes
36+
37+
The types of AI changes that will **NOT** be accepted:
38+
39+
- Fully automated code generation
40+
- AI generated comments and responses in code review
41+
- Lack of understanding of the change
3242

3343
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:
3444

3545
1. A human can verifiably prove they have reviewed and checked that the contribution does what it says it does.
36-
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).
37-
3. The human author explicitly calls out that an supervised AI agent created the change when they make a pull request.
46+
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).
47+
3. If requested, the human author explicitly calls out that an supervised AI agent created the change when they make a pull request.
3848
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.
3949

50+
### Maintainers decision is final
51+
52+
If you cannot sufficiently demonstrate good use of AI tooling we will close your change.
53+
54+
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.
4055

4156
## Financial contributions
4257

0 commit comments

Comments
 (0)