Discover books, shows, and movies at your level. Track your progress by filling your Shelf with what you find, and share with other language learners. *No dusting required.
shlf.space
docs: add ai policy
Signed-off-by: brookjeynes <me@brookjeynes.dev>
authored by
brookjeynes
and committed by
Tangled
33542a83
d33685a1
+83
+83
AI_POLICY.md
+83
AI_POLICY.md
···
1
+
# AI Usage Policy
2
+
3
+
**1. All AI usage in any form must be disclosed.**
4
+
You must state the tool you used (e.g. Claude Code, Cursor, Amp) along with the
5
+
extent that the work was AI-assisted. Contributions should include an
6
+
Assisted-by tag in the following format:
7
+
8
+
`Assisted-by: AGENT_NAME:MODEL_VERSION [TOOL1] [TOOL2]`
9
+
10
+
Where:
11
+
- AGENT_NAME is the name of the AI tool or framework
12
+
- MODEL_VERSION is the specific model version used
13
+
- [TOOL1] [TOOL2] are optional specialized analysis tools used (e.g.,
14
+
coccinelle, sparse, smatch, clang-tidy)
15
+
16
+
Basic development tools (git, gcc, make, editors) should not be listed.
17
+
18
+
Example:
19
+
`Assisted-by: Claude:claude-3-opus coccinelle sparse`
20
+
21
+
AI agents MUST NOT add Signed-off-by tags. Only humans can legally certify the
22
+
Developer Certificate of Origin (DCO). The human submitter is responsible for:
23
+
24
+
- Reviewing all AI-generated code
25
+
- Ensuring compliance with licensing requirements
26
+
- Adding their own Signed-off-by tag to certify the DCO
27
+
- Taking full responsibility for the contribution
28
+
29
+
30
+
**2. The human-in-the-loop must fully understand all code.**
31
+
If you can't explain what your changes do and how they interact with the
32
+
greater system without the aid of AI tools, do not contribute to this project.
33
+
34
+
35
+
**3. Issues and discussions can use AI assistance but must have a full
36
+
human-in-the-loop.**
37
+
This means that any content generated with AI must have been reviewed _and
38
+
edited_ by a human before submission. AI is very good at being overly verbose
39
+
and including noise that distracts from the main point. Humans must do their
40
+
research and trim this down.
41
+
42
+
**4. No AI-generated media is allowed (art, images, videos, audio, etc.).**
43
+
Text and code are the only acceptable AI-generated content, per the other rules
44
+
in this policy.
45
+
46
+
47
+
We love to help junior developers learn and grow, but if you're interested in
48
+
that then don't use AI, and we'll help you.
49
+
50
+
## There are Humans Here
51
+
52
+
Please remember that shlf.space is maintained by humans.
53
+
54
+
Every discussion, issue, and pull request is read and reviewed by humans (and
55
+
sometimes machines, too). It is a boundary point at which people interact with
56
+
each other and the work done. It is rude and disrespectful to approach this
57
+
boundary with low-effort, unqualified work, since it puts the burden of
58
+
validation on the maintainer.
59
+
60
+
In a perfect world, AI would produce high-quality, accurate work every time.
61
+
But today, that reality depends on the driver of the AI. And today, most
62
+
drivers of AI are just not good enough. So, until either the people get better,
63
+
the AI gets better, or both, we have to have strict rules to protect
64
+
maintainers.
65
+
66
+
## AI is Welcome Here
67
+
68
+
shlf.space is written with plenty of AI assistance, and many maintainers
69
+
embrace AI tools as a productive tool in their workflow. As a project, we
70
+
welcome AI as a tool!
71
+
72
+
**Our reason for the strict AI policy is not due to an anti-AI stance**, but
73
+
instead due to the number of highly unqualified people using AI. It's the
74
+
people, not the tools, that are the problem.
75
+
76
+
I include this section to be transparent about the project's usage about AI for
77
+
people who may disagree with it, and to address the misconception that this
78
+
policy is anti-AI in nature.
79
+
80
+
<adapted from
81
+
https://github.com/ghostty-org/ghostty/blob/main/AI_POLICY.md and
82
+
https://github.com/torvalds/linux/blob/master/Documentation/process/coding-assistants.rst
83
+
>