Files
hallmark/skill/references
YoussefandClaude Opus 4.7 dcd45e21d7 Smart placeholders + mobile-responsiveness gates (skill v1.x)
Two enhancements that surfaced from real use of v1.0:

PLACEHOLDERS — imagery decisions are now explicit, not fuzzy.

· hero-enrichment.md gains an "Image-need detection" table at the
  top. Brief signals map to image strategy: e-commerce / photography
  / food / team / travel / news → photographic placeholders;
  SaaS / manifesto / agency / editorial → kit-led imagery; API /
  docs / dev-tool / editorial-essay → no imagery; default →
  typography-only. Rules call out: never overwrite user-supplied
  assets; ask one short question on ambiguity; never invent stock
  photos as if they were the final design.

· assets.md gains a "Placeholder strategy" section listing the
  source canon in order: Hallmark imagery kit > hand-built SVG >
  Picsum (deterministic seed) > Unsplash (keyword-anchored) >
  local public/placeholder fallback. Swappability rules are
  non-negotiable: TODO comments, single --placeholder-base
  constant, alt text describing intended subject not the
  placeholder.

· imagery-kit.md is new. The skill ships a manifest pointing at
  curated abstract assets hosted on the marketing site
  (hallmark-murex.vercel.app/imagery/<category>/<file>) — six
  categories: watercolor washes, transparent abstract objects,
  editorial ornaments, texture/grain overlays, generic product
  silhouettes, pattern fields. The skill stays binary-free; the
  output references images by absolute URL with graceful fallback
  to hand-built SVG when the asset 404s. Includes CSS recipes for
  layered hero composition (transparent PNG, large, off-centre,
  z-index 0 behind text), section background wash, decoration,
  texture overlay, empty state. Anti-patterns: don't use kit as
  literal subject, don't layer 3+ pieces, don't apply same wash
  to multiple sections, don't use kit imagery in modern-minimal
  genre.

· SKILL.md Step 4 wires the heuristic — "First, does the brief
  need imagery at all?" runs before tier selection, defaults to
  typography-only.

MOBILE — the responsiveness pass is now codified as gates.

· slop-test.md adds gates 61–65 covering the patterns the
  marketing-site responsiveness fix uncovered: image-bearing grid
  tracks must use minmax(0, 1fr) (61), root must have overflow-x:
  clip on html and body (62), display headers wrap inside long
  words via overflow-wrap: anywhere (63), per-theme section-head
  overrides include mobile collapse (64), CSS-only radio tab
  patterns must not scroll-jump (65). New stamp line: mobile:
  pass (36, 59, 61–65).

· responsive.md grows a "Mobile — non-negotiable" section at the
  top that consolidates all seven mobile gates as a hard floor.
  Test at 320 / 375 / 414 / 768 px before marking complete.

· SKILL.md Discipline 5 expanded — was just "clickable text never
  wraps" (gate 59), now broader "mobile responsiveness — every
  emit verified at 320/375/414/768" naming all seven gates.

Skill total grew from 6633 → 6890 lines (+257, ~4%). The new
imagery-kit.md is 170 lines, larger than the original ~55-line
plan because it ships the actual CSS recipes for layered hero
composition, section wash, texture overlay, and empty state — the
implementation-grade detail required to hit the "professional
frontend engineer" bar set in the plan.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-06 11:38:06 +01:00
..
2026-04-27 21:46:57 +01:00
2026-04-27 21:46:57 +01:00