get-shit-pretty 0.7.0 → 0.7.3

package/gsp/skills/gsp-style/styles/professional.md

@@ -1,539 +1,503 @@
-<role>
-You are an expert frontend engineer, UI/UX designer, visual design specialist, and typography expert. Your goal is to help the user integrate a design system into an existing codebase in a way that is visually consistent, maintainable, and idiomatic to their tech stack.
-
-Before proposing or writing any code, first build a clear mental model of the current system:
-
-- Identify the tech stack (e.g. React, Next.js, Vue, Tailwind, shadcn/ui, etc.).
-- Understand the existing design tokens (colors, spacing, typography, radii, shadows), global styles, and utility patterns.
-- Review the current component architecture (atoms/molecules/organisms, layout primitives, etc.) and naming conventions.
-- Note any constraints (legacy CSS, design library in use, performance or bundle-size considerations).
-
-Ask the user focused questions to understand the user's goals. Do they want:
-
-- a specific component or page redesigned in the new style,
-- existing components refactored to the new system, or
-- new pages/features built entirely in the new style?
-
-Once you understand the context and scope, do the following:
-
-- Propose a concise implementation plan that follows best practices, prioritizing:
-  - centralizing design tokens,
-  - reusability and composability of components,
-  - minimizing duplication and one-off styles,
-  - long-term maintainability and clear naming.
-- When writing code, match the user’s existing patterns (folder structure, naming, styling approach, and component patterns).
-- Explain your reasoning briefly as you go, so the user understands *why* you’re making certain architectural or design choices.
-
-Always aim to:
-
-- Preserve or improve accessibility.
-- Maintain visual consistency with the provided design system.
-- Leave the codebase in a cleaner, more coherent state than you found it.
-- Ensure layouts are responsive and usable across devices.
-- Make deliberate, creative design choices (layout, motion, interaction details, and typography) that express the design system’s personality instead of producing a generic or boilerplate UI.
-
-</role>
-
-<design-system>
-# Design Style: Serif
-
-## Design Philosophy
-
-### Core Principle
-
-**Typographic elegance through classical restraint.** This design system draws inspiration from the finest editorial publications, literary magazines, and luxury brand identities. It believes that the highest form of design is one that elevates content through refined typography, considered spacing, and deliberate simplicity.
-
-The serif typeface is not merely a font choice—it is the soul of this aesthetic. Every curve of the letterform, every carefully weighted stroke, speaks to centuries of typographic tradition. This design honors that heritage while executing with modern precision.
-
-### The Visual Vibe
-
-**Editorial. Timeless. Warm. Refined.**
-
-Imagine opening a beautifully designed hardcover book or a premium architecture magazine. The pages breathe. The typography has room to speak. Nothing screams for attention because everything has been placed with intention. This is the feeling we create.
-
-**Emotional Keywords:**
-
-- *Timeless* — This design would feel appropriate today, a decade ago, or a decade from now. It transcends trends.
-- *Warm* — The ivory backgrounds, the organic serif curves, the golden accent create an inviting, human quality.
-- *Sophisticated* — Small caps, refined rules, generous margins all whisper quality and attention to detail.
-- *Literary* — This feels like it belongs in the world of ideas, of considered communication, of meaningful content.
-- *Confident* — True elegance comes from restraint, not embellishment. This design is secure enough to be quiet.
-
-**What This Design Is NOT:**
-
-- Not cold or stark (despite being minimal)
-- Not trendy or ephemeral (the serif anchors it in timelessness)
-- Not decorative or ornate (restraint is key)
-- Not corporate or generic (the typography gives it soul)
-- Not loud or aggressive (it draws you in rather than demanding attention)
-
-### The DNA of This Style
-
-#### 1. The Signature Serif
-
-The **Playfair Display** typeface is the cornerstone. Its high contrast between thick and thin strokes, its elegant ball terminals, and its classical proportions immediately establish editorial gravitas. This font has presence—it commands attention without raising its voice.
-
-**Where it appears:**
-
-- All major headlines (h1, h2, h3)
-- Large display numbers (pricing, stats)
-- Pull quotes in testimonials
-- Logo wordmark
-
-**Why it works:** Serif typefaces carry associations with tradition, trustworthiness, and intellectual depth. Playfair Display specifically feels both classical and contemporary—it's not stuffy or old-fashioned but brings warmth and character.
-
-#### 2. The Warm Palette
-
-Color in this system is used with extreme restraint. The palette is essentially monochromatic with a single warm accent:
-
-- **Ivory (#FAFAF8)** — A cream-tinted white that feels warmer than pure white
-- **Rich Black (#1A1A1A)** — Deep but not harsh, for primary text
-- **Warm Gray (#6B6B6B)** — For secondary text, with slight warmth
-- **Burnished Gold (#B8860B)** — The single accent color, used sparingly for emphasis
-
-The gold accent is inspired by gold leaf in illuminated manuscripts, the gilded edges of fine books, the brass details in luxury interiors. It adds just enough warmth and distinction without overwhelming the monochrome foundation.
-
-#### 3. The Rule Line System
-
-Thin horizontal rules (1px lines) are a defining element:
-
-- Section dividers
-- Card borders (top accent lines)
-- Underline effects on key elements
-- Table separators
-
-These rules are inspired by editorial layouts where fine lines create structure and rhythm without visual weight. They're always in the border color (#E8E4DF), slightly warmer than pure gray.
-
-#### 4. Small Caps & Tracking
-
-**Small caps** are used extensively for:
-
-- Section labels
-- Meta information (dates, categories)
-- Supporting text
-- Navigation items
-
-Combined with **generous letter-spacing (0.1em - 0.15em)**, small caps create a refined, sophisticated look that's distinctly editorial. This is not a cheap trick—it's a typography fundamental that separates thoughtful design from generic output.
-
-#### 5. Generous Whitespace
-
-This design breathes. Margins are large. Padding is substantial. Line heights are relaxed.
-
-- Section padding: `py-32` to `py-44`
-- Content max-width: `max-w-5xl` (narrower for reading comfort)
-- Line height for body: `1.75` (very relaxed)
-- Letter spacing for body: slight positive tracking for readability
-
-The whitespace isn't empty—it's an active design element that gives the typography room to perform.
-
-#### 6. Asymmetric Balance
-
-While the overall aesthetic is classical, the layouts embrace asymmetric compositions:
-
-- Hero: Centered but with offset decorative elements
-- Benefits: Uneven column splits (1.3fr / 0.7fr)
-- Cards: Thin top border creates visual weight at top
-
-This prevents the design from feeling static or predictable while maintaining elegance.
-
-### Differentiation: Minimalism With Soul
-
-Many minimalist designs strip away so much that they become characterless—white backgrounds, gray text, system fonts. This design proves that minimalism and personality are not mutually exclusive.
-
-**The serif typeface is the key differentiator.** It brings:
-
-- Visual interest without decoration
-- Warmth without color
-- Character without complexity
-- Timelessness without being dated
-
-This is minimalism with a point of view. It has something to say.
-
-### Sensory Description
-
-If this design were a physical space, it would be:
-
-- A private library with floor-to-ceiling bookshelves
-- Natural light filtering through tall windows
-- A worn leather chair and a mahogany writing desk
-- The smell of aged paper and fresh coffee
-- Silence that invites contemplation
-
-If it were music, it would be:
-
-- Solo piano, perhaps Satie or Debussy
-- Lots of space between notes
-- Warm, resonant tones
-- Something you'd hear in a boutique hotel lobby
-- Understated but unmistakably refined
-
----
-
-## Design Token System (The DNA)
-
-### Color Strategy
-
-**Monochrome With Warmth:** An intentionally limited palette that gains sophistication through restraint. The single gold accent provides just enough distinction.
-
-| Token                 | Value       | Usage & Context                                                        |
-| :-------------------- | :---------- | :--------------------------------------------------------------------- |
-| `background`        | `#FAFAF8` | Primary canvas. Warm ivory that feels more refined than pure white.    |
-| `foreground`        | `#1A1A1A` | Primary text. Rich black, not pure black.                              |
-| `muted`             | `#F5F3F0` | Secondary surfaces, card backgrounds. Slightly warmer than background. |
-| `muted-foreground`  | `#6B6B6B` | Secondary text. Warm gray with softness.                               |
-| `accent`            | `#B8860B` | Burnished gold. Links, highlights, key interactive elements.           |
-| `accent-secondary`  | `#D4A84B` | Lighter gold for gradients and hover states.                           |
-| `accent-foreground` | `#FFFFFF` | Text on accent backgrounds.                                            |
-| `border`            | `#E8E4DF` | Warm gray for rules, dividers, card borders.                           |
-| `card`              | `#FFFFFF` | Card surfaces. Pure white for maximum lift from ivory background.      |
-| `ring`              | `#B8860B` | Focus rings. Matches accent gold.                                      |
-
----
-
-### Typography System
-
-**Font Pairing (Editorial System):**
-
-- **Display/Headlines:** `"Playfair Display", Georgia, serif` — Elegant high-contrast serif for all headings. The signature of this design.
-- **Body/UI:** `"Source Sans 3", system-ui, sans-serif` — Clean, highly readable sans-serif that complements without competing.
-- **Monospace:** `"IBM Plex Mono", monospace` — For labels and small caps treatments.
-
-**Type Scale & Usage:**
-
-| Element           | Size                  | Font             | Weight   | Tracking    | Notes                                |
-| :---------------- | :-------------------- | :--------------- | :------- | :---------- | :----------------------------------- |
-| Hero Headline     | `7xl` → `4.5rem` | Playfair Display | Normal   | `-0.02em` | Tight leading (1.1). Center-aligned. |
-| Section Headlines | `4xl` → `2.5rem` | Playfair Display | Normal   | `-0.01em` | Leading 1.2.                         |
-| Card Titles       | `xl` → `1.25rem` | Playfair Display | Semibold | Normal      | Leading 1.3.                         |
-| Body Text         | `base` → `lg`    | Source Sans 3    | Normal   | `0.01em`  | Relaxed line-height (1.75).          |
-| Section Labels    | `xs` (12px)         | IBM Plex Mono    | Medium   | `0.15em`  | UPPERCASE small caps style.          |
-| Navigation        | `sm`                | Source Sans 3    | Medium   | `0.05em`  | Slightly tracked.                    |
-
-**Small Caps Pattern:**
-
-```css
-.small-caps {
-  font-family: "IBM Plex Mono", monospace;
-  font-size: 0.75rem;
-  font-weight: 500;
-  letter-spacing: 0.15em;
-  text-transform: uppercase;
-}
-```
-
----
-
-### Spacing & Layout
-
-**Core Principle:** Luxurious breathing room. This design is not afraid of empty space.
-
-- **Section Spacing:** Large vertical padding (`py-32` to `py-44`) creates paced, contemplative scrolling.
-- **Container Width:** `max-w-5xl` (64rem) for narrower, more readable content columns.
-- **Component Density:** Generous internal padding (p-8 to p-10) on cards.
-- **Grid Gaps:** `gap-8` to `gap-12` between grid items.
-
-**Layout Patterns:**
-
-- Hero: Centered, narrow container, stacked elements
-- Features: 3-column grid with generous gaps
-- Benefits: Asymmetric 2-column (`grid-cols-[1.3fr_0.7fr]`)
-- Use thin rule lines to create visual structure
-
----
-
-### Borders, Surfaces & Shadows
-
-**Surfaces:**
-
-- Cards use pure white (`#FFFFFF`) for lift from ivory background
-- Very subtle shadows—this isn't about depth, it's about refinement
-- Thin borders (1px) in warm gray
-
-**Border System:**
-
-| Token             | Value                 | Usage                             |
-| :---------------- | :-------------------- | :-------------------------------- |
-| `border-thin`   | `1px solid #E8E4DF` | Primary borders, rules            |
-| `border-accent` | `1px solid #B8860B` | Accent borders, highlighted cards |
-
-**Shadow System:**
-
-| Token         | Value                              | Usage               |
-| :------------ | :--------------------------------- | :------------------ |
-| `shadow-sm` | `0 1px 2px rgba(26,26,26,0.04)`  | Subtle lift         |
-| `shadow-md` | `0 4px 12px rgba(26,26,26,0.06)` | Cards, hover states |
-| `shadow-lg` | `0 8px 24px rgba(26,26,26,0.08)` | Elevated elements   |
-
-**Rule Lines (Critical for Style Identity):**
-
-- Thin horizontal rules as section dividers
-- Top border accent on cards (1px accent color)
-- Decorative rule under headlines
-
----
-
-## Component Styling & Interactions
-
-### Buttons
-
-**Primary Button:**
-
-- Background: `accent` gold
-- Text: White, medium weight, slightly tracked
-- Border-radius: `rounded-md` (6px) — not too round, not too sharp
-- Shadow: Very subtle, accent-tinted (`shadow-sm`)
-- Hover: Color shifts to `accent-secondary`, shadow enhances to `shadow-accent`, subtle lift (-translate-y-0.5)
-- Active: Returns to base position (translate-y-0)
-- Touch: `touch-manipulation` class for better mobile interaction
-- Minimum height: 44px on mobile (accessibility requirement)
-
-**Secondary/Outline Button:**
-
-- Background: Transparent
-- Border: `1px` in `foreground` color (strong contrast)
-- Text: `foreground`
-- Hover: Fill with `muted` background, border and text shift to `accent` color
-- Smooth color transitions on all properties
-
-**Ghost Button:**
-
-- No background or border
-- Text: `muted-foreground` → `foreground` on hover
-- Underline appears on hover with `accent` color decoration
-- Underline offset: 4px for breathing room
-
-**Animation:** Refined transitions (`200ms`). Subtle lift on primary buttons adds tactile feedback while maintaining elegance.
-
----
-
-### Cards
-
-**Standard Card:**
-
-- Background: `card` (white)
-- Border: `1px` in `border` color
-- Border-radius: `rounded-lg` (8px)
-- Shadow: `shadow-sm` — very subtle
-- Top accent: Optional `2px` accent border on top edge (when `accentTop` prop used)
-
-**Hover Effects (when `hoverEffect` prop used):**
-
-- Shadow increases to `shadow-md`
-- Border color shifts to `border-hover`
-- Background subtle tint to `muted/30` (30% opacity)
-- No translate/lift — maintains elegant restraint
-- Smooth `200ms` transition on all properties
-
-**Elevated Card:**
-
-- Uses `shadow-md` by default (when `elevated` prop used)
-- Provides more depth for important content like highlighted pricing tiers
-
-**Featured Card:**
-
-- Background tint of accent color at 6% (`accent-muted`)
-- Accent top border at 2px thickness
-- Often combined with elevated shadow for maximum prominence
-
----
-
-### Inputs
-
-- Height: `h-12` (44px minimum for accessibility)
-- Border: `1px` in `input` color (matches `border`)
-- Border-radius: `rounded-md` (6px)
-- Background: Transparent
-- Hover: Border shifts to `border-hover` color
-- Focus:
-  - `ring-2 ring-accent ring-offset-2`
-  - Border shifts to `accent` color for clear visual feedback
-  - Smooth `150ms` transition
-- Placeholder: `text-muted-foreground/60` (60% opacity for subtle hierarchy)
-- Typography: Sans-serif body font, base size
-- Transitions: All properties animate smoothly with `ease-out` easing
-
----
-
-### Section Labels
-
-A consistent label pattern appears at the start of each section:
-
-```jsx
-<div className="mb-6 flex items-center gap-4">
-  <span className="h-px flex-1 bg-[var(--border)]" />
-  <span className="font-mono text-xs font-medium uppercase tracking-[0.15em] text-[var(--accent)]">
-    Section Name
-  </span>
-  <span className="h-px flex-1 bg-[var(--border)]" />
-</div>
-```
-
----
-
-## The "Bold Factor" (Signature Elements)
-
-These elements prevent generic output and define this style:
-
-1. **Dramatic Serif Headlines:** Oversized serif typography (7xl in hero) that commands attention through scale and beauty, not decoration.
-2. **Rule Line System:** Thin horizontal rules throughout create rhythm and structure—a distinctly editorial element.
-3. **Small Caps Labels:** All section labels and meta info use tracked uppercase monospace, creating refined visual rhythm.
-4. **Burnished Gold Accent:** The single warm accent color adds just enough distinction to prevent sterility.
-5. **Generous Whitespace:** Sections breathe with `py-32` to `py-44` padding. This is premium, not cramped.
-6. **Large Display Numbers:** Stats and pricing use serif display numbers at dramatic sizes (5xl+).
-7. **Decorative Quote Marks:** Testimonials feature large opening quote marks in accent gold.
-8. **Asymmetric Layouts:** Strategic use of uneven columns prevents static feeling while maintaining elegance.
-9. **Layered Depth in Abstracts:** Product detail and benefits sections feature enhanced abstract graphics with:
-
-   - Gradient backgrounds (`from-[color] via-[color] to-[color]`)
-   - Decorative ring/circle elements with low opacity
-   - Multi-layered card elements with borders and shadows
-   - Hover-interactive elements that respond to user interaction
-   - Subtle accent color tints for visual interest
-10. **Paper Texture Overlay:** Subtle noise texture overlay at 30% opacity across entire page creates tactile, print-like quality.
-11. **Ambient Glow:** Large blurred circle with 2% opacity accent color creates warm atmospheric depth.
-12. **Enhanced Micro-interactions:**
-
-    - Button subtle lift on hover with return animation
-    - Card background tinting on hover
-    - Border color shifts throughout interface
-    - Smooth 200ms transitions on all interactive elements
-
----
-
-## Effects & Animation
-
-**Motion Philosophy:** Restrained and refined. Nothing bounces, nothing overshoots. Every animation should feel inevitable, not surprising.
-
-**Transition Defaults:**
-
-- Standard: `transition-all duration-200 ease-out`
-- Subtle: `duration-150`
-
-**Interaction States:**
-
-- Hover brightness change: 5-10%, no dramatic shifts
-- Shadow enhancement on hover
-- Underlines appearing/growing
-- NO translate/lift effects — too trendy for this timeless aesthetic
-
-**Entrance Animations (Optional, Subtle):**
-
-```js
-const fadeIn = {
-  hidden: { opacity: 0 },
-  visible: { opacity: 1, transition: { duration: 0.6, ease: "easeOut" } }
-};
-```
-
----
-
-## Responsive Strategy
-
-**Breakpoint Philosophy:** Mobile layouts maintain the editorial feel through typography and spacing, even when structure simplifies. All interactive elements meet accessibility requirements for touch targets.
-
-### Mobile Adaptations (< 768px)
-
-- **Hero:**
-
-  - Single column with centered text
-  - Headline size: `text-[2.5rem]` (40px) maintains presence
-  - CTAs stack vertically with full width on small screens
-  - Maintains generous vertical padding
-- **Stats:**
-
-  - 2-column grid on mobile (4-column on desktop)
-  - Vertical dividers between columns only (not all items)
-  - Numbers scale to `text-4xl` (still prominent)
-  - Horizontal gap added (`gap-x-6`) to prevent crowding
-- **Features/Testimonials/Blog:**
-
-  - Stack to single column
-  - Generous gaps maintained (`gap-8` minimum)
-  - Card styling remains consistent
-  - Hover effects work as tap effects on mobile
-- **Pricing:**
-
-  - Stack vertically
-  - Highlighted tier loses elevation (no -translate-y-4) but keeps visual distinction through background tint
-  - All cards equal width for consistency
-- **Navigation:**
-
-  - Logo scales down slightly (`text-lg` → `text-xl`)
-  - Desktop nav hidden on mobile/tablet
-  - Primary CTA always visible
-  - Mobile menu would be hamburger pattern (if implemented)
-
-### Touch Optimization
-
-- **All buttons:** Minimum 44px height (`min-h-[44px]`) on mobile
-- **FAQ accordions:** 44px minimum height with `touch-manipulation`
-- **All interactive elements:** Use `touch-manipulation` CSS for better tap response
-- **Links:** Adequate padding and spacing for fat-finger friendly tapping
-
-**Key Adaptations:**
-
-- Section padding reduces gracefully but maintains premium feel
-- Typography scales down but hierarchy crystal clear
-- Serif font impact preserved—soul of design intact on all devices
-- Rule lines and gold accents remain consistent
-- No horizontal overflow—tested with various content widths
-- Touch targets meet WCAG AAA standards (minimum 44x44px)
-
----
-
-## Accessibility & Best Practices
-
-**Color Contrast:**
-
-- All text meets WCAG AA standards minimum
-- Rich black (#1A1A1A) on ivory (#FAFAF8) provides excellent readability
-- Gold accent (#B8860B) passes contrast requirements on white backgrounds
-- Muted foreground (#6B6B6B) maintains sufficient contrast for secondary text
-
-**Focus States:**
-
-- Visible focus rings on all interactive elements: `ring-2 ring-accent ring-offset-2`
-- Focus states use accent gold color for consistency
-- Offset creates clear visual separation from element
-- Input borders shift to accent color on focus for additional feedback
-- All focus states tested with keyboard navigation
-
-**Touch & Interaction:**
-
-- All buttons meet minimum 44x44px touch target (WCAG AAA)
-- `touch-manipulation` CSS prevents double-tap zoom on mobile
-- FAQ accordion buttons have adequate size and spacing
-- All clickable areas have sufficient padding
-- No touch targets overlap or create confusion
-
-**Typography:**
-
-- Body text uses relaxed line-height (1.75) for comfortable reading
-- Slight positive tracking improves readability on screens
-- Base font size: 16px (never smaller for body text)
-- Heading hierarchy clearly defined with size and font variation
-- Line length controlled with max-width (max-w-5xl) for optimal reading
-
-**Motion:**
-
-- All animations are subtle and respectful (200ms standard)
-- No rapid movements or flashing
-- Transforms limited to subtle shifts (translate-y-0.5)
-- `prefers-reduced-motion` should be respected in production
-- Easing curves use gentle `ease-out` for natural feel
-
-**Semantic HTML:**
-
-- Proper heading hierarchy (h1 → h2 → h3)
-- Button elements for interactive actions (not divs)
-- Semantic sections with appropriate ARIA when needed
-- Images include meaningful alt text (width/height prevent CLS)
-- Form inputs properly labeled
-
-**Performance:**
-
-- CSS variables reduce specificity and improve maintainability
-- Transitions use transform and opacity (GPU-accelerated)
-- Images specify dimensions to prevent layout shift
-- Font loading optimized with proper font-display values
-  `</design-system>`
+<design-system>
+# Design Style: Serif
+
+## Design Philosophy
+
+### Core Principle
+
+**Typographic elegance through classical restraint.** This design system draws inspiration from the finest editorial publications, literary magazines, and luxury brand identities. It believes that the highest form of design is one that elevates content through refined typography, considered spacing, and deliberate simplicity.
+
+The serif typeface is not merely a font choice—it is the soul of this aesthetic. Every curve of the letterform, every carefully weighted stroke, speaks to centuries of typographic tradition. This design honors that heritage while executing with modern precision.
+
+### The Visual Vibe
+
+**Editorial. Timeless. Warm. Refined.**
+
+Imagine opening a beautifully designed hardcover book or a premium architecture magazine. The pages breathe. The typography has room to speak. Nothing screams for attention because everything has been placed with intention. This is the feeling we create.
+
+**Emotional Keywords:**
+
+- *Timeless* — This design would feel appropriate today, a decade ago, or a decade from now. It transcends trends.
+- *Warm* — The ivory backgrounds, the organic serif curves, the golden accent create an inviting, human quality.
+- *Sophisticated* — Small caps, refined rules, generous margins all whisper quality and attention to detail.
+- *Literary* — This feels like it belongs in the world of ideas, of considered communication, of meaningful content.
+- *Confident* — True elegance comes from restraint, not embellishment. This design is secure enough to be quiet.
+
+**What This Design Is NOT:**
+
+- Not cold or stark (despite being minimal)
+- Not trendy or ephemeral (the serif anchors it in timelessness)
+- Not decorative or ornate (restraint is key)
+- Not corporate or generic (the typography gives it soul)
+- Not loud or aggressive (it draws you in rather than demanding attention)
+
+### The DNA of This Style
+
+#### 1. The Signature Serif
+
+The **Playfair Display** typeface is the cornerstone. Its high contrast between thick and thin strokes, its elegant ball terminals, and its classical proportions immediately establish editorial gravitas. This font has presence—it commands attention without raising its voice.
+
+**Where it appears:**
+
+- All major headlines (h1, h2, h3)
+- Large display numbers (pricing, stats)
+- Pull quotes in testimonials
+- Logo wordmark
+
+**Why it works:** Serif typefaces carry associations with tradition, trustworthiness, and intellectual depth. Playfair Display specifically feels both classical and contemporary—it's not stuffy or old-fashioned but brings warmth and character.
+
+#### 2. The Warm Palette
+
+Color in this system is used with extreme restraint. The palette is essentially monochromatic with a single warm accent:
+
+- **Ivory (#FAFAF8)** — A cream-tinted white that feels warmer than pure white
+- **Rich Black (#1A1A1A)** — Deep but not harsh, for primary text
+- **Warm Gray (#6B6B6B)** — For secondary text, with slight warmth
+- **Burnished Gold (#B8860B)** — The single accent color, used sparingly for emphasis
+
+The gold accent is inspired by gold leaf in illuminated manuscripts, the gilded edges of fine books, the brass details in luxury interiors. It adds just enough warmth and distinction without overwhelming the monochrome foundation.
+
+#### 3. The Rule Line System
+
+Thin horizontal rules (1px lines) are a defining element:
+
+- Section dividers
+- Card borders (top accent lines)
+- Underline effects on key elements
+- Table separators
+
+These rules are inspired by editorial layouts where fine lines create structure and rhythm without visual weight. They're always in the border color (#E8E4DF), slightly warmer than pure gray.
+
+#### 4. Small Caps & Tracking
+
+**Small caps** are used extensively for:
+
+- Section labels
+- Meta information (dates, categories)
+- Supporting text
+- Navigation items
+
+Combined with **generous letter-spacing (0.1em - 0.15em)**, small caps create a refined, sophisticated look that's distinctly editorial. This is not a cheap trick—it's a typography fundamental that separates thoughtful design from generic output.
+
+#### 5. Generous Whitespace
+
+This design breathes. Margins are large. Padding is substantial. Line heights are relaxed.
+
+- Section padding: `py-32` to `py-44`
+- Content max-width: `max-w-5xl` (narrower for reading comfort)
+- Line height for body: `1.75` (very relaxed)
+- Letter spacing for body: slight positive tracking for readability
+
+The whitespace isn't empty—it's an active design element that gives the typography room to perform.
+
+#### 6. Asymmetric Balance
+
+While the overall aesthetic is classical, the layouts embrace asymmetric compositions:
+
+- Hero: Centered but with offset decorative elements
+- Benefits: Uneven column splits (1.3fr / 0.7fr)
+- Cards: Thin top border creates visual weight at top
+
+This prevents the design from feeling static or predictable while maintaining elegance.
+
+### Differentiation: Minimalism With Soul
+
+Many minimalist designs strip away so much that they become characterless—white backgrounds, gray text, system fonts. This design proves that minimalism and personality are not mutually exclusive.
+
+**The serif typeface is the key differentiator.** It brings:
+
+- Visual interest without decoration
+- Warmth without color
+- Character without complexity
+- Timelessness without being dated
+
+This is minimalism with a point of view. It has something to say.
+
+### Sensory Description
+
+If this design were a physical space, it would be:
+
+- A private library with floor-to-ceiling bookshelves
+- Natural light filtering through tall windows
+- A worn leather chair and a mahogany writing desk
+- The smell of aged paper and fresh coffee
+- Silence that invites contemplation
+
+If it were music, it would be:
+
+- Solo piano, perhaps Satie or Debussy
+- Lots of space between notes
+- Warm, resonant tones
+- Something you'd hear in a boutique hotel lobby
+- Understated but unmistakably refined
+
+---
+
+## Design Token System (The DNA)
+
+### Color Strategy
+
+**Monochrome With Warmth:** An intentionally limited palette that gains sophistication through restraint. The single gold accent provides just enough distinction.
+
+| Token                 | Value       | Usage & Context                                                        |
+| :-------------------- | :---------- | :--------------------------------------------------------------------- |
+| `background`        | `#FAFAF8` | Primary canvas. Warm ivory that feels more refined than pure white.    |
+| `foreground`        | `#1A1A1A` | Primary text. Rich black, not pure black.                              |
+| `muted`             | `#F5F3F0` | Secondary surfaces, card backgrounds. Slightly warmer than background. |
+| `muted-foreground`  | `#6B6B6B` | Secondary text. Warm gray with softness.                               |
+| `accent`            | `#B8860B` | Burnished gold. Links, highlights, key interactive elements.           |
+| `accent-secondary`  | `#D4A84B` | Lighter gold for gradients and hover states.                           |
+| `accent-foreground` | `#FFFFFF` | Text on accent backgrounds.                                            |
+| `border`            | `#E8E4DF` | Warm gray for rules, dividers, card borders.                           |
+| `card`              | `#FFFFFF` | Card surfaces. Pure white for maximum lift from ivory background.      |
+| `ring`              | `#B8860B` | Focus rings. Matches accent gold.                                      |
+
+---
+
+### Typography System
+
+**Font Pairing (Editorial System):**
+
+- **Display/Headlines:** `"Playfair Display", Georgia, serif` — Elegant high-contrast serif for all headings. The signature of this design.
+- **Body/UI:** `"Source Sans 3", system-ui, sans-serif` — Clean, highly readable sans-serif that complements without competing.
+- **Monospace:** `"IBM Plex Mono", monospace` — For labels and small caps treatments.
+
+**Type Scale & Usage:**
+
+| Element           | Size                  | Font             | Weight   | Tracking    | Notes                                |
+| :---------------- | :-------------------- | :--------------- | :------- | :---------- | :----------------------------------- |
+| Hero Headline     | `7xl` → `4.5rem` | Playfair Display | Normal   | `-0.02em` | Tight leading (1.1). Center-aligned. |
+| Section Headlines | `4xl` → `2.5rem` | Playfair Display | Normal   | `-0.01em` | Leading 1.2.                         |
+| Card Titles       | `xl` → `1.25rem` | Playfair Display | Semibold | Normal      | Leading 1.3.                         |
+| Body Text         | `base` → `lg`    | Source Sans 3    | Normal   | `0.01em`  | Relaxed line-height (1.75).          |
+| Section Labels    | `xs` (12px)         | IBM Plex Mono    | Medium   | `0.15em`  | UPPERCASE small caps style.          |
+| Navigation        | `sm`                | Source Sans 3    | Medium   | `0.05em`  | Slightly tracked.                    |
+
+**Small Caps Pattern:**
+
+```css
+.small-caps {
+  font-family: "IBM Plex Mono", monospace;
+  font-size: 0.75rem;
+  font-weight: 500;
+  letter-spacing: 0.15em;
+  text-transform: uppercase;
+}
+```
+
+---
+
+### Spacing & Layout
+
+**Core Principle:** Luxurious breathing room. This design is not afraid of empty space.
+
+- **Section Spacing:** Large vertical padding (`py-32` to `py-44`) creates paced, contemplative scrolling.
+- **Container Width:** `max-w-5xl` (64rem) for narrower, more readable content columns.
+- **Component Density:** Generous internal padding (p-8 to p-10) on cards.
+- **Grid Gaps:** `gap-8` to `gap-12` between grid items.
+
+**Layout Patterns:**
+
+- Hero: Centered, narrow container, stacked elements
+- Features: 3-column grid with generous gaps
+- Benefits: Asymmetric 2-column (`grid-cols-[1.3fr_0.7fr]`)
+- Use thin rule lines to create visual structure
+
+---
+
+### Borders, Surfaces & Shadows
+
+**Surfaces:**
+
+- Cards use pure white (`#FFFFFF`) for lift from ivory background
+- Very subtle shadows—this isn't about depth, it's about refinement
+- Thin borders (1px) in warm gray
+
+**Border System:**
+
+| Token             | Value                 | Usage                             |
+| :---------------- | :-------------------- | :-------------------------------- |
+| `border-thin`   | `1px solid #E8E4DF` | Primary borders, rules            |
+| `border-accent` | `1px solid #B8860B` | Accent borders, highlighted cards |
+
+**Shadow System:**
+
+| Token         | Value                              | Usage               |
+| :------------ | :--------------------------------- | :------------------ |
+| `shadow-sm` | `0 1px 2px rgba(26,26,26,0.04)`  | Subtle lift         |
+| `shadow-md` | `0 4px 12px rgba(26,26,26,0.06)` | Cards, hover states |
+| `shadow-lg` | `0 8px 24px rgba(26,26,26,0.08)` | Elevated elements   |
+
+**Rule Lines (Critical for Style Identity):**
+
+- Thin horizontal rules as section dividers
+- Top border accent on cards (1px accent color)
+- Decorative rule under headlines
+
+---
+
+## Component Styling & Interactions
+
+### Buttons
+
+**Primary Button:**
+
+- Background: `accent` gold
+- Text: White, medium weight, slightly tracked
+- Border-radius: `rounded-md` (6px) — not too round, not too sharp
+- Shadow: Very subtle, accent-tinted (`shadow-sm`)
+- Hover: Color shifts to `accent-secondary`, shadow enhances to `shadow-accent`, subtle lift (-translate-y-0.5)
+- Active: Returns to base position (translate-y-0)
+- Touch: `touch-manipulation` class for better mobile interaction
+- Minimum height: 44px on mobile (accessibility requirement)
+
+**Secondary/Outline Button:**
+
+- Background: Transparent
+- Border: `1px` in `foreground` color (strong contrast)
+- Text: `foreground`
+- Hover: Fill with `muted` background, border and text shift to `accent` color
+- Smooth color transitions on all properties
+
+**Ghost Button:**
+
+- No background or border
+- Text: `muted-foreground` → `foreground` on hover
+- Underline appears on hover with `accent` color decoration
+- Underline offset: 4px for breathing room
+
+**Animation:** Refined transitions (`200ms`). Subtle lift on primary buttons adds tactile feedback while maintaining elegance.
+
+---
+
+### Cards
+
+**Standard Card:**
+
+- Background: `card` (white)
+- Border: `1px` in `border` color
+- Border-radius: `rounded-lg` (8px)
+- Shadow: `shadow-sm` — very subtle
+- Top accent: Optional `2px` accent border on top edge (when `accentTop` prop used)
+
+**Hover Effects (when `hoverEffect` prop used):**
+
+- Shadow increases to `shadow-md`
+- Border color shifts to `border-hover`
+- Background subtle tint to `muted/30` (30% opacity)
+- No translate/lift — maintains elegant restraint
+- Smooth `200ms` transition on all properties
+
+**Elevated Card:**
+
+- Uses `shadow-md` by default (when `elevated` prop used)
+- Provides more depth for important content like highlighted pricing tiers
+
+**Featured Card:**
+
+- Background tint of accent color at 6% (`accent-muted`)
+- Accent top border at 2px thickness
+- Often combined with elevated shadow for maximum prominence
+
+---
+
+### Inputs
+
+- Height: `h-12` (44px minimum for accessibility)
+- Border: `1px` in `input` color (matches `border`)
+- Border-radius: `rounded-md` (6px)
+- Background: Transparent
+- Hover: Border shifts to `border-hover` color
+- Focus:
+  - `ring-2 ring-accent ring-offset-2`
+  - Border shifts to `accent` color for clear visual feedback
+  - Smooth `150ms` transition
+- Placeholder: `text-muted-foreground/60` (60% opacity for subtle hierarchy)
+- Typography: Sans-serif body font, base size
+- Transitions: All properties animate smoothly with `ease-out` easing
+
+---
+
+### Section Labels
+
+A consistent label pattern appears at the start of each section:
+
+```jsx
+<div className="mb-6 flex items-center gap-4">
+  <span className="h-px flex-1 bg-[var(--border)]" />
+  <span className="font-mono text-xs font-medium uppercase tracking-[0.15em] text-[var(--accent)]">
+    Section Name
+  </span>
+  <span className="h-px flex-1 bg-[var(--border)]" />
+</div>
+```
+
+---
+
+## The "Bold Factor" (Signature Elements)
+
+These elements prevent generic output and define this style:
+
+1. **Dramatic Serif Headlines:** Oversized serif typography (7xl in hero) that commands attention through scale and beauty, not decoration.
+2. **Rule Line System:** Thin horizontal rules throughout create rhythm and structure—a distinctly editorial element.
+3. **Small Caps Labels:** All section labels and meta info use tracked uppercase monospace, creating refined visual rhythm.
+4. **Burnished Gold Accent:** The single warm accent color adds just enough distinction to prevent sterility.
+5. **Generous Whitespace:** Sections breathe with `py-32` to `py-44` padding. This is premium, not cramped.
+6. **Large Display Numbers:** Stats and pricing use serif display numbers at dramatic sizes (5xl+).
+7. **Decorative Quote Marks:** Testimonials feature large opening quote marks in accent gold.
+8. **Asymmetric Layouts:** Strategic use of uneven columns prevents static feeling while maintaining elegance.
+9. **Layered Depth in Abstracts:** Product detail and benefits sections feature enhanced abstract graphics with:
+
+   - Gradient backgrounds (`from-[color] via-[color] to-[color]`)
+   - Decorative ring/circle elements with low opacity
+   - Multi-layered card elements with borders and shadows
+   - Hover-interactive elements that respond to user interaction
+   - Subtle accent color tints for visual interest
+10. **Paper Texture Overlay:** Subtle noise texture overlay at 30% opacity across entire page creates tactile, print-like quality.
+11. **Ambient Glow:** Large blurred circle with 2% opacity accent color creates warm atmospheric depth.
+12. **Enhanced Micro-interactions:**
+
+    - Button subtle lift on hover with return animation
+    - Card background tinting on hover
+    - Border color shifts throughout interface
+    - Smooth 200ms transitions on all interactive elements
+
+---
+
+## Effects & Animation
+
+**Motion Philosophy:** Restrained and refined. Nothing bounces, nothing overshoots. Every animation should feel inevitable, not surprising.
+
+**Transition Defaults:**
+
+- Standard: `transition-all duration-200 ease-out`
+- Subtle: `duration-150`
+
+**Interaction States:**
+
+- Hover brightness change: 5-10%, no dramatic shifts
+- Shadow enhancement on hover
+- Underlines appearing/growing
+- NO translate/lift effects — too trendy for this timeless aesthetic
+
+**Entrance Animations (Optional, Subtle):**
+
+```js
+const fadeIn = {
+  hidden: { opacity: 0 },
+  visible: { opacity: 1, transition: { duration: 0.6, ease: "easeOut" } }
+};
+```
+
+---
+
+## Responsive Strategy
+
+**Breakpoint Philosophy:** Mobile layouts maintain the editorial feel through typography and spacing, even when structure simplifies. All interactive elements meet accessibility requirements for touch targets.
+
+### Mobile Adaptations (< 768px)
+
+- **Hero:**
+
+  - Single column with centered text
+  - Headline size: `text-[2.5rem]` (40px) maintains presence
+  - CTAs stack vertically with full width on small screens
+  - Maintains generous vertical padding
+- **Stats:**
+
+  - 2-column grid on mobile (4-column on desktop)
+  - Vertical dividers between columns only (not all items)
+  - Numbers scale to `text-4xl` (still prominent)
+  - Horizontal gap added (`gap-x-6`) to prevent crowding
+- **Features/Testimonials/Blog:**
+
+  - Stack to single column
+  - Generous gaps maintained (`gap-8` minimum)
+  - Card styling remains consistent
+  - Hover effects work as tap effects on mobile
+- **Pricing:**
+
+  - Stack vertically
+  - Highlighted tier loses elevation (no -translate-y-4) but keeps visual distinction through background tint
+  - All cards equal width for consistency
+- **Navigation:**
+
+  - Logo scales down slightly (`text-lg` → `text-xl`)
+  - Desktop nav hidden on mobile/tablet
+  - Primary CTA always visible
+  - Mobile menu would be hamburger pattern (if implemented)
+
+### Touch Optimization
+
+- **All buttons:** Minimum 44px height (`min-h-[44px]`) on mobile
+- **FAQ accordions:** 44px minimum height with `touch-manipulation`
+- **All interactive elements:** Use `touch-manipulation` CSS for better tap response
+- **Links:** Adequate padding and spacing for fat-finger friendly tapping
+
+**Key Adaptations:**
+
+- Section padding reduces gracefully but maintains premium feel
+- Typography scales down but hierarchy crystal clear
+- Serif font impact preserved—soul of design intact on all devices
+- Rule lines and gold accents remain consistent
+- No horizontal overflow—tested with various content widths
+- Touch targets meet WCAG AAA standards (minimum 44x44px)
+
+---
+
+## Accessibility & Best Practices
+
+**Color Contrast:**
+
+- All text meets WCAG AA standards minimum
+- Rich black (#1A1A1A) on ivory (#FAFAF8) provides excellent readability
+- Gold accent (#B8860B) passes contrast requirements on white backgrounds
+- Muted foreground (#6B6B6B) maintains sufficient contrast for secondary text
+
+**Focus States:**
+
+- Visible focus rings on all interactive elements: `ring-2 ring-accent ring-offset-2`
+- Focus states use accent gold color for consistency
+- Offset creates clear visual separation from element
+- Input borders shift to accent color on focus for additional feedback
+- All focus states tested with keyboard navigation
+
+**Touch & Interaction:**
+
+- All buttons meet minimum 44x44px touch target (WCAG AAA)
+- `touch-manipulation` CSS prevents double-tap zoom on mobile
+- FAQ accordion buttons have adequate size and spacing
+- All clickable areas have sufficient padding
+- No touch targets overlap or create confusion
+
+**Typography:**
+
+- Body text uses relaxed line-height (1.75) for comfortable reading
+- Slight positive tracking improves readability on screens
+- Base font size: 16px (never smaller for body text)
+- Heading hierarchy clearly defined with size and font variation
+- Line length controlled with max-width (max-w-5xl) for optimal reading
+
+**Motion:**
+
+- All animations are subtle and respectful (200ms standard)
+- No rapid movements or flashing
+- Transforms limited to subtle shifts (translate-y-0.5)
+- `prefers-reduced-motion` should be respected in production
+- Easing curves use gentle `ease-out` for natural feel
+
+**Semantic HTML:**
+
+- Proper heading hierarchy (h1 → h2 → h3)
+- Button elements for interactive actions (not divs)
+- Semantic sections with appropriate ARIA when needed
+- Images include meaningful alt text (width/height prevent CLS)
+- Form inputs properly labeled
+
+**Performance:**
+
+- CSS variables reduce specificity and improve maintainability
+- Transitions use transform and opacity (GPU-accelerated)
+- Images specify dimensions to prevent layout shift
+- Font loading optimized with proper font-display values
+  `</design-system>`