Skip to content

docs(product): native first-run product tour design record (RIG-2797) - #662

Open
rigel-mintaka wants to merge 1 commit into
mainfrom
compass-ux/2797-first-run-tour-design
Open

docs(product): native first-run product tour design record (RIG-2797)#662
rigel-mintaka wants to merge 1 commit into
mainfrom
compass-ux/2797-first-run-tour-design

Conversation

@rigel-mintaka

Copy link
Copy Markdown
Contributor

Design record for the native first-run product tour: a store-gated
App-root SolidJS overlay whose steps anchor to real chrome via data-tour
attributes and drive the app's own router/store, entering on the
chase-light motion primitive. No PostHog-rendered UI ships in-app; PostHog
is measurement-only through a no-op-safe captureTourEvent indirection over
the #656 T6 embed, and tour UI has zero dependency on that embed landing.

Drafted by the design subagent, red-teamed by design-critic; both blocking
findings (async anchor-resolve race, unreachable agent-workspace nav) and
all should-fix findings folded. Ledger delta DL-265..268 applied to
docs/designs/DECISIONS.md in the same PR (UX foundation section).

Three load-bearing open questions (remote content, seen-state grain,
step-arc ratification) go to Matt for ruling before the freeze.

Co-authored-by: Matt Wilkinson matt@rigel.build

@linear-code

linear-code Bot commented Aug 27, 2026

Copy link
Copy Markdown

RIG-2797

@github-actions

github-actions Bot commented Aug 27, 2026

Copy link
Copy Markdown

Compass engineering docs preview: https://compass-ux-2797-first-run-to.compass-eng-docs.pages.dev

Deployed from compass-ux/2797-first-run-tour-design at b7990ea.

Changed pages:

@rigel-mintaka
rigel-mintaka force-pushed the compass-ux/2797-first-run-tour-design branch 2 times, most recently from 4c931a8 to fa243ae Compare August 27, 2026 02:17
@rigel-mintaka
rigel-mintaka marked this pull request as ready for review August 27, 2026 02:18
@rigel-mintaka

rigel-mintaka commented Aug 27, 2026

Copy link
Copy Markdown
Contributor Author

Unblocked — #664 merged, this PR rebased onto clean main.

The main-red duplicate DL-264 is cleared (#664 landed at f7b1923e). This branch is rebased onto clean main and its four ledger rows are renumbered to the next contiguous block above the landed max: DL-272..275 (DL-269..271 are reserved for RIG-2751 #645, ahead in the merge queue). design-ledger-gate passes; markdownlint clean; no duplicate DL ids.

Ready for Matt's review + merge (the freeze) alongside the three OQ rulings on RIG-2808.

Design record for the native first-run product tour: a store-gated
App-root SolidJS overlay whose steps anchor to real chrome via data-tour
attributes and drive the app's own router/store, entering on the
chase-light motion primitive. No PostHog-rendered UI ships in-app; PostHog
is measurement-only through a no-op-safe captureTourEvent indirection over
the #656 T6 embed, and tour UI has zero dependency on that embed landing.
Drafted by the design subagent, red-teamed by design-critic; both blocking
findings (async anchor-resolve race, unreachable agent-workspace nav) and
all should-fix findings folded. Ledger delta DL-272..275 applied to
docs/designs/DECISIONS.md in the same PR (UX foundation section).
Three load-bearing open questions (remote content, seen-state grain,
step-arc ratification) go to Matt for ruling before the freeze.

Co-authored-by: Matt Wilkinson <matt@rigel.build>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant