Skip to content

site: remove named AI-slop tells from the product pages - #43

Merged
utsengar merged 2 commits into
mainfrom
site-slop-audit
Aug 22, 2026
Merged

site: remove named AI-slop tells from the product pages#43
utsengar merged 2 commits into
mainfrom
site-slop-audit

Conversation

@utsengar

Copy link
Copy Markdown
Owner

Audits htmlbin.dev's own three pages against the design-tell vocabulary impeccable.style publishes, and against DESIGN.md's own hard-don'ts. Seven of the fixes below were already written down as rules in DESIGN.md and simply weren't enforced in styles.ts.

Scope is the product pages only. Nothing here touches the drop quality floor in SKILL.md or patterns/.

Clean already

No gradients, no backdrop-filter, no beige (#FAFAFA/#F5F5F5 are neutral grays), concrete headline, specific CTA, no fields on the landing, no images to animate.

Doc correction: DESIGN.md §7 permits a "status-dot pulse." There is no status pill and no pulse animation in the sheet — the only @keyframes is the memo's open reveal. That line is stale.

Fixed

Tell Where What it was
Side-tab border .error, .definition 3px red left stripe plus tinted background plus full hairline
Everything equal .caps grid-auto-rows: 1fr locked all four tiles to identical height
Ghost-cards .cap Four fully-outlined white cells with hover-fill
Cards in cards .cap .mini, .tabs Bordered block in bordered cell; rounded tab in rounded track in rounded card
Status-chip soup .prompt-chrome Traffic dots + filled tab track + copy pill = three chip clusters in one bar
Over-rounding sheet-wide Nine ad-hoc radii (3/4/5/6/7/8/14/50%/999px) → three-step scale
Clipped label .viewer-bar Title capped at 28vw, desc at 24vw — truncated short titles on wide screens
Italic .definition em The sheet's only font-style: italic, forbidden by §7
Glow .copy-cta Red drop-shadow under a red button, forbidden by §3
Shadow > 1px .prompt, .term-block 28px and 20px ambient blurs against §3's 1px cap
Palette leak 10 sites Ten off-token hex values incl. two different blues, in a palette §3 calls "black, white, gray, and one red"

The capability grid was the worst of it — four tells stacking in one section. Now a borderless two-column list separated by whitespace, which is what §6 already prescribed: "if you're tempted to add a border-bottom to 'section' the document, don't." Rows still align per-row via the grid's default stretch.

Left deliberately: the traffic-light dots, their three colors, and the 50% radius on them — DESIGN.md §5.3 documents them as the one intentional exception.

Second commit: broken npm scripts

npm run dev, npm run deploy, npm run tail, and npm run stats all failed with MODULE_NOT_FOUND — the .bin/wrangler shim path-math bug CLAUDE.md documents for the db:* scripts and predicted these would eventually hit. npm run dev failing blocked local verification of the styles change, so it's fixed here with the same direct-invoke pattern the db:* scripts already use.

Verification

  • tsc --noEmit clean
  • Every var(--*) reference resolves to a defined token
  • Removed patterns confirmed absent from a live 200 response on wrangler dev

Not verified: no screenshot. The browser MCP was disconnected in the session that produced this, so all verification above is structural. The .caps change is the one most worth a visual check on the preview URL.

Two judgment calls worth a second opinion

  1. The prompt slab's shadow is flattened to a 1px hairline to match §3. If the page reads too flat, that's a one-line revert.
  2. The tab track lost its filled background — active state is now carried by the tab's own fill alone.

Follow-up not done here

DESIGN.md still documents the old capability grid, the stale status-dot pulse, and the shadow values this PR changed. Happy to sync the doc in a follow-up once the visual calls above are settled.

🤖 Generated with Claude Code

utsengar and others added 2 commits August 22, 2026 15:33
Audited htmlbin.dev's own pages against the design-tell vocabulary
impeccable.style publishes, and against DESIGN.md's own hard-don'ts,
which several rules in this sheet were already violating.

Fixed:

- Side-tab border (2x). .error and .definition each stacked a 3px red
  left-edge stripe on top of a tinted background AND a full hairline —
  three redundant emphasis mechanisms. Tint + hairline now carry it.
- Everything-equal / ghost-cards / cards-in-cards. The capability grid
  was a 2x2 of fully-bordered cells, grid-auto-rows:1fr locking every
  tile to identical height, each opening with an identical 5px red dot,
  each holding a bordered .mini inside the bordered cell. Now a
  borderless two-column list separated by whitespace, which is also
  what DESIGN.md §6 says to do instead of sectioning borders. Rows
  still align per-row via the grid's default stretch.
- Nested rounded surfaces in the prompt chrome. The tab group was a
  rounded filled track holding rounded filled tabs inside the rounded
  prompt card, and was a third chip cluster in a bar already carrying
  the traffic-light dots and the copy pill. The active tab's own fill
  is enough.
- Glow. .copy-cta carried a red drop-shadow under a red button.
  DESIGN.md §3 rules out glow explicitly.
- Shadows above 1px (2x). The prompt slab and term block had 28px and
  20px ambient blurs — the generic floating-card look, and against
  DESIGN.md §3's 1px cap.
- Italic. .definition em was the sheet's only font-style:italic, which
  DESIGN.md §7 forbids product-wide.
- Clipped labels. The viewer bar capped title and description at fixed
  viewport slices (28vw / 24vw), truncating a short title on a wide
  screen with room to spare. They now share leftover space and
  ellipsize only when actually out of room.
- Radius chaos. Nine ad-hoc radii (3/4/5/6/7/8/14/50%/999px) collapse
  to a three-step scale. The 999px lock-pill was the only fully-round
  element on the site.
- Palette leak. Ten off-token hex values, including two different
  blues, in a palette DESIGN.md describes as "black, white, gray, and
  one red". Tokenized; hover now uses the existing --red-press.

Left deliberately: the traffic-light dots and their three colors are a
documented DESIGN.md §5.3 exception, and the 50% radius on them is a
real circle.

Verified: typecheck clean, all var(--*) references resolve, and the
removed patterns are absent from a live 200 response on wrangler dev.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
The .bin/wrangler shim is installed as a regular file rather than a
symlink, so its __dirname-relative path math resolves
node_modules/wrangler-dist/cli.js instead of
node_modules/wrangler/wrangler-dist/cli.js. CLAUDE.md documents this
for the db:* scripts and predicted these three would break the same
way eventually. They have — npm run dev and npm run stats both fail
with MODULE_NOT_FOUND. npm run dev failing blocked local verification
of the styles change in this branch.

Same fix the db:* scripts and the dashboard server already use.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown

🚀 Cloudflare preview

URL: https://8ceb091a-htmlbin.utkarsh2012.workers.dev

Built from commit 52a657809e78f4135e4a81f7c1e4a7d15eb7840c.

Note: bindings (D1, KV, AI) are shared with production.
Avoid destructive PR tests on real data.

@utsengar
utsengar merged commit 05c5413 into main Aug 22, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant