@lovehlmmm/primekit 1.0.0

package/skills/design/references/cip-deliverable-guide.md

@@ -0,0 +1,95 @@
+# CIP Deliverable Guide
+
+## Core Identity
+
+### Primary Logo
+- Vector format (SVG, AI, EPS)
+- Clear space rules defined
+- Scalable from favicon to billboard
+
+### Logo Variations
+- Horizontal, vertical, stacked
+- Icon/symbol only
+- Monochrome versions (black, white, reversed)
+
+## Stationery Set
+
+### Business Card
+- Standard: 3.5x2 inches / 85x55mm
+- Premium paper stock (300-400gsm)
+- Finishes: matte, spot UV, foil, emboss
+
+### Letterhead
+- A4 or Letter size
+- Header area for logo/contact
+- Digital and print versions
+
+### Envelope
+- DL, C4, C5 sizes
+- Logo on flap or front
+- Return address styling
+
+## Office Environment
+
+### Reception Signage
+- 3D dimensional letters
+- Backlit LED options
+- Materials: acrylic, metal, wood
+
+### Wayfinding System
+- Consistent icon system
+- Clear hierarchy
+- ADA compliance
+
+### Wall Graphics
+- Mission/values displays
+- Large-scale murals
+- Window frosting
+
+## Apparel
+
+### Polo Shirt
+- Embroidery preferred
+- Left chest placement
+- Quality fabric (pique cotton)
+
+### Uniforms
+- Department color coding
+- Name badge integration
+- Safety requirements if applicable
+
+## Vehicle Branding
+
+### Car/Sedan
+- Door panel branding
+- Partial or full wrap
+- Contact information visible
+
+### Fleet Vehicles
+- Consistent design across fleet
+- High visibility contact details
+- Professional installation
+
+## Digital Assets
+
+### Social Media
+- Profile pictures (icon version)
+- Cover images (platform-specific)
+- Post templates
+
+### Email Signature
+- HTML responsive
+- Max 600px width
+- Essential contact only
+
+## Events & Promotional
+
+### Trade Show Booth
+- Modular design
+- Easy assembly
+- Key messaging visible
+
+### Promotional Items
+- Quality over quantity
+- Useful items preferred
+- Brand colors prominent

package/skills/design/references/cip-design.md

@@ -0,0 +1,121 @@
+# CIP Design Reference
+
+Corporate Identity Program design with 50+ deliverables, 20 styles, 20 industries. Generate mockups with Gemini Nano Banana (Flash/Pro).
+
+## Scripts
+
+| Script | Purpose |
+|--------|---------|
+| `scripts/cip/search.py` | Search deliverables, styles, industries; generate CIP briefs |
+| `scripts/cip/generate.py` | Generate CIP mockups with Gemini (Flash/Pro) |
+| `scripts/cip/render-html.py` | Render HTML presentation from CIP mockups |
+| `scripts/cip/core.py` | BM25 search engine for CIP data |
+
+## Commands
+
+### CIP Brief (Start Here)
+
+```bash
+python3 ${CLAUDE_PLUGIN_ROOT}/skills/primekit-design/scripts/cip/search.py "tech startup" --cip-brief -b "BrandName"
+```
+
+### Search Domains
+
+```bash
+# Deliverables
+python3 ${CLAUDE_PLUGIN_ROOT}/skills/primekit-design/scripts/cip/search.py "business card letterhead" --domain deliverable
+
+# Design styles
+python3 ${CLAUDE_PLUGIN_ROOT}/skills/primekit-design/scripts/cip/search.py "luxury premium elegant" --domain style
+
+# Industry guidelines
+python3 ${CLAUDE_PLUGIN_ROOT}/skills/primekit-design/scripts/cip/search.py "hospitality hotel" --domain industry
+
+# Mockup contexts
+python3 ${CLAUDE_PLUGIN_ROOT}/skills/primekit-design/scripts/cip/search.py "office reception" --domain mockup
+```
+
+### Generate Mockups
+
+```bash
+# With logo (RECOMMENDED - uses image editing)
+python3 ${CLAUDE_PLUGIN_ROOT}/skills/primekit-design/scripts/cip/generate.py --brand "TopGroup" --logo /path/to/logo.png --deliverable "business card" --industry "consulting"
+
+# Full CIP set with logo
+python3 ${CLAUDE_PLUGIN_ROOT}/skills/primekit-design/scripts/cip/generate.py --brand "TopGroup" --logo /path/to/logo.png --industry "consulting" --set
+
+# Pro model for 4K text rendering
+python3 ${CLAUDE_PLUGIN_ROOT}/skills/primekit-design/scripts/cip/generate.py --brand "TopGroup" --logo logo.png --deliverable "business card" --model pro
+
+# Custom deliverables with aspect ratio
+python3 ${CLAUDE_PLUGIN_ROOT}/skills/primekit-design/scripts/cip/generate.py --brand "GreenLeaf" --logo logo.png --industry "organic food" --deliverables "letterhead,packaging,vehicle" --ratio 16:9
+
+# Without logo (AI generates interpretation)
+python3 ${CLAUDE_PLUGIN_ROOT}/skills/primekit-design/scripts/cip/generate.py --brand "TechFlow" --deliverable "business card" --no-logo-prompt
+```
+
+### Render HTML Presentation
+
+```bash
+python3 ${CLAUDE_PLUGIN_ROOT}/skills/primekit-design/scripts/cip/render-html.py --brand "TopGroup" --industry "consulting" --images /path/to/cip-output
+python3 ${CLAUDE_PLUGIN_ROOT}/skills/primekit-design/scripts/cip/render-html.py --brand "TopGroup" --industry "consulting" --images ./topgroup-cip --output presentation.html
+```
+
+## Models
+
+- `flash` (default): `gemini-2.5-flash-image` - Fast, cost-effective
+- `pro`: `gemini-3-pro-image-preview` - Quality, 4K text rendering
+
+## Deliverable Categories
+
+| Category | Items |
+|----------|-------|
+| Core Identity | Logo, Logo Variations |
+| Stationery | Business Card, Letterhead, Envelope, Folder, Notebook, Pen |
+| Security/Access | ID Badge, Lanyard, Access Card |
+| Office Environment | Reception Signage, Wayfinding, Meeting Room Signs, Wall Graphics |
+| Apparel | Polo Shirt, T-Shirt, Cap, Jacket, Apron |
+| Promotional | Tote Bag, Gift Box, USB Drive, Water Bottle, Mug, Umbrella |
+| Vehicle | Car Sedan, Van, Truck |
+| Digital | Social Media, Email Signature, PowerPoint, Document Templates |
+| Product | Packaging Box, Labels, Tags, Retail Display |
+| Events | Trade Show Booth, Banner Stand, Table Cover, Backdrop |
+
+## Design Styles
+
+| Style | Colors | Best For |
+|-------|--------|----------|
+| Corporate Minimal | Navy, White, Blue | Finance, Legal, Consulting |
+| Modern Tech | Purple, Cyan, Green | Tech, Startups, SaaS |
+| Luxury Premium | Black, Gold, White | Fashion, Jewelry, Hotels |
+| Warm Organic | Brown, Green, Cream | Food, Organic, Artisan |
+| Bold Dynamic | Red, Orange, Black | Sports, Entertainment |
+
+## HTML Presentation Features
+
+- Hero section with brand name, industry, style, mood
+- Deliverable cards with mockup images
+- Descriptions: concept, purpose, specifications
+- Responsive desktop/mobile, dark theme
+- Images embedded as base64 (single-file portable)
+
+## Workflow
+
+1. Generate CIP brief → `scripts/cip/search.py --cip-brief`
+2. Generate mockups with logo → `scripts/cip/generate.py --brand --logo --industry --set`
+3. Render HTML presentation → `scripts/cip/render-html.py --brand --industry --images`
+
+**Tip:** If no logo exists, use Logo Design (built-in) to generate one first.
+
+## Detailed References
+
+- `references/cip-deliverable-guide.md` - Deliverable specifications
+- `references/cip-style-guide.md` - Design style descriptions
+- `references/cip-prompt-engineering.md` - AI generation prompts
+
+## Setup
+
+```bash
+export GEMINI_API_KEY="your-key"
+pip install google-genai pillow
+```

package/skills/design/references/cip-prompt-engineering.md

@@ -0,0 +1,84 @@
+# CIP Mockup Prompt Engineering
+
+## Base Prompt Structure
+
+```
+Professional corporate identity mockup photograph showing [DELIVERABLE] for brand '[BRAND_NAME]', [STYLE] design style, using colors [COLORS], [TYPOGRAPHY] typography, logo placement: [PLACEMENT], [MATERIALS] materials with [FINISHES] finish, [CONTEXT] setting, [MOOD] mood, photorealistic product photography, soft natural lighting, high quality professional shot, 8k resolution detailed
+```
+
+## Deliverable-Specific Modifiers
+
+### Business Card
+```
+business card on marble surface, stack of cards, premium paper texture, soft shadows, 45 degree angle
+```
+
+### Letterhead
+```
+letterhead flat lay with envelope and pen, velvet fabric background, brand stationery set, overhead view
+```
+
+### Office Signage
+```
+3D logo signage on office wall, modern lobby interior, backlit LED, brushed metal finish, architectural photography
+```
+
+### Vehicle Branding
+```
+branded vehicle on urban street, 3/4 front angle view, professional car wrap, motion blur background optional
+```
+
+### Apparel (Polo/T-Shirt)
+```
+folded polo shirt on clean background, embroidered logo on chest, premium fabric texture, product photography
+```
+
+## Style Modifiers
+
+### Corporate Minimal
+```
+clean minimal aesthetic, white space, subtle shadows, matte finish, professional
+```
+
+### Luxury Premium
+```
+dark background, dramatic rim lighting, gold accents, premium materials, sophisticated
+```
+
+### Modern Tech
+```
+gradient colors, geometric elements, clean surfaces, futuristic, innovative
+```
+
+### Warm Organic
+```
+natural materials, kraft paper texture, warm lighting, authentic, artisan
+```
+
+## Lighting Modifiers
+
+- **Studio:** `professional studio lighting, even illumination`
+- **Natural:** `soft natural daylight, window light`
+- **Dramatic:** `dramatic rim light, dark background, high contrast`
+- **Warm:** `warm golden hour lighting, cozy atmosphere`
+
+## Context Modifiers
+
+- **Marble desk:** `white marble surface, soft shadows, luxury`
+- **Wooden table:** `warm wood grain, natural, artisan`
+- **Office interior:** `modern office environment, architectural`
+- **Flat lay:** `overhead view, organized arrangement`
+- **Lifestyle:** `in-use context, human element`
+
+## Quality Modifiers
+
+Always include:
+```
+photorealistic, professional photography, high quality, 8k resolution, detailed, sharp focus
+```
+
+## Negative Prompts (what to avoid)
+
+```
+blurry, low quality, distorted text, misspelled, amateur, clipart, cartoon, illustration, watermark
+```

package/skills/design/references/cip-style-guide.md

@@ -0,0 +1,68 @@
+# CIP Design Style Guide
+
+## Corporate Minimal
+**Industries:** Finance, Legal, Consulting, Tech
+**Colors:** Navy (#0F172A), White (#FFFFFF), Blue accents
+**Typography:** Clean sans-serif (Inter, Helvetica)
+**Materials:** Premium matte paper, subtle textures
+**Finishes:** Matte, spot UV on logo
+
+## Modern Tech
+**Industries:** Tech, SaaS, Startups, AI
+**Colors:** Purple (#6366F1), Cyan (#0EA5E9), Green (#10B981)
+**Typography:** Geometric sans (Outfit, Poppins)
+**Materials:** Smooth surfaces, gradient prints
+**Finishes:** Gloss, metallic accents
+
+## Luxury Premium
+**Industries:** Fashion, Jewelry, Hotels, Fine Dining
+**Colors:** Black (#1C1917), Gold (#D4AF37), White
+**Typography:** Elegant serif (Playfair), thin sans
+**Materials:** Heavy cotton paper, leather, metal
+**Finishes:** Gold foil, emboss, deboss, soft-touch
+
+## Classic Traditional
+**Industries:** Law Firms, Heritage Brands, Finance
+**Colors:** Navy, Burgundy, Gold
+**Typography:** Traditional serif (Times, Garamond)
+**Materials:** Quality laid paper, wood
+**Finishes:** Letterpress, gold emboss
+
+## Warm Organic
+**Industries:** Food, Organic, Wellness, Craft
+**Colors:** Brown (#8B4513), Green (#228B22), Cream
+**Typography:** Friendly serif, organic script
+**Materials:** Kraft paper, recycled materials
+**Finishes:** Uncoated, natural textures
+
+## Bold Dynamic
+**Industries:** Sports, Entertainment, Gaming
+**Colors:** Red (#DC2626), Orange (#F97316), Black
+**Typography:** Bold condensed sans
+**Materials:** High-contrast, metallic
+**Finishes:** Gloss, vibrant colors
+
+## Fresh Modern
+**Industries:** Healthcare, Wellness, Fintech
+**Colors:** Mint (#10B981), Sky (#0EA5E9), White
+**Typography:** Modern rounded sans
+**Materials:** Light, clean surfaces
+**Finishes:** Matte, clean minimal
+
+## Soft Elegant
+**Industries:** Beauty, Wedding, Spa, Fashion
+**Colors:** Pink (#F472B6), Gold, White
+**Typography:** Elegant script, thin sans
+**Materials:** Soft-touch, quality paper
+**Finishes:** Rose gold foil, emboss
+
+## Color Psychology
+
+| Color | Meaning | Best Use |
+|-------|---------|----------|
+| Blue | Trust, stability | Finance, Tech, Healthcare |
+| Green | Growth, nature | Eco, Wellness, Organic |
+| Gold | Luxury, prestige | Premium, Jewelry |
+| Red | Energy, passion | Food, Sports |
+| Black | Sophistication | Luxury, Fashion |
+| White | Clean, minimal | Tech, Healthcare |

package/skills/design/references/design-critique-guide.md

@@ -0,0 +1,246 @@
+# Design Critique Guide
+
+> Adapted from [huashu-design](https://github.com/alchaincyf/huashu-design) by alchaincyf (花叔), MIT — commit `1572d43` (2026-07-26).
+>
+> Copyright (c) 2026 alchaincyf. Licensed under the MIT License. See upstream `LICENSE` for full terms.
+
+Load this reference when reviewing a design output — self-critique before delivery, or a second pass on a previously shipped design. The rubric is universal; scoring is contextual (a slide is not a logo). Cultural sensibility varies — treat the ranges as anchors, not verdicts.
+
+For HTML/CSS craft numerics (spacing scale, contrast ratio, font count, whitespace %, OKLCH ramps, 60/30/10), defer to `primekit-frontend-design`. This guide owns the *what to check* and *how to weigh it*; the numeric standards live in the front-end skill so a single number is not restated in two places.
+
+This guide scores a *finished* piece. For the pre-generation gate (the one-line Design Read, and the converged failure-mode catalog — generic gradients, template card grids, fake screenshots, generic content, decorative furniture, one-note palettes), see `../../primekit-frontend-design/references/design-quality-preflight.md`.
+
+## The 6 dimensions
+
+Concept first, then five execution dimensions. Execution is a multiplier — a great multiplier on zero is still zero.
+
+### 0. Concept — highest weight
+
+Ask "does this design have an idea?" before "is it well made?" Execution amplifies; amplifying a hollow concept only makes it emptier.
+
+| Score | Standard |
+| --- | --- |
+| 9–10 | A unique idea that grew out of the user's content; the visual motif is not swappable |
+| 7–8 | Clear intent; motif relates to content but would just barely still work for a similar topic |
+| 5–6 | Style only, no concept — good-looking, says nothing |
+| 3–4 | Generic template dressed up; concept layer is zero |
+| 1–2 | Not even the right style — decorative pile-on |
+
+Core questions:
+
+- What does this design *say*? Can you name the idea in one sentence? If not, there isn't one.
+- Cover every piece of text and the logo — is the subject still recognizable? If not, visuals aren't carrying the message. (Exception: type-as-motif layouts — reframe the question to "does this type treatment survive being applied to a different subject?")
+- Swap the client name / product name — does it still work? **If yes, it's a template — this dimension is ≤5.**
+- Does the form derive from a unique motif in the content, or was it lifted from a style library?
+
+**Concept veto rule (hard)**: when concept ≤ 5, total score is **capped at 6.0** (upper end of "needs work"). The five execution dimensions are amplifiers — polishing a template further just makes it a shinier template.
+
+### 1. Philosophy alignment
+
+Does the piece stay coherent with the design philosophy / style / school it commits to?
+
+| Score | Standard |
+| --- | --- |
+| 9–10 | Fully embodies the philosophy's core spirit; every detail has a reason inside it |
+| 7–8 | Right overall direction; core traits present; minor detail drift |
+| 5–6 | Intent visible but execution mixes in other-style elements; not pure |
+| 3–4 | Surface mimicry; the philosophy's core is not understood |
+| 1–2 | Basically unrelated to the stated philosophy |
+
+Review checks:
+
+- Does the piece use the signature moves of the designer / school it invokes?
+- Do color, type, and layout choices align with that philosophy's rules?
+- Any self-contradicting elements? (E.g. choosing Kenya Hara's negative-space school and then packing the frame edge-to-edge.)
+
+### 2. Visual hierarchy
+
+Can the viewer's eye find the entry, follow the intended path, and reach the CTA without friction?
+
+| Score | Standard |
+| --- | --- |
+| 9–10 | Eye flows naturally along the designer's intended path; zero-friction information capture |
+| 7–8 | Primary vs. secondary is clear; 1–2 places of hierarchy drift |
+| 5–6 | Title vs. body separable; mid-level hierarchy is muddled |
+| 3–4 | Information laid flat; no clear visual entry |
+| 1–2 | Chaos — viewer doesn't know where to look first |
+
+Review checks:
+
+- Title vs. body: contrast ratio sufficient (defer to `primekit-frontend-design` for the numeric ratio)
+- 3–4 distinct hierarchy levels distinguishable by size / weight / color
+- Whitespace actively guiding the eye, not just filler
+- **Squint test**: squint your eyes — does the hierarchy still read?
+
+### 3. Craft quality
+
+Alignment, spacing, color discipline, edge quality.
+
+| Score | Standard |
+| --- | --- |
+| 9–10 | Pixel-precise; no visible alignment / spacing / color flaws |
+| 7–8 | Polished overall; 1–2 tiny alignment / spacing issues |
+| 5–6 | Basically aligned but spacing is inconsistent, color use unsystematic |
+| 3–4 | Obvious alignment errors, spacing chaos, too many colors |
+| 1–2 | Rough — looks like a draft |
+
+Review checks (**numeric standards defer to `primekit-frontend-design`**):
+
+- Uses a consistent spacing scale — not arbitrary values
+- Same element types share the same spacing
+- Color count controlled (bounded palette, not "whatever felt right")
+- Font family count controlled — cap deferred to `primekit-frontend-design`
+- Edge alignment is precise
+
+### 4. Functionality
+
+Does every element serve the goal, or is decoration crowding the message?
+
+| Score | Standard |
+| --- | --- |
+| 9–10 | Every element serves the goal; zero redundancy |
+| 7–8 | Clear function orientation; a small amount of trimmable decoration |
+| 5–6 | Basically usable but decorative elements distract |
+| 3–4 | Form over function; the viewer must work to find information |
+| 1–2 | Drowned in decoration; lost the ability to convey information |
+
+Review checks:
+
+- If you delete any single element, does the design get worse? If not, delete it.
+- Is the CTA / key info in the most prominent position?
+- Any "added because it looked nice" elements?
+- Information density matched to the medium? (A slide should not read like a PDF page.)
+
+### 5. Originality
+
+Freshness within the philosophy — not novelty for its own sake.
+
+| Score | Standard |
+| --- | --- |
+| 9–10 | Genuinely fresh; found a unique expression inside the chosen philosophy |
+| 7–8 | Has its own voice; not just template reuse |
+| 5–6 | Middle-of-the-road; looks like a template |
+| 3–4 | Heavy use of clichés (see below) |
+| 1–2 | Pure template or stock-asset collage |
+
+Review checks:
+
+- Did it dodge the common clichés below?
+- Personal expression present alongside philosophy adherence?
+- Any "unexpected but obviously right" design decisions?
+
+## Scene weighting — mapped to primekit-design's 7 subskills
+
+Concept dimension is not in this table — it is the first gate for every scene and is never traded off.
+
+| Subskill | Most important | Second | Can relax |
+| --- | --- | --- | --- |
+| Logo | Craft quality, Originality | Philosophy alignment | Functionality (a mark carries no interaction) |
+| CIP (Corporate Identity Program — business card, letterhead, signage) | Craft quality, Philosophy alignment | Functionality | Originality (fidelity to the brand system > novelty) |
+| Slides | Visual hierarchy, Functionality | Craft quality | Originality (clarity first) |
+| Banner (marketing / hero) | Functionality, Visual hierarchy | Originality | — (all-around requirement) |
+| Social photos (e.g. Xiaohongshu / IG posts) | Originality, Visual hierarchy | Philosophy alignment | Craft quality (atmosphere first) |
+| Icon | Craft quality, Functionality (semantic clarity) | Philosophy alignment | Originality (recognizability > novelty) |
+| Poster | Visual hierarchy, Originality | Craft quality | Functionality (single-glance impact leads) |
+
+Rows describe defaults; a brief that inverts the emphasis wins.
+
+## Common issues — Top 10
+
+Ranked by how often they show up in image-generation and mixed-medium design output. Style-based items are phrased as **default-off unless the brief demands**: the ban is against unconsidered reflex use, not against the aesthetic itself.
+
+### 1. AI-tech clichés (image-generation slop)
+
+- **Symptom**: gradient orbs, digital rain, blue circuit boards, robot faces, generic "neural network" node webs.
+- **Why it fails**: viewer fatigue. Cannot tell one brand from another.
+- **Fix**: replace literal symbols with abstract metaphors drawn from the content ("dialogue" as motif, not a chat-bubble icon).
+
+### 2. Neon / cyberpunk reflex
+
+- **Symptom**: deep navy background (near-black blue) + neon glow effects, used as the fallback for any "tech" brief.
+- **Default-off unless the brief demands** — it is one of the most-abused looks. When a brand's identity legitimately lives here (a synthwave label, a cyberpunk game), it can be the right answer.
+- **Fix (when out of scope)**: pick a palette with actual identifiability; defer numeric palette rules to `primekit-frontend-design`.
+
+### 3. Insufficient title-vs-body contrast
+
+- **Symptom**: title and body sizes too close.
+- **Fix**: widen the contrast — for the numeric ratio, defer to `primekit-frontend-design`.
+
+### 4. Too many colors
+
+- **Symptom**: five or more colors with no primary/secondary structure.
+- **Fix**: bounded palette with a clear primary / secondary / accent split — see `primekit-frontend-design` for the discipline.
+
+### 5. Inconsistent spacing
+
+- **Symptom**: element spacing feels arbitrary, no rhythm.
+- **Fix**: adopt a spacing scale — see `primekit-frontend-design` for the actual scale.
+
+### 6. Too much or too little whitespace
+
+- **Symptom**: either edge-to-edge cram or an aimless void with no anchor.
+- **Fix**: whitespace should guide the eye — defer to `primekit-frontend-design` for the ratio standard.
+
+### 7. Too many typefaces
+
+- **Symptom**: three or more type families competing.
+- **Fix**: cap the family count and use weight/size for variation — see `primekit-frontend-design`.
+
+### 8. Alignment mixing
+
+- **Symptom**: left-aligned here, centered there, right-aligned somewhere else, no reason.
+- **Fix**: pick one alignment discipline (usually left) and apply globally.
+
+### 9. Decoration outweighs content
+
+- **Symptom**: pattern / gradient / shadow / drop steals attention from the actual message.
+- **Fix**: "delete this decoration — does the design get worse?" If not, delete.
+
+### 10. Density–medium mismatch
+
+- **Symptom**: a whole PDF page's worth of text on one slide; ten motifs stuffed into a cover.
+- **Fix by medium**: slides = one point per slide; cover = one focal point; infographic = layered; PDF can be denser but needs navigation.
+
+## Review output template
+
+```
+## Design critique
+
+**Overall**: X.X/10 [excellent (8+) / good (6–7.9) / needs work (4–5.9) / fail (<4)]
+(When concept ≤ 5, total is capped at 6.0 — fix the concept before polishing execution.)
+
+**Dimension scores**:
+- Concept: X/10 — [the idea in one sentence, or "no idea"]
+- Philosophy alignment: X/10 — [one line]
+- Visual hierarchy: X/10 — [one line]
+- Craft quality: X/10 — [one line]
+- Functionality: X/10 — [one line]
+- Originality: X/10 — [one line]
+
+### Keep
+- [specific — describe in design language, not vibes]
+
+### Fix
+[sorted by severity]
+
+**1. [problem name]** — ⚠️ critical / ⚡ important / 💡 polish
+- Current: [what is there]
+- Why: [why it fails]
+- Fix: [specific action — for numeric standards defer to `primekit-frontend-design`]
+
+### Quick wins (5-minute pass)
+- [ ] [highest-impact fix]
+- [ ] [second]
+- [ ] [third]
+```
+
+## When *not* to critique this way
+
+- Sketch / rough / thumbnail: use "does the shape work at all?" — not the 6-dim rubric.
+- User-requested-cliché brief (parody, retro tribute, deliberate template): the "default-off" bans lift. Note in the review that they are lifted.
+- Micro-tweak follow-up: only score the affected dimensions.
+
+## Anti-pattern to avoid in the review itself
+
+- Don't remembered-hex. Never restate a brand's color as a specific hex code from memory — read it off `brand-spec.md` or the source. This mistake is what `brand-asset-protocol.md`'s case studies exist to prevent.
+- Don't restate craft numerics (font-count cap, whitespace %, spacing scale, OKLCH ramp, 60/30/10) — link to `primekit-frontend-design` instead. Two sources means eventual contradiction.