designesy
Score a site

Synthesis contract

Report

Report is the synthesis capstone: fetch one URL, run score + drift + readiness in parallel, and produce a unified design-intelligence report with a single composite grade. One input, one output, one grade: the most shareable surface in the dynasty. Where /score answers "how good is this design", /drift answers "is AI breaking it", and /readiness answers "can agents use it", /report answers all three at once.

Version 0.1.1 · provisional · machine export

View as Markdown

Source authority

Composition
Weighted synthesis of three independent Designesy engines: /score (45-check audit), /drift (12-check drift radar), /readiness (10-check AI readiness). Each engine is independently validated; report composes their results.
Shareability
Report is designed as the share hook: "here is your design-intelligence report" is more compelling than "run these six tools". One grade, one URL, one page.
URL gap
No competitor synthesizes audit + drift + readiness into a single composite report from a live URL: the designesy pattern.
Primary source
Designesy design intelligence research 2026-08-02

Method

How it works

Fetch the target URL once. Fire /api/score, /api/drift, and /api/readiness in parallel (Promise.all). Each engine independently fetches the URL, extracts CSS + tokens, and runs its own checks. Collect the three results. Compute a composite score using the weighted formula: score × 0.5 + drift × 0.3 + readiness × 0.2. Derive a composite grade from the composite score. Aggregate all checks across the three engines into a single check list. Surface the three sub-scores, the composite score, the composite grade, and the full check inventory.

Weighting

01 score 45-check design-intelligence audit: the broadest quality measure (tokens, typography, motion, accessibility, anti-generic, runtime) Weight 0.5
02 drift 12-check AI-generated UI drift radar: token fabrication, value variance, off-contract patterns Weight 0.3
03 readiness 10-check AI readiness: machine-readable tokens, llms.txt, agent.json, MCP, DESIGN.md, sitemap Weight 0.2

compositeScore = round(score × 0.5 + drift × 0.3 + readiness × 0.2). compositeGrade from compositeScore: A≥90, B≥80, C≥70, D≥60, F<60.

Verification

8 synthesis checks. The composite score is NOT derived from these checks: it is the weighted average of the three sub-engine scores. These checks verify the synthesis itself ran correctly. PASS=1, WARN=0.5, FAIL=0. Composite grade: A≥90, B≥80, C≥70, D≥60, F<60.

01 rp01 · Target URL fetched and validated Pass URL is a public http(s) URL and was accepted by the guard Fail URL is invalid, private, or blocked by the SSRF guard
02 rp02 · Score engine completed: 45-check audit ran Pass Score engine returned a result with a score and grade Warn Score engine returned but with SKIP checks (partial result) Fail Score engine failed or timed out (the audit did not complete)
03 rp03 · Drift engine completed: 12-check drift radar ran Pass Drift engine returned a result with a score and grade Fail Drift engine failed or timed out (the drift radar did not complete)
04 rp04 · Readiness engine completed: 10-check readiness probe ran Pass Readiness engine returned a result with a score and grade Fail Readiness engine failed or timed out (the readiness probe did not complete)
05 rp05 · Composite score computed: weighted synthesis Pass Composite score computed from all three sub-scores using the weighting formula Warn Composite score computed from partial results (one or more engines returned no score) Fail Composite score could not be computed (one or more sub-scores are missing)
06 rp06 · Composite grade derived Pass Composite grade derived from the composite score (A–F) Fail Composite grade could not be derived (composite score is missing)
07 rp07 · Check inventory aggregated: all checks across engines collected Pass All checks from score, drift, and readiness collected into a single inventory Fail Check aggregation failed (engine results are malformed)
08 rp08 · Report is coherent: no engine contradicts the composite Pass No engine score is more than 30 points from the composite (the grade is defensible) Warn One engine score is 20 to 30 points from the composite (the grade is borderline) Fail One or more engine scores are more than 30 points from the composite (the grade is not defensible)

Validation

Designesy report engine: parallel /score + /drift + /readiness with weighted synthesis. Method: Fire three internal API calls in parallel, collect results, compute composite score, derive composite grade, aggregate checks. Browser-only checks: None: all checks are server-side API composition, no browser needed.

Relationship to core

01 /score Report runs /score as its primary sub-engine (weight 0.5): the 45-check audit is the backbone of the composite weight 0.5
02 /drift Report runs /drift as its second sub-engine (weight 0.3): drift radar feeds the composite weight 0.3
03 /readiness Report runs /readiness as its third sub-engine (weight 0.2): readiness feeds the composite weight 0.2
04 /guardrails Report does not run guardrails: guardrails emits a build contract instead of a score, as a companion rather than a sub-engine Not run
05 /monitor Report is a single-point snapshot; /monitor tracks the snapshot over time Not run
06 /compare Report scores one URL; /compare diffs two: report is the input to compare Not run

Open questions

Run it

Generate a unified design-intelligence report for any URL:

Generate a report →API endpoint
The report contract is the synthesis capstone: it answers “how good is this design, is AI breaking it, and can agents use it” in one composite grade. Machine export.