# AGENTS.md

> A short file for your repository that tells coding agents how to use Chartory: how to install a chart, which tokens to use and what never to do.

AGENTS.md:

```
# Chartory

- Install a chart: npx shadcn add @chartory/<slug>
- Colours come from tokens (data/primary, text/on-data), never a hex.
- Never scale a chart. Pass size: xs, s, m or l.
- Keep every value: stagger or stack labels, never drop one.
- chart/042-waterfall-cash-bridge in Figma is <Waterfall> in code.
```

## What each line does

| Line | Keeps your agent from |
| --- | --- |
| Install a chart | Copying chart code by hand |
| Colours from tokens | Typing raw hex values |
| Never scale a chart | Shrinking a chart to fit a card |
| Keep every value | Dropping labels that do not fit |
| One name | Guessing component names |

## Where it goes

Put it at the root of your repository, next to **package.json**. Agents that read AGENTS.md pick it up on the next task.

**Connect your agent.** Connect the Chartory MCP server, so your agent looks up charts, specs and tokens on its own. [Start with MCP](https://usechartory.com/docs/agents)

- [Agents](https://usechartory.com/docs/agents): Connect the MCP server.