vertical-site-conventions

Vertical Site Conventions

Compose pages and whole sites to the layout, density, and merchandising conventions that make a build read as a credible member of its vertical. Stack-agnostic. Works on any framework that can express server-rendered pages and component composition.

This skill owns vertical-level composition: which modules go where, how dense the page is, how much of the catalog or offering is surfaced, and which paths the navigation serves. It routes the day-to-day visual decisions to design-standards, the aesthetic register to creative-direction, the site-structure modeling to information-architecture, and the component implementation to frontend-component-build. It does not duplicate any of them; it composes their outputs into a vertical-correct site.

It is the build-side counterpart to competitor-experience-audit. The audit measures the field on seven dimensions; this skill builds to those same seven, dimension by dimension. The two are deliberately structured as two sides of one standard so an experience bar produced by the audit maps one-to-one onto what this skill builds.

When to use

• Building a new site in a vertical you have not built in before
• Fixing a build that reads as generic or off-vertical even though it is technically clean (the SEO, accessibility, and component implementation are correct, but the page does not read like its category)
• Building to an experience bar produced by competitor-experience-audit (the audit-fed path is the intended use)
• Adding the merchandising, density, and navigation conventions a site in this category is expected to carry
• Building a showcase or demo where the build must read as its vertical, not as a generic SaaS landing page

When NOT to use

• Day-to-day visual decisions on a known build (use design-standards)
• Defining the brand register or aesthetic from scratch (use creative-direction, brand-archetype-system, brand-discovery)
• Building one component well (use frontend-component-build)
• Modeling site structure and navigation hierarchy from scratch (use information-architecture)
• Building a formal design system or token system (use design-system)
• Auditing the competitive field for what conventions exist (use competitor-experience-audit; this skill consumes that audit's output, it does not produce it)

Required inputs

• The site shape the build is for, from the controlled list: ecommerce-catalog, inventory-listing, directory-marketplace, local-service-booking, subscription-app, hospitality-food, institution-mission, b2b-manufacturer, ecommerce-standout, hospitality-experience.
• An experience bar from competitor-experience-audit (the cross-site patterns and gaps for the vertical). If absent, the skill falls back to the per-shape default conventions in the references; the audit-fed path is stronger and is the intended use.
• The brand register and aesthetic decisions (from creative-direction or already settled). This skill does not redefine them.
• The framework or technical context the build will use (the skill is stack-agnostic but the consumer needs to know).

If the site shape is unclear, ask. Building to the wrong shape's conventions produces a build that reads off-vertical, which is the exact failure this skill exists to prevent.

The framework: build to the seven dimensions

The framework mirrors the seven dimensions competitor-experience-audit measures. Each is expressed here as build guidance (what to do) rather than audit questions (what to observe). Run them in order; the synthesis in dimension 7 is the composition checklist that catches what the earlier six missed.

1. Build the primary task as the dominant, earliest element

The visitor arrives with a primary job. The leaders in the vertical lead with that job; off-vertical builds bury it behind marketing copy or competing CTAs.

• Identify the vertical's primary task from the experience bar or the per-shape reference. (Ecommerce-catalog: a fitment, search, or category-entry interaction. Hospitality-food: a menu or reservation entry. Inventory-listing: a search-and-filter. Local-service-booking: a "book now" or service-picker.)
• Give that task the largest, earliest interactive treatment in the hero.
• Demote competing CTAs. The hero gets one primary action; secondary actions live below the fold or in the chrome.
• Reach the core task without scrolling on the device class the vertical's visitors use.
• For commercial pages, sticky a compact version of the primary task to the chrome so it stays reachable on scroll.

If the primary task cannot be the hero (a constraint from a stakeholder, a regulated vertical), surface the closest equivalent and document the compromise. Do not silently push the primary task below the fold.

2. Build to the vertical's layout register and density

Most off-vertical builds default to a generic SaaS-airy landing page. Retail and catalog verticals are denser; editorial verticals are calmer; hospitality is image-led. Build to the field's density, not to a default.

• Identify the register from the experience bar or the per-shape reference (storefront-dense, editorial-calm, marketing-airy, image-led).
• Match the field's content-per-viewport: a catalog vertical surfaces more modules above the fold than a SaaS landing page.
• Choose the module count above the fold deliberately. State the count in the build notes.
• Route the actual color, type, and aesthetic choice to creative-direction and design-standards. This skill owns the density and module-count decision, not the visual register itself.

Composition decision lives here. Visual register lives there. Do not redefine either; route to the right skill.

3. Build the merchandising and category surface the vertical uses

How much of the catalog or offering is surfaced at once, and in what shape, is a per-vertical decision the build must own.

• Surface the catalog the way the vertical does: how many category, collection, or entry-point modules appear before scroll.
• Signal depth the way the vertical signals it: mega-menu hover, grid of category cards, faceted-search side rail, breadcrumb-driven hierarchy. Pick one and commit; do not stack three.
• Choose flat (one tier visible) or hierarchical (parent plus child categories shown together) per the vertical's convention.
• Use icon / image / text / hybrid category presentation per the vertical.

Cross-reference information-architecture for the structural modeling of the nav tree. This skill owns the compositional surface; that skill owns the structural model.

4. Build both the know-what-I-want and the browse path the vertical expects

Verticals differ on which path is primary. A catalog vertical needs both search and category browse, with search often primary. A hospitality-food site rarely needs search but always needs a menu and a reservation entry. Build to the paths the field actually offers, in the prominence the field gives them.

• List the paths the experience bar names (by category, by brand, by attribute, by vehicle, by location, by occasion, by audience).
• Score each path as primary, secondary, or absent per the vertical.
• Build the primary paths into the hero or primary nav. Build the secondary paths into the chrome or below the fold. Drop the paths the field does not use.
• Search input prominence is a per-vertical decision: header-primary, secondary in a side rail, or absent. Match the field.

Route the structural nav modeling to information-architecture; route the search UX patterns to that skill or to the project's existing search component. This skill owns which paths exist and how prominent each is.

5. Build the brand posture consistently across the page

The brand register is set by creative-direction and brand-archetype-system. This skill does not redefine it. But composition decides whether the posture holds across the page or only in the hero.

• Carr