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:
@@ -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,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.
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user