Notes from building ai2.
The thinking behind the system, the occasional deep dive, and the how-tos we wish we had. No filler.
PerspectiveWhy we built an agent-native design system
Most registries are written for humans and merely tolerated by agents. We flipped that: the metadata is written to be read by models, and it is the same metadata people read.
July 12, 20264 min read
Deep diveThe variant matrix, explained
One flat variant list is where design systems quietly break. Three axes, composed, is how the same button covers thirty styles without thirty exceptions.
July 8, 20265 min read
How-toInstall ai2 with the shadcn MCP
Point the shadcn MCP server at the @ai2 registry once, then let your agent search, read and install components on its own.
July 3, 20263 min read


