Reverse spec drafted

Workspace switcher

Active Workspace identity and membership-aware switching between organizations.

Observed route/adminFuture Spec 03 →

Current maturityVisible active-Workspace control; switching behavior unverified

Evidence confidencePartially verified

Last reviewedAugust 4, 2026

Visual evidenceDeferred during UI updates

Current-state summary

The switcher is located beneath the brand in both the Admin and Settings shells. It begins in a loading state and resolves to the active Workspace name and context. The current observed Workspace is Proper Gallery with Registry Administration context. The menu contents and cross-Workspace switching transaction were not exercised.

Interface inventory

Anatomy and verified behavior

Verification states separate observed behavior from requirements or assumptions.

Element	Current behavior	Verification
Section label	Displays Active Workspace.	Verified live
Workspace name	Transitions from Loading Workspace… to Proper Gallery.	Verified live
Context label	Transitions from Checking membership to Registry Administration.	Verified live
Switch affordance	A downward caret communicates an expandable control.	Verified live; menu not opened

User journeys

Current flows

Resolve active Workspace

Restore the session
Check Membership
Resolve active Workspace
Render Workspace name and context
Scope the shell and content

Change Workspace

Open switcher
Choose another active Membership
Validate access server-side
Clear previous Workspace data
Load navigation and content for the new context

State model

Current and expected states

Loading

Loading Workspace… / Checking membership.

Resolved

Proper Gallery / Registry Administration.

Multiple Workspaces

Menu and selection behavior not verified.

No active Membership

Not verified.

Membership suspended during session

Not verified.

Product rules

Non-negotiable boundaries

The selected Workspace must map to an active Membership.
Workspace switching must change search, notifications, navigation, quick actions and data access.
Previous Workspace data must not remain visible after switching.
A client-provided Workspace ID cannot grant authority.

Dependencies

Workspace MembershipsActive Workspace session stateWorkspace profilePermission evaluationCache and subscription invalidation

Known current limitations · 5 mapped

What is missing, broken or unverified

Future Spec 03 owns closure →

Menu contents and actual switching are not verified.
Only one active Workspace has been observed.
Legacy Proper Gallery naming remains visible.
Deep links into records owned by another Workspace are unverified.
Long names and mobile layout are unverified.

Future alignment

Required evolution

01Group active, pending and limited-context Workspaces where applicable.
02Clear Workspace-owned caches before rendering a new context.
03Handle deep-link switch prompts safely.
04Show Workspace type or Provider category consistently.

Current baseline

Acceptance record

Loading and resolved states are visible.
The active Workspace and context are identifiable.
Unverified switching behavior is not represented as complete.

Reverse-spec completeness

Documentation coverage

The interface is still changing, so visual evidence and repository tracing remain intentionally incomplete.

Purpose and user outcome

Documented

Roles and access

Documented

Routes and entry points

Documented

Page and component anatomy

Documented

Fields and displayed data

Documented

Primary actions

Documented

Forms and validation

Documented

States and transitions

Documented

Empty, loading and error states

Documented

Responsive behavior

Partial

Accessibility behavior

Partial

Activity and audit events

Partial

Data sources and persistence

Documented

Notifications and automation

Partial

Known defects and limitations

Documented

Reusable component dependencies

Documented

Future-spec conflicts

Partial

Visual and repository evidence

Deferred

Acceptance of current baseline

Documented