mirror of
https://github.com/Nutlope/hallmark.git
synced 2026-08-14 12:35:33 +02:00
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>