AGENTS.md: A new file is taking over GitHub

Already in 20,000+ repos, it’s basically the README.md for AI coding agents.

README.md → for humans (intro, contribution guide, quick start)
AGENTS.md → for AI (setup commands, testing workflows, coding style, PR rules)

By separating this context, devs keep READMEs clean while giving agents structured, machine-readable instructions. 

It works across tools like Codex, Jules, Cursor, Aider, and Zed – and even scales to monorepos.

Fans love it: simple Markdown, no lock-in.
Skeptics worry: it splits docs between humans and machines.

Either way, AGENTS.md feels a lot like README.md in its early days – simple, obvious, and maybe foundational for human–AI collaboration in coding.

What do you think: 

Is AGENTS.md the next open-source convention, or just another file cluttering repos?  

The most up-to-date AI + Gen AI Coaching for senior IT professionals

In case you are looking to learn AI + Gen AI in an instructor-led live class environment, check out these courses

Happy learning!

If you have any queries or suggestions, share them with me on LinkedIn – https://www.linkedin.com/in/nikhileshtayal/

Let’s learn to build a basic AI/ML model in 4 minutes (Part 1)