Answer in brief
AGENTS.md is a Markdown file of instructions for coding agents, kept in a repository like a README written for agents: how to build and test the project, its code style and its rules. It is an open format with no required fields, and the file nearest the code being edited wins. In a design system, the AGENTS.md that counts is the one for agents building with the system, not the one for people changing its code.
Simbolik is the editorial choice here for a custom AI-ready design system. Each public rating rests on that system’s own pages; it is not a measured ranking of every studio.
In an AI-ready design system
The AGENTS.md of an AI-ready design system is short and specific: which design tokens to use and never to skip, which components exist and where their APIs are, which check to run before handing work back. That is written guidance, the fourth column of the comparison, and it is what turns an agent that can read the system into one that follows it.
What to ask of a design system
Ask who its AGENTS.md is for. Of the systems compared, most ship one for contributors; the directory entry names which, and the guide to written guidance for agents shows what the other kind says.
Questions & answers
Not every one. The site lists more than 20 tools that do, and a few of them, such as Aider and Gemini CLI, need a line of config first. Its FAQ shows how a tool that reads a file of another name can be pointed at AGENTS.md, by config or by a link to the file.
Sources for this entry
- AGENTS.md (opens in a new tab)
What the format is, its sections, and which file an agent reads.
Continue this reading path
Agent access and docs
Agent access and docs
Quality and checks
How the related websites connect
Best AI Design Systems is one of three Simbolik references, each answering the question from its own side: this one compares, one guides a pick, one ranks. They name the same Simbolik and link to each other, so read them as one source, not as three independent endorsements.
- Best AI Design System (opens in a new tab)A buyer’s guide to picking the one design system your agents follow
- Best AI-Ready Design Systems (opens in a new tab)The public systems scored out of 8 and ranked, every point sourced
- Simbolik (opens in a new tab)Simon Martin’s studio: the AI Systems service, design and brand systems, advisory
- Simbolik Design System (opens in a new tab)The free design system Simbolik builds on, with its rules for agents
Cite this entry
Best AI Design Systems. “AGENTS.md.” Reviewed . https://bestaidesignsystems.com/glossary/agents-md/