Skip to content
Open
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
62 changes: 62 additions & 0 deletions AI_POLICY.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
# AI Policy for holochain-serialization

If you plan to contribute to holochain-serialization using AI tools, you **must** read,
understand and follow this policy.

The maintainers of this project support using AI (i.e., LLMs) as tools for coding,
however we don't want to interact directly with bots. We hold a high
bar for all contributions to our projects. Thus, contributions must come from a human
who understands the submitted code or text, can explain it, and is responsible for
its quality as if they wrote it themselves. Using AI as a tool to help you write
or reason about a contribution is fine; submitting AI output you don't understand,
or relaying messages between a maintainer and an AI, is not.

If you wish to include context from an interaction with AI in your comments, it
must be in a quote block (e.g., using `>`) and disclosed as such. It must be
accompanied by human commentary explaining the relevance and implications of
the context.

## Disclosure

You **must** disclose any significant use of AI tools in your contributions, i.e.
tell us if an AI tool generated or substantially shaped the content
you submit — code, prose or commit messages — including agents, chat assistants
and AI-assisted editors. Mechanical editor autocompletion of a few characters
does not need to be disclosed; if in doubt, disclose.

## Translations

AI is useful when communicating as a non-native English speaker. If you are
using AI to edit your comments for this purpose, please take the time to ensure
it reflects your own voice and ideas.

## Provenance and licensing

You are responsible for the provenance of anything you submit. AI tools can
reproduce code or text from their training data verbatim, which may carry a
license incompatible with this project. By contributing, you confirm the work
is yours to submit under the project's license and does not infringe a third
party's rights. This is the same standard that applies to code you write by hand.

## Consequences

Violating this policy is likely to get your contribution rejected and, for repeated or
egregious violations, get you blocked from the project without further warning.

## Examples

Examples of things that will get your PR closed:

- Point an agent to a GitHub issue, ask it to solve the issue and open a PR,
without understanding the issue, the PR, or testing the solution yourself.
- Copy responses from the AI (or having it post directly because it has your credentials) when replying to questions from maintainers,
without understanding the question or the response.
In other words, you should not just be a go-between for
the reviewer, and the AI tool.

## Inspiration

This AI policy was inspired by:

- [release-plz](https://github.com/release-plz/.github/blob/main/AI_POLICY.md)
- [astral](https://github.com/astral-sh/.github/blob/c5187e200db51bfe11d56e13053d29bd3793fdd8/AI_POLICY.md)
5 changes: 5 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,6 +58,11 @@ them clean. To help with keeping them clean, follow these principles:
consistent with the existing codebase and/or it does not solve the problem it
claims to, then we will close the PR without comment.

## AI Policy

If you use AI tools in any part of your contribution, you must read,
understand, and follow our [AI Policy](./AI_POLICY.md).

## Reporting Issues

- Use GitHub Issues to report bugs or request features.
Expand Down