I Shipped an npm Package With an AGENTS.md File — Here's Why Every Library Should Do This

Last week I published shimmer-trace, a React skeleton loader that traces your real DOM and paints a pixel-perfect shimmer over it. No manual skeletons. One-line wrap. Zero CLS. But this post isn't about the shimmer. It's about a small file I shipped alongside it that I think is going to become a standard: AGENTS.md — a README written for AI agents, not humans. The Problem: Your README Is Lying to the LLM In 2026, more than half the people "reading" your library docs aren't peopl...