--- name: omd-scout description: >- Build a measured LEGO reference inventory without designing anything: whole pages for feel, tight selectors for component anatomy, typography studies, motion studies, image refs for the unrenderable. Use when the user asks for references, inspiration, benchmarks, or "how do good sites do X" — standalone, before or without a build — and also when the request is to fix or improve the UX of an existing surface: research how strong products solve that same UX problem before proposing changes, instead of applying generic rules from memory. Triggers: 레퍼런스 찾아줘, 레퍼런스 수집, 참고 사이트, 벤치마킹, UX 고쳐줘, UX 개선, 이 페이지 UX 개선해줘, find references, inspiration board, how do other sites do, fix/improve the UX. --- # OMD-scout A LEGO reference assembly, measured instead of pinned. Read `protocol/reference-assembly.md` under `omd pack dir`; it owns the selected stages, their single owners, and their artifact/stop boundaries. This skill collects evidence and names transferable principles; it does not design or implement the result. ## Pipeline-role bootstrap When this skill is loaded inside an already spawned `omd-scout` child that has injected role instructions, the injected role is authoritative for acquisition order, read bounds, fallbacks, and owned artifacts. This read only satisfies the host's skill bootstrap. Do not spawn another scout, do not broaden the standalone workflow, and immediately execute the injected role's first operational pass. When the host exposes an isolated role boundary, spawn `omd-scout` with the concept (ask one short question only when neither the request nor `.omd/frame.md` supplies one), the component inventory, working directory, and user URLs. On a Pi-compatible host without such a boundary, execute this bounded standalone scout role in the current session and do not claim independent-process isolation. User URLs are captured first and marked `--from-user`. The scout owns only `fragment inventory`, `brick analysis`, and `candidate assemblies`. It uses `browser-rs` first for interactive visual research and user-directed image-region capture. Use the headless, reduced-motion `omd render` or `omd probe` Playwright fallback only when browser-rs is unavailable for this platform (no browser-rs build — e.g. an arm Linux host) or the user declines to install/use browser-rs; report which applies rather than silently swapping providers on a transient failure. Preserve the existing measured-transfer, motion, reduced-motion, and WebGL/3D gates. Do not scrape, hotlink, or ship source pixels. ## Coverage contract Build for decision coverage, not capture counts. Before searching, list the decisions the later design must make and the components it must support. The inventory is complete only when it contains useful, non-duplicate evidence for every applicable category: - domain conventions and user expectations; - direct competitors and meaningful alternatives; - first-party or user/community language; - typography and voice; - motion when the concept or interaction actually needs it; - every required component or state whose anatomy is uncertain. There is no minimum query count, capture quota, famous-site quota, or mandatory award gallery. A small inventory with complete, independent evidence is better than a large gallery of near-duplicates. If a category is irrelevant, record why. If evidence remains weak or contradictory, report the gap and uncertainty instead of filling a slot with decoration. Never choose, target, estimate, or announce a number or range of references (never "18–25 references", never an "N of M" progress count) — there is no target count, and a made-up count is exactly the fabricated specificity this tool exists to remove. Capture strictly per decision: for each decision the design must make, capture until you have enough independent evidence to settle that one decision, then move to the next. Stop when another capture would not change any remaining decision. In chat, report only which decision you are gathering evidence for, never a count, quota, or gallery size. Use the narrowest useful capture: ```bash omd ref add --as --from-user omd ref add --as omd ref add --as --selector ".component" omd ref add --as --selector ".component" --blueprint omd ref import-image omd ref principles --as --add "..." omd ref list omd ref check omd ref candidates ``` Do not reflexively web-search the same famous benchmarks (토스/Toss, Linear, Stripe, Vercel, 당근) on every brief — that reflex is the reference-grammar homogenization this tool removes. Search this product's own domain, its real competitors, and its audience's language; a famous product enters only when the brief's real problem points to it. Run independent searches and captures in parallel — batch captures with `omd ref add-batch `, never a sequential `omd ref add` per reference when several are already known. After capture, run `omd ref audit`; it fails when the recorded capture times show a sequential pass (a browser launch per reference) rather than a batched one — batch the known set so it passes. Whole-page captures establish rhythm or product feel; tight selectors establish component anatomy; type and motion studies establish measured behavior; image references support only what cannot be rendered. A blueprint is allowed only for an explicitly requested exact component transplant or a structurally equivalent component problem. Structure may transfer; skin and pixels do not. For Pinterest-like or gallery sources, use browser-rs to capture only the user-selected local region, then pass that PNG, its HTTP(S) source-page provenance, capture-region description, rights status/notes, visual role, and principles to `omd ref import-image`. A remote image URL is provenance only, never an importer input or production asset. After analysis, write the internal candidate record, run `omd ref check`, then paste the exact `omd ref candidates` Markdown table directly into the host chat. It is the selection surface: do not make a board UI, HTML, PNG, showcase, or `omd-board` command. The coordinator selects the strongest candidate itself and records it with `omd ref select`, disclosing its choice and reason; it does not ask the user to pick a candidate, and a candidate the user explicitly named still wins. Downstream receives only the resulting hash-bound sanitized selected assembly. Work at component granularity: for a specific button, card, or region, capture that exact component with a tight `--selector` and `--shot`, and record its own take, avoid, and adaptation per slot. The candidate table's local-capture column carries each part-image's local path for human inspection. A raw file under `.omd/refs/` is Scout provenance, not Hand authority. The coordinator may derive a selected, source-free, no-ship geometry packet after selection; Scout never grants raw pixels to Hand. Without that packet Hand consumes the sanitized measured assembly. Component-level and whole-surface fidelity are both allowed; `omd ref distance` is advisory — it reports closeness and never blocks shipping in bare mode. After current usage and build observation, selected measurable production slots must each score at least `0.6` and pass `omd ref distance --selected --gate --json`; a failed, missing, malformed, unmeasurable, or stale receipt blocks new final-v2 publication. Record attribution for every used reference and write the product's own copy. For board-v3, also run `omd ref influence-proof --input ` so every used influence passes at every target viewport on its promised axis and falsifier; aggregate closeness cannot compensate for a missing feature. The optional `omd ref visual-packet` command is coordinator-owned after selection. Its private evidence stays with source provenance; downstream roles receive only the current source-free manifest and named no-ship SVG. ## Evidence quality and contamination Prefer first-party product sources and direct user/community evidence over SEO summaries. Label source trust, uncertainty, and whether evidence is independent or derivative. Reject a non-user source only when it is derivative or convergent — an SEO/content-farm summary, a near-duplicate, or a page whose repeated roleless treatments erase task and subject specificity. A premium, first-party, intentional design is not slop for using a common pattern (a gradient, a card grid, a common sans) with a visible role; measure it. Slop review measures convergence and consequence, never authorship or any familiar visual move in isolation. Keep a user-provided contaminated source only as a named anti-reference. Drop kin at similarity `>= .85`; a cluster of related pages is one evidence family, not independent corroboration. A blocked page is not retried; use an honest image/discourse fallback or discard it. Every retained capture records: - the decision or coverage gap it answers; - measured invariants and the reason they matter; - what contradicts the concept; - source trust and uncertainty; - the token, component, motion, voice, or composition question it may inform. Hand off measurements, principles, contradictions, coverage gaps, and trust. A raw file under `.omd/refs/` is Scout provenance, not Hand authority; only the coordinator's selected neutral geometry packet may cross downstream, never raw source pixels. Component-level and whole-surface fidelity are both intended, and `omd ref distance ` is advisory in bare mode. The selected production gate is blocking and slot-scoped; high per-part closeness is intended without authorizing whole-page cloning. Record attribution and write the product's own copy rather than lifting source copy. Board-v3 additionally requires `omd ref influence-proof --input ` at every promised viewport. Composer and eye still receive only the sanitized evidence summary required for their decision.