Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
58 changes: 58 additions & 0 deletions AI_POLICY.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
## AnkiDroid AI Tool Use Policy

We expect that contributors will provide a net benefit to AnkiDroid over time, in return we offer
mentorship and guidance.

AI generated contributions are nullifying our mentorship efforts by consuming guidance meant for
humans and shifting the responsibility of ensuring correctness onto our code reviewers.

This policy aims to:

* Ensure contributors can contribute without AI assistance.
* Provide reviewers with a framework to block contributions which do not benefit AnkiDroid.
* Ensure mentors are mentoring people, not AI output.

### New Contributors

Before you have 3 merged pull requests, you may **not** use any AI tools to produce contributions
for AnkiDroid.
This includes code, documentation, and GitHub comments (including spelling and grammar corrections).

If a reviewer suspects that **any** part of a contribution is produced with AI tools, a warning will
be issued. Pull requests may be closed at the reviewer's discretion.

You may be banned from the repository if this occurs a second time.

### Contributors

* You **must** be able to explain all your contributions.
* AI tools **should not** be used to produce GitHub comments, including filling in the pull request
template.
* Contributions that make nontrivial use of AI tools **must** be labelled, with the tool version.

**Commit messages** **must** use the `Assisted-by:`
[git trailer](https://git-scm.com/docs/git-interpret-trailers#_description) with an explanation
of the contributions in the description.


```
docs: example title

[Optional commit description]

GPT-5.2 implemented `complexMethod`

Assisted-by: GPT-5.2
Assisted-by: Claude Opus 4.5 [Proofreading/grammar]
```

**GitHub comments** **must** use the `> [!NOTE]`
[alert](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts).

```md
> [!NOTE]
> The following table was generated using Claude Opus 4.5
```
produces:
> [!NOTE]
> The following table was generated using Claude Opus 4.5
11 changes: 11 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,17 @@ Discord is great for real-time/casual conversations. Records of the outcomes of
discussions should be copied to the relevant PR/issue (ideally linking to the Discord message).
It's not expected that Discord history will be permanently retained.

## AI Policy

> [!CAUTION]
> Using AI tools as a new contributor will result in moderator action.

New contributors **may not** use any AI tools to produce contributions for AnkiDroid. This includes
code, documentation, and GitHub comments (including spelling and grammar corrections).

See our [AI policy](AI_POLICY.md) for when these restrictions are lifted from your account, and why
they exist.

## Selecting an issue [[GitHub Search](https://github.com/ankidroid/Anki-Android/issues?q=is%3Aissue%20state%3Aopen)]

If you are starting out with open source, we recommend starting with: [#13282: Fix Android Studio Warnings](<https://github.com/ankidroid/Anki-Android/issues/13282>).
Expand Down