---
name: sync-tokens
description: Rebuild CSS and JS outputs from token JSON sources
---

Synchronise design tokens — rebuild CSS and JS outputs from token JSON sources.

Use this after token JSON files have been edited manually or after `/create-tokens`. This is a maintenance command — it does NOT create new tokens (use `/create-tokens` for that).

Use the token-architect agent to handle this task.

**Instructions for the agent:**
1. Read `docs/memory/token-registry.md` to understand current token state
2. Validate all token JSON files have required fields (`$value`, `$type`, `$description`)
3. Run `npm run build:tokens` to regenerate:
   - `src/theme/generated/tokens.css` (CSS custom properties)
   - `src/theme/generated/tokens.js` (JS ES6 module)
   - `tokens/export/tokens-flat.json` (flat JSON export)
4. Check that `src/theme/index.ts` is consuming the generated tokens correctly
5. If any tokens were added/changed since the theme was last updated, update `src/theme/index.ts`
6. Report what was generated and any issues found
7. Update `docs/memory/token-registry.md` if it's out of date