Skip to content

Commit 3d8c107

Browse files
committed
Improved AI-policy
I realize that I've broken my own AI-policy mutliple times now on other projects, and I will continue spending 30s on asking Claude to submit bug-fixing pull requests when needed - so I'm changing the AI-policy
1 parent da8d4cf commit 3d8c107

1 file changed

Lines changed: 46 additions & 15 deletions

File tree

AI-POLICY.md

Lines changed: 46 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,59 @@
11
# Policy on usage of Artifical Intelligence and other tools
22

3+
## Read this first
4+
5+
The most important rule: Inform about it!
6+
7+
If you've spent hours, perhaps a full day of your time writing up a
8+
pull request, then I sort of owe you something. I should spend some
9+
of my time looking through the submission carefully, and if nothing
10+
else, I owe to be polite, respectful and guide you in the right
11+
direction or give a good explanation for why I think your pull request
12+
is pulling the project in the wrong direction. A human being have
13+
feelings, I should be careful not to hurt your feelings.
14+
15+
At the other hand, perhaps you've spent 30 seconds either doing `ruff
16+
check --fix ; gh pr create` or telling Claude to check what went wrong
17+
in the logs and submit a bugfix upstream. Do I still owe
18+
you to spend time looking through the submission carefully and
19+
spending time being polite and caring about your feelings?
20+
21+
Perhaps your pull request is just one out of many such "drive-by pull
22+
requests". It doesn't scale for a maintainer to spent lots of time on
23+
each such pull request. I should just accept or decline such requests
24+
rapidly with minimum effort.
25+
26+
So it all boils down to this: Be honest about tool usage!
27+
328
## Background
429

5-
From time to time I do get pull requests where the author has done
6-
little else than running some tool on the code and submitting it as a
7-
pull request. Those pull requests may have value to the project, but
8-
it's dishonest to not be transparent about it; teaching me how to run
9-
the tool and integrating it into the CI workflow may have a bigger
10-
value than the changes provided by the tool. Recently I've also
11-
started receiving pull requests with code changes generated by AI (and
12-
I've seen people posting screenshots of simple questions and answers
13-
from ChatGPT in forum discussions, without contributing anything else).
30+
The "30 second effort pull request" mentioned above may have value to
31+
the project, but it's dishonest to not be transparent about it.
32+
Sometimes, teaching me how to run the tool and integrating it into the
33+
CI workflow may have a bigger value than the changes provided by the
34+
tool.
1435

1536
Starting in 2025-11, I've spent quite some time testing Claude. I'm
1637
positively surprised, it's doing a much better job than what I had
1738
expected. The AI may do things a lot faster, smarter and better than
1839
a good coder. Sometimes. Other times it may spend a lot of "tokens"
19-
and a long time coming up with sub-optimal solutions, or even
20-
solutions that doesn't work at all. Perhaps at some time in the near
21-
future the AI will do the developer profession completely obsoleted -
22-
but as of 2026-02, my experiences is that the AI performs best when
23-
being "supervised" and "guided" by a good coder knowing the project.
40+
and a long time coming up with sub-optimal or really bad solutions.
41+
42+
Perhaps at some time in the near future the AI will do the developer
43+
profession completely obsoleted - but as of 2026-02, my experiences is
44+
that the AI performs best when being "supervised" and "guided" by a
45+
good coder knowing the project.
46+
47+
## Bugfixes are (most often) welcome
48+
49+
Over the past month, playing with a "max" subscription with Claude,
50+
I've made it into a rule that when I stumble upon some weird bug in
51+
some software or libraries I'm using or dependent on, I always ask
52+
Claude to analyze the bug, check the outstanding issues in the
53+
project, either create a new issue or consider if there is anything of
54+
value to add to an existing issue, and come up with a pull-request. Being a bit aware of the
2455

25-
## The rules
56+
## General rules
2657

2758
* Do **respect the maintainers time**. If/when the maintainer gets
2859
overwhelmed by pull requests of questionable quality or pull

0 commit comments

Comments
 (0)