diff --git a/.changeset/docs-ai-contribution-policy.md b/.changeset/docs-ai-contribution-policy.md new file mode 100644 index 000000000..85e1cc88a --- /dev/null +++ b/.changeset/docs-ai-contribution-policy.md @@ -0,0 +1,5 @@ +--- +default: docs +--- + +Update PR template to add AI disclosure level. diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md index d481c26ba..1e8cffc2c 100644 --- a/.github/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -1,4 +1,4 @@ - + ### Description @@ -13,6 +13,15 @@ Fixes # - [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected) - [ ] This change requires a documentation update +#### AI assistance level + + + +- [ ] **None** — No AI tools were used +- [ ] **Research only** — AI used for research, brainstorming, or understanding existing code; no generated code included +- [ ] **AI-assisted** — AI suggested code or logic that I reviewed, tested, and understand fully; I can explain every change +- [ ] **Primarily AI-generated** — The majority of code was AI-generated; I have thoroughly reviewed it, verified correctness, and made it my own + ### Checklist: - [ ] My code follows the style guidelines of this project diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index c417e2071..3da5a3b0c 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -47,7 +47,7 @@ Also, we use [ESLint](https://eslint.org/) for clean and stylistically consisten If your change touches logic with testable behaviour, please include tests. See [docs/TESTING.md](./docs/TESTING.md) for a guide on how to write them. -## Restrictions on Generative AI Usage +## Generative AI Usage We expect and appreciate authentic engagement in our community. @@ -59,6 +59,8 @@ Make sure you have added value based on your personal competency to your contrib Maintainers may close issues and PRs that are not useful or productive, including those that are fully generated by AI. If a contributor repeatedly opens unproductive issues or PRs, they may be blocked. +When opening a pull request, disclose your level of AI use using the checklist in the PR template. This isn't gatekeeping — it's transparency that helps reviewers calibrate their review depth. A heavily AI-generated PR will get more scrutiny; that's expected and fine. + ## Release notes and versioning (Knope) We use [Knope](https://knope.tech/) with the Knope GitHub Bot to manage change documentation and releases. The workflow configuration lives in [`knope.toml`](./knope.toml).