diff --git a/docs/product/genre-packs.md b/docs/product/genre-packs.md index 6fb5a31..298ce66 100644 --- a/docs/product/genre-packs.md +++ b/docs/product/genre-packs.md @@ -1,23 +1,34 @@ # Genre packs -Generic business fields are scaffolding. Durable differentiation is **genre-specific primitives**. +**Structural direction (working):** three layers when surfacing work to owners — not one giant schema dump. -## Planned packs +| Layer | What | Owner hears | +| :--- | :--- | :--- | +| **A — Universal** | Discovery foundation: NAP + Core 3 claimed + hours + website + description + service-area mode + no duplicates/contradictions | Everyone’s first punch list | +| **B — Genre pack** | Thin ranked list for that vertical (secondaries, high-value attributes, services/menu shape, booking/links, maybe one vertical directory) | “For salons like yours, next is X” — never “schema” | +| **C — Known-for** | From the owner’s own words | Extra attributes/photos/proof + later AI-readiness queries | -- Auto repair (see [UC-01](./use-cases/uc-01-endpoint-auto-repair.md)) -- Beauty -- Home services -- Tourism activity ([UC-02](./use-cases/uc-02-intermediate-tourism-board.md) context) -- **Local retail / general store** (see [UC-03](./use-cases/uc-03-local-retail-general-store.md)) — assortment signals, house specialties, hours, visit path +**Surface rule:** scorecard ladder first (exist → know what you do → would recommend), then **3–7 actions max**, sorted by impact. Genre pack ranks the backlog. + +**Core 3 coverage rule:** **GBP** is richest; Apple Business Connect mid; Bing Places thinnest. Pack actions: set on GBP; mirror on Apple/Bing where the field exists. + +## Deep example packs (planning-rev2) + +- [Salon](./genre-packs/salon.md) +- [Bakery](./genre-packs/bakery.md) + +## Earlier planned packs (from main / prior docs) + +- Auto repair (see [UC-01](./use-cases/uc-01-endpoint-auto-repair.md)) +- Beauty (overlaps salon — reconcile later) +- Home services +- Tourism activity ([UC-02](./use-cases/uc-02-intermediate-tourism-board.md)) +- Local retail / general store ([UC-03](./use-cases/uc-03-local-retail-general-store.md)) ## Why this matters -Assistants evaluate helpfulness by whether the business answers the *right* questions for its category. “Do you work on Korean transmissions?” is not the same shape as “Do you have a toothbrush?” or “Are the chicken strips still a thing?” - -## Sequencing - -Services packs may ship first for pilot speed. Retail is **in scope**, not a strategy exception. +Assistants evaluate helpfulness by whether the business answers the *right* questions for its category. Salon booking ≠ bakery known-for products. ## Detail source -[Canonical Strategy](../strategy/CANONICAL_STRATEGY.md) §1a and genre primitives. +Conversation checkpoint on `planning-rev2`; [BUSINESS_PLAN.md](../strategy/BUSINESS_PLAN.md); [Canonical Strategy](../strategy/CANONICAL_STRATEGY.md) §1a. diff --git a/docs/product/genre-packs/bakery.md b/docs/product/genre-packs/bakery.md new file mode 100644 index 0000000..22618b9 --- /dev/null +++ b/docs/product/genre-packs/bakery.md @@ -0,0 +1,48 @@ +# Genre pack — Bakery (deep example) + +**Status:** working shell from planning conversation (not locked) +**Vertical:** local retail / food — products & known-for more than “book a slot” +**Assumes Layer A** (Discovery foundation) already ranked or clean. + +**Core 3 rule:** set on **GBP** first; mirror on Apple Business Connect / Bing Places where the field exists. GBP = richest; Apple = mid; Bing = thinnest. + +--- + +## Must address (beyond Layer A) + +| Action (owner language) | Placeholder example | GBP | Apple Business Connect | Bing Places | +| :--- | :--- | :---: | :---: | :---: | +| Primary category (+ secondary if real) | Bakery; Cafe / Coffee shop if true | ✓ | ✓ | ✓ | +| Known-for in description | “sourdough & muffins” | ✓ | ✓ | ✓ | +| Hours accuracy | Weekends / early open correct | ✓ | ✓ | ✓ | +| Service options | dine-in / takeout / delivery | ✓ attributes | partial | partial | +| Ordering or menu URL | online order or PDF menu | ✓ (+ website) | link fields if present | link fields if present | + +--- + +## High-value recommended + +| Action | Placeholder / note | Core 3 coverage | +| :--- | :--- | :--- | +| Attributes (*only if true*) | outdoor seating, wheelchair accessible, wifi, kid-friendly, pet-friendly | **GBP-heavy**; Apple/Bing partial — mirror where fields exist | +| Products / proof for known-for | “homemade muffins” → products, photos, description + later AI-readiness queries | **Not** a Core-3 checkbox — don’t force fake attributes | +| Peak / holiday hours | Thanksgiving week, summer weekend rush | ✓ Core 3 when seasonal | + +--- + +## Example ranked punch list (3–7) + +If Layer A is clean, a bakery might see: + +1. Set category Bakery (+ Coffee shop if true) on Core 3 +2. Put “sourdough & muffins” in the short description everywhere +3. Confirm weekend / early-open hours on Core 3 +4. Set dine-in + takeout on GBP; mirror where Apple/Bing allow +5. Add menu or order URL on GBP + website +6. Add 5 product photos (muffins, sourdough) on GBP + +--- + +## Out of scope for this pack shell + +Full Google food schema, delivery-marketplace integrations, MCP/endpoints. diff --git a/docs/product/genre-packs/salon.md b/docs/product/genre-packs/salon.md new file mode 100644 index 0000000..354c028 --- /dev/null +++ b/docs/product/genre-packs/salon.md @@ -0,0 +1,48 @@ +# Genre pack — Salon (deep example) + +**Status:** working shell from planning conversation (not locked) +**Vertical:** appointment-based beauty / hair +**Assumes Layer A** (Discovery foundation) already ranked or clean. + +**Core 3 rule:** set on **GBP** first; mirror on Apple Business Connect / Bing Places where the field exists. GBP = richest; Apple = mid; Bing = thinnest. + +--- + +## Must address (beyond Layer A) + +| Action (owner language) | Placeholder example | GBP | Apple Business Connect | Bing Places | +| :--- | :--- | :---: | :---: | :---: | +| Primary category + 1–2 secondaries | Hair salon; Nail salon; Beauty salon | ✓ | ✓ | ✓ | +| Services list | Haircut, Color, Balayage, Blowout | ✓ strong | thinner — fold detail into description if no services field | thinner — same | +| Booking URL | Mindbody / Square / Booksy link | ✓ (+ website) | website / appointment link if present | link fields if present | +| Accessibility | Wheelchair accessible entrance | ✓ where offered | ✓ where offered | ✓ where offered | + +--- + +## High-value recommended + +| Action | Placeholder / note | Core 3 coverage | +| :--- | :--- | :--- | +| Attributes that match real ask patterns | women-led, LGBTQ+ friendly, wifi, parking — *only if true* | **Mostly GBP**; not all exist on Apple/Bing — don’t invent checkboxes there | +| Known-for specialties | “bridal hair,” “curly specialists” | description + photos + services on all Core 3 — **not** fake attribute checkboxes | +| 5–10 real work photos | before/after, salon floor (real, not stock) | **GBP / Apple** strong; Bing weaker | +| Staff / credentials | only if true | platform-specific; skip if none | + +--- + +## Example ranked punch list (3–7) + +If Layer A is clean, a salon might see: + +1. Fix primary category (Hair salon) on Core 3 +2. Add booking link on GBP + website +3. List top 4 services (Haircut, Color, Balayage, Blowout) +4. Add “curly specialists” to description (known-for) +5. Upload 5 real work photos on GBP +6. Mirror hours + booking URL on Apple Business Connect + +--- + +## Out of scope for this pack shell + +Full Google attribute schema, review response playbooks, MCP/endpoints. diff --git a/docs/strategy/BUSINESS_PLAN.md b/docs/strategy/BUSINESS_PLAN.md index 7916b81..c98aa06 100644 --- a/docs/strategy/BUSINESS_PLAN.md +++ b/docs/strategy/BUSINESS_PLAN.md @@ -115,6 +115,12 @@ Checked *on* the Core 3 (and the site). Prerequisite for 2027 work **when flaws **Foundation sync (P1)** across Core 3: NAP + primary category + hours + website URL + short description + service-area/address mode. Phone lives in NAP but must match. P2 (attributes, photos, menus, booking, secondary categories) is genre/known-for gated — not universal min-bar. +### Surfacing work to owners (working direction — essence) + +Three layers (not one giant schema): **A** universal Discovery foundation → **B** thin genre pack → **C** known-for overlay. Scorecard first, then 3–7 actions max by impact. + +Deep example packs: [`docs/product/genre-packs/salon.md`](../product/genre-packs/salon.md), [`docs/product/genre-packs/bakery.md`](../product/genre-packs/bakery.md). Index: [`docs/product/genre-packs.md`](../product/genre-packs.md). + ### Validation gate (working direction — essence) Anyone using GeoLocal tools must pass a **business-representation check** first (e.g. prove control of a contact channel tied to that business). Mechanism details and free/silver/gold allotments stay open until COGS is real — only the gate itself is directional essence so far. @@ -174,6 +180,7 @@ If something here conflicts with `CANONICAL_STRATEGY.md`, resolve on purpose in | 2026-09-15 | Essence: owner vocab Core listings / Core 3; 2017 foundation six-point bar checked on Core 3 + site | | 2026-09-15 | Essence: two tiers — Discovery foundation → AI readiness (owner names); measure both early, fix foundation first when broken | | 2026-09-15 | Essence: P1 foundation sync = NAP + category + hours + website + description + service-area mode; P2 genre/known-for gated | +| 2026-09-15 | Essence: Layer A/B/C surfacing; deep pack shells for salon + bakery under docs/product/genre-packs/ | ---