diff --git a/README.md b/README.md index d00c293..b4a2127 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ -# geolocal.io — planning-rev2 +# geolocal.io — planning-selfserve-audit -**Net-new planning branch** (2026-09-15 session). Not a clone of `main`. Do not merge main docs here. +**Working review branch:** `review/ready` (from `planning-selfserve-audit`, itself from `planning-rev2` 2026-09-15 session). Not a clone of `main`. Do not merge main docs here. ## Map (locked) @@ -11,18 +11,26 @@ | `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 | +| `REVIEW.md` | Review package for Ty (requirements, flags, branch map, checklist) — added on `review/ready` | ## 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/-.md` with source URL. Link from the plan; don’t paste essays into the plan. +4. External survey / report → `docs/evidence/-.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: +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 diff --git a/docs/BUSINESS_PLAN.md b/docs/BUSINESS_PLAN.md index f308685..c7a443a 100644 --- a/docs/BUSINESS_PLAN.md +++ b/docs/BUSINESS_PLAN.md @@ -1,6 +1,6 @@ # geolocal.io — Business Plan (working draft) -**Branch:** `planning-rev2` +**Branch:** `planning-selfserve-audit` (review packaging on `review/ready`) **Status:** In progress — conversation checkpoint, not final **Purpose:** **Only** durable home for the business idea on this branch. Fold strategy here; do not spawn sibling strategy docs.