# Workspaces and context

> Workspaces group models and people, carry the conventions every agent reads, and hold a library of templates. Each model adds its own FINANCE.md.

## Workspaces

A **workspace** holds models and the people who work on them. Everyone has a personal workspace; a team workspace adds members (admins and members) who all edit its models. A model can also be shared with a guest, as a viewer or an editor, or published through a link.

## Conventions

Each workspace carries **conventions**: one short Markdown document (at most 3,000 characters) with the standing preferences its members share. Typical content: the statements the firm expects, sign and naming habits, depth of detail, who reads the models. Every agent reads them before it writes, and they come back with every model it opens.

## FINANCE.md

Each model carries its own **[FINANCE.md](/docs/reference/finance-md)**: a YAML header (currency, units, language, glossary) and a Markdown body (the objective of the model, the structure of its statements, its conventions). It is an open format: a FINANCE.md file in a project folder can be pushed to the model, and the model's own can be read back.

The two documents work together: conventions say how this team models, FINANCE.md says what this model is.

## Templates

A **template** is a read-only copy of a model, published from the app. Official templates are curated by Layerz; a workspace has its own library. A template's FINANCE.md is its usage guide. A new model can start from a template (sources and mapping rules included, credentials excluded), or a template can be added as a module into an existing model.
