Skip to content

contributing: Add more human responsibility in AI use#7120

Open
wenzeslaus wants to merge 3 commits intoOSGeo:mainfrom
wenzeslaus:promote-human-responsibility-in-ai-usage-and-policy
Open

contributing: Add more human responsibility in AI use#7120
wenzeslaus wants to merge 3 commits intoOSGeo:mainfrom
wenzeslaus:promote-human-responsibility-in-ai-usage-and-policy

Conversation

@wenzeslaus
Copy link
Member

This modifies the agent and contributing instructions to back the code in the change and also pre-review the code before submitting it. While the contributing file already has instructions for taking responsibility, this add explicit ask for reviewing your own code before submitting.

For the agent instructions, this pushes the agent more to do a review by including explicit instructions. The policy section and these instructions are moved to the top to increase the chances that the agent will pick them up and consider them, and are also formulated more as instructions in imperative (rather than policy). I'm doing the move because Claude was not picking up the instructions anymore even when asked after the file became longer.

The no-AI-co-author instructions is now more connected with the acknowledge instruction hopefully providing more clarity to the intention.

This modifies the agent and contributing instructions to back the code in the change and also pre-review the code before submitting it. While the contributing file already has instructions for taking responsibility, this add explicit ask for reviewing your own code before submitting.

For the agent instructions, this pushes the agent more to do a review by including explicit instructions. The policy section and these instructions are moved to the top to increase the chances that the agent will pick them up and consider them, and are also formulated more as instructions in imperative (rather than policy). I'm doing the move because Claude was not picking up the instructions anymore even when asked after the file became longer.

The no-AI-co-author instructions is now more connected with the acknowledge instruction hopefully providing more clarity to the intention.
@github-actions github-actions bot added docs markdown Related to markdown, markdown files labels Feb 25, 2026
AGENTS.md Outdated
Comment on lines +10 to +13
comments, and commit messages should anticipate these questions — not by
adding explanatory fluff, but by making the code itself clear and
well-reasoned. If a line cannot be justified, change or remove it rather
than inventing a rationale for keeping it.
Copy link
Member

Choose a reason for hiding this comment

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

I've read that we should avoid negative examples, and direct instructions are better respected. I assume it can mix up what to do. Here, there's a couple of "negative" that might be better to be direct? To try, as I don't really use these kinds of tools yet. I only myself did some kind of traditional machine learning/deep learning just before LLMs exploded, so I see the (mathematical) reasoning in terms of RNN and attention.

Copy link
Member Author

Choose a reason for hiding this comment

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

Improved in f7fe1d4

@echoix
Copy link
Member

echoix commented Mar 6, 2026

@wenzeslaus is it ready?

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

Labels

docs markdown Related to markdown, markdown files

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants