Proposal: AGENT.md to improve PR quality

Hi,

If AI-assisted PRs that ignore project guidelines start being generated at scale, there’s a concern that maintainer review time could be wasted.

One idea is to introduce a simple AGENT.md . Initially, it could stay minimal, for example:

  • Follow Issue/PR templates
  • Read CONTRIBUTING.md, xxx.md, xxx.md, …
  • Run tests and verify the fix in local before making PR

If agents repeatedly submit PRs that ignore these, it may be worth considering closing them early.
Any thoughts?

2 Likes

Hey @witchcraze I think this is a great idea. It seems like the guidance for what to add to AGENTS.md is changing daily, but I think we should definitely add something to help make sure basic things are being done like you’ve mentioned here. I think we could have some links to different topic READMEs for sure, information about most common parts of the code organization, binary classifier testing and other things that hopefully will let the agents get better context to do the right thing the first time. We are definitely looking for ways to reduce our maintenance burden on the contribution side. I’ll try to give this some thought, or feel free to submit a PR with any ideas you have and we can move the discussion of any details there.

1 Like