Files
hallmark/docs/img
YoussefandClaude Opus 4.7 6b2e701dc6 Tier 1 — visual-first README · recipes.md · study-examples.md · study-led positioning
## What shipped (Tier 1 of the brainstorm)

1. **Visual-first README** — replaces the text-only top with a 4-up theme grid
   (Specimen / Studio / Brutal / Newsprint) and an 8-cell test-page mosaic
   (Tide → Cohort) using the existing thumbnails. First impression becomes
   *visual* rather than a wall of bullets.

2. **Try-it prompt at the top** — the Coffeebox brief is now the canonical
   first thing visitors paste to verify the skill is wired correctly.
   References the new `recipes.md` directly.

3. **Comparison table vs the field** — Hallmark vs Anthropic frontend-design,
   nexu-io Open Design, Dembrandt. Positions Hallmark's `study` as the
   differentiator (everyone else ships preset menus or scrapers).

4. **`study` repositioned as the headline verb** — bolded in the verbs table,
   has its own lead-paragraph in the hero, links to the new
   `study-examples.md` for worked DNA-extractions.

5. **Canonical 2026 vocabulary** in the README opening: "tactile rebellion"
   (Creative Bloq's SEO term), "anti-AI-slop" (925studios canon),
   "custom-craft" (the Lottie-as-last-resort stance). Cited.

## New reference files

### `skill/references/recipes.md` (~140 lines)

Eight worked briefs + a canonical try-it prompt. Each shows: prompt verbatim,
inferred trio (audience/use/tone), picked macrostructure + theme + enrichment,
and a one-paragraph excerpt of the output. The first recipe (Coffeebox) is
the canonical try-it prompt the README points users at. Recipes 01–08 are
the existing eight test pages, normalised to the same four-line format.

### `skill/references/study-examples.md` (~210 lines)

Three worked DNA-extractions of `study`:

- **Example A** — Pentagram-style editorial portfolio: extracts Specimen
  macrostructure + italic-display + warm-orange accent + sparse density.
  Refuses font ID. Notes two anti-patterns to NOT carry over.
- **Example B** — Klim-Type-Foundry-style specimen: Type Specimen + display-
  heavy + dark-paper + chromatic-other accent. Single-font specimen page.
  Suggests hybrid (Specimen homepage + Workbench for case studies).
- **Example C** — Rauno-Freiberg-style personal site: refuse-or-proceed
  check fires (competitor portfolio). After user confirms public reference,
  extracts Long Document + centred demo + dark-cool paper + chromatic-other
  green accent. Notes one anti-pattern to fix (no reduced-motion fallback).

Each example follows the same four-step protocol: refuse-or-proceed →
diagnose → confirm → build. Demonstrates the skill's discipline that
`study` extracts DNA, not pixels.

## SKILL.md updates

- Adds `recipes.md` and `study-examples.md` to the references list with
  load-on-demand notes (when the user asks "what does Hallmark output look
  like?" → load recipes; when running `study` → load study-examples).
- No version bump (no behavioural change yet).

## docs/

New `docs/img/` folder with four theme captures at 900px wide:
- theme-specimen.png — warm cream + italic Fraunces + warm-orange
- theme-studio.png — cool grey + italic Fraunces + forest-green
- theme-brutal.png — stark white-and-black + Inter Tight 900
- theme-newsprint.png — warm cream + Playfair Display + deep red

These sit in the README hero <table> for the 4-up grid.

## Skill files mirrored

cp SKILL.md, recipes.md, study-examples.md to ~/.claude/skills/hallmark/.
References dir now has 18 files (was 16).

## Plan file updated

`/Users/youssef/.claude/plans/...` rewritten with concrete Tier 2 (DTCG
tokens.json export · macrostructure rotation hints · ASCII preview block)
and Tier 3 (theme knobs · pre-flight inference · Figma MCP recipe)
implementation specs. Each item has scope, file budget, verification, and
recommended order. Ready to execute when the user wants either tier.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-30 19:26:38 +01:00
..