v0.1.2 · AI-First Codebase Standard

Continuous repository scoring for teams shipping with AI.

Clarx measures how safely and efficiently an AI agent can navigate, modify, and verify changes in your repository — across five pillars, 25 rules, with scores that improve over time.

Authored intent
<Button intent="destructive" emphasis="high" > Delete project </Button>
<button className="px-4 py-2 bg-red-600 text-white text-sm rounded-md hover:bg-red-700 font-medium" > Delete project </button>
Rendered behavior
Destructive · high emphasis
Destructive · low emphasis
Status · pendingReviewing
Status · readyDeployed
Agent · streamingGenerating
01 — Philosophy

UI is communication before decoration. A component exists to communicate meaning: status, urgency, confidence, availability, next action, system state.

01

Intent over instruction

Developers should say what something means, not reconstruct its appearance from utility classes. The API encodes intent, appearance, priority, state, and role.

02

Centralized visual decisions

Color, spacing, weight, and motion still matter — they should be decided in the design system, not improvised again at every callsite.

03

Legible to humans and machines

A good component API is no longer just ergonomic for engineers. It must also be unambiguous to AI tools generating or modifying UI.

04

Built to survive change

Interfaces, platforms, and implementation methods keep changing. The durable layer is meaning. Systems built around intention adapt better than systems built around frozen visual recipes.

02 — Communication

Design systems are communication systems. The communication happens on three levels.

01

Product → User

Components communicate status, urgency, and the next available action without requiring the user to decode visual language each time.

RENDERED INTERFACE
02

Design ↔ Engineering

A shared vocabulary — intent, emphasis, role, state — replaces drift between Figma libraries and frontend code.

SHARED VOCABULARY
03

Humans ↔ AI

Semantic props are easier for models to use correctly than scattered visual overrides. Intent travels well across abstraction layers.

MACHINE-READABLE INTENT
03 — Primitives

A small set of components that say what they mean. Buttons, badges, alerts, status indicators — and a layer of AI-native primitives for chat, tool calls, and agent state.

<Button intent="primary" emphasis="high" size="md" > Continue </Button>

Buttons take intent (primary, secondary, destructive), emphasis (high, medium, low), and state (idle, loading, disabled). The system resolves visuals.

Live preview

— Manifesto

“This is destructive.” “This is pending.” “This should be subtle.” Those are the decisions that should live in the API.

FRAMEWORK AGNOSTIC ·
ReactVueSvelteSolidWeb Components
CLAUDE.md.cursor/rulesAGENTS.md

Start scoring your repos.

Install the CLI, run your first scan, connect to CI.

$npm install -g @clarxai/cli