grokbot_ty
5ac84b6ca5
Root REVIEW.md synthesizes geo-lead structure + SEO Desk research flags (lanes, fan-out ceiling, platform confirm/flag table, weak contradictions). Mechanical README map + BUSINESS_PLAN branch label for planning-selfserve-audit. No product contradictions closed.
43 lines
2.8 KiB
Markdown
43 lines
2.8 KiB
Markdown
# 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`.
|