Skip to content
Docs / Private guides

Private guides

A private guide is your brand in the same shape as Astron's public guides: tokens, typefaces and written rules. Inside your workspace, agents prefer it over the public library.

Available on Pro and Team. On Team, private guides are shared with every seat. Compare plans.

File format

A guide is one astron.guide.json file. Rules are plain sentences; write them the way you would brief a new designer.

astron.guide.jsonjson
{
  "slug": "ledgerly",
  "title": "Ledgerly",
  "extends": "editorial-saas",
  "tokens": {
    "ink": "#0b0b0c",
    "accent": "#f2542d",
    "radius": [12, 16, 20],
    "font": { "sans": "Geist", "mono": "Geist Mono" }
  },
  "rules": [
    "Amounts always use tabular figures and a currency code.",
    "Destructive actions are text buttons, never filled red.",
    "Empty states show the single action that fills them."
  ]
}

Upload

From the dashboard, open Guides and drop the file in. Or use the CLI in CI so the guide tracks your repository:

Terminal
npx @astron/mcp guide push ./astron.guide.json

How agents choose

  • With a private guide in the workspace, get_design_guide returns it for every kind of screen.
  • Rules from extends apply unless your guide overrides them.
  • Pass guide explicitly to use a public guide for one call.