@design-ai/cli 4.55.0

package/knowledge/print/stationery.md

@@ -0,0 +1,262 @@
+<!-- hand-written -->
+---
+title: Stationery (business cards, letterhead, envelopes)
+applies_to: [print, stationery, business-card, brand]
+version: 1.0.0
+last_updated: 2026-05
+stability: stable
+---
+
+# Stationery
+
+Business cards, letterhead, envelopes — the most-touched physical brand surface. Read [`print-fundamentals.md`](print-fundamentals.md) first for CMYK / bleed / paper.
+
+## Business cards
+
+The smallest, most-touched, most-defining piece of brand stationery. People judge a brand from a card in 5 seconds.
+
+### Sizes
+
+| Region | Size (mm) | Notes |
+| --- | --- | --- |
+| Korean 명함 | **90 × 50** | Standard. Slightly larger than international. |
+| International | 85 × 55 | Most Western markets |
+| US | 88.9 × 50.8 (3.5" × 2") | Slight variant |
+| Japan | 91 × 55 | Slightly different again |
+| Square | 65 × 65 | Boutique / creative |
+| Mini | 70 × 28 | Designer / unconventional |
+
+If your brand is Korean primary: **use 90 × 50mm**. Western cards in Korean wallets stick out (literal physical inconvenience).
+
+### Anatomy
+
+```
+┌──────────────────────────────────┐
+│                                  │
+│   [Logo]                         │
+│                                  │
+│   Name 이름 (large)               │
+│   Title 직책 (medium)             │
+│                                  │
+│   Company 회사 (small)            │
+│   ───────────                    │
+│   Phone 전화                      │
+│   Email 이메일                    │
+│   Address 주소                    │
+│                                  │
+└──────────────────────────────────┘
+```
+
+Front: identity (logo, name, title).
+Back: contact info OR pure brand (just the logo big).
+
+### Information hierarchy
+
+Critical: **name + title + one contact method**. Everything else is secondary.
+
+A card with too much info is a card people don't read:
+- ✗ Phone, mobile, fax, email, web, two addresses, social handles, QR code
+- ✓ Name, title, mobile, email
+
+For Korean B2B: company name + position + mobile + email is the minimum. 회사 주소 if office-based.
+
+### Bilingual cards (Korean + English)
+
+Korean B2B cards are often bilingual:
+
+```
+Front (Korean):              Back (English):
+─────────────                 ─────────────
+김철수                         Cheolsu Kim
+대표 / 디자이너                CEO / Designer
+
+회사명                         Company name
+010-1234-5678                010-1234-5678
+chulsu@company.com           chulsu@company.com
+서울 강남구 ...                Seoul, Gangnam-gu, ...
+```
+
+Or both languages on the same side (compact):
+
+```
+김철수 / Cheolsu Kim
+대표 / CEO
+
+010-1234-5678 | chulsu@company.com
+```
+
+For Korean → international audiences: bilingual is expected.
+For Korean-only domestic: Korean only is fine, more space for hierarchy.
+For international primary: English only OK.
+
+### Typography on business cards
+
+- **Name**: 10-14pt (small enough to fit, large enough to read).
+- **Title**: 8-10pt.
+- **Contact**: 7-9pt.
+
+Don't go below 6pt. Don't go above 16pt for name (looks shouty).
+
+For Korean: Pretendard, Spoqa Han Sans Neo, AppleSDGothicNeo, NanumSquare are common. Pretendard is the default modern choice.
+
+For mixed Korean + English: pick a font that has both (Pretendard, Noto Sans CJK KR work well).
+
+### Paper
+
+Korean business card defaults:
+- **250-300gsm matte coated** — most common, mid-tier quality.
+- **300-350gsm uncoated** — environmental / artisanal feel.
+- **350-400gsm + soft-touch lamination** — premium, soft tactile.
+- **350gsm + foil stamp logo** — luxury, brand-critical.
+
+Avoid:
+- Thin 200gsm or below — feels cheap, bends in wallet.
+- Glossy / shiny finish for B2B — reads as low-end mass-market.
+
+### Finishes (premium)
+
+| Finish | Effect | Cost premium |
+| --- | --- | --- |
+| **Spot UV on logo** (matte stock + glossy logo only) | Tactile contrast | +15-30% |
+| **Foil stamp** (gold / silver / copper / holographic) | Metallic shine | +30-100% |
+| **Letterpress / 활판** | Antique-feel impression | +50-100% |
+| **Emboss / 양각** (raised) | 3D logo | +30-60% |
+| **Edge color** (painted edges) | Slim color line on edge | +20-40% |
+| **Die-cut shape** (rounded corners, custom shape) | Differentiated silhouette | +20-50% |
+| **Soft-touch lamination** | Velvety feel | +20-40% |
+
+Korean premium business cards often use 1-2 of these. Going above 2 reads as overdone.
+
+### Common card mistakes
+
+- **Type too small** to read at arm's length.
+- **Margins too tight** — text bleeds to the edge, looks cramped.
+- **Trim cut crops critical info** — content not in safe area.
+- **QR codes too small** to scan reliably (minimum 1cm × 1cm).
+- **CMYK conversion too late** — bright RGB color → dull on press.
+- **Contrast too low** — pale gray text on white doesn't read.
+- **Two-sided design ignoring orientation** — front portrait, back landscape, doesn't flip naturally.
+
+## Letterhead
+
+The branded letter format. Less common in 2024+ (most letters are PDF / email), but still required for:
+- Legal correspondence.
+- Formal business letters.
+- Invoices on company letterhead.
+- Certificates / awards.
+
+### Anatomy
+
+```
+┌─────────────────────────────────┐
+│  [Logo top-left]   [Date right] │   ← header
+│                                  │
+│  Recipient name                  │
+│  Recipient address               │
+│                                  │
+│  Re: Subject                     │
+│                                  │
+│  Dear ___,                       │
+│                                  │
+│  [Letter body — 1.5 line spacing]│
+│  ...                             │
+│                                  │
+│  Sincerely,                      │
+│  [Signature space]               │
+│  Sender name                     │
+│                                  │
+│  ─────────────────────────       │   ← footer
+│  Company name | Address          │
+│  Phone | Email | Website         │
+└─────────────────────────────────┘
+```
+
+### Margins
+
+| Margin | Top | Bottom | Left | Right |
+| --- | --- | --- | --- | --- |
+| Korean | 25-30mm | 25-30mm | 25-30mm | 25-30mm |
+| Western | 1" / 25mm | 1" | 1.25" | 1" |
+
+Equal margins look balanced. The recipient address is usually 2-3 lines below the header.
+
+### Typography
+
+- **Body**: 11-12pt, 1.5 line spacing.
+- **Korean**: Pretendard / Spoqa Han Sans Neo at 11pt is comfortable.
+- **English**: Garamond, Times, Georgia, Inter at 11pt.
+
+Single column. Margins control line length (45-75 char per line ideal).
+
+### Color
+
+- Letterhead is usually 1-color or 2-color (black + brand color).
+- 4-color CMYK letterhead is unusual — most letters print on personal printers (color = expensive).
+- Logo can be brand color; body text always black (best printer compatibility).
+
+## Envelopes
+
+| Korean envelope | Size (mm) | Use |
+| --- | --- | --- |
+| **DL** | 220 × 110 | Business letters, fits A4 folded in thirds |
+| **C5** | 229 × 162 | Half A4 |
+| **C4** | 324 × 229 | Full A4 unfolded (legal documents) |
+| **A6 / 카드 봉투** | 110 × 155 | Greeting cards, invitations |
+
+### Layout
+
+```
+┌────────────────────────────────────┐
+│  [Logo]                            │   ← top-left, small
+│                                    │
+│                                    │
+│           Recipient name           │   ← center or right
+│           Address line 1           │
+│           Address line 2           │
+│           City, Postcode           │
+│                                    │
+│  Sender info ─────                 │   ← bottom-left, small
+│  Sender name                       │
+│  Address                           │
+└────────────────────────────────────┘
+```
+
+For Korean post: postcode (우편번호) goes in a designated box; the format depends on KEPCO standards.
+
+For modern envelopes: window envelopes (with cut-out window showing address from the inserted letter) are more efficient — the same letter address shows through. Match the window position to the letter's address block.
+
+## Stationery as a system
+
+Stationery should feel like a coordinated set:
+- **Same logo** across all pieces.
+- **Same brand colors** (CMYK + Pantone matching).
+- **Same paper** (or coordinated paper system: 350gsm card + 100gsm letterhead in same color).
+- **Same typography**.
+- **Same hierarchy** (logo always top-left, address always bottom).
+
+Don't have a fancy gold-foil business card and a Word-template letterhead. Inconsistent = unprofessional.
+
+## Production tips
+
+- **Order business cards in 100s minimum** — single-card price is high.
+- **Order letterhead in 250-500 minimum** — printers' minimum.
+- **Order envelopes in 500 minimum** — usually MOQ.
+- **Reorder triggers**: business cards every 6-12 months (text changes), letterhead every 12-24 months.
+- **Test before bulk run**: order 1-10 sample cards first ($20-50), proof color + finish, then scale.
+
+## Don't
+
+- Don't put 5 contact methods on a business card. Pick 1-2 critical.
+- Don't use multiple fonts in stationery — pick 1-2 max.
+- Don't print Korean cards in international 85×55 size — odd in wallets.
+- Don't ship cards with low contrast. Card readers (people in dim restaurants) need legible text.
+- Don't change the layout halfway through a stationery order ("just change my card; letterhead stays old").
+- Don't print stationery before brand identity is locked. Reprints = full cost.
+
+## Cross-reference
+
+- [`knowledge/print/print-fundamentals.md`](print-fundamentals.md) — CMYK, bleed, DPI
+- [`knowledge/print/korean-print-conventions.md`](korean-print-conventions.md) — KR specifics
+- [`knowledge/patterns/brand-identity.md`](../patterns/brand-identity.md) — logo + brand
+- [`knowledge/typography/font-pairings.md`](../typography/font-pairings.md) — Pretendard + English pairings
+- [`knowledge/i18n/korean-document-style.md`](../i18n/korean-document-style.md) — Korean honorific level on formal letters

package/knowledge/spatial/ar-patterns.md

@@ -0,0 +1,253 @@
+<!-- hand-written -->
+---
+title: AR patterns (mobile AR, headset MR, world-anchored UI)
+applies_to: [ar, mixed-reality, augmented-reality, arkit, arcore, hololens]
+version: 1.0.0
+last_updated: 2026-05
+stability: stable
+---
+
+# AR patterns
+
+Augmented Reality and Mixed Reality. The user's real environment is enhanced with virtual content. Mobile AR (ARKit on iOS, ARCore on Android), headset MR (Vision Pro passthrough, Quest passthrough, HoloLens).
+
+Read [`spatial-design-fundamentals.md`](spatial-design-fundamentals.md) first.
+
+## AR vs VR — design differences
+
+| | VR | AR |
+| --- | --- | --- |
+| Background | Fully virtual | Real environment |
+| Lighting | Controlled | Variable (sun, lamps, dim) |
+| Surfaces | Designed | User's room (random) |
+| Movement | Locomotion-aware | Real walking |
+| Privacy | Closed | Public (shared cameras) |
+| Battery | Tethered or VR-class | Mobile / headset shared |
+
+AR designs **survive variable conditions**. White text on an off-white wall? Unreadable. Plan for any background.
+
+## Three AR contexts
+
+### 1. Mobile handheld AR
+
+iPhone / Android holding the device up:
+- **Phone screen as window** to AR world.
+- **One hand for device, one for interaction**.
+- **Limited session length** (arm fatigue at 30s+).
+- **Looking at phone, not real world** (different from VR / headset).
+
+Examples: Pokemon GO, Snap filters, IKEA Place, Google Lens AR translate.
+
+Design:
+- Treat as a moving viewport.
+- Critical UI on screen (not in world).
+- Short interaction sessions.
+- Small visual angles (limited screen).
+
+### 2. AR glasses / headset (HoloLens, Vision Pro passthrough, Magic Leap)
+
+Wearable; hands free:
+- **Both hands free**.
+- **Full FOV** (varies by device).
+- **Real environment visible** through display.
+- **Long sessions possible**.
+
+Examples: HoloLens medical training, Vision Pro productivity (passthrough mode), industrial AR.
+
+Design:
+- World-anchored UI works.
+- Hand interactions natural.
+- Real-world context informs UI.
+
+### 3. World-anchored AR (object recognition / mapping)
+
+Virtual content anchored to real things:
+- **Marker-based** (QR code, image triggers content).
+- **Plane-detection** (place virtual furniture on detected floor).
+- **Object recognition** (recognize a product, show overlay).
+- **Persistent anchors** (content stays where user placed it across sessions).
+
+Examples: IKEA Place (place furniture), Hyundai AR car configurator, museum AR exhibits.
+
+## Visibility against real backgrounds
+
+The hardest AR design problem.
+
+### Strategies
+
+| Strategy | When |
+| --- | --- |
+| **Solid background panel** | Default — opaque or semi-opaque rectangle behind UI |
+| **Drop shadow / outline** | Floating text / icons; visible on most backgrounds |
+| **High-contrast colors** | Bright UI, dark text — forces visibility |
+| **Animated highlight** | Pulsing brings attention even on busy backgrounds |
+| **Semi-transparent backdrop** | Blur the real world behind UI panel |
+
+For mobile AR (iPhone): use semi-opaque dark panels; readable on any background.
+
+For headset MR (HoloLens, Vision Pro): plan for variable lighting; user can't dim their room.
+
+## Spatial mapping and surface detection
+
+ARKit / ARCore detect:
+- **Horizontal planes** (floors, tables).
+- **Vertical planes** (walls).
+- **Mesh** (Vision Pro, HoloLens — full room mesh).
+
+UI rules:
+- **Place furniture on horizontal planes**, anchored to floor.
+- **Hang artwork on vertical planes**, anchored to walls.
+- **Snap to surfaces** for natural feel.
+- **Show detection state** to user ("Move phone to detect surfaces", indicator showing detected plane).
+
+## Anchoring strategies
+
+### World-locked
+
+Content stays where placed in the world. User moves around it.
+
+- **Stable anchor** required (some surfaces drift over time).
+- **Re-localization** when user returns to same space (cloud anchors).
+
+### Image-locked
+
+Content tied to a recognized image / marker:
+- **Print marker** triggers content (museum signs, posters).
+- **QR code** for entry point.
+- **Object recognition** — Coca-Cola can recognized → branded experience plays.
+
+### Body-locked / wrist
+
+UI on body parts (Vision Pro Home View on wrist).
+
+### Screen-locked (mobile AR)
+
+UI overlaid on phone screen, not in 3D world. For:
+- App controls (close, share).
+- Persistent indicators.
+- Status info.
+
+Don't put everything in world — some 2D UI on the phone screen is better.
+
+## Onboarding AR
+
+First-run experience:
+
+```
+Step 1: "Hold phone up and move slowly"
+        → User scans environment
+        → System detects surfaces
+        → Visual feedback: dots / mesh on detected planes
+
+Step 2: "Tap to place"
+        → Reticle appears on detected surface
+        → User taps; content appears
+
+Step 3: "Walk around to see"
+        → User moves; content stays anchored
+```
+
+Rules:
+- **Visual instructions** at each step (animated).
+- **No long text walls** — show, don't tell.
+- **Skip option** for repeat users.
+- **Restart** if AR session fails (lost tracking).
+
+## Common AR interactions
+
+| Interaction | How |
+| --- | --- |
+| **Place object** | Tap-on-screen at detected surface |
+| **Move object** | Drag (mobile) / pinch + move (headset) |
+| **Rotate** | Two-finger twist (mobile) / hand gesture (headset) |
+| **Scale** | Pinch (mobile) / two-hand spread (headset) |
+| **Activate** | Tap (mobile) / pinch (headset) |
+| **Delete** | Drag off-screen / dedicated button |
+
+Provide visual feedback for each interaction.
+
+## Permission and privacy
+
+AR requires camera access. Permission flow:
+
+```
+"To use AR, [App] needs camera access"
+[Allow]  [Don't allow]
+```
+
+Once granted: explain what happens with camera data:
+- Local processing only? Or cloud?
+- Storage? Sharing?
+- Right to delete?
+
+For privacy-sensitive AR (face filters, body capture):
+- Local processing whenever possible.
+- Disclose if cloud upload.
+- Comply with regional privacy laws (GDPR, 개인정보보호법).
+
+## Tracking failure handling
+
+AR tracking can lose:
+- **Low light** — can't see features.
+- **Featureless surfaces** — blank wall.
+- **Rapid motion** — blur.
+- **Reflective surfaces** — glass, mirrors.
+
+UX:
+- **Visible tracking quality indicator**.
+- **Recovery prompt**: "Move slowly... point camera at textured surface".
+- **Pause AR** when tracking lost; resume when recovered.
+- **Fallback to 2D mode** if persistent failure.
+
+## Korean AR market
+
+Limited but growing:
+- **Naver Z (Zepeto)** — virtual avatars + AR features.
+- **Snapchat / Instagram filters** — large user base.
+- **Pokemon GO** — sustained popularity.
+- **Retail AR** — Shinsegae, Hyundai car configurators.
+- **Tourism / museum AR** — government-sponsored.
+
+For Korean AR product:
+- Korean voice / text overlays.
+- Mobile-first (iPhone + Galaxy primary).
+- Camera permission UX in Korean (개인정보보호법 compliance).
+
+## Mobile AR performance
+
+Mobile constraints:
+- **Battery drain** — heavy CPU + GPU + camera.
+- **Heat** — phone gets hot fast.
+- **Limited session length** — 5-15 minutes typical before user puts phone down.
+
+Optimize:
+- **Reduce polygon count** — mobile-friendly models.
+- **Bake lighting** instead of real-time.
+- **Lower resolution** for distant objects.
+- **Pause when idle** — turn off camera processing during dialog.
+
+## Headset MR performance
+
+Vision Pro / HoloLens / Quest 3 passthrough:
+- **Passthrough rendering cost** — real-time camera feed processing.
+- **Hand tracking compute** — separate from rendering.
+- **Higher polygon budget** than mobile but still finite.
+
+## Don't
+
+- Don't ignore variable lighting. Test in dark, bright, mixed.
+- Don't put critical UI invisible against common backgrounds (white text on white wall).
+- Don't ignore tracking loss. Always show recovery path.
+- Don't make sessions too long. Mobile AR is 5-15 min comfort limit.
+- Don't request camera without explaining why.
+- Don't ship persistent anchors without re-localization fallback.
+- Don't ignore privacy. Camera data is sensitive.
+- Don't assume horizontal floor exists — some users in standing-only spaces.
+
+## Cross-reference
+
+- [`knowledge/spatial/spatial-design-fundamentals.md`](spatial-design-fundamentals.md) — fundamentals
+- [`knowledge/spatial/vr-patterns.md`](vr-patterns.md) — VR
+- [`knowledge/spatial/spatial-ui-elements.md`](spatial-ui-elements.md) — panels, controls
+- [`knowledge/spatial/comfort-and-accessibility.md`](comfort-and-accessibility.md) — comfort + a11y
+- [`knowledge/i18n/korean-payments.md`](../i18n/korean-payments.md) — KR privacy law