> ## Documentation Index
> Fetch the complete documentation index at: https://docs.a21e.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Workspaces

> Configure workspaces with repo context, preferences, personas, and org policies.

## Overview

A workspace is a configuration scope that binds together repository context, user preferences, personas, and org-level policies. Every API request resolves to a workspace — either explicitly via `workspace_id` or implicitly via your default personal workspace.

## Workspace hierarchy

```
Organization workspace (org-wide policies)
  └── Personal workspace (user preferences)
       └── Request parameters (per-call overrides)
```

**Precedence** (highest to lowest):

1. Enforced org policies — cannot be overridden
2. Explicit request parameters
3. Personal workspace preferences
4. Generic defaults

## Connecting a repository

Link a GitHub repository to your workspace for code-aware responses:

1. Go to **Settings > Workspace** in the dashboard
2. Click **Connect repository**
3. Install the a21e GitHub App on the target repository
4. Select the repository and default branch

Once connected, a21e will:

* **Scan the file tree** on every request to identify relevant files
* **Read source code** to ground responses in your actual implementation
* **Linkify file paths** in responses so you can click through to GitHub

## Preferences

Set default values that apply to all requests from your workspace:

| Preference       | Values                                   | Effect                                |
| ---------------- | ---------------------------------------- | ------------------------------------- |
| `model_tier`     | `auto`, `economy`, `standard`, `premium` | Default model quality                 |
| `risk_tolerance` | `low`, `moderate`, `high`                | How conservative the output should be |
| `verbosity`      | `concise`, `normal`, `detailed`          | Response length                       |
| `tone`           | `formal`, `neutral`, `casual`            | Writing style                         |

## Personas

A persona adds custom system instructions to every request in the workspace:

```
You are a senior backend engineer working on a Node.js/PostgreSQL stack.
Always prefer functional patterns over OOP. Use TypeScript strict mode.
Explain trade-offs when suggesting architectural changes.
```

Configure personas in **Settings > Workspace > Persona**.

## Organization workspaces

Org admins can set **enforced preferences** that override personal settings:

* Enforced `model_tier: economy` prevents team members from using premium models
* Enforced `risk_tolerance: low` ensures conservative outputs across the org
* Org-level personas apply to all members

Org preferences are set in **Settings > Organization > Policies**.