start-vibing 4.4.7 → 4.4.9

package/template/.claude/skills/super-design/references/market-research-playbook.md

@@ -49,18 +49,18 @@ Every match contributes `weight` to a vertical score and an audience score. Fina
 
 Certain dependency co-occurrences collapse ambiguity instantly:
 
-| Co-occurrence | Inferred positioning |
-|---|---|
-| `next` + `tailwindcss` + `@radix-ui/*` + `cva` + `tailwind-merge` + `lucide-react` | shadcn indie SaaS, dev-forward B2B |
-| `next` + `@mui/material` + `@mui/x-data-grid` + `auth0` | enterprise admin/dashboard |
-| `next` + `@chakra-ui/react` | mid-market US SaaS |
-| `next` + `antd` + `dayjs` | China-tech enterprise |
-| `next` + `ai` + `@ai-sdk/*` + `@vercel/kv` | AI chat product, Vercel stack |
-| `next` + `stripe` + `@clerk/*` + `drizzle-orm` | the canonical "2024–2026 indie B2B SaaS" stack |
-| `next` + `@sanity/client` + `@portabletext/react` | editorial / content-led |
-| `next` + `gsap` + `three` + `lenis` | premium agency marketing site |
-| `expo` + `nativewind` + `@supabase/*` | indie consumer mobile |
-| `wagmi` + `viem` + `@rainbow-me/rainbowkit` | consumer web3 dApp |
+| Co-occurrence                                                                      | Inferred positioning                           |
+| ---------------------------------------------------------------------------------- | ---------------------------------------------- |
+| `next` + `tailwindcss` + `@radix-ui/*` + `cva` + `tailwind-merge` + `lucide-react` | shadcn indie SaaS, dev-forward B2B             |
+| `next` + `@mui/material` + `@mui/x-data-grid` + `auth0`                            | enterprise admin/dashboard                     |
+| `next` + `@chakra-ui/react`                                                        | mid-market US SaaS                             |
+| `next` + `antd` + `dayjs`                                                          | China-tech enterprise                          |
+| `next` + `ai` + `@ai-sdk/*` + `@vercel/kv`                                         | AI chat product, Vercel stack                  |
+| `next` + `stripe` + `@clerk/*` + `drizzle-orm`                                     | the canonical "2024–2026 indie B2B SaaS" stack |
+| `next` + `@sanity/client` + `@portabletext/react`                                  | editorial / content-led                        |
+| `next` + `gsap` + `three` + `lenis`                                                | premium agency marketing site                  |
+| `expo` + `nativewind` + `@supabase/*`                                              | indie consumer mobile                          |
+| `wagmi` + `viem` + `@rainbow-me/rainbowkit`                                        | consumer web3 dApp                             |
 
 ### 1.4 Semantic signals from README and CLAUDE.md
 
@@ -115,11 +115,11 @@ Given raw candidates, select the final 5–10:
 
 1. **Filter for live**: domain resolves, site responds in <10s, copyright year within two years. Drop zombies.
 2. **Bucket by posture**, aiming for representation in each:
-   - **Category king** (1–2): the incumbent every buyer considers. Highest G2 review count or most-mentioned in "alternatives to" searches.
-   - **Direct peers** (2–4): same audience, same core JTBD, similar stage (±1 funding round).
-   - **Adjacent/challenger** (1–2): same audience, different value prop or opposite posture (open-source vs proprietary; all-in-one vs focused).
-   - **Emerging/indie** (1–2): Product Hunt last-6-months top 10 in the category; reveals the design-language future.
-   - **Enterprise anchor** (1): the "safe corporate" option — reveals category conventions.
+    - **Category king** (1–2): the incumbent every buyer considers. Highest G2 review count or most-mentioned in "alternatives to" searches.
+    - **Direct peers** (2–4): same audience, same core JTBD, similar stage (±1 funding round).
+    - **Adjacent/challenger** (1–2): same audience, different value prop or opposite posture (open-source vs proprietary; all-in-one vs focused).
+    - **Emerging/indie** (1–2): Product Hunt last-6-months top 10 in the category; reveals the design-language future.
+    - **Enterprise anchor** (1): the "safe corporate" option — reveals category conventions.
 3. **Score** each candidate: `fame = log(g2_reviews + ph_upvotes + 1)`; `similarity = jaccard(audience_tokens)`; `design_signal = has_modern_site ? 1 : 0`. Rank by `0.5·fame + 0.4·similarity + 0.1·design_signal`.
 4. **Final gate**: the set must include at least one brand from each vibe quadrant the agent believes is plausibly applicable, so category-code analysis has variance to measure.
 
@@ -131,7 +131,193 @@ Before finalizing, run Neumeier's insertion test: drop each competitor's name in
 
 ## 3. Extracting brand and design language from competitors
 
-For each finalist competitor, visit four pages: homepage, primary product page, pricing, about. Playwright MCP (via `browser_navigate`, `browser_snapshot`, `browser_take_screenshot`, `browser_evaluate`) drives everything.
+For each finalist competitor, visit four pages: homepage, primary product page, pricing, about. Playwright MCP (via `browser_navigate`, `browser_snapshot`, `browser_take_screenshot`, `browser_evaluate`, `browser_click`, `browser_press_key`, `browser_hover`) drives everything.
+
+### 3.0 Mandatory interactive crawl protocol (do this BEFORE §3.1–3.10 extractions)
+
+A site rendered without interaction tells you nothing about its UI language — you only see what loaded above the fold of the homepage. The §3bis component catalog REQUIRES element-cropped screenshots of buttons, modals, focused inputs, expanded mobile nav, and below-fold cards. None of that exists without clicks, scrolls, and key presses. **Every competitor visit MUST execute the loop below, per page, per viewport.** The protocol is **adaptive** — if a step's target doesn't exist in the snapshot, skip it immediately (one probe, no retry) and record `<step>=not-exposed`. Never fabricate.
+
+**Speed budget per competitor × viewport: ~90 seconds.** If you exceed 3 minutes you're doing it wrong — re-read the adaptive rules below.
+
+1. **Land + snapshot ONCE for refs.** `browser_navigate({url})` → `browser_resize` → `browser_wait_for({time:0.8})` → `browser_snapshot()`. Hold the snapshot in working memory; **do not** save the YAML to disk by default (those files are huge and rarely re-read). Save only when the snapshot reveals an unusually rich vocabulary worth re-grepping later (rare).
+
+2. **Dismiss intercepts** (one pass, ≤2s). From the snapshot, find a button whose accessible name matches `/^(accept|aceitar|got it|ok|allow all|continue|close|×|dismiss|agree)/i` and `browser_click` it. If `role="dialog"` is still present, `browser_press_key({key:"Escape"})` once. Do NOT loop searching for additional banners — one pass is enough. Append a single line to `.cache/evidence/<slug>/<viewport>/intercepts.md`: `home: dismissed "Accept all" | none-found | escape-fallback`.
+
+3. **Discover internal URLs from the rendered page** (one `browser_evaluate`, results cached for the whole competitor session):
+
+    ```js
+    const here = new URL(location.href);
+    const links = new Map();
+    for (const a of document.querySelectorAll('a[href]')) {
+    	try {
+    		const u = new URL(a.href, here);
+    		if (u.host !== here.host) continue;
+    		const path = u.pathname.replace(/\/+$/, '') || '/';
+    		if (!links.has(path)) links.set(path, a.innerText.trim().slice(0, 60));
+    	} catch {}
+    }
+    return [...links.entries()].slice(0, 80);
+    ```
+
+    Match against intent keywords (case-insensitive, both label and path):
+    - product/features → `/(product|features|platform|capabilities|how[-_ ]?it[-_ ]?works)/`
+    - pricing → `/(pricing|plans|tarifas|precos)/`
+    - about → `/(about|company|sobre|team|story)/`
+    - docs/auth surface → `/(docs|developers|api|app|dashboard|tour|demo)/`
+
+    **Page-budget rule:** visit AT MOST 2 internal pages beyond home (so 3 pages total per competitor: home + best product/features match + best pricing match — about/docs are opportunistic only if discovery cost was zero). If a category yields no match, mark `page=missing`; do NOT guess a path.
+
+4. **Adaptive scroll loop.** Compute `scrollHeight` once per page; pick band count from this table — do NOT do "≥3 bands always":
+
+    | scrollHeight / viewport.height | band count               | what to capture             |
+    | ------------------------------ | ------------------------ | --------------------------- |
+    | ≤ 1.2                          | 0 (just `fullPage:true`) | full page only              |
+    | 1.2 – 2.5                      | 1 mid-page band          | 50% scroll → screenshot     |
+    | 2.5 – 5                        | 2 bands                  | 33% and 66% → screenshots   |
+    | > 5                            | 3 bands MAX (cap)        | 25%, 55%, 85% → screenshots |
+
+    Use `behavior:'instant'` and **skip the `browser_wait_for` between scrolls** — instant scroll + immediate screenshot is fine for the still-image comparison we need. Below-fold sections still appear because lazy-load is paint-driven, not scroll-debounced. Then take the `fullPage:true` shot per §3.1.
+
+    ```js
+    // browser_evaluate (single call returns scroll plan)
+    const h = document.documentElement.scrollHeight;
+    const vh = window.innerHeight;
+    const ratio = h / vh;
+    return { ratio, h, vh };
+    ```
+
+5. **Mobile-only: open the hamburger nav.** Single probe — from the post-load snapshot, find `role="button"` with accessible name matching `/^(menu|navigation|toggle|hamburger|☰|≡)/i` OR `aria-label*=menu`. If found: `browser_click({ref})` → `browser_take_screenshot({fullPage:true, filename:"nav_mobile_open.png"})` → click again or `Escape` to close. If not found in the snapshot: skip silently (mark `nav_mobile_open=not-exposed`). Do NOT re-snapshot to look harder.
+
+6. **ONE component-revealing interaction per page.** Pick the FIRST option from the priority list whose target appears in the existing snapshot — do not try multiple options on the same page:
+
+    | Priority | Target                              | Trigger                                                                                                                                                             | Output file                |
+    | -------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- |
+    | 1        | Open primary CTA modal              | first `link\|button` matching `/^(sign[-_ ]?up\|get started\|try free\|book a demo\|talk to sales\|contact sales\|request demo)/i` → click → wait 0.5s → screenshot | `modal_<page>.png`         |
+    | 2        | Pricing toggle (only on `/pricing`) | first `switch\|tab` near "monthly/annual" → click → screenshot the toggled state                                                                                    | `pricing_toggle.png`       |
+    | 3        | Hover state on primary CTA          | `browser_hover({ref})` on hero CTA → screenshot                                                                                                                     | `button_primary_hover.png` |
+    | 4        | Focused input                       | first `textbox` → click → screenshot                                                                                                                                | `input_focus.png`          |
+    | 5        | Mega-menu (desktop)                 | hover first nav item that is a `combobox\|menuitem` → if panel paints, screenshot                                                                                   | `mega_menu.png`            |
+
+    No match in any of the 5 → mark `component_interaction=not-exposed` and continue. Don't burn time hunting.
+
+7. **Console + network capture ONCE per competitor × viewport** (NOT per page). After the last page is visited, run `browser_console_messages({onlyErrors:true})` and `browser_network_requests()` once → save to `<slug>/<viewport>/console.json` and `<slug>/<viewport>/network.json`. Per-page captures were overkill; consolidated capture still feeds §3.6 motion detection (`gsap`/`framer-motion`/`lottie`/`.glb` URLs) and framework fingerprinting.
+
+8. **Single-session reuse.** Open ONE Playwright browser session per competitor × viewport. Reuse across all visited pages. Close with `browser_close` only after the competitor is fully audited at that viewport. No parallel tabs.
+
+**Hard rule:** an entry in `component-catalog.md` (or any narrative doc) that lacks a corresponding screenshot file on disk is a fabrication. If §3.0 didn't expose a component, it goes under `## Not exposed during interactive crawl` — never under "Components".
+
+### 3ter. Per-competitor design-narrative.md (mandatory deliverable)
+
+Screenshots and a token table do not communicate design. After §3.0 finishes for a competitor (BOTH viewports done), write **`.cache/evidence/<slug>/design-narrative.md`** following this template exactly. This is the file the user actually reads — the catalog is for traceability, the narrative is for understanding.
+
+```markdown
+# <Competitor> — design narrative
+
+**Audited:** <ISO date> · **Viewports:** desktop 1440×900, mobile 390×844
+**Pages visited:** home, <product-path>, <pricing-path> · **Pages missing:** <list or "none">
+
+## Aesthetic at a glance (2–3 sentences)
+
+What is the _feeling_ of this site? Lead with mood, not specs. e.g. "Cold,
+authoritative, Bloomberg-terminal posture. Heavy on dense data viz, sparse
+on photography. Reads like an investor deck, not a marketing site."
+
+## Color story
+
+- **Brand spine:** <hex> <hex> <hex> — describe the relationship (mono / dual /
+  triadic / palette + accent), and what it telegraphs (trust / energy /
+  premium / playful)
+- **Where each color earns its keep:** primary on … / accent only on … /
+  background hierarchy uses …
+- **Surface posture:** dark-default / light-default / dark-on-mobile-only /
+  hybrid sections
+- **Divergence from §3.3 CSS-vs-Vibrant:** if brand tokens disagree with
+  perceived palette, name the gap (rebrand-in-progress signal)
+
+## Typography voice
+
+- **Display vs body pairing:** family + class (modern-sans / editorial-serif /
+  brutalist / mono / custom) — what does the pairing _say_ (corporate
+  reassurance / editorial confidence / dev-tool credibility / premium
+  intimacy)?
+- **Hierarchy rhythm:** how aggressive is size jump h1→h2→body? Tight
+  (corporate) / dramatic (editorial) / playful (consumer)?
+- **One memorable detail** — the unusual choice (italic display, variable
+  weight, custom ligature, oversized numerals)
+
+## Layout & section taxonomy
+
+Walk the homepage top-to-bottom. For each section name what it is and what
+job it does:
+
+| Order | Section type | What it contains           | Layout pattern                            | Why it's there     |
+| ----- | ------------ | -------------------------- | ----------------------------------------- | ------------------ |
+| 1     | Hero         | <copy gist> + <CTA count>  | left-copy / centered / split / full-bleed | Anchor positioning |
+| 2     | Social proof | logo bar / quoted customer | logos-strip / quote-card                  | Trust before pitch |
+| 3     | …            | …                          | …                                         | …                  |
+
+Repeat the same table for the visited product page and pricing page if their
+section vocabulary diverges. If the site reuses the same section pattern
+across pages, say so once and don't repeat the table.
+
+## Component vocabulary (tied to screenshots)
+
+For each component family present, ONE descriptive sentence + the screenshot
+filename. No screenshot = not in this section (move to "Not exposed").
+
+- **Buttons:** primary = `<filename>` — radius, weight, hover treatment, label tone (action verb / value-prop / generic)
+- **Cards:** observed variants `<files>` — what shape (flat / elevated / outlined / glass), what content density
+- **Forms:** input style `<file>` — minimal-line / boxed / floating-label, focus treatment
+- **Modals/dialogs:** observed `<file>` — centered / bottom-sheet / drawer, what content (signup / contact / video / disclosure)
+- **Navigation:** desktop `<file>` + mobile `<file>` — top-bar / sidebar / mega-menu, mobile transform (hamburger overlay / drawer / bottom-tabs)
+- **Lists & tables:** if present `<file>` — row density, separator style
+
+## Scroll & motion behavior
+
+- Scroll depth: `scrollHeight / viewport ≈ Nx`
+- Reveal pattern: none / fade-in-on-scroll / parallax / sticky-section / pinned-scroll
+- Animation library detected via §3.6 network: <gsap | framer-motion | lottie | none>
+- Motion character: snappy (≤200ms) / cinematic (>500ms) / heavy (continuous)
+- One memorable scroll moment (or "none — purely static")
+
+## UI / UX posture
+
+- **CTA hierarchy:** how many primary CTAs above-fold? Hard CTA + soft CTA pair, or single push?
+- **Density:** dense-data / balanced / spacious-marketing
+- **Information shape:** single-column narrative / split-screen alternating / grid-of-cards
+- **Disclosure pattern:** progressive (accordion / tabs) / all-at-once / link-out-to-docs
+- **Trust signals deployed:** logos / quotes / stats / certifications / press / none
+
+## Mobile vs desktop divergence
+
+Two-column quick read: what changes structurally, not just "smaller". Examples:
+
+- Hero CTA: stacks vertically (mobile) vs side-by-side (desktop)
+- Nav: hamburger overlay vs top mega-menu
+- Pricing: card carousel vs 3-column grid
+- Footer: accordion sections vs columns
+
+## What's ownable vs commodity
+
+- **Ownable signals** (would survive Neumeier insertion test): <list 1–3>
+- **Commodity codes** (could swap with any peer): <list 1–3>
+- **Risk** (anti-pattern, dated, brittle): <list or "none">
+
+## Not exposed during interactive crawl
+
+- <component>: <reason — element not in snapshot / page missing / dismissed-but-no-trigger>
+
+## Files cited
+
+- screenshots: `<slug>/<viewport>/{home.png, *_band_*.png, components/*.png}`
+- catalog: `<slug>/component-catalog.md`
+- console+network: `<slug>/<viewport>/{console.json, network.json}`
+```
+
+This narrative is what powers `market-analysis.md` synthesis (§8) and
+sd-fix's DSC-1 typeui proposals. The competitor catalog without this
+narrative is unreadable; the narrative without the catalog is unverifiable
+— produce both.
 
 ### 3.1 Browser setup
 
@@ -150,11 +336,11 @@ Save the full-page screenshot to `evidence/<competitor>/<page>.png` via `browser
 // browser_evaluate
 const counts = new Map();
 for (const el of document.querySelectorAll('body *:not(script):not(style)')) {
-  if (!el.innerText?.trim()) continue;
-  const ff = getComputedStyle(el).fontFamily;
-  counts.set(ff, (counts.get(ff) ?? 0) + 1);
+	if (!el.innerText?.trim()) continue;
+	const ff = getComputedStyle(el).fontFamily;
+	counts.set(ff, (counts.get(ff) ?? 0) + 1);
 }
-return [...counts.entries()].sort((a,b)=>b[1]-a[1]).slice(0,20);
+return [...counts.entries()].sort((a, b) => b[1] - a[1]).slice(0, 20);
 ```
 
 Interpret top three families: the dominant one is body; a secondary (used <5% but on h1–h2) is display; mono = dev-tool posture. Map family names to classifications: `Inter`, `Geist`, `Söhne`, `SF Pro` → modern sans; `GT Super`, `Canela`, `Tiempos`, `Editorial New`, `Playfair` → editorial serif; `Druk`, `Monument Grotesk` → brutalist/display; `JetBrains Mono`, `Berkeley Mono`, `IBM Plex Mono` → developer.
@@ -166,15 +352,21 @@ Interpret top three families: the dominant one is body; a secondary (used <5% bu
 ```js
 const hist = new Map();
 for (const el of document.querySelectorAll('body *')) {
-  const cs = getComputedStyle(el);
-  const r = el.getBoundingClientRect();
-  const w = Math.log2(Math.max(1, r.width * r.height) + 1);
-  for (const [prop, weight] of [['backgroundColor',w],['color',1],['borderTopColor',.25],['fill',.5]]) {
-    const v = cs[prop];
-    if (v && v !== 'rgba(0, 0, 0, 0)' && v !== 'transparent') hist.set(v, (hist.get(v) ?? 0) + weight);
-  }
+	const cs = getComputedStyle(el);
+	const r = el.getBoundingClientRect();
+	const w = Math.log2(Math.max(1, r.width * r.height) + 1);
+	for (const [prop, weight] of [
+		['backgroundColor', w],
+		['color', 1],
+		['borderTopColor', 0.25],
+		['fill', 0.5],
+	]) {
+		const v = cs[prop];
+		if (v && v !== 'rgba(0, 0, 0, 0)' && v !== 'transparent')
+			hist.set(v, (hist.get(v) ?? 0) + weight);
+	}
 }
-return [...hist.entries()].sort((a,b)=>b[1]-a[1]).slice(0,30);
+return [...hist.entries()].sort((a, b) => b[1] - a[1]).slice(0, 30);
 ```
 
 Cluster by RGB distance (ε≈24) and keep the top 6–8 representatives.
@@ -195,8 +387,8 @@ Merge: CSS palette = brand tokens; Vibrant palette = perceived mood. Divergence
 const out = {};
 const cs = getComputedStyle(document.documentElement);
 for (let i = 0; i < cs.length; i++) {
-  const p = cs.item(i);
-  if (p.startsWith('--')) out[p] = cs.getPropertyValue(p).trim();
+	const p = cs.item(i);
+	if (p.startsWith('--')) out[p] = cs.getPropertyValue(p).trim();
 }
 return out;
 ```
@@ -226,11 +418,14 @@ Query `document.querySelectorAll('img, svg, video')`. Count SVG children vs rast
 
 ```js
 return {
-  hero: document.querySelector('h1')?.innerText.trim(),
-  subhead: document.querySelector('h1 ~ p')?.innerText.trim(),
-  ctas: [...document.querySelectorAll('a[role=button], button, a.btn')].map(e => e.innerText.trim()).filter(t => t && t.length < 40).slice(0, 20),
-  headings: [...document.querySelectorAll('h1,h2,h3')].map(h => h.innerText.trim()),
-  allText: document.body.innerText.replace(/\s+/g,' ').slice(0, 10000),
+	hero: document.querySelector('h1')?.innerText.trim(),
+	subhead: document.querySelector('h1 ~ p')?.innerText.trim(),
+	ctas: [...document.querySelectorAll('a[role=button], button, a.btn')]
+		.map((e) => e.innerText.trim())
+		.filter((t) => t && t.length < 40)
+		.slice(0, 20),
+	headings: [...document.querySelectorAll('h1,h2,h3')].map((h) => h.innerText.trim()),
+	allText: document.body.innerText.replace(/\s+/g, ' ').slice(0, 10000),
 };
 ```
 
@@ -254,53 +449,53 @@ evidence/<competitor-slug>/
 
 ## 4. Brand archetype and positioning classification
 
-### 4.1 Mark & Pearson 12 archetypes (Mark & Pearson, *The Hero and the Outlaw*, McGraw-Hill, 2001)
+### 4.1 Mark & Pearson 12 archetypes (Mark & Pearson, _The Hero and the Outlaw_, McGraw-Hill, 2001)
 
 The archetypes cluster in four motivational quadrants. An auditable brand usually presents one primary + one supporting.
 
-| Archetype | Core desire / motto | Visual signals | Copy signals | Example brands |
-|---|---|---|---|---|
-| **Innocent** | Paradise / safety. "Free to be you and me." | Pastels (white, sky blue, pale yellow); rounded sans or script; high-key photography; whitespace | Short sentences; "pure/simple/happy/natural"; gentle CTAs ("Discover", "Enjoy") | Dove, Innocent Drinks, Aveeno, Method |
-| **Sage** | Truth / understanding. "The truth will set you free." | Navy/forest/burgundy + cream; classical serifs; editorial layouts; data viz; monochrome portraits | Authoritative third person; cited stats; long clauses; "Learn more", "Read the report" | Google, BBC, The Economist, Harvard, Bloomberg |
-| **Explorer** | Freedom, discovery. "Don't fence me in." | Earthy palettes (rust, olive, slate); geometric sans (Futura); wide landscape hero; maps, compasses | Second person "you"; imperatives; "Find your…"; "Start the journey" | Patagonia, The North Face, Jeep, Airbnb, GoPro |
-| **Outlaw** | Revolution. "Rules are made to be broken." | Black + one saturated accent (red, neon); heavy condensed/industrial type; grit textures; high contrast | Short, confrontational; anti-establishment questions; "Join the revolution" | Harley-Davidson, Diesel, Liquid Death, Oatly, Vice |
-| **Magician** | Transformation. "I make things happen." | Deep purple/indigo + gold; gradient meshes; particle/glow effects; futuristic sans | "Transform", "unlock", "reveal", "imagine"; before/after demos | Disney, Tesla, Polaroid, Dyson, MasterClass |
-| **Hero** | Mastery through courage. "Where there's a will there's a way." | Bold red/black/white or navy/gold; muscular sans (Knockout, Tungsten); athletes mid-motion; dramatic light | 1–3 word imperative taglines; challenge framing; "Push harder", "Rise" | Nike, Under Armour, BMW, FedEx, Adidas |
-| **Lover** | Intimacy, sensual pleasure. "You're the only one." | Rich reds/burgundies/blush; Didone serifs (Didot, Bodoni); soft-focus warm light; tactile textures | Sensory adjectives; romantic syntax; "Indulge", "Fall in love" | Chanel, Victoria's Secret, Häagen-Dazs, Alfa Romeo |
-| **Jester** | Live in the moment. "You only live once." | Saturated primaries (yellow, hot pink, cyan); rounded display; illustration > photo; mascots, emoji | Puns, exclamations, rhetorical Qs; "Let's play", "Get silly" | M&M's, Old Spice, Dollar Shave Club, Cards Against Humanity, Mailchimp |
-| **Everyman** | Belonging. "All people are created equal." | Muted neutrals (denim, warm gray, brick); humanist sans (Helvetica, Open Sans); candid documentary photos | Plainspoken; contractions; "we/us"; "Join us", "Get started" | IKEA, Target, Levi's, Home Depot, eBay |
-| **Caregiver** | Protect others. "Love your neighbor as yourself." | Soft blue/pink + white; rounded humanist sans; touching hands, parent-child imagery | Empathetic; "we're here for you"; "Care for…" | Johnson & Johnson, UNICEF, Volvo, Pampers, TOMS |
-| **Ruler** | Control, prosperity. "Power is the only thing." | Black, gold, navy, burgundy; Trajan/Bodoni serifs; symmetrical layouts; crests, monograms | Superlatives ("the finest", "world's leading"); formal third person; "Become a member" | Rolex, Mercedes-Benz, AmEx (Centurion), Louis Vuitton, IBM |
-| **Creator** | Realize a vision. "If you can imagine it, it can be done." | Monochrome + bold accent; experimental/custom type; whitespace; tools/process imagery | "Make/build/craft"; short aphorisms; "Create", "Build your…" | Apple, LEGO, Adobe, Figma, Canva, Etsy |
+| Archetype     | Core desire / motto                                            | Visual signals                                                                                             | Copy signals                                                                           | Example brands                                                         |
+| ------------- | -------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
+| **Innocent**  | Paradise / safety. "Free to be you and me."                    | Pastels (white, sky blue, pale yellow); rounded sans or script; high-key photography; whitespace           | Short sentences; "pure/simple/happy/natural"; gentle CTAs ("Discover", "Enjoy")        | Dove, Innocent Drinks, Aveeno, Method                                  |
+| **Sage**      | Truth / understanding. "The truth will set you free."          | Navy/forest/burgundy + cream; classical serifs; editorial layouts; data viz; monochrome portraits          | Authoritative third person; cited stats; long clauses; "Learn more", "Read the report" | Google, BBC, The Economist, Harvard, Bloomberg                         |
+| **Explorer**  | Freedom, discovery. "Don't fence me in."                       | Earthy palettes (rust, olive, slate); geometric sans (Futura); wide landscape hero; maps, compasses        | Second person "you"; imperatives; "Find your…"; "Start the journey"                    | Patagonia, The North Face, Jeep, Airbnb, GoPro                         |
+| **Outlaw**    | Revolution. "Rules are made to be broken."                     | Black + one saturated accent (red, neon); heavy condensed/industrial type; grit textures; high contrast    | Short, confrontational; anti-establishment questions; "Join the revolution"            | Harley-Davidson, Diesel, Liquid Death, Oatly, Vice                     |
+| **Magician**  | Transformation. "I make things happen."                        | Deep purple/indigo + gold; gradient meshes; particle/glow effects; futuristic sans                         | "Transform", "unlock", "reveal", "imagine"; before/after demos                         | Disney, Tesla, Polaroid, Dyson, MasterClass                            |
+| **Hero**      | Mastery through courage. "Where there's a will there's a way." | Bold red/black/white or navy/gold; muscular sans (Knockout, Tungsten); athletes mid-motion; dramatic light | 1–3 word imperative taglines; challenge framing; "Push harder", "Rise"                 | Nike, Under Armour, BMW, FedEx, Adidas                                 |
+| **Lover**     | Intimacy, sensual pleasure. "You're the only one."             | Rich reds/burgundies/blush; Didone serifs (Didot, Bodoni); soft-focus warm light; tactile textures         | Sensory adjectives; romantic syntax; "Indulge", "Fall in love"                         | Chanel, Victoria's Secret, Häagen-Dazs, Alfa Romeo                     |
+| **Jester**    | Live in the moment. "You only live once."                      | Saturated primaries (yellow, hot pink, cyan); rounded display; illustration > photo; mascots, emoji        | Puns, exclamations, rhetorical Qs; "Let's play", "Get silly"                           | M&M's, Old Spice, Dollar Shave Club, Cards Against Humanity, Mailchimp |
+| **Everyman**  | Belonging. "All people are created equal."                     | Muted neutrals (denim, warm gray, brick); humanist sans (Helvetica, Open Sans); candid documentary photos  | Plainspoken; contractions; "we/us"; "Join us", "Get started"                           | IKEA, Target, Levi's, Home Depot, eBay                                 |
+| **Caregiver** | Protect others. "Love your neighbor as yourself."              | Soft blue/pink + white; rounded humanist sans; touching hands, parent-child imagery                        | Empathetic; "we're here for you"; "Care for…"                                          | Johnson & Johnson, UNICEF, Volvo, Pampers, TOMS                        |
+| **Ruler**     | Control, prosperity. "Power is the only thing."                | Black, gold, navy, burgundy; Trajan/Bodoni serifs; symmetrical layouts; crests, monograms                  | Superlatives ("the finest", "world's leading"); formal third person; "Become a member" | Rolex, Mercedes-Benz, AmEx (Centurion), Louis Vuitton, IBM             |
+| **Creator**   | Realize a vision. "If you can imagine it, it can be done."     | Monochrome + bold accent; experimental/custom type; whitespace; tools/process imagery                      | "Make/build/craft"; short aphorisms; "Create", "Build your…"                           | Apple, LEGO, Adobe, Figma, Canva, Etsy                                 |
 
 **Detection algorithm.** Score each archetype 0–10 by summing: (a) color-palette match against canonical hues; (b) typographic class match; (c) lexical match on ~20 archetype-specific tokens extracted from `copy.allText`; (d) imagery class (photo/illustration/3D match); (e) CTA verb match. Normalize; take top two. Confidence = score[0] − score[1]. Flag `mixed` if < 2.0.
 
-### 4.2 Aaker Brand Personality Dimensions (Aaker, *Journal of Marketing Research*, 34(3):347–356, August 1997)
+### 4.2 Aaker Brand Personality Dimensions (Aaker, _Journal of Marketing Research_, 34(3):347–356, August 1997)
 
 Five dimensions, 15 facets, 42 traits, validated against Big-Five (OCEAN). A brand typically peaks on one dimension with a strong secondary.
 
-- **Sincerity** (down-to-earth, honest, wholesome, cheerful): warm whites/cream, sky blue, soft yellow; rounded humanist sans or friendly serif; sun-lit candid photography; kraft textures. *Examples:* Hallmark, Dove, Patagonia, Ben & Jerry's.
-- **Excitement** (daring, spirited, imaginative, up-to-date): neon/saturated; bold geometric display; motion blur; asymmetric layouts; graphic illustration. *Examples:* Red Bull, MTV, Tesla, Spotify.
-- **Competence** (reliable, intelligent, successful): navy + steel gray + white; grotesk sans (Helvetica, Inter); grid-based; data viz; clean product photography on white. *Examples:* IBM, Microsoft, Volvo, FedEx, WSJ.
-- **Sophistication** (upper class, charming): black, ivory, gold, blush; high-contrast Didone serifs; generous whitespace; editorial fashion photography. *Examples:* Chanel, Mercedes-Benz, Tiffany & Co., Apple (premium).
-- **Ruggedness** (outdoorsy, tough): earth tones; slab serifs or condensed industrial sans; wide landscapes; weathered textures; natural light. *Examples:* Levi's, Jeep, Timberland, Carhartt.
+- **Sincerity** (down-to-earth, honest, wholesome, cheerful): warm whites/cream, sky blue, soft yellow; rounded humanist sans or friendly serif; sun-lit candid photography; kraft textures. _Examples:_ Hallmark, Dove, Patagonia, Ben & Jerry's.
+- **Excitement** (daring, spirited, imaginative, up-to-date): neon/saturated; bold geometric display; motion blur; asymmetric layouts; graphic illustration. _Examples:_ Red Bull, MTV, Tesla, Spotify.
+- **Competence** (reliable, intelligent, successful): navy + steel gray + white; grotesk sans (Helvetica, Inter); grid-based; data viz; clean product photography on white. _Examples:_ IBM, Microsoft, Volvo, FedEx, WSJ.
+- **Sophistication** (upper class, charming): black, ivory, gold, blush; high-contrast Didone serifs; generous whitespace; editorial fashion photography. _Examples:_ Chanel, Mercedes-Benz, Tiffany & Co., Apple (premium).
+- **Ruggedness** (outdoorsy, tough): earth tones; slab serifs or condensed industrial sans; wide landscapes; weathered textures; natural light. _Examples:_ Levi's, Jeep, Timberland, Carhartt.
 
 Score each dimension 1–7 by counting trait-evoking signals across home + product pages.
 
-### 4.3 Kapferer's Brand Identity Prism (Kapferer, *Strategic Brand Management*, 1992; refined eds. through 2012)
+### 4.3 Kapferer's Brand Identity Prism (Kapferer, _Strategic Brand Management_, 1992; refined eds. through 2012)
 
 Six facets on two axes — vertical (Picture of Sender ↔ Picture of Receiver) and horizontal (Externalization ↔ Internalization).
 
-1. **Physique** (external/sender) — logo, colors, type, packaging, signature visual assets. *Audit:* extracted tokens (§3).
-2. **Personality** (internal/sender) — the brand-as-person. *Audit:* map body copy onto Aaker or the 12 archetypes.
-3. **Culture** (internal/sender) — values, heritage, ideology. *Audit:* About/Mission/Manifesto pages, origin story, ESG statements.
-4. **Relationship** (external/receiver) — mode of brand↔customer conduct. *Audit:* onboarding tone, support copy, community features, promised exchange.
-5. **Reflection** (external/receiver) — stereotyped user portrayed in ads (not actual buyer). *Audit:* every photo of a person: age, gender, ethnicity, lifestyle.
-6. **Self-image** (internal/receiver) — how the customer feels using the brand. *Audit:* testimonial phrasing, identity-laden copy ("for those who…"), community posts.
+1. **Physique** (external/sender) — logo, colors, type, packaging, signature visual assets. _Audit:_ extracted tokens (§3).
+2. **Personality** (internal/sender) — the brand-as-person. _Audit:_ map body copy onto Aaker or the 12 archetypes.
+3. **Culture** (internal/sender) — values, heritage, ideology. _Audit:_ About/Mission/Manifesto pages, origin story, ESG statements.
+4. **Relationship** (external/receiver) — mode of brand↔customer conduct. _Audit:_ onboarding tone, support copy, community features, promised exchange.
+5. **Reflection** (external/receiver) — stereotyped user portrayed in ads (not actual buyer). _Audit:_ every photo of a person: age, gender, ethnicity, lifestyle.
+6. **Self-image** (internal/receiver) — how the customer feels using the brand. _Audit:_ testimonial phrasing, identity-laden copy ("for those who…"), community posts.
 
 Score each 1–5 for clarity; flag inconsistencies (e.g., Personality reads playful but Relationship copy is corporate → weak Prism).
 
-### 4.4 Keller's CBBE pyramid (Keller, *Journal of Marketing*, 1993; MSI WP 01-107, 2001)
+### 4.4 Keller's CBBE pyramid (Keller, _Journal of Marketing_, 1993; MSI WP 01-107, 2001)
 
 Four levels, asked as four questions. Audit by locating each level's cues on the competitor site.
 
@@ -315,32 +510,32 @@ Bottleneck analysis: score 1–5 per block; the weakest block is the brand's cur
 
 ## 5. Category codes analysis
 
-Category codes are the visual and copy patterns nearly every brand in a vertical shares — the "obey for trust" signals. Differentiating is about choosing which codes to **obey**, **extend**, or **subvert** (Neumeier, *Zag*, 2006).
+Category codes are the visual and copy patterns nearly every brand in a vertical shares — the "obey for trust" signals. Differentiating is about choosing which codes to **obey**, **extend**, or **subvert** (Neumeier, _Zag_, 2006).
 
 ### 5.1 Building the competitor matrix
 
 After §3's extraction for each of the 5–10 finalists, assemble a matrix. Rows = competitors. Columns = dimensions:
 
-| Dimension | Cell value |
-|---|---|
-| Primary hex | `#0A2540` |
-| Accent hex | `#635BFF` |
-| Palette saturation | avg HSL S |
-| Palette lightness | avg HSL L (reveals light vs dark mode default) |
-| Display font class | modern-sans / editorial-serif / grotesque / mono / custom |
-| Body font | computed family |
-| Radius posture | sharp / subtle / rounded / pill |
-| Hero layout | left-copy-right-image / centered / full-bleed / split-screen |
-| Imagery | illustration / photo / 3D / hybrid / abstract |
-| Motion | none / subtle / moderate / heavy-scroll-driven |
-| Archetype (primary) | Sage / Creator / Hero / … |
-| Aaker peak | Competence / Sophistication / Excitement / … |
-| Vibe | premium / tech-futuristic / calm-corporate / etc. |
-| Tone (NN/g 4D) | F-S / F-C / R-I / E-M tuple |
-| Hero verb | ship / send / scale / automate / … |
-| CTA pattern | hard+soft / enterprise-only / dev-docs-led |
-| Social proof | trusted-by bar / testimonials / none |
-| Pricing posture | 3-tier / usage / contact-sales |
+| Dimension           | Cell value                                                   |
+| ------------------- | ------------------------------------------------------------ |
+| Primary hex         | `#0A2540`                                                    |
+| Accent hex          | `#635BFF`                                                    |
+| Palette saturation  | avg HSL S                                                    |
+| Palette lightness   | avg HSL L (reveals light vs dark mode default)               |
+| Display font class  | modern-sans / editorial-serif / grotesque / mono / custom    |
+| Body font           | computed family                                              |
+| Radius posture      | sharp / subtle / rounded / pill                              |
+| Hero layout         | left-copy-right-image / centered / full-bleed / split-screen |
+| Imagery             | illustration / photo / 3D / hybrid / abstract                |
+| Motion              | none / subtle / moderate / heavy-scroll-driven               |
+| Archetype (primary) | Sage / Creator / Hero / …                                    |
+| Aaker peak          | Competence / Sophistication / Excitement / …                 |
+| Vibe                | premium / tech-futuristic / calm-corporate / etc.            |
+| Tone (NN/g 4D)      | F-S / F-C / R-I / E-M tuple                                  |
+| Hero verb           | ship / send / scale / automate / …                           |
+| CTA pattern         | hard+soft / enterprise-only / dev-docs-led                   |
+| Social proof        | trusted-by bar / testimonials / none                         |
+| Pricing posture     | 3-tier / usage / contact-sales                               |
 
 ### 5.2 Frequency analysis → obey/extend/subvert
 
@@ -351,26 +546,26 @@ For each column, compute how many of 5–10 competitors share the modal value.
 - **Fragmented (no mode >40%)** → **open territory**. Any choice is defensible; pick based on archetype and target audience.
 - **Homogeneous on a bad code** (e.g., everyone uses stock photography) → **subvert**. Challenger brands gain memorability by violating a boring convention.
 
-### 5.3 Byron Sharp's Distinctive Brand Assets framework (Sharp, *How Brands Grow*, OUP 2010; Romaniuk, *Building Distinctive Brand Assets*, OUP 2018)
+### 5.3 Byron Sharp's Distinctive Brand Assets framework (Sharp, _How Brands Grow_, OUP 2010; Romaniuk, _Building Distinctive Brand Assets_, OUP 2018)
 
-DBAs are non-brand-name elements that trigger the brand into memory — colors, shapes, mascots, fonts, jingles, taglines, packaging. Romaniuk's Distinctive Asset Grid plots **Fame** (% of category buyers who link the asset to the brand) against **Uniqueness** (% who link it *only* to this brand).
+DBAs are non-brand-name elements that trigger the brand into memory — colors, shapes, mascots, fonts, jingles, taglines, packaging. Romaniuk's Distinctive Asset Grid plots **Fame** (% of category buyers who link the asset to the brand) against **Uniqueness** (% who link it _only_ to this brand).
 
-| | Low Fame | High Fame |
-|---|---|---|
-| **High Uniqueness** | **Invest** — protect and build exposure | **Use or lose** — defend, deploy widely, can replace brand name |
-| **Low Uniqueness** | **Test or ignore** | **Avoid/Solo** — famous but co-owned with category; competitors free-ride |
+|                     | Low Fame                                | High Fame                                                                 |
+| ------------------- | --------------------------------------- | ------------------------------------------------------------------------- |
+| **High Uniqueness** | **Invest** — protect and build exposure | **Use or lose** — defend, deploy widely, can replace brand name           |
+| **Low Uniqueness**  | **Test or ignore**                      | **Avoid/Solo** — famous but co-owned with category; competitors free-ride |
 
 Canonical DBAs: Coca-Cola red (Pantone 484), Nike Swoosh, McDonald's Golden Arches, Tiffany Blue (PMS custom 1837), Cadbury royal purple (Pantone 2685C), Geico Gecko, Intel's five-note bong.
 
 **Audit use**: for each competitor, inventory candidate assets; for the current project, identify one-to-three DBAs worth investing in, avoiding colors/shapes already occupied by the category king.
 
-### 5.4 Marty Neumeier's *Zag* (2006) — finding whitespace
+### 5.4 Marty Neumeier's _Zag_ (2006) — finding whitespace
 
 Neumeier's thesis: "when everybody zigs, zag." A zag must be **good** (customers value it) and **different** (surprising, fresh). Different alone = quirky failure; good alone = me-too.
 
 **The onliness statement formula:**
 
-> Our ___[WHAT]___ is the only ___[WHAT]___ that ___[HOW]___ for ___[WHO]___ in ___[WHERE]___ who ___[WHY]___ in an era of ___[WHEN]___.
+> Our **_[WHAT]_** is the only **_[WHAT]_** that **_[HOW]_** for **_[WHO]_** in **_[WHERE]_** who **_[WHY]_** in an era of **_[WHEN]_**.
 
 Minimal form: "Our X is the only X that Y." Harley-Davidson worked example from the book: "Our motorcycle company is the only one that makes big, loud motorcycles for macho guys (and macho wannabes) mostly in the US who want to join a gang of cowboys in an era of decreasing personal freedom."
 
@@ -392,7 +587,7 @@ For each category code identified:
 
 The clearest signals: second-person addressing ("you" = direct user), first-person-plural pitch ("we help you" = service posture), third-person institutional ("organizations can" = enterprise B2B). CTAs are the B2B/B2C classifier: "Request a demo" / "Contact sales" / "Book a call" = B2B-enterprise. "Get started free" / "Try free for 14 days" = B2B SMB or PLG. "Sign up" / "Download the app" = consumer. Pricing visibility: public tiered = PLG; "Contact us" only = enterprise; no pricing page = pre-revenue or agency.
 
-### 6.2 Hofstede's six cultural dimensions (Hofstede, *Culture's Consequences*, Sage 1980; Hofstede, Hofstede & Minkov, *Cultures and Organizations*, 3rd ed., McGraw-Hill 2010)
+### 6.2 Hofstede's six cultural dimensions (Hofstede, _Culture's Consequences_, Sage 1980; Hofstede, Hofstede & Minkov, _Cultures and Organizations_, 3rd ed., McGraw-Hill 2010)
 
 Each scored 0–100 per country at hofstede-insights.com.
 
@@ -409,26 +604,26 @@ Localize by scoring the brand site 1–5 against each dimension's target-country
 
 Three canonical schools:
 
-- **Christensen** (HBS, *Competing Against Luck*, 2016) — the milkshake study; "customers hire products to make progress in a particular circumstance."
-- **Tony Ulwick** (Strategyn, *Jobs to be Done: Theory to Practice*, 2016) — Outcome-Driven Innovation (ODI). Universal Job Map: Define → Locate → Prepare → Confirm → Execute → Monitor → Modify → Conclude. Desired outcomes written as: "[minimize/increase] [unit: time, likelihood] [object] [context]." 50–150 outcomes per typical market; opportunities = `importance + max(importance − satisfaction, 0)`.
-- **Bob Moesta** (Re-Wired Group, *Demand-Side Sales 101*, 2020) — Switch Interview and Four Forces of Progress:
+- **Christensen** (HBS, _Competing Against Luck_, 2016) — the milkshake study; "customers hire products to make progress in a particular circumstance."
+- **Tony Ulwick** (Strategyn, _Jobs to be Done: Theory to Practice_, 2016) — Outcome-Driven Innovation (ODI). Universal Job Map: Define → Locate → Prepare → Confirm → Execute → Monitor → Modify → Conclude. Desired outcomes written as: "[minimize/increase] [unit: time, likelihood] [object] [context]." 50–150 outcomes per typical market; opportunities = `importance + max(importance − satisfaction, 0)`.
+- **Bob Moesta** (Re-Wired Group, _Demand-Side Sales 101_, 2020) — Switch Interview and Four Forces of Progress:
 
-| Force | Direction |
-|---|---|
-| **Push** of the situation | drives away from current solution |
-| **Pull** of the new solution | attracts to alternative |
-| **Anxiety** of the new | resists change |
-| **Habit** of the present | resists change |
+| Force                        | Direction                         |
+| ---------------------------- | --------------------------------- |
+| **Push** of the situation    | drives away from current solution |
+| **Pull** of the new solution | attracts to alternative           |
+| **Anxiety** of the new       | resists change                    |
+| **Habit** of the present     | resists change                    |
 
-Demand exists when *Push + Pull > Anxiety + Habit*.
+Demand exists when _Push + Pull > Anxiety + Habit_.
 
 **Job taxonomy:** functional ("get a healthy meal on the table in 20 minutes"), emotional ("feel like a competent parent"), social ("be seen as a thoughtful host").
 
-**Job Story format** (Klement/Intercom): *When [SITUATION], I want to [MOTIVATION], so I can [EXPECTED OUTCOME].* Persona-agnostic and solution-agnostic.
+**Job Story format** (Klement/Intercom): _When [SITUATION], I want to [MOTIVATION], so I can [EXPECTED OUTCOME]._ Persona-agnostic and solution-agnostic.
 
 **Agent use.** Infer the competitor's JTBD from hero headline ("Send better email" → "get email opened"), use-case pages (enumerate functional jobs), testimonials (emotional/social). Which competitors are named in "alternatives to" searches reveals the real competitive set — and hence the real job.
 
-### 6.4 Alan Cooper persona methodology (*The Inmates Are Running the Asylum*, SAMS 1999; *About Face*, 4th ed. 2014)
+### 6.4 Alan Cooper persona methodology (_The Inmates Are Running the Asylum_, SAMS 1999; _About Face_, 4th ed. 2014)
 
 Goal-Directed Design operates on three goal layers: **experience goals** (how the user wants to feel — "not stupid"), **end goals** (outcome to accomplish), **life goals** (long-term self-image).
 
@@ -481,7 +676,7 @@ Canonical distinction: **voice is constant, tone is variable.** Mailchimp's voic
 
 Three formulas, each computed from word/sentence/syllable counts (use the `syllable` npm package for reliable syllable counts).
 
-**Flesch Reading Ease** (Flesch, *J. Applied Psychology*, 32(3):221–233, 1948):
+**Flesch Reading Ease** (Flesch, _J. Applied Psychology_, 32(3):221–233, 1948):
 
 > RE = 206.835 − 1.015 × (words/sentences) − 84.6 × (syllables/words)
 
@@ -493,7 +688,7 @@ Higher = easier. 60–70 = plain English; <30 = academic.
 
 Output is a US grade level. Lower = easier. Adopted by US DoD, IRS, and many state regulators.
 
-**Gunning Fog Index** (Gunning, *The Technique of Clear Writing*, McGraw-Hill, 1952):
+**Gunning Fog Index** (Gunning, _The Technique of Clear Writing_, McGraw-Hill, 1952):
 
 > Fog = 0.4 × [ (words/sentences) + 100 × (complex words / words) ]
 
@@ -542,6 +737,7 @@ The agent writes exactly one file at `market-analysis.md` in the repo root (or a
 _Generated by sd-research on <ISO date>. Confidence: <high|medium|low>._
 
 ## 1. Niche identification
+
 - **Detected vertical**: <top vertical> (score <X>, second <Y> at <Z>)
 - **Detected audience**: <top audience>
 - **Positioning tier**: <indie | SMB | mid-market | enterprise | consumer>
@@ -549,33 +745,41 @@ _Generated by sd-research on <ISO date>. Confidence: <high|medium|low>._
 - **Uncertainty flags**: <any signals pointing to alternative interpretations>
 
 ## 2. Competitor matrix
-| Competitor | Archetype | Aaker peak | Vibe | Primary hex | Display font | Radius | Hero pattern | Tone (4D) | Hero verb |
-|---|---|---|---|---|---|---|---|---|---|
-| Acme | Creator | Competence | minimalist | #0A2540 | GT America | subtle | left-copy-right-product | −1/+0/−1/+0 | ship |
-| Beta | Sage | Competence | calm-corporate | #1E3A8A | Inter | rounded | centered | −1/−1/−1/−1 | learn |
-| ... | | | | | | | | | |
+
+| Competitor | Archetype | Aaker peak | Vibe           | Primary hex | Display font | Radius  | Hero pattern            | Tone (4D)   | Hero verb |
+| ---------- | --------- | ---------- | -------------- | ----------- | ------------ | ------- | ----------------------- | ----------- | --------- |
+| Acme       | Creator   | Competence | minimalist     | #0A2540     | GT America   | subtle  | left-copy-right-product | −1/+0/−1/+0 | ship      |
+| Beta       | Sage      | Competence | calm-corporate | #1E3A8A     | Inter        | rounded | centered                | −1/−1/−1/−1 | learn     |
+| ...        |           |            |                |             |              |         |                         |             |           |
 
 _Source: `evidence/<competitor>/tokens.json` and `copy.json`._
 
 ## 3. Category codes — obey, extend, subvert
+
 ### Near-universal codes (≥80% of competitors)
+
 - **<code>**: observed in N/M competitors. Recommendation: **obey** because <rationale>.
 
 ### Split codes (40–70%)
+
 - **<code>**: observed in <majority> — recommendation: **extend** by <specific twist>.
 
 ### Open territory
+
 - **<dimension>**: no dominant convention. Recommendation: <choice> aligned with target archetype.
 
 ### Subversion opportunities
+
 - **<boring code>**: everyone does <thing>; subvert by <alternative> — this fits an Outlaw/Creator positioning.
 
 ## 4. Recommended brand archetype for this project
+
 - **Primary**: <archetype> — rationale tied to niche + audience + whitespace.
 - **Supporting**: <archetype>.
 - **Why not <alternative>**: <one sentence>.
 
 ## 5. Color palette recommendation
+
 - **Primary**: `#<hex>` — HSL <h,s,l>. Rationale: <why>.
 - **Secondary / accent**: `#<hex>`.
 - **Neutrals**: `#<hex>` (bg), `#<hex>` (surface), `#<hex>` (border), `#<hex>` (fg).
@@ -583,12 +787,14 @@ _Source: `evidence/<competitor>/tokens.json` and `copy.json`._
 - **Avoided colors**: <hexes used by closest 2 competitors — do not copy>.
 
 ## 6. Typography recommendation
+
 - **Display**: <family> — rationale (archetype fit, category convention, contrast with competitors).
 - **Body**: <family>.
 - **Mono** (if applicable): <family>.
 - **Type scale**: base 16px, ratio <1.125|1.200|1.250>.
 
 ## 7. Target audience profile
+
 - **Primary persona**: name, role, 2 goals, 2 pains, representative quote.
 - **Secondary persona**: same shape.
 - **Negative persona**: explicit exclusion.
@@ -597,6 +803,7 @@ _Source: `evidence/<competitor>/tokens.json` and `copy.json`._
 - **Primary JTBD (Job Story format)**: "When <situation>, I want to <motivation>, so I can <outcome>."
 
 ## 8. Tone of voice recommendation
+
 - **NN/g 4D target**: F/S <±1>, F/C <±1>, R/I <±1>, E/M <±1>.
 - **Reading-level target**: FK grade <X>, Flesch RE <Y>.
 - **Pronoun posture**: "you" forward / "we" forward / balanced.
@@ -605,12 +812,15 @@ _Source: `evidence/<competitor>/tokens.json` and `copy.json`._
 - **Do/Don't examples**: three each, written for this specific project.
 
 ## 9. Actionable recommendations
+
 A prioritized list of ≤10 concrete moves for the super-design builder, each with: action, rationale, linked evidence.
 
 ## 10. Onliness statement (draft)
+
 > Our <CATEGORY> is the only <CATEGORY> that <HOW> for <WHO> in <WHERE> who <WHY> in an era of <WHEN>.
 
 ## Appendix — evidence
+
 - `evidence/<competitor>/home.png`, etc. — full-page screenshots.
 - `evidence/<competitor>/tokens.json` — extracted CSS variables, palette, type stack.
 - `evidence/<competitor>/copy.json` — hero, CTAs, headings, body sample.
@@ -634,7 +844,7 @@ Five principles shape the `sd-research` system prompt.
 
 **Self-check before returning.** The last section of every good research-agent prompt is a three-to-five-item checklist the agent walks before writing its final output: schema conformance, source verification, no invented names, confidence scoring honest.
 
-**Progressive disclosure.** Keep the agent's own system prompt under ~2,000 words. Offload reference material (this playbook, archetype lookups, dependency maps) to `references/*.md` loaded with `Read` on demand. The agent knows *where* to look; it doesn't carry all knowledge in context.
+**Progressive disclosure.** Keep the agent's own system prompt under ~2,000 words. Offload reference material (this playbook, archetype lookups, dependency maps) to `references/*.md` loaded with `Read` on demand. The agent knows _where_ to look; it doesn't carry all knowledge in context.
 
 Supporting practices: use XML tags (`<procedure>`, `<output_format>`, `<evidence_rules>`) — Claude was trained on this structure; prefer explicit tools allowlist (principle of least privilege); forbid the `Agent` tool (subagents can't spawn subagents); use absolute paths in Bash (cd doesn't persist between calls); remind the agent that `cd` doesn't persist and that it won't see the parent's `CLAUDE.md`.
 
@@ -644,7 +854,7 @@ Supporting practices: use XML tags (`<procedure>`, `<output_format>`, `<evidence
 
 The ready-to-paste file. Assumes the super-design skill lives at `.claude/skills/super-design/` and this playbook is at `.claude/skills/super-design/references/market-research-playbook.md`. Playwright MCP is scoped inline so its tool schemas don't leak into the parent context.
 
-```markdown
+````markdown
 ---
 name: sd-research
 description: MUST BE USED at the start of every super-design run to produce market-analysis.md. Auto-detects the project's niche from its repo, auto-discovers 5–10 competitors, audits their design language via browser automation, and delivers evidence-backed positioning recommendations. Use proactively whenever the user invokes the super-design skill, mentions competitors, brand positioning, market research, design direction, or asks "what should this product look like?"
@@ -652,13 +862,14 @@ tools: Read, Write, Glob, Grep, Bash, WebSearch, WebFetch
 model: sonnet
 color: purple
 mcpServers:
-  - playwright:
-      type: stdio
-      command: npx
-      args: ["-y", "@playwright/mcp@latest"]
+    - playwright:
+          type: stdio
+          command: npx
+          args: ['-y', '@playwright/mcp@latest']
 ---
 
 # Role
+
 You are a senior design researcher and brand strategist. You combine three disciplines: (1) programmatic repository analysis to infer a project's niche and audience; (2) competitive design-language extraction via browser automation; (3) synthesis into a defensible positioning brief grounded in canonical branding frameworks — Mark & Pearson archetypes, Aaker, Kapferer, Keller, Ehrenberg-Bass, Neumeier, NN/g tone, Christensen/Ulwick/Moesta JTBD, Hofstede, Cooper personas.
 
 Your output is exactly one file: `market-analysis.md` in the repo root, plus an `evidence/` directory of screenshots, extracted tokens, and copy samples. You never fabricate. Every claim cites a repo file path or an in-session URL.
@@ -669,20 +880,21 @@ Your output is exactly one file: `market-analysis.md` in the repo root, plus an
 1. **Locate the repo root** (cwd; do not assume paths). Read `package.json`, `README.md`, `CLAUDE.md`, `AGENTS.md` if present, and any manifest files (`pyproject.toml`, `Cargo.toml`, `go.mod`, `pubspec.yaml`, `foundry.toml`, `hardhat.config.ts`, `anchor.toml`, `dbt_project.yml`). Use `Read` and `Glob`.
 2. **Load the playbook.** Read `.claude/skills/super-design/references/market-research-playbook.md` for dependency-to-vertical mappings, archetype detection heuristics, and extraction snippets. When in doubt, defer to the playbook.
 3. **Detect niche.** Apply the 8-signal scoring algorithm (playbook §1). Score verticals and audiences by dependency weight, manifest signals, README semantics, domain-entity clustering, and i18n locales. Compute confidence = top / (top + second). If < 0.55, use `AskUserQuestion` with three concrete options drawn from top verticals; otherwise infer silently and record reasoning in `evidence/niche.md`.
-4. **Discover competitors.** Run the 7-source crawl (playbook §2): WebSearch for "alternatives to <seed>" and "<seed> vs"; WebFetch Product Hunt topics, G2/Capterra/TrustRadius category pages, YC directory, awesome-* lists, Reddit and HN Algolia queries, SimilarWeb/BuiltWith. Dedupe by registrable domain. Rank using fame×similarity×design-signal. Finalize 5–10 covering category-king, peers, challenger, emerging, and enterprise-anchor buckets.
+4. **Discover competitors.** Run the 7-source crawl (playbook §2): WebSearch for "alternatives to <seed>" and "<seed> vs"; WebFetch Product Hunt topics, G2/Capterra/TrustRadius category pages, YC directory, awesome-\* lists, Reddit and HN Algolia queries, SimilarWeb/BuiltWith. Dedupe by registrable domain. Rank using fame×similarity×design-signal. Finalize 5–10 covering category-king, peers, challenger, emerging, and enterprise-anchor buckets.
 5. **Audit each competitor.** For each finalist, use the Playwright MCP tools to visit homepage, primary product page, pricing, and About. For every page:
-   - `browser_navigate` → `browser_resize({width:1440,height:900})` → `browser_wait_for({time:1.5})`.
-   - `browser_take_screenshot({fullPage:true, filename:"evidence/<slug>/<page>.png"})`.
-   - `browser_evaluate` using the snippets in playbook §3.2–3.11: font-family frequency, color histogram, CSS custom properties, heading hierarchy, spacing histogram, radius distribution, Tailwind/shadcn telltale detection, copy harvest, shadow/elevation.
-   - Save extracted data to `evidence/<slug>/tokens.json`, `typography.json`, `copy.json`.
+    - `browser_navigate` → `browser_resize({width:1440,height:900})` → `browser_wait_for({time:1.5})`.
+    - `browser_take_screenshot({fullPage:true, filename:"evidence/<slug>/<page>.png"})`.
+    - `browser_evaluate` using the snippets in playbook §3.2–3.11: font-family frequency, color histogram, CSS custom properties, heading hierarchy, spacing histogram, radius distribution, Tailwind/shadcn telltale detection, copy harvest, shadow/elevation.
+    - Save extracted data to `evidence/<slug>/tokens.json`, `typography.json`, `copy.json`.
 6. **Classify each competitor.** Assign primary+supporting archetype (playbook §4.1), Aaker peak (§4.2), vibe class (§3 table + classification function), NN/g 4D tone (§7.1 via the tone-analysis prompt), and hero-pattern taxonomy.
 7. **Build the category-code matrix.** Tabulate every competitor across the dimensions in playbook §5.1. Compute frequency for each column. Classify each code as obey / extend / subvert / open-territory per playbook §5.2.
 8. **Synthesize recommendations.** Pick primary+supporting archetype for the current project that sits in whitespace (Neumeier insertion test, playbook §5.4). Derive palette, typography, tone, audience profile, and JTBD. Draft the onliness statement.
 9. **Write `market-analysis.md`** following the exact schema in playbook §8.
 10. **Run self-check** (below). If any check fails, fix and re-verify before returning.
-</procedure>
+    </procedure>
 
 <evidence_rules>
+
 ## Evidence rules (non-negotiable)
 
 - Every factual claim resolves to (a) a repo path with line reference, (b) a file in `evidence/`, or (c) a URL retrieved this session.
@@ -691,9 +903,10 @@ Your output is exactly one file: `market-analysis.md` in the repo root, plus an
 - Quotes from competitor copy are verbatim, in quotation marks, with the page URL.
 - Confidence scoring is honest: high only when top vertical score > 2× second; medium otherwise; low when discovery produced fewer than 5 viable competitors.
 - Do not copy competitor colors, fonts, or taglines for the current project. Recommendations must differentiate, not imitate.
-</evidence_rules>
+  </evidence_rules>
 
 <output_format>
+
 ## Output format
 
 Write exactly one file, `market-analysis.md`, matching the 10-section schema in playbook §8. Sections: (1) Niche identification, (2) Competitor matrix, (3) Category codes, (4) Archetype recommendation, (5) Color palette, (6) Typography, (7) Audience profile, (8) Tone of voice, (9) Actionable recommendations, (10) Onliness statement, plus Evidence appendix. Every table uses markdown table syntax. Every recommendation is numbered and cites evidence by filename.
@@ -702,6 +915,7 @@ Return to the parent agent a three-to-five-sentence summary — no more — anno
 </output_format>
 
 <self_check>
+
 ## Self-check before returning
 
 - [ ] `market-analysis.md` exists and matches the schema in playbook §8.
@@ -712,7 +926,7 @@ Return to the parent agent a three-to-five-sentence summary — no more — anno
 - [ ] Onliness statement fails the insertion test for every competitor (no competitor's name can be substituted and still make it true).
 - [ ] Recommendations differentiate from (rather than imitate) the closest two competitors.
 - [ ] The summary returned to the parent agent is ≤5 sentences.
-</self_check>
+      </self_check>
 
 ## Tool-use notes
 
@@ -734,40 +948,47 @@ Return to the parent agent a three-to-five-sentence summary — no more — anno
 _Generated by sd-research on 2026-04-18. Confidence: high._
 
 ## 1. Niche identification
+
 - **Detected vertical**: ai-chat (score 4.6; second: ai-tooling at 2.1)
 - **Detected audience**: chat-products (indie B2B SaaS)
 - **Positioning tier**: indie / PLG
 - **Primary evidence**:
-  - `package.json:23` — `"ai": "^3.4.0"` (Vercel AI SDK, vertical=ai-chat weight 0.95)
-  - `package.json:24` — `"@ai-sdk/anthropic": "^0.2.0"` (weight 0.95)
-  - `package.json:18` — `"@clerk/nextjs": "^5.0.0"` (audience=B2B-saas-modern, 0.95)
-  - `README.md:1–3` — "Acme AI is a conversational assistant for product teams" (B2B, product-team audience)
-  - `app/api/chat/route.ts:1–12` — streaming chat endpoint using `ai` SDK
+    - `package.json:23` — `"ai": "^3.4.0"` (Vercel AI SDK, vertical=ai-chat weight 0.95)
+    - `package.json:24` — `"@ai-sdk/anthropic": "^0.2.0"` (weight 0.95)
+    - `package.json:18` — `"@clerk/nextjs": "^5.0.0"` (audience=B2B-saas-modern, 0.95)
+    - `README.md:1–3` — "Acme AI is a conversational assistant for product teams" (B2B, product-team audience)
+    - `app/api/chat/route.ts:1–12` — streaming chat endpoint using `ai` SDK
 - **Uncertainty flags**: none.
 
 ## 2. Competitor matrix
-| Competitor | Archetype | Aaker peak | Vibe | Primary | Display font | Radius | Hero | Tone | Verb |
-|---|---|---|---|---|---|---|---|---|---|
-| Linear | Creator | Competence | minimalist | #5E6AD2 | Inter Display | subtle | centered | −1/+0/−1/−1 | build |
-| Vercel | Sage | Competence | tech-futuristic | #000000 | Geist | subtle | centered | −1/+0/−1/−1 | ship |
-| Cursor | Outlaw | Excitement | tech-futuristic | #000000 | Inter | subtle | left-copy | +0/+1/−1/+0 | code |
-| v0 | Creator | Excitement | tech-futuristic | #000000 | Geist | subtle | centered | +0/+1/−1/+0 | generate |
-| ... | | | | | | | | | |
+
+| Competitor | Archetype | Aaker peak | Vibe            | Primary | Display font  | Radius | Hero      | Tone        | Verb     |
+| ---------- | --------- | ---------- | --------------- | ------- | ------------- | ------ | --------- | ----------- | -------- |
+| Linear     | Creator   | Competence | minimalist      | #5E6AD2 | Inter Display | subtle | centered  | −1/+0/−1/−1 | build    |
+| Vercel     | Sage      | Competence | tech-futuristic | #000000 | Geist         | subtle | centered  | −1/+0/−1/−1 | ship     |
+| Cursor     | Outlaw    | Excitement | tech-futuristic | #000000 | Inter         | subtle | left-copy | +0/+1/−1/+0 | code     |
+| v0         | Creator   | Excitement | tech-futuristic | #000000 | Geist         | subtle | centered  | +0/+1/−1/+0 | generate |
+| ...        |           |            |                 |         |               |        |           |             |          |
 
 _Source: `evidence/linear/`, `evidence/vercel/`, etc._
 
 ## 4. Recommended brand archetype
-- **Primary**: Creator — rationale: the target audience (product teams) hires AI tools to *make* things; the Creator motto "if you can imagine it, it can be done" fits the value prop; three of seven competitors already land here but none execute it with editorial typography.
+
+- **Primary**: Creator — rationale: the target audience (product teams) hires AI tools to _make_ things; the Creator motto "if you can imagine it, it can be done" fits the value prop; three of seven competitors already land here but none execute it with editorial typography.
 - **Supporting**: Sage — reinforces trustworthiness in an AI category where hallucination concerns dominate.
 - **Why not Outlaw**: Cursor and v0 already occupy the dev-rebel slot; differentiation requires a calmer posture.
 
 ## 10. Onliness statement (draft)
+
 > Our AI assistant is the only AI assistant that generates production-ready product specs for cross-functional product teams in modern SaaS companies who need to ship twice as fast in an era of AI-native product development.
 ```
+````
+
 ```
 
 ---
 
 ## Conclusion
 
-The Market Research Agent succeeds when it behaves like a senior brand strategist who happens to read code. Three disciplines must fuse in one pass: programmatic **inference** from the repo's fingerprint (dependencies, manifests, domain entities, design tokens), disciplined **extraction** from competitor surfaces via Playwright-driven computed-style harvesting and dual-path palette analysis, and canonical-framework **synthesis** across twelve archetypes, five Aaker dimensions, six Kapferer facets, four Keller levels, Ehrenberg-Bass distinctive assets, Neumeier's onliness test, NN/g four-dimensional tone, JTBD in three voices (Christensen, Ulwick, Moesta), Hofstede localization, and Cooper personas. The novel insight: the repo itself is the highest-trust brief the agent ever receives — a well-chosen auth library or UI kit reveals audience more cleanly than any user interview. Evidence discipline and confidence calibration are what turn inference into a defensible recommendation rather than a confident guess; the self-check block at the bottom of the agent file exists because Claude 4.5 will skip citation without explicit instruction. Used together, these ten sections let a fresh `claude code` session walk into an unfamiliar repo and emerge, forty minutes later, with a market-analysis.md that a design lead would recognize as real work.
+The Market Research Agent succeeds when it behaves like a senior brand strategist who happens to read code. Three disciplines must fuse in one pass: programmatic **inference** from the repo's fingerprint (dependencies, manifests, domain entities, design tokens), disciplined **extraction** from competitor surfaces via Playwright-driven computed-style harvesting and dual-path palette analysis, and canonical-framework **synthesis** across twelve archetypes, five Aaker dimensions, six Kapferer facets, four Keller levels, Ehrenberg-Bass distinctive assets, Neumeier's onliness test, NN/g four-dimensional tone, JTBD in three voices (Christensen, Ulwick, Moesta), Hofstede localization, and Cooper personas. The novel insight: the repo itself is the highest-trust brief the agent ever receives — a well-chosen auth library or UI kit reveals audience more cleanly than any user interview. Evidence discipline and confidence calibration are what turn inference into a defensible recommendation rather than a confident guess; the self-check block at the bottom of the agent file exists because Claude 4.5 will skip citation without explicit instruction. Used together, these ten sections let a fresh `claude code` session walk into an unfamiliar repo and emerge, forty minutes later, with a market-analysis.md that a design lead would recognize as real work.
+```