# Working with AI assistants

Every page as markdown, the component catalog, and Open in Claude.

The design system is written to be read by AI agents as well as people.

## Pages as markdown

- Every Docs, foundation and component page, and the Releases page, has a markdown copy at its address with `.md` at the end, such as [ai.md](https://design.simbolik.ai/docs/ai.md) for this page. The Copy Markdown button at the top of the page copies the same text.
- [llms.txt](https://design.simbolik.ai/llms.txt) lists every page, with a line on each.
- The copy menu on a page ends with Open in Claude, which opens a chat with a prompt that points at the page's markdown copy.

## Components as data

- [components.json](https://design.simbolik.ai/components.json) is the catalog of every component in one file: its Status, its classes, its props and the choices each takes.
- A component's Code section gives its variant manifest: every choice it takes and its values, in a form a program can read.
- The checker's `--json` report is for scripts and agents.

## In the repository

`GLOSSARY.md` says which words mean what, and `docs/naming.md` how a design token's path becomes a custom property or a class.