Skip to content

Commit 5f4c68f

Browse files
authored
Add AI-assisted contribution and review policy (#1603) (#1604)
* Add AI-assisted contribution and review policy (#1603) * Normalize project name to xarray-spatial throughout CONTRIBUTING.md
1 parent 2d18207 commit 5f4c68f

1 file changed

Lines changed: 40 additions & 3 deletions

File tree

CONTRIBUTING.md

Lines changed: 40 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# Contributing to Xarray-Spatial
1+
# Contributing to xarray-spatial
22

3-
As stated in [Xarray Spatial code of conduct](https://github.com/xarray-contrib/xarray-spatial/blob/main/CODE_OF_CONDUCT.md), a primary goal of Xarray Spatial is to be inclusive to the largest number of contributors. However, we do have some requests for how contributions should be made. Please read these guidelines before contributing to have a most positive experience with Xarray Spatial.
3+
As stated in the [xarray-spatial code of conduct](https://github.com/xarray-contrib/xarray-spatial/blob/main/CODE_OF_CONDUCT.md), a primary goal of xarray-spatial is to be inclusive to the largest number of contributors. However, we do have some requests for how contributions should be made. Please read these guidelines before contributing to have a most positive experience with xarray-spatial.
44

55
### Getting Started
66

@@ -28,7 +28,7 @@ In order to avoid duplication of effort, it's always a good idea to comment on a
2828

2929
1. Make sure that there is a corresponding issue for your change first. If there isn't yet, create one.
3030

31-
2. Create a fork of the Xarray Spatial repository on GitHub (this is only done before *first*) contribution.
31+
2. Create a fork of the xarray-spatial repository on GitHub (this is only done before *first*) contribution.
3232

3333
3. Create a branch off the `main` branch with a meaningful name. Preferably include issue number and a few keywords, so that we will have a rough idea what the branch refers to, without looking up the issue.
3434

@@ -43,6 +43,43 @@ In order to avoid duplication of effort, it's always a good idea to comment on a
4343
8. We will review your PR as time permits. Reviewers may comment on your contributions, ask you questions regarding the implementation or request changes. If changes are requested, push new commits to the existing branch. Do *NOT* rebase, amend, or cherry-pick published commits. Any of those actions will make us start the review from scratch. If you need updates from `main`, just merge it into your branch.
4444

4545

46+
### AI-Assisted Contribution and Review
47+
48+
xarray-spatial welcomes responsible AI-assisted development and review when it helps contributors move faster, improve quality, and reduce maintainer burden. The project has limited dedicated development capacity, so contributors are encouraged to use AI tools for testing, debugging, feature work, documentation, deployment, and release preparation.
49+
50+
Attribution and responsibility belong to human contributors. Do not add AI tools, coding agents, or AI companies as commit authors, co-authors, reviewers, or attribution lines in commits, pull requests, changelogs, or release notes.
51+
52+
Please avoid attribution such as:
53+
54+
Co-authored-by: Claude <...>
55+
Co-authored-by: ChatGPT <...>
56+
Generated with Claude Code
57+
Generated by Copilot
58+
Reviewed-by: <AI tool>
59+
60+
If AI-assisted code introduces a bug, security issue, regression, or incorrect behavior, the responsible party is the human contributor who submitted and reviewed the change. AI tools may assist the work, but they do not own the work.
61+
62+
#### Review Expectations
63+
64+
Before submitting a pull request, contributors should review and use the relevant commands in:
65+
66+
.claude/commands/
67+
68+
These command markdown files reflect current project expectations for performance, accuracy, security, testing, maintainability, deployment, and release readiness. New contributors should read through them to understand the project's quality standards.
69+
70+
Contributors who do not use Claude Code can adapt the command markdown files into prompts or checklists for their preferred AI tools and review workflows. The important part is the quality review they represent, not the specific tool used to run them.
71+
72+
Where applicable, run the relevant sweep or review commands before requesting maintainer review. If a command flags an issue, either address it or clearly explain why it is acceptable for the current change.
73+
74+
Copilot code review may run on pull requests as automated review assistance. Its feedback is useful, but it does not replace human responsibility or maintainer judgment.
75+
76+
#### Current Priority
77+
78+
The next sprint is focused on stabilizing xarray-spatial for its first major release. Contributors should prioritize bug fixes, reliability, tests, release blockers, and performance, accuracy, or security issues. New features should avoid adding significant release risk unless they are essential.
79+
80+
The preferred contribution style is fast, careful, and human-accountable: use AI aggressively to improve velocity and quality, but keep ownership and attribution with the people contributing to the project.
81+
82+
4683
### Attribution
4784

4885
Portions of text derived from [Bokeh CONTRIBUTING file]: (https://github.com/bokeh/bokeh/blob/branch-3.4/.github/CONTRIBUTING.md)

0 commit comments

Comments
 (0)