&w=3840&q=75)
Mind Blowing Simplicity
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.
<!-- 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 -->It's simple, it's beautiful, and it's going to do exactly what it says on the tin!
How does it work?
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.
Why does it work?
There's a few tricks to this, firstly dropping it into AGENTS.md is great for platforms like Cursor (which indexes pretty much everything) and OpenCode which prompts the LLMs to reference it.
You've got a reference in CLAUDE.md to steer Claude Code to look at AGENTS.md, and the rest is pretty self explanatory.
I cant tell you how many times LLMs have tried to generate NextJS 15.x code, or once even Pages router (remember that?).
Conclusion
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!
