---
id: ADR-PFM-CSH-009
title: Workspace Switching Retains Resource Context
product_area: platform
module: console-shell
revision: 1
status: proposed
design_intent: confirmed
source_sha:
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
  services-platform: ad3f6a6582843008ed0f5a17b131878d15829af1
decision: >-
  Switch to the corresponding area and list in the chosen workspace while
  removing record identities and queries and clearing client data on successful
  context installation.
constrains:
  - DOM-PFM-CSH-003
  - WF-PFM-CSH-003
  - WF-PFM-CSH-002
  - SCR-PFM-CSH-006
origin: >-
  react-console:docs/url-architecture.md#6. Tenant from the URL (decided by
  Andrew 2026-10-14; final acceptance 2026-10-15)
alternatives:
  - option: Always land on the new workspace home
    why_not: Home entry interrupts a person continuing the same resource work.
  - option: 'Keep the full address, records included'
    why_not: Record values can identify unrelated data after a workspace change.
consequences:
  - >-
    A switch preserves the resource context where a destination can be
    identified.
  - Unmatched planned paths remain in the new workspace address.
  - The current toast does not wait for confirmed entry.
supersedes: []
evidence:
  - >-
    react-console at baf6dae: lib/routes/match.ts:switchTenantPath;
    components/console/tenant-switcher.tsx; lib/security-context/provider.tsx
---
# Workspace Switching Retains Resource Context

## Context

People often switch organizations to perform the same task, but record identities belong to their original workspace.

## Decision

Build the new address from the current area and list, discard record identities and the query, then install the strict entry answer with cache clearing and subtree remounting.

## Alternatives Considered

Always using Home loses task context. Carrying the whole record address could request an unrelated record in the new workspace.

## Consequences

The person retains a recognizable work area. Planned paths remain intact. Confirmation currently occurs before entry succeeds and needs a settled timing policy.