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.
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
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)
- Strategy / GTM / wedge / owner workflow / surfaces / MCP / distribution / packaging → fold into
docs/BUSINESS_PLAN.md. Never spawn a sibling strategy file. - New industry term →
docs/GLOSSARY.md. - Platform field / API / UI claim → open
SOURCES.md, update field map. No invented matrices. - External survey / report →
docs/evidence/<SOURCE>-<year>.mdwith source URL. Link from the plan; don't paste essays into the plan. - No new
docs/*top-level folder unless Ty explicitly approves. - Checkpoint log stays inside
BUSINESS_PLAN.md(trim; don't spawnDECISIONS.md). - 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
- Layer A/B/C = how we surface work (universal / genre / known-for) →
- Self-serve AI discoverability concept / phased plan → amend
docs/SELF_SERVE_AI_DISCOVERABILITY_CONCEPT.mdonly (seedocs/CONVENTIONS.md). Do not spawn PLAN/CONCEPT twins. docs/ALTERNATE_BUSINESS_PROPOSAL.mdis 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.