# geolocal.io — planning-selfserve-audit

**Review surface branch** (from `planning-rev2` 2026-09-15 session lineage). Hot self-serve / remediation work 2026-10-01. Not a clone of `main`. Do not merge main docs here.

**Start here for Ty review:** [`REVIEW.md`](REVIEW.md)

## Map (locked)

| Path | Role |
| :--- | :--- |
| `REVIEW.md` | Review package (requirements, decisions, flags, branch map, checklist) |
| `docs/BUSINESS_PLAN.md` | **Only** home for the business idea / strategy / GTM / wedge / workflow / MCP / packaging |
| `docs/GLOSSARY.md` | Industry terms only |
| `docs/product/genre-packs.md` | Layer A/B/C index (how we surface work to owners) |
| `docs/product/genre-packs/` | Field SoT (`SOURCES.md`, `core3-field-map.md`) + genre notes (`salon.md`, `bakery.md`) |
| `docs/evidence/` | Sourced research notes (cite URL) — not strategy |
| `docs/SELF_SERVE_AI_DISCOVERABILITY_CONCEPT.md` | Self-serve AI discoverability concept + phased plan (amend in place; one SoT) |
| `docs/CONVENTIONS.md` | Anti-duplication docs rules (one-concept-one-file) |
| `docs/writing-rules.md` | Outsider-first writing rules for strategy/research prose |
| `docs/ALTERNATE_BUSINESS_PROPOSAL.md` | Alternate commercial thesis (ticket-set / warehouse); does not amend concept SoT |
| `docs/research-brief.pdf` | PDF packaging of research brief / alternate proposal |

## Placement rules (agents must follow)

1. Strategy / GTM / wedge / owner workflow / surfaces / MCP / distribution / packaging → **fold into** `docs/BUSINESS_PLAN.md`. Never spawn a sibling strategy file.
2. New industry term → `docs/GLOSSARY.md`.
3. Platform field / API / UI claim → open `SOURCES.md`, update field map. No invented matrices.
4. External survey / report → `docs/evidence/<SOURCE>-<year>.md` with source URL. Link from the plan; don't paste essays into the plan.
5. **No new `docs/*` top-level folder** unless Ty explicitly approves.
6. Checkpoint log stays **inside** `BUSINESS_PLAN.md` (trim; don't spawn `DECISIONS.md`).
7. Two "layer" vocabularies — keep them distinct:
   - **Layer A/B/C** = how we surface work (universal / genre / known-for) → `genre-packs.md`
   - **Beyond NAP** = shared basics → provider extras → provider stacks → section inside `BUSINESS_PLAN.md`
8. Self-serve AI discoverability concept / phased plan → amend `docs/SELF_SERVE_AI_DISCOVERABILITY_CONCEPT.md` only (see `docs/CONVENTIONS.md`). Do not spawn PLAN/CONCEPT twins.
9. `docs/ALTERNATE_BUSINESS_PROPOSAL.md` is an explicit alternate thesis file already on this lineage; do not fold it into the concept SoT without Ty saying so.

## Process

- **SEO & AEO Desk** = sole scribe + conversation SME on this branch.
- Essence of agreed direction only; mark provisional until Ty locks.
- Nothing locked until Ty says so.
- Never invent Core 3 fields — use `docs/product/genre-packs/SOURCES.md`.