references/checklist.md
GitHubWeb prototype checklist
Run this before emitting <artifact>. P0 = must pass; P1 = should pass; P2 = nice to have.
P0 — must pass
- No raw hex outside
:roottoken block. Every color isvar(--bg)/var(--fg)/var(--muted)/var(--border)/var(--accent)/var(--surface)(or acolor-mix()of those). Grep#[0-9a-fA-F]{3,8}outside:root{}should return nothing. - All headings use
var(--font-display). No sans-serif<h1>/<h2>. Inter / Roboto / system-sans never serve as a display face. - Accent appears at most twice per screen. Count: eyebrow color, primary CTA fill, anything else? If three or more, demote one to
var(--fg)orvar(--muted). - No purple/violet gradient backgrounds. No
linear-gradient(... #a855f7 / #8b5cf6 / purple ...). The seed template has no gradients on backgrounds — keep it that way. - No emoji used as feature icons. Use the inline SVG monoline marks shipped in Layout 3, or a tasteful single-character glyph in
--font-mono. ✨ 🚀 🎯 are out. - No invented metrics. Every number on the page came from the user, the brief, or is clearly labelled as a placeholder (e.g.
[REPLACE] · 38×). "10× faster", "99.9% uptime" without source = remove. - No filler copy. Zero "Feature One / Feature Two", lorem ipsum, "Lorem ipsum dolor". If a section feels empty, delete it; do not pad.
-
data-od-idon every top-level<section>. Used by comment mode to target sections. - Mobile reflow works. All
grid-2,grid-3,grid-4,grid-2-1,grid-1-2collapse to one column at ≤920px (the default media query intemplate.htmldoes this). Verify by mentally narrowing — no horizontal scroll. - No
scrollIntoView()calls. Breaks the OD preview iframe. UsescrollTo({...})if you need scroll behaviour.
P1 — should pass
- One decisive flourish. A pull quote, a striking stat, a real-feeling photograph, one micro-animation on the hero. One. Not three.
- Section rhythm alternates. No two stat rows in a row. No two feature triplets in a row. No two quote blocks in a row.
- Headlines under 14 words. If longer, the writing is doing the design's job.
- Lead text under 56 ch / two sentences.
max-width: 60chon.leadenforces this; don't override. - CTA buttons say what happens. "Start free" beats "Get Started". "Read the story" beats "Learn More".
- Hover states present for all
<a>and.btn. Seed template covers this. - Numerics use
.num(mono, tabular). Prices, stats, version numbers, dates. - One image style per page. Don't mix square portrait headshots with widescreen product hero with vertical phone mock — pick a lane.
P2 — nice to have
-
text-wrap: pretty/balanceon long paragraphs / headings (already on<p>andh*in seed). -
color-mix()for derived tones. No additional--accent-50/--accent-300Bootstrap-style tokens — derive on the spot. - Sticky topnav has frosted glass (already in seed via
backdrop-filter: blur()). - Loaded fonts are system-first. Iowan Old Style / Charter for serif, system stack for sans. Only pull a Google Font if DESIGN.md specifies one.
Anti-slop spot-check
Look at the page for two seconds. If your gut says any of:
- "looks like every Cursor / Linear / Vercel ripoff I've seen this month"
- "this could be any AI startup's homepage"
- "the feature row has an icon, a heading, and three lines of vague benefit copy"
…go back, replace one feature cell with something more specific to this product (a screenshot, a concrete example, a sample of the actual output), and remove one accent.