

So Vercel just dropped NextJS 16.2 with loads of really awesome features, but the one that blew my mind was the new AGENTS.md.
It's simple, it's beautiful, and it's going to do exactly what it says on the tin!
So, it kicks off with a cool tip I got from a colleage at Google: use HTML-like tags to group related content. LLMs need extra help with markdown.
Start by telling LLMs, "This is NOT the Next.js you know" steering them away from old data.
Then direct them to node_modules/next/dist/docs/ for the latest info.
Followed up by a clear instruction to read the deprecation notices. As LLMs often gloss over these and lean on training bias.
This is the first time that I've seen agent docs through NPM packages, and I love it. It highlights and starts to combat what I think is the biggest problem with Skills... distribution.
Now dont get me wrong, I love a good skill, just write some markdown in a repo and boom, the npx skills command copies it into your local repo, and you're ready to go.
What skills doesn't do is then keep your skills up-to-date - that's something you have to run manually, and that's what this essentially does.
Great work Guillermo and Team Vercel! Once again showing that innvoation doesn't have to be complex, just smart!
<!-- BEGIN:nextjs-agent-rules -->
# This is NOT the Next.js you know
This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` before writing any code. Heed deprecation notices.
<!-- END:nextjs-agent-rules -->