> [Agent navigation index](/llms.txt)

# Workspaces

A Brix workspace coordinates independently built applications, shared libraries, external hosts, and one root-owned toolchain. Use the focused guides for architecture, lifecycle workflows, and external integration.

Applications remain independently deployable, while libraries expose intentional shared APIs. Root commands coordinate dependency order and policy without allowing one application to import another application's implementation.

## Recommended path

1. [Create the workspace and explicit library boundaries](/docs/workspaces-libraries.md).
1. [Run root and focused workflows](/docs/workspaces-workflows.md) once links and package names are correct.
1. [Adopt an external host](/docs/workspaces-external.md) only when it must share installation ownership.

If two applications need incompatible Brix versions, they do not belong in one Brix workspace.
