← Corpus / augment-it / spec
Initial User Experience — From Landing to a Productive First Action
What does the first thirty seconds of augment-it feel like? This spec covers the surface a brand-new user lands on, the lightweight onboarding that gets them to a productive first action without lecturing, and the seams where the working-app and architecture-demonstration identities first meet the visitor. Designed to be skipped by returning users, never re-shown unnecessarily, and never required to dismiss to do work.
- Path
- specs/Initial-User-Experience.md
- Authors
- Michael Staton
- Augmented with
- Claude Code on Claude Opus 4.7 (1M context)
- Tags
- Spec · Augment-It · Onboarding · Initial-User-Experience · First-Use · UX · Discoverability
Initial User Experience
Related
- [[Shell-and-Micro-Frontend-UX-Coherence]] — the coherence principles this onboarding has to instance (no Hidden/Dead/Mismatched/Misnamed affordances on first contact, of all places)
- [[../blueprints/Augment-It-as-Working-App-and-Architecture-Demo]] — the dual identity that shapes who “the new user” actually is
- [[../blueprints/Auth-Patterns-following-Astro-Knots-Patterns]] — the auth gate is part of the first 30 seconds; the patterns it follows matter to this spec
- [[API-First-In-App-Documentation]] — the in-app docs reveal is one candidate first-touch with the architecture-demo identity
- [[Augment-It-as-CRM-Augmentation-Pipeline]] — the working-app vision the onboarding has to make legible