docs: add read-only Lumen UX flow audit (docs/ux-walk.md)

[Copilot]

Canonical issue

Issue linkage is handled automatically by the system.

Outcome

Adds a single read-only audit doc mapping current Lumen/Studio entry-to-completion routing and explicitly calling out blocked/missing surfaces. This gives one source of truth for current UX behavior without changing runtime code.

Scope

• Included:

  • New /docs/ux-walk.md covering:

    • entry surfaces and redirect behavior (/, /studio, legacy route fold-ins),
    • current / → /studio completion walk,
    • blocked/missing surfaces (no /lumen, auth/deploy gates, redirect-only retired surfaces).

  • Evidence references to concrete route/runtime files in apps/web.

  • Example snapshot from the audit:

    | `/dashboard` + `/dashboard/*` | Retired; redirected to `/studio` | app/dashboard/page.tsx, proxy.ts, next.config.js |
    | `/lumen` | No route found in current app router or redirects | repo search in apps/web/src + next.config.js |

• Explicitly excluded:

  • No app/router/runtime logic changes.
  • No API contract, auth policy, or workflow behavior changes.
  • No new tests (docs-only change).

Risk

• Risk level: low
• Failure mode:
  • Audit drift if routing behavior changes later and doc is not updated.
• Rollback:
  • Revert commit 157ff26 (removes docs/ux-walk.md).

Verification

List exact automated and manual checks, tied to the current head SHA.

• Focused tests
• Required CI
• Review threads resolved

Head SHA: 157ff26
Manual verification: cross-checked each documented route/flow claim against referenced apps/web source files.

Production evidence

Not applicable (documentation-only; no deployable runtime change).

Agent handoff

• One canonical issue is linked
• No competing PR implements the same issue
• Acceptance criteria are satisfied
• Required checks pass on the current head
• Human decision is requested only for product, security, irreversible infrastructure, or production approval

• Fixes Document current Lumen end-to-end UX flow walk and gaps #1636

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
v0-uvai	Ready	Preview, v0	Sep 8, 2026 11:46pm UTC