# `Pixir.WorkspaceStrategy`
[🔗](https://github.com/Ranvier-Technologies/pixir/blob/main/lib/pixir/workspace_strategy.ex#L1)

Workspace Strategy vocabulary for Subagents and Workflow steps.

A Workspace Strategy describes how a child sees files and whether writes can mutate
the parent workspace. Subagents execute `shared` and `isolated`, and may opt in to
`virtual_overlay` with operator-owned read-set context. Workflow steps also support
explicit virtual commands. Each invocation imports host files afresh and returns an
unapplied `virtual_diff`; only commands within that invocation share virtual edits.
Canonical Logs/artifacts persist on disk; no persistent Session scratch is implied.

# `delegation_context`

```elixir
@spec delegation_context(term(), map()) :: {:ok, map()} | {:error, map()}
```

Return compact Delegation Context fields for a modeled workspace mode.

# `normalize_runtime_mode`

```elixir
@spec normalize_runtime_mode(term(), String.t(), map(), keyword()) ::
  {:ok, String.t()} | {:error, map()}
```

Normalize a runtime workspace mode or return a structured error.

---

*Consult [api-reference.md](api-reference.md) for complete listing*