Revise genre clusters after GBP mapping pressure test.

Split destination workshop from service-area trades, narrow beauty
away from healthcare, demote hybrid to a cross-cutting flag, and note
GBP's flat GCID catalog as outbound maps only.
This commit is contained in:
2026-10-01 10:05:31 -07:00
parent 1a912c96fc
commit fea735782b
+16 -12
View File
@@ -1,7 +1,7 @@
# How local businesses get AI to recommend them
**Branch:** `planning-selfserve-audit` (from `planning-rev2`)
**Status:** Working draft from conversation on 2026-10-01
**Status:** Working draft from conversation on 2026-10-01; cluster cut revised after GBP mapping pressure test the same day
**Related:** [`BUSINESS_PLAN.md`](./BUSINESS_PLAN.md) · conventions in [`CONVENTIONS.md`](./CONVENTIONS.md)
This is the single working doc for the self-serve “Am I discoverable by AI?” idea — both the *why* and the phased *how*. Revise this file in place. Do not add a sibling PLAN or CONCEPT file for the same subject.
@@ -64,7 +64,9 @@ There is no single industry-wide taxonomy that Apple, Google, and Yelp all use.
**NAICS** (North American Industry Classification System) is the U.S. government’s statistical system for classifying businesses by what they produce. It is good for reports and some B2B software. It is not how someone searches “plumber near me” on a map. **SIC** is the older system NAICS replaced for federal stats.
**Google Business Profile** has its own category IDs (often looking like `gcid:…`), available through Google’s business APIs. **Apple Maps / Business Connect** has its own primary category (one main label) plus optional extras; the public docs have been shifting as Apple folds Connect into a broader “Apple Business” offering. **Yelp** has its own tree of category aliases, published through Yelp’s developer APIs.
**Google Business Profile** has its own category IDs (often looking like `gcid:…`), available through Google’s Business Information API (`categories.list`, region US / language en). That official list is a **flat catalog of roughly 4,050 leaves** — not a hierarchy that matches our genre parents. Google does not publish a downloadable tree that says “these GCIDs belong under service-area trades.” A public September 2026 compilation of **4,053** US English GCID names (with third-party industry buckets used only for structure) is useful for research; those buckets are **not** Google’s official parents. We use GBP GCIDs as **outbound presence-check maps** and fix suggestions, not as our spine.
**Apple Maps / Business Connect** has its own primary category (one main label) plus optional extras; the public docs have been shifting as Apple folds Connect into a broader “Apple Business” offering. **Yelp** has its own tree of category aliases, published through Yelp’s developer APIs.
**schema.org’s LocalBusiness** types are an open vocabulary used widely on the web for structured data (the markup that helps search engines understand a page). That is the best spine for an AI-era product that also wants to publish clear web facts: owner-friendly genres inside our product, keyed to schema.org where they fit, optional NAICS when a statistical code helps, and **outbound maps** — translation tables — from our genres to Google, Apple, and Yelp categories when we check presence or suggest fixes.
@@ -82,25 +84,27 @@ What actually splits the audits:
Where the work happens (customer comes to you, you go to them, both, or a moving spot). What “place” means (a storefront with a public address, a service-area business that hides its address, a tourist landmark, or many locations). What decision data matters (menu, service list, booking, hours open right now, amenities). What kind of demand it is (emergency, same-day convenience, a planned night out, a trip, or B2B research). How trust shows up (reviews, photos, licenses). Seasonality. And whether the AI is helping a consumer or a business buyer.
We are proposing eight clusters as a starting cut — also a hypothesis until real audits teach us to merge or split:
We are proposing **eight top-level clusters** plus one cross-cutting flag as a starting cut — also a hypothesis until real audits teach us to merge or split. A GBP category pressure test (flat GCID catalog + third-party industry buckets for structure only) pushed three corrections: split bring-to-shop trades away from service-area trades; narrow beauty away from medical; demote hybrid from a parent to a flag.
**Service-area trades** (plumber, HVAC, cleaner): presence cares about looking like a real service-area listing rather than a fake storefront, having coherent service areas and categories; recommendability cares about matching the job type and the customer’s area, plus reliability signals.
**Service-area trades** (plumber, HVAC, cleaner, landscaper, pest control): the provider goes to the customer. Presence cares about looking like a real service-area listing rather than a fake storefront, having coherent service areas and categories; recommendability cares about matching the job type and the customer’s area, plus reliability signals. Do **not** put auto repair here.
**Destination workshop** (auto repair, tire shop, furniture repair, shoe repair, and similar bring-the-item-in trades): the customer brings the asset to a shop with a public address. Presence is storefront-like (real pin, hours, specialty categories); recommendability is trade-like (job match, make/model or specialty, reliability). GBP catalogs Automotive separately from Construction & Trades / Home & Garden — that split supports this parent.
**Storefront retail:** presence cares about address, hours, and category truth; recommendability cares about whether the assortment fits the ask and whether the shop is actually open.
**Food service** (restaurants, cafés, bars, food trucks): presence cares about specific cuisine or format categories (not a vague “Restaurant”), hours, and a current menu; trucks also need “where are you today.” Recommendability cares about occasion (date night versus quick lunch), price and vibe signals, dietary clarity, and fresh reviews. Fine dining, quick service, and trucks are **parameters inside this cluster**, not eight separate products.
**Food service** (restaurants, cafés, bars, food trucks): presence cares about specific cuisine or format categories (not a vague “Restaurant”), hours, and a current menu; trucks also need “where are you today.” Recommendability cares about occasion (date night versus quick lunch), price and vibe signals, dietary clarity, and fresh reviews. Fine dining, quick service, and trucks are **parameters inside this cluster**, not separate products.
**Professional / office services** (lawyer, accountant): less weight on “open right now,” more on specialty, credentials, and clear service language.
**Home and personal care** (salon, dentist, medspa): booking path and services on the presence side; skill match and outcome-themed trust on recommendability.
**Beauty** (salon, barber, day spa, nails — formerly the non-medical slice of “home and personal care”): booking path and services on the presence side; skill match, portfolio, and outcome-themed trust on recommendability. Dentist, medical spa, and other clinical work belong under healthcare, not here.
**Hospitality and tourism** (hotel, surf rental, tour): destination and amenity truth, seasonal hours, and conflicts between the business’s own facts and big travel sites; recommendability is trip-intent fit (“family,” “near the break,” pet-friendly) and seasonal availability.
**Hospitality and tourism** (hotel, surf rental, tour): destination and amenity truth, seasonal hours, and conflicts between the business’s own facts and big travel sites; recommendability is trip-intent fit (“family,” “near the break,” pet-friendly) and seasonal availability. This stays a **rubric parent even though GBP will not hand it to us as one bucket** — lodging leaves (hotel, motel, B&B) group fairly cleanly; tourism activity scatters across Sports, Education, Arts, and related leaves. Our audits still need one trip-intent rubric.
**Healthcare / regulated** (only if we take them on): higher bar for accurate categories and careful claims.
**Healthcare / regulated** (only if we take them on — including dentist and medical spa): higher bar for accurate categories and careful claims. **Veterinary** is an open decision: GBP treats pets/vets as their own industry neighborhood; decide later whether vets ride with healthcare or get a separate call.
**Hybrid** (dine-in plus delivery, showroom plus install): both storefront and service-area rules have to be right; the query tells you which mode matters.
**Hybrid / multi-mode is not a ninth parent.** It is a **cross-cutting flag** that can sit on any cluster (dine-in plus delivery on food service; showroom plus install on retail or destination workshop). Presence and recommendability apply the relevant mode slices; the query tells you which mode matters. Google encodes many of these as specific leaves (delivery restaurant, mobile caterer), not as a top-level grouping.
For version one, start with **two** cluster packs that prove the split matters — service-area trades and food service. If the commercial wedge is tourist businesses, hospitality can swap in for food service as the second pack.
For version one, start with **two** cluster packs that prove the split matters — service-area trades and food service. If the commercial wedge is tourist businesses, hospitality can swap in for food service as the second pack. Destination workshop is the natural pack when the wedge is auto repair (as in the older UC-01 example).
---
@@ -128,12 +132,12 @@ Once Phase 0 is clear, work can run in parallel streams: promise and wedge langu
## Decisions still open
Ty still needs to lock: which cluster pack we ship first; whether version one is web-only or also embeds in a chatbot; which providers feed the Presence score; how we measure Recommendability without overclaiming (simple heuristics versus live checks inside assistants); where the “email on file” for verification comes from; free versus paid; and what never goes to a human versus when escalation is allowed.
Ty still needs to lock: which cluster pack we ship first; whether version one is web-only or also embeds in a chatbot; which providers feed the Presence score; how we measure Recommendability without overclaiming (simple heuristics versus live checks inside assistants); where the “email on file” for verification comes from; free versus paid; what never goes to a human versus when escalation is allowed; and whether **veterinary** rides with healthcare/regulated or gets its own decision (GBP keeps a Pets neighborhood separate from Health & Medical).
---
## What we are treating as hypotheses
Until we score real businesses, treat these as educated bets, not finished truth: that eight clusters is the right split; that schema.org plus maps to Google, Apple, and Yelp is the right labeling spine; that two version-one packs are enough to prove cluster-specific rubrics; and that a web app beats an MCP-first distribution story for owners in the near term (revisit in about three months).
Until we score real businesses, treat these as educated bets, not finished truth: that eight top-level clusters plus a hybrid flag is the right split (including destination workshop separate from service-area trades, and beauty separate from healthcare); that schema.org plus outbound maps to Google, Apple, and Yelp GCIDs/aliases is the right labeling spine — not GBP’s flat leaf list as internal SoT; that two version-one packs are enough to prove cluster-specific rubrics; and that a web app beats an MCP-first distribution story for owners in the near term (revisit in about three months).
Nothing in this doc is locked until Ty says so. Amend this file when decisions land — do not start a second near-named document.