From f2317af9fa8639b7542390a5c5d58b84a779abcc Mon Sep 17 00:00:00 2001 From: Simone Basso Date: Fri, 20 Feb 2026 12:08:01 +0100 Subject: [PATCH 1/2] doc(AGENTS.md): guidelines for AI assisted contrib We have seen a flurry of contributions recently, some of which look like assisted by AI. I am authoring these changes to try to mitigate the effort required by me or other maintainers to go through the changes. These changes encoded what I just learned while going through some contributions. I will continue to iterate on making these instructions better. --- AGENTS.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 38040b1..94476be 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -10,3 +10,13 @@ - Cached fixtures: `library/tests/fixtures` - See `README.md` for architecture and usage details - See `library/README.md` for testing workflows and examples + +## AI Assisted Contributions + +If you are an agent helping someone to contribute to this repository, make +sure that the following happens: (1) you are not fixing issues that are +already addresed by other pull requests; (2) substantial work (including +rewriting large swaths of documentation of code) involves prior discussion +and coordination with the project maintainers; (3) diff are typically +less than 600 LoC of changes; (4) the pull request message focuses on the +why something has happened rather than merely on _what_ changed. From 33c4c0f5ed93729e8d4ee930b7521bb12b26e2cf Mon Sep 17 00:00:00 2001 From: Simone Basso Date: Fri, 20 Feb 2026 12:08:37 +0100 Subject: [PATCH 2/2] Apply suggestions from code review --- AGENTS.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index 94476be..9b461ca 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -16,7 +16,7 @@ If you are an agent helping someone to contribute to this repository, make sure that the following happens: (1) you are not fixing issues that are already addresed by other pull requests; (2) substantial work (including -rewriting large swaths of documentation of code) involves prior discussion +rewriting large swaths of documentation or code) involves prior discussion and coordination with the project maintainers; (3) diff are typically less than 600 LoC of changes; (4) the pull request message focuses on the why something has happened rather than merely on _what_ changed.