Mechanical review prep: branch labels and doc map inventory

Point README and BUSINESS_PLAN at planning-selfserve-audit /
review/ready; list concept SoT, conventions, writing-rules,
alternate proposal, and research PDF already on tip. No product
decisions invented.
This commit is contained in:
2026-10-01 13:25:42 -07:00
parent 8337408f5b
commit 5596fc99ce
2 changed files with 14 additions and 6 deletions
+13 -5
View File
@@ -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) ## 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.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/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/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) ## 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. 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`. 2. New industry term → `docs/GLOSSARY.md`.
3. Platform field / API / UI claim → open `SOURCES.md`, update field map. No invented matrices. 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. 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. 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`). 6. Checkpoint log stays **inside** `BUSINESS_PLAN.md` (trim; don't spawn `DECISIONS.md`).
7. Two “layer” vocabularies — keep them distinct: 7. Two "layer" vocabularies — keep them distinct:
- **Layer A/B/C** = how we surface work (universal / genre / known-for) → `genre-packs.md` - **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` - **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 ## Process
+1 -1
View File
@@ -1,6 +1,6 @@
# geolocal.io — Business Plan (working draft) # 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 **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. **Purpose:** **Only** durable home for the business idea on this branch. Fold strategy here; do not spawn sibling strategy docs.