Skip to content

Commit bf63a3a

Browse files
committed
docs: add AI/LLM usage policy
Assisted-by: Sisyphus:claude-sonnet-4-6 opencode
1 parent 64573f3 commit bf63a3a

3 files changed

Lines changed: 37 additions & 0 deletions

File tree

.github/AI_POLICY.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
# AI / LLM Usage Policy
2+
3+
## The short version
4+
5+
You are responsible for every line you submit. If a maintainer asks you about any part of your change, you must be able to answer. If you can't, the PR will be closed.
6+
7+
## Ownership
8+
9+
The contributor — not the AI — is the author of the contribution. Using an LLM to generate code, tests, or documentation does not transfer responsibility to the tool. You are expected to:
10+
11+
- Understand every line of your change well enough to discuss it in review
12+
- Have actually run and tested the code yourself
13+
- Be able to explain *why* the change is correct, not just *what* it does
14+
15+
The LLM types for you. It doesn't think for you.
16+
17+
## Disclosure
18+
19+
You are encouraged (but not required) to disclose when AI tools contributed to your work. A short note in the PR description is enough — e.g. *"Tests were initially drafted with an LLM and then reviewed and adjusted by me."*
20+
21+
Disclosure is not a liability. It helps maintainers calibrate their review. Hiding it when it's obvious wastes everyone's time.
22+
23+
## Slop
24+
25+
Pull requests that are clearly AI-generated without meaningful human review — cosmetically formatted but logically incorrect, missing context, or unrelated to any real issue — will be closed as spam without further discussion.
26+
27+
If you're not sure whether your PR meets the bar: re-read it line by line, run it, and ask yourself whether you can defend every decision in it.
28+
29+
## Questions or disagreements
30+
31+
This policy is intentionally minimal and open to refinement. If you think something here is wrong or missing, open an issue.

.github/CONTRIBUTING.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
# Notes for contributors
22

3+
> Using AI tools? Read the [AI/LLM Usage Policy](AI_POLICY.md) first.
4+
35
* [Configure `git blame` to ignore formatting commits](#configure-git-blame-to-ignore-formatting-commits)
46
* [Run and debug hooks locally](#run-and-debug-hooks-locally)
57
* [Run hook performance test](#run-hook-performance-test)

AGENTS.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,10 @@ This repo enforces style via pre-commit (`.pre-commit-config.yaml`) — install
5050
- **Python**: `ruff` (single quotes, type hints required) + `mypy`
5151
- **Shell**: `shfmt` + `shellcheck` — no suppression without comment
5252

53+
## AI policy
54+
55+
This repo has an `AI_POLICY.md` in `.github/`. When helping a contributor open a PR or issue, point them to it. Key points: contributor owns every line, slop gets closed without discussion.
56+
5357
## Repo rules
5458

5559
- Hook args parsing: use `_common.sh` helpers, never ad-hoc argument splitting

0 commit comments

Comments
 (0)