AI-Readiness Standard for Codebases

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 — five pillars, 27 rules, and a score that says what it is, what it is not, and what it could not evaluate.

What the repo declares
// clarx-manifest.json { "generated": ["dist", "src/gen"], "verificationCommands": ["pnpm test"], "thresholds": { "maxFileLines": 500 } }
// what agents get without it no CLAUDE.md, no manifest 923-line page component generated dirs look hand-written → agents edit blind
What the scan reports
AI-readiness83 / 100
Fix firstC2 · caps score at 65
Not evaluatedB1, C3–C6 · no JS/TS graph
ConfidenceHigh · manifest present
Scan · running27 rules · 5 pillars
01 — What the score means

A score is a claim. It should defend itself. AI-readiness measures how easily an AI agent can navigate and safely edit your repo — not code quality, security, or correctness.

01

Agent ergonomics, nothing else

The number answers one question: can an agent find its way, stay inside boundaries, and verify its own changes here? It never pretends to audit quality or security.

02

Declared thinness reads as integrity

Rules that cannot run on your stack are reported as not evaluated, never silently passed. A Python repo sees exactly which import-graph checks did not apply — and they never move the score.

03

Every threshold has a rationale

All numeric limits ship with written reasoning and can be overridden per repo in clarx-manifest.json. When you tune one, reports render the active value — tuned repos read honestly.

04

Hard failures cap, not obliterate

Blocking issues impose a graduated score floor and a fix-first list that names the cap each one carries — so the path from 65 back to 90 is explicit, not mysterious.

02 — The system

One standard, three layers. An open specification, local tooling, and a hosted workflow.

01

The Standard

Five pillars — discoverability, boundary clarity, context efficiency, operational guidance, edit safety — measured by 27 rules. Public, versioned, and language-agnostic.

OPEN SPECIFICATION
02

Engine + CLI

npx @clarxai/cli score . runs locally or in CI, explains every rule on demand, and reads your manifest for overrides. No account required.

RUNS ANYWHERE
03

Clarx Cloud

Scan history, org-wide benchmarks, AI-enriched findings review, and a manifest studio with live pillar scoring — the team workflow on top of the same engine.

HOSTED WORKFLOW
03 — Manifest studio

Your CLAUDE.md, scored as you type. Live pillar scoring, a section checklist, and AI-assisted fixes — this is a slice of the real studio.

CLAUDE.md — edit me
85AI-readiness · manifest
Discoverability73
Boundary clarity80
Context efficiency70
Operational guidance100
Edit safety100
11 of 11 sections present

The real analyzer, running in your browser. Nothing leaves this page.

Open the studio →
04 — Tooling

A CLI that explains itself. Score in one command, ask any rule why it exists, and declare your repo's intent in a manifest the engine actually reads.

$ npx @clarxai/cli score . AI-readiness 83/100 · confidence: high Fix first C2 — Buyd.tsx exceeds 400 lines (caps the score at 65) Not evaluated B1, C3–C6 — no JS/TS import graph

One command, no config. The report leads with what to fix first, names the cap each hard failure imposes, and declares which rules could not be evaluated for your stack — inapplicable rules never move the score.

Live preview

AI-readiness 83/100Fix first · C2 caps score at 65Not evaluated · B1, C3–C6Confidence · high
— Principle

The score is called what it is, says what it is not, declares what it could not evaluate, and defends its thresholds.

LANGUAGE AGNOSTIC ·
JS / TS — full analysisPythonGoRust — partial, declared
CLAUDE.mdAGENTS.md.cursor/rulesclarx-manifest.json

Start scoring your repos.

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

$npm install -g @clarxai/cli