scrimshawlife-ctrl · scrimshawlife-ctrl · Jul 29, 2026 · Jul 29, 2026 · Jul 29, 2026
@@ -86,7 +86,7 @@ Demo Mode runs the same deterministic loop without physical movement or location
 | Multiplayer, marketplace, LiveOps | 🔒 Deferred | Outside current scope |
 | Generalized AI Director | 🔒 Future reference | Not current implementation authority |
 
-See the complete [`Current Capability Matrix`](docs/canonical/CURRENT_CAPABILITY_MATRIX.md).
+See the complete [`Current Capability Matrix`](docs/canonical/CURRENT_CAPABILITY_MATRIX.md). AR redesign planning (supporting only): [`AR Product Redesign Map`](docs/design/AR_PRODUCT_REDESIGN_MAP.md) · long-term [`North Star`](docs/design/PRODUCT_VISION_NORTH_STAR.md) · [`MVP → Vision Ladder`](docs/canonical/MVP_TO_VISION_LADDER.md).
 
 ## Quick Start
 
@@ -264,4 +264,4 @@ Start with [`CONTRIBUTING.md`](CONTRIBUTING.md). Coding agents must also read [`
 
 ## License
 
-Licensed under the [Apache License 2.0](LICENSE).
+Licensed under the [Apache License 2.0](LICENSE).
@@ -1,5 +1,7 @@
 # Waykin Roadmap
 
+> **North star (reference only):** [`docs/design/PRODUCT_VISION_NORTH_STAR.md`](docs/design/PRODUCT_VISION_NORTH_STAR.md) — AR companion across walks/runs/rides + fitness; later worldbuilding and user-designed companions/experiences. Gated path: [`docs/canonical/MVP_TO_VISION_LADDER.md`](docs/canonical/MVP_TO_VISION_LADDER.md). Near-term AR session redesign planning: [`docs/design/AR_PRODUCT_REDESIGN_MAP.md`](docs/design/AR_PRODUCT_REDESIGN_MAP.md) (**SUPPORTING**). This roadmap remains evidence-gated engineering for the **current** binding MVP.
+
 Waykin advances by proving one bounded layer before promoting the next. This roadmap is directional; GitHub issues and accepted milestone documents authorize implementation.
 
 ## Status Legend
@@ -131,4 +133,4 @@ A future capability becomes implementable only when:
 3. Canonical scope and architecture documents are updated when necessary.
 4. Architecture review or an ADR approves material boundary changes.
 
-See `WAYKIN_SPEC.md`, `docs/design/AI_DIRECTOR_RELEASE_CANDIDATES.md`, `docs/design/HEALTHKIT.md`, `docs/canonical/CURRENT_CAPABILITY_MATRIX.md`, and `docs/governance/DOCUMENT_AUTHORITY.md`.
+See `WAYKIN_SPEC.md`, `docs/design/AI_DIRECTOR_RELEASE_CANDIDATES.md`, `docs/design/HEALTHKIT.md`, `docs/canonical/CURRENT_CAPABILITY_MATRIX.md`, and `docs/governance/DOCUMENT_AUTHORITY.md`.
@@ -29,6 +29,12 @@ Waykin documentation is organized by **authority**, **maturity**, and **evidence
 | [`SOLO_MVP_SCOPE.md`](SOLO_MVP_SCOPE.md) | Constraints that keep Waykin implementable by one person |
 | [`../ROADMAP.md`](../ROADMAP.md) | Evidence-gated progression from physical-loop proof to future systems |
 | [`canonical/CURRENT_CAPABILITY_MATRIX.md`](canonical/CURRENT_CAPABILITY_MATRIX.md) | What is implemented, under validation, deferred, or future-only |
+| [`design/AR_PRODUCT_REDESIGN_MAP.md`](design/AR_PRODUCT_REDESIGN_MAP.md) | AR product redesign master map — **SUPPORTING** (not binding) |
+| [`plans/AR_APP_REDESIGN_PLAN.md`](plans/AR_APP_REDESIGN_PLAN.md) | Phased AR-app redesign plan — supporting |
+| [`design/AR_SYSTEM_INVENTORY.md`](design/AR_SYSTEM_INVENTORY.md) | File-level AR system inventory — supporting |
+| [`design/AR_SESSION_IA_CONFLICTS.md`](design/AR_SESSION_IA_CONFLICTS.md) | Active Session IA conflicts (C1–C11) — supporting |
+| [`design/PRODUCT_VISION_NORTH_STAR.md`](design/PRODUCT_VISION_NORTH_STAR.md) | Long-term vision — **REFERENCE_ONLY** |
+| [`canonical/MVP_TO_VISION_LADDER.md`](canonical/MVP_TO_VISION_LADDER.md) | Gated ladder MVP → north star (R0–R8) — supporting |
 | [`../KNOWN_LIMITATIONS.md`](../KNOWN_LIMITATIONS.md) | Validated, partial, deferred, and `NOT_COMPUTABLE` gates |
 
 ## Engineering

@@ -0,0 +1,195 @@
+# Waykin MVP → Vision Ladder
+
+```yaml
+document_id: WAYKIN-MVP-TO-VISION-LADDER-001
+version: 1.0
+date: 2026-07-29
+status: SUPPORTING
+authority: SUPPORTING
+maturity: NEAR_TERM
+north_star: docs/design/PRODUCT_VISION_NORTH_STAR.md
+does_not_override: [docs/SOLO_MVP_SCOPE.md, WAYKIN_SPEC.md]
+```
+
+## 1. Purpose
+
+Translate the [north star](../design/PRODUCT_VISION_NORTH_STAR.md) into a **gated ladder** so the team can build toward:
+
+- AR companion on **walks → runs → rides** (+ fitness depth)
+- then **worldbuilding**
+- then **user-designed companions & experiences**
+
+…without breaking the current architecture or shipping excluded scope early.
+
+**Lower rungs do not unlock upper rungs by aspiration alone.** Each gate needs evidence + explicit promotion.
+
+## 2. Ladder overview
+
+```text
+R0  Binding MVP (today)
+R1  AR-designed walk identity + session
+R2  Outdoor AR walk proof
+R3  Fitness depth (still walk-primary)
+R4  Multi-activity framework (run, then ride)
+R5  First-party worldbuilding content systems
+R6  Experience pack runtime (first-party packs)
+R7  User-designed experiences
+R8  User-designed companions (+ marketplace only if ever ratified)
+```
+
+```text
+R0 ──▶ R1 ──▶ R2 ──▶ R3 ──▶ R4 ──▶ R5 ──▶ R6 ──▶ R7 ──▶ R8
+ walk   AR     outdoor fitness multi  world  packs  UGC    UGC
+ law    law    AR      depth   activity build first  exp.   companions
+        UX     PASS                  party
+```
+
+## 3. Rung detail
+
+### R0 — Binding MVP (current law)
+
+| Field | Content |
+| ----- | ------- |
+| **Product** | Solo adaptive **walk**; one companion **Lira**; Bond; bounded pursuit; semantic audio; local memory |
+| **AR** | Presentation adapter; optional cover; MVP frozen for feature creep |
+| **Fitness** | Soft HealthKit reads only |
+| **Creator / multi-companion / multi-activity** | Excluded or deferred |
+| **Authority** | `SOLO_MVP_SCOPE`, `WAYKIN_SPEC`, capability matrix |
+| **Exit** | N/A — baseline |
+
+### R1 — AR-designed walk (near-term redesign)
+
+| Field | Content |
+| ----- | ------- |
+| **Product** | Same walk MVP; identity = **AR-designed** (not audio-first); AR primary session surface when capable |
+| **Work** | Phase 0 law + Phase 2 session IA ([`AR_APP_REDESIGN_PLAN`](../plans/AR_APP_REDESIGN_PLAN.md), [`AR_SESSION_IA_CONFLICTS`](../design/AR_SESSION_IA_CONFLICTS.md)) |
+| **Must not** | Multi-activity, multi-companion, creator, AR gameplay authority |
+| **Exit gate** | Binding docs + UIUX amended; skills/agents aligned; isolation + tests green |
+
+### R2 — Outdoor AR walk proof
+
+| Field | Content |
+| ----- | ------- |
+| **Work** | #41 outdoor re-walk; continuity, thermal, battery, safety; honest receipts |
+| **Exit gate** | Outdoor AR evidence policy satisfied for claims you want to make; no PASS invented from sim |
+| **Unlocks** | Credible AR marketing; confidence for multi-activity planning |
+
+### R3 — Fitness depth (walk still primary)
+
+| Field | Content |
+| ----- | ------- |
+| **Work** | Harden HK lifecycle evidence; optional workout write; Watch **only** via promoted issues; effort as soft context |
+| **Must not** | Medical claims; effort selecting events/Bond coercively |
+| **Exit gate** | Device evidence for each promoted fitness surface; capability matrix rows flipped with issues |
+
+### R4 — Multi-activity framework (run, then ride)
+
+| Field | Content |
+| ----- | ------- |
+| **Work** | Activity profiles on shared movement engine; integrity thresholds per mode; AR/HUD safety for speed contexts; copy and onboarding |
+| **Order** | **Run** before **ride** unless product reorders with ADR |
+| **Must not** | Separate app forks; activity-specific gameplay authorities that bypass Core |
+| **Exit gate per activity** | Integrity + outdoor sessions + return-intent signal; spec lists activity as authorized |
+
+### R5 — First-party worldbuilding systems
+
+| Field | Content |
+| ----- | ------- |
+| **Work** | Content/lore systems, arcs, place-linked memories, seasonal pressure — **still** deterministic-capable core; presentation via existing channels |
+| **Must not** | AI-owned gameplay state; unbounded generative world as required loop |
+| **Exit gate** | Content pipeline + validation; no scope leak into multiplayer/marketplace |
+
+### R6 — Experience pack runtime (first-party)
+
+| Field | Content |
+| ----- | ------- |
+| **Work** | Promote deferred Experience Pack seam: pack format, load, offline fallback, validation |
+| **Content** | First-party packs only |
+| **Exit gate** | Runtime + at least one first-party pack shippable; security/safety review |
+
+### R7 — User-designed experiences
+
+| Field | Content |
+| ----- | ------- |
+| **Work** | Creator tools or structured authoring; moderation; rate limits; safety |
+| **Depends on** | R6 stable |
+| **Exit gate** | Policy + technical gates; binding docs promote creator experiences |
+
+### R8 — User-designed companions (+ optional marketplace)
+
+| Field | Content |
+| ----- | ------- |
+| **Work** | Companion identity model versioning; user-defined look/behavior **bounds**; AR presentation of third-party companions; optional marketplace |
+| **Depends on** | R1–R2 quality bar for “a companion in AR”; R6–R7 governance lessons |
+| **Must not** | Unbounded behavior that violates safety or movement authority |
+| **Exit gate** | Explicit legal/product/security ratification; multi-companion ban lifted in binding scope |
+
+## 4. Mapping north-star pillars → earliest rung
+
+| North-star pillar | Earliest rung |
+| ----------------- | ------------- |
+| AR companion presence | R1 (design), R2 (proof) |
+| Real movement | R0+ |
+| Multi-activity fitness | R4 (framework); R3 (fitness depth on walk) |
+| Bond relationship | R0+ (deepen ongoing) |
+| Worldbuilding | R5 |
+| Creator companions & experiences | R7–R8 (packs R6) |
+
+## 5. What each horizon may claim
+
+| Horizon | OK to say | Not OK |
+| ------- | --------- | ------ |
+| R0–R1 | AR companion for walking (with honest capability limits) | Multi-sport app; make your own companion |
+| R2+ | Outdoor AR walk claims per receipt | Universal outdoor AR quality |
+| R3+ | Fitness-connected walk companion | Medical/clinical |
+| R4+ | Run/ride companion (per shipped modes) | “All sports” without list |
+| R5+ | Deeper world / story of Lira’s world | User-generated world as default |
+| R6+ | Official experience packs | App Store “UGC platform” |
+| R7–R8 | Design experiences / companions | Unmoderated marketplace |
+
+## 6. Architecture seams to keep open (without implementing early)
+
+| Seam | Already / planned | Serves rungs |
+| ---- | ----------------- | ------------ |
+| `ARWorldCommand` + matrix | Shipped | R1–R8 presentation |
+| Movement engine + integrity | Shipped | R0–R4 |
+| Activity enrichment (HK) | Soft reads shipped | R3–R4 |
+| Watch / wearable contracts | Reference | R3–R4 |
+| Experience pack (deferred) | Seam only | R6–R7 |
+| Companion identity persistence | Lira singleton | R8 needs versioning |
+
+**Do not** invent parallel runtimes per activity or per creator pack that bypass Core.
+
+## 7. Relationship to binding exclusions
+
+Until a rung is promoted, these remain **out of force for implementation** even though they appear in the north star:
+
+- Run / cycle / hike / climb expansion
+- Multi-companion
+- Marketplace / creator SDK
+- Downloadable experience packs (runtime deferred)
+- Multiplayer
+- Generalized AI world director
+
+## 8. Suggested promotion checklist (any rung)
+
+- [ ] Outdoor / device evidence named and attached
+- [ ] Capability matrix row updates
+- [ ] `WAYKIN_SPEC` / `SOLO_MVP_SCOPE` diff (if product law changes)
+- [ ] ADR if boundaries change
+- [ ] UIUX / agent context updated
+- [ ] Explicit non-goals restated so agents don’t overbuild
+
+## 9. Related
+
+| Doc | Role |
+| --- | ---- |
+| [`../design/PRODUCT_VISION_NORTH_STAR.md`](../design/PRODUCT_VISION_NORTH_STAR.md) | Destination |
+| [`../design/AR_PRODUCT_REDESIGN_MAP.md`](../design/AR_PRODUCT_REDESIGN_MAP.md) | R1 architecture map |
+| [`../plans/AR_APP_REDESIGN_PLAN.md`](../plans/AR_APP_REDESIGN_PLAN.md) | R1 execution |
+| [`CURRENT_CAPABILITY_MATRIX.md`](CURRENT_CAPABILITY_MATRIX.md) | What is shipped vs deferred |
+| [`../../ROADMAP.md`](../../ROADMAP.md) | Evidence-gated engineering roadmap |
+
+---
+
+*Ladder v1.0 — supporting. Does not override binding MVP law.*
@@ -16,7 +16,7 @@ Last updated: 2026-07-29 (**FREEZE MERGED** — #249; device indoor next; no red
 | Issue #41 — outdoor / physical validation | Human device | **Parked** — scaffold [OUTDOOR_QA_RECEIPT_20260729T191500Z_7df3a16_PENDING.md](../design/receipts/OUTDOOR_QA_RECEIPT_20260729T191500Z_7df3a16_PENDING.md); walk after indoor preferred | [DEFERRED_RECOMMENDATIONS.md](../design/DEFERRED_RECOMMENDATIONS.md) |
 | Issue #247 — TF archive hold | Product / dist | **Softened, not closed** — Prabu photo shows authored mesh on *some* build; still need OBSERVED on **exact freeze/archive SHA** before TF | [#247](https://github.com/scrimshawlife-ctrl/Waykin/issues/247) |
 | Internal TestFlight RC | Human (signing / ASC) | **Blocked** — freeze + #247 + fresh validate first | [TESTFLIGHT_RC_CHECKLIST.md](../design/TESTFLIGHT_RC_CHECKLIST.md) |
-| PR #245 AR redesign docs | Docs lane | **Parked behind freeze** — SUPPORTING only; recover onto freeze tip later; do **not** merge stale branch | [#245](https://github.com/scrimshawlife-ctrl/Waykin/pull/245) |
+| AR redesign docs recovery | Docs lane | **Landing via [#251](https://github.com/scrimshawlife-ctrl/Waykin/pull/251)** — recovered SUPPORTING docs on freeze main; supersedes stale [#245](https://github.com/scrimshawlife-ctrl/Waykin/pull/245). After merge: treat recovery **complete**; close #245 | SUPPORTING only; no Phase 0 binding edits |
 | AR session redesign PRs / Phase 0 law | — | **Not started** — build-on-top only after freeze + device honesty | Continuation plan steps 9–12 |
 
 ## Tip identity

@@ -84,6 +84,7 @@ When this freeze is accepted:
 ## Related
 
 - [CONTINUATION_PLAN.md](CONTINUATION_PLAN.md) v5.0
+- [AR_PRODUCT_REDESIGN_MAP.md](AR_PRODUCT_REDESIGN_MAP.md) — SUPPORTING redesign planning (does not lift freeze)
 - [LIRA_AR_PRODUCTION_RIG.md](LIRA_AR_PRODUCTION_RIG.md)
 - [AR_REPLAY_VALIDATION.md](../AR_REPLAY_VALIDATION.md)
 - [ACTIVE_WORK.md](../collaboration/ACTIVE_WORK.md)