Skip to content

WIP + POC: Add AGENTS.md#4680

Draft
seisman wants to merge 3 commits into
mainfrom
agentsmd
Draft

WIP + POC: Add AGENTS.md#4680
seisman wants to merge 3 commits into
mainfrom
agentsmd

Conversation

@seisman

@seisman seisman commented Jun 15, 2026

Copy link
Copy Markdown
Member

Initial draft done by codex.

Address #4677

@seisman seisman added the maintenance Boring but important stuff for the core devs label Jun 19, 2026
Comment thread AGENTS.md

## Maintainer and Release Context

Most agents should not perform maintainer-only operations unless explicitly asked.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Should this explicitly list the maintainer-only operations that are forbidden? I'm assuming the intent is to keep agents from submitting PRs without human oversight?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

First of all, the current version of the AGENTS.md file was generated entirely by Codex, so some wording may not be ideal.

I actually think it's fine to let agents make whatever changes they consider appropriate. The responsibility is then on us, as maintainers, to carefully review the resulting PRs and merge them manually.

@willschlitzer willschlitzer Jun 27, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

My concern is that agents will begin sending in excessive PRs that aren't necessarily constructive; I obviously don't think it will be as bad as on really popular packages like curl, but I think that agent-submitted PRs could lead to extra work for volunteer maintainers.

In my own experience with using AI to suggest code improvements, I find that it makes a lot of style suggestions that don't actually fix bugs, add features, or meaningfully improve documentation without more specific direction. My concern is that there would be PRs that would simply suggest renaming variables/functions or other similar changes that would take away from reviewers' time.

Also, as someone who came into open-source development by finding the low-hanging fruit on a PyGMT, my concern is that agents will consume all of the fixes that used to be tagged as "good first issue" and limit the chances for newcomers to the project to meaningfully contribute without extensive experience.

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

Labels

maintenance Boring but important stuff for the core devs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants