Skip to content

Establish Automation/AI policy#15984

Open
lisanna-dettwyler wants to merge 1 commit into
NixOS:masterfrom
lisanna-dettwyler:ai-policy
Open

Establish Automation/AI policy#15984
lisanna-dettwyler wants to merge 1 commit into
NixOS:masterfrom
lisanna-dettwyler:ai-policy

Conversation

@lisanna-dettwyler

@lisanna-dettwyler lisanna-dettwyler commented Jun 5, 2026

Copy link
Copy Markdown
Contributor

This is adapted from the nixpkgs policy, but with additional restrictions around authorship of human communication.

Resolves #15340

Motivation

Nixpkgs has already adopted a policy, so we should also have one. Slop communication especially can really take a toll on the team so we should at the very least have a policy addressing that.

Context

#15340
Nixpkgs PR: NixOS/nixpkgs#514587


Add 👍 to pull requests you find important.

The Nix maintainer team uses a GitHub project board to schedule and track reviews.

@github-actions github-actions Bot added the contributor-experience Developer experience for Nix contributors label Jun 5, 2026
Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md Outdated
@xokdvium

xokdvium commented Jun 5, 2026

Copy link
Copy Markdown
Contributor

Just a reminder: let's keep this open for some time to let most of the team chime in on this.

@xokdvium

xokdvium commented Jun 5, 2026

Copy link
Copy Markdown
Contributor

Should we also document the restriction to good-first-issue issues?

@lisanna-dettwyler lisanna-dettwyler force-pushed the ai-policy branch 2 times, most recently from 658d984 to 9a01fba Compare June 5, 2026 19:42
Comment thread CONTRIBUTING.md

Every contribution to Nix and related development venues, including code, documentation, and communication on GitHub and Matrix, must have a responsible person in the loop who is accountable for that contribution and reviews it before submission, and must transparently disclose any non‐trivial use of automation to produce it, including but not limited to LLM‐based AI tools.

Human communication must remain human. Pull request / issue descriptions and comments, documentation, commit messages, and code comments must be human-authored.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Might be worth clarifying that typo/grammar checking is of course automatable (it's large Language models after all).

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Amended the exemptions section with a mention of this.


- [ ] checked [latest Nix manual] \([source])
- [ ] checked [open bug issues and pull requests] for possible duplicates
- [ ] reviewed the [contributing guide]

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should this lead to the AI policy instead? It might be a bit confusing to ask people to look at contributing docs when filing issues/bugreports

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think so, the first sections in the contributing guide are actually about reporting bugs and security vulnerabilities, so it seems relevant.

@lisanna-dettwyler

Copy link
Copy Markdown
Contributor Author

My concern with this is that no one is going to read it and we're going to have to remind people to go look at it whenever violations happen. Should we put an attestation checkbox in the PR template like what nixpkgs does, or is that overkill?

Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md Outdated
This is adapted from the [nixpkgs policy](https://github.com/NixOS/nixpkgs/blob/master/CONTRIBUTING.md#automationai-policy),
but with additional restrictions around authorship of human
communication.

Resolves NixOS#15340

Signed-off-by: Lisanna Dettwyler <lisanna.dettwyler@gmail.com>
Comment thread CONTRIBUTING.md

All covered use of automated tooling for a contribution must be disclosed as part of that contribution.

In the case of LLM‐based AI tooling used for commits, this **must** be in the form of an `Assisted-by:` Git commit trailer, including at least the tool name and the primary model name and version used for the contribution.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Since we also have a few Anthropic contributors in our community, they might be not always allowed to disclose what exact model they are using. But I suppose they could also just provide the name of the latest released model?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good question whether using the released version for the final implementation to be submitted is a strong constraint or not really anymore (in the sense of using an undisclosed model to find relevant places and check that the change is doable, then ask the released model to do the final patch by doing this and that change in that place — this would only ask for the released model version under the policy, as far as I can tell).

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think for that it's simply okay to specify that they're using an unreleased model, I can clarify this.

@Mic92 Mic92 Jun 23, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So Anthropic policy is to put in something like this: Assisted-by: Claude:unspecified and requires all LLM-generated commits to be pushed manually after reviewing.

@nixos-discourse

Copy link
Copy Markdown

This pull request has been mentioned on NixOS Discourse. There might be relevant details there:

https://discourse.nixos.org/t/seeking-community-input-on-ai-usage-policy-for-nix/78230/1

@domenkozar

Copy link
Copy Markdown
Member

I'd reconsider stance on using AI to generate comments, they should be disclosed just as code that they are written with assisted by, but if AI can write code it can also write English explanation of why things work they way they do, same as commit messages.

The tricky part is to see people spamming things, but we're also losing a way to do mass triage of issues against code, etc.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

contributor-experience Developer experience for Nix contributors

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add AI usage policy to CONTRIBUTING.md

8 participants