From f752e8d0ae9c92b1e8120a0367557f66d7a13f2a Mon Sep 17 00:00:00 2001 From: porbot Date: Tue, 15 Sep 2026 19:26:53 +0000 Subject: [PATCH] Scribe layers beyond NAP and why owners care Base Core 3, provider extras, provider stacks (Apple vs Google). --- README.md | 1 + docs/GLOSSARY.md | 2 ++ docs/strategy/BUSINESS_PLAN.md | 10 ++++++ docs/strategy/LAYERS-BEYOND-NAP.md | 51 ++++++++++++++++++++++++++++++ docs/strategy/README.md | 2 ++ 5 files changed, 66 insertions(+) create mode 100644 docs/strategy/LAYERS-BEYOND-NAP.md diff --git a/README.md b/README.md index 0f3129d..2d20d7b 100644 --- a/README.md +++ b/README.md @@ -8,6 +8,7 @@ Not a clone of `main`. Do not merge main docs into this branch. | Path | Role | | :--- | :--- | | `docs/strategy/BUSINESS_PLAN.md` | Working plan / POR checkpoint | +| `docs/strategy/LAYERS-BEYOND-NAP.md` | Beyond NAP: extras + stacks; why owners care | | `docs/GLOSSARY.md` | Running glossary (NAP, GBP, Core 3, …) | | `docs/product/genre-packs.md` | Layer A/B/C + pack index | | `docs/product/genre-packs/core3-field-map.md` | Sourced Core 3 field map | diff --git a/docs/GLOSSARY.md b/docs/GLOSSARY.md index f898ce8..dc269c7 100644 --- a/docs/GLOSSARY.md +++ b/docs/GLOSSARY.md @@ -13,4 +13,6 @@ Running definitions for industry terms used in geolocal.io planning. | **Core 3** | The common US min-bar listing set: GBP, Apple Business Connect, Bing Places. Genre/market adds (Yelp, Facebook, TripAdvisor, vertical dirs) are separate. | | **Discovery foundation** | Owner-facing name for tier 1: Core listings + NAP/hours/category/contact consistency (internally: “2017”). | | **AI readiness** | Owner-facing name for tier 2: known-for / recommendability scorecard and structured presence when ready (internally: “2027”). | +| **Apple Stack** | Owner-facing name for Apple Business brand/place-card capabilities above NAP: Brand logo/Style Guide, cover into Maps + Wallet/Pay, Showcases, Actions, Insights — a unified brand OS, not just a Maps pin. | +| **Listings pack** | Per-provider capability model (what GBP / Apple / Bing can hold above NAP). Distinct from **genre pack** (what a salon vs bakery must prove). | diff --git a/docs/strategy/BUSINESS_PLAN.md b/docs/strategy/BUSINESS_PLAN.md index 9ccce98..53f841c 100644 --- a/docs/strategy/BUSINESS_PLAN.md +++ b/docs/strategy/BUSINESS_PLAN.md @@ -124,6 +124,16 @@ Three layers (not one giant schema): **A** universal Discovery foundation → ** 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). +### Layers beyond NAP (working direction — essence) + +See [`LAYERS-BEYOND-NAP.md`](./LAYERS-BEYOND-NAP.md). + +1. **Shared listing basics (Core 3)** — category, hours, website, description, service-area mode +2. **Provider listing extras** — GBP services/posts/actions/attrs; Apple Good to Know / hours types; Bing thinner +3. **Provider stacks** — Apple Stack (brand → Maps+Wallet/Pay, Showcases, Actions); Google = rich but fragmented listing + adjacent products + +**Why owners care:** NAP = findable; extras = know what you do; stacks/actions = chosen and acted on. + ### 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. diff --git a/docs/strategy/LAYERS-BEYOND-NAP.md b/docs/strategy/LAYERS-BEYOND-NAP.md new file mode 100644 index 0000000..d2e504c --- /dev/null +++ b/docs/strategy/LAYERS-BEYOND-NAP.md @@ -0,0 +1,51 @@ +# Layers beyond NAP — why owners should care + +**Status:** working essence (2026-09-15 session) — not locked +**Audience:** GeoLocal POR / owner-language planning + +--- + +## NAP is the floor + +**NAP** = Name, Address, Phone. Matching identity across Core listings is the floor. Without it, Maps and assistants can’t reliably find the business. + +--- + +## Three layers above NAP + +### 1. Shared listing basics (Core 3) + +Category, hours, website, short description, service-area/address mode — same *job* on **GBP**, **Apple Business Connect**, and **Bing Places**: what you are, when you’re open, how to reach you. + +Field SoT: [`../product/genre-packs/core3-field-map.md`](../product/genre-packs/core3-field-map.md). + +### 2. Provider listing extras + +Platform-specific depth beyond the shared basics, e.g.: + +- **GBP:** services (`serviceItems`), products, posts, Place Actions, category-dynamic attributes, photos +- **Apple:** Good to Know, richer hours types (normal / service / temporary), About, Actions (as offered) +- **Bing:** thinner extras + +This moves the owner from “they can find me” → “they know what I do.” + +### 3. Provider brand / capability stacks + +Specialized capability above listing extras: + +- **Apple Stack (clearest unified OS):** Brand (logo, Style Guide) → place card that carries logo/cover into **Maps and Wallet/Pay**, Showcases, approved Actions, Insights +- **Google:** rich but **fragmented** — GBP listing extras + adjacent products (Brand profile, Merchant Center, Pay/Wallet console branding). Not one Apple-shaped brand OS + +Sources: [`../product/genre-packs/SOURCES.md`](../product/genre-packs/SOURCES.md). + +--- + +## Why business owners should care + +| Layer | Owner outcome | +| :--- | :--- | +| NAP | Findable — assistants and Maps can match you | +| Shared basics + extras | Understandable — what you do, when, how to reach | +| Stacks (esp. Apple Actions / Google Place Actions) | **Chosen and acted on** — directions, call, book, order | + +Discovery foundation → AI readiness is this ladder: exist → know what you do → recommend / act. NAP alone is not enough for “most recommended bakery for muffins.” diff --git a/docs/strategy/README.md b/docs/strategy/README.md index c9045df..f603b31 100644 --- a/docs/strategy/README.md +++ b/docs/strategy/README.md @@ -1,3 +1,5 @@ # strategy Start with `BUSINESS_PLAN.md`. + +- [`LAYERS-BEYOND-NAP.md`](./LAYERS-BEYOND-NAP.md) — base / extras / stacks; why owners care