Home / About / Engineering / 018: Guide a first-time reader through the whole loop, from the early-access key to the first note sent
Engineering · open
018: Guide a first-time reader through the whole loop, from the early-access key to the first note sent
Guide a first-time reader through the whole loop, from the early-access key to the first note sent
| Id | 018 |
| Status | open |
| Kind | Story |
| Priority | high |
| Created | 2026-10-12T15:20:00Z |
| Source | the owner's first run of v0.12.0 on an iPad, 12 October 2026: three screenshots and a note kept in the pane, relayed in chat |
| Release | v0.12.2 |
| Effort | medium |
| File | admin/engineering/issues/open/018-first-time-guidance.md |
What is asked
The owner: "we need to guide the user so that anybody who never used this before can follow up … we need to create a better experience." The three steps (007) are the start; this card is the whole first run: what to do, in order, on the page where it happens, with what each step makes and why.
Scenario
Given I arrive with nothing
When I open the pane
Then it tells me the loop in three lines and what the first step is
And every step says what it makes (a passkey, three vaults, a file, a lane) and what leaves the browser
And at the end I can see what I made, in the Keys tab, and what I sent
Mock-up
A first-run card at the top of This page, dismissible, that follows the steps; the vault page's "The feedback loop" section as the long form.
For an agent
Issue 018 on newsroom.sgit.ai: Guide a first-time reader through the whole loop, from the early-access key to the first note sent. Status open, kind story, priority high, release v0.12.2. Source file admin/engineering/issues/open/018-first-time-guidance.md.