The design system contract for teams and agents.

Retrieval gives you data. Reconciliation gives you truth.

$npx @ai-by-design/primitiv init
Read the docs

Ingest

From your sources, where they live.

Read via adapters from Figma, Storybook, codebase, token files. Every token traces back — file, line, Figma ID, story ID.

◆
Figmavariables
◫
Storybookcomponents
{ }
Codebasetokens / CSS
primitiv.contract.json
color.primary: #2E5BFFsource: figma

Reconcile

By your rules, not by guessing.

You set sourceOfTruth and onConflict. Primitiv applies them and writes a suggestedFix agents can act on.

◆
Figmavariables
◫
Storybookcomponents
{ }
Codebasetokens / CSS
// primitiv.contract.json
{}

Rationale

Why, when, deprecated.

Agents prefer annotated tokens, refuse deprecated ones, and surface the reasoning.

primitiv.rationale.yml
color.primary.old:
  deprecated: true
  why: "Replaced by color.brand in v2"
  alternatives: [color.brand]

Serve

Any MCP client.

Cursor, Claude Code, Codex, Windsurf, Zed or any tool that speaks MCP. primitiv init writes the per-project config.

// primitiv.contract.json
{}
CursorIDE
Claude CodeCLI
CodexCLI
WindsurfIDE
ZedIDE
get_design_contextget_tokenget_componentget_conflictsget_inferred_rules

Verify

CI-gate on drift.

primitiv verify fails the build when contracts go stale or conflicts sit unresolved.

$ primitiv verify

✖ 2 unresolved conflicts
  • color.primary — figma vs codebase
  • spacing.md   — storybook vs codebase

Exit 2

Get started

Open source

Primitiv

Run locally. Reconcile Figma, tokens, and code. Free forever.

npx @ai-by-design/primitiv init
View on GitHub
Coming soon

Primitiv for teams

Shared contracts, governance, CI/CD. At your organisation's scale.

  • Shared contracts across repos
  • Governance and audit
  • CI/CD pipeline integration
  • Multi-contributor workflows
Join the waitlist